wp/wp-includes/class-wp-image-editor-imagick.php
author ymh <ymh.work@gmail.com>
Tue, 09 Jun 2015 03:35:32 +0200
changeset 5 5e2f62d02dcd
parent 0 d970ebf37754
child 7 cf61fcea0001
permissions -rw-r--r--
upgrade wordpress + plugins
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     1
<?php
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     2
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     3
 * WordPress Imagick Image Editor
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     4
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     5
 * @package WordPress
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     6
 * @subpackage Image_Editor
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     7
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     8
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     9
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    10
 * WordPress Image Editor Class for Image Manipulation through Imagick PHP Module
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    11
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    12
 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    13
 * @package WordPress
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    14
 * @subpackage Image_Editor
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    15
 * @uses WP_Image_Editor Extends class
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    16
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    17
class WP_Image_Editor_Imagick extends WP_Image_Editor {
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    18
	/**
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    19
	 * @var Imagick
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    20
	 */
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    21
	protected $image; // Imagick Object
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    22
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    23
	public function __destruct() {
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    24
		if ( $this->image instanceof Imagick ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    25
			// we don't need the original in memory anymore
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    26
			$this->image->clear();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    27
			$this->image->destroy();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    28
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    29
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    30
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    31
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    32
	 * Checks to see if current environment supports Imagick.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    33
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    34
	 * We require Imagick 2.2.0 or greater, based on whether the queryFormats()
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    35
	 * method can be called statically.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    36
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    37
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    38
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    39
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    40
	 * @return boolean
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    41
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    42
	public static function test( $args = array() ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    43
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    44
		// First, test Imagick's extension and classes.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    45
		if ( ! extension_loaded( 'imagick' ) || ! class_exists( 'Imagick' ) || ! class_exists( 'ImagickPixel' ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    46
			return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    47
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    48
		if ( version_compare( phpversion( 'imagick' ), '2.2.0', '<' ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    49
			return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    50
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    51
		$required_methods = array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    52
			'clear',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    53
			'destroy',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    54
			'valid',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    55
			'getimage',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    56
			'writeimage',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    57
			'getimageblob',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    58
			'getimagegeometry',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    59
			'getimageformat',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    60
			'setimageformat',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    61
			'setimagecompression',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    62
			'setimagecompressionquality',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    63
			'setimagepage',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    64
			'scaleimage',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    65
			'cropimage',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    66
			'rotateimage',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    67
			'flipimage',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    68
			'flopimage',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    69
		);
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    70
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    71
		// Now, test for deep requirements within Imagick.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    72
		if ( ! defined( 'imagick::COMPRESSION_JPEG' ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    73
			return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    74
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    75
		if ( array_diff( $required_methods, get_class_methods( 'Imagick' ) ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    76
			return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    77
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    78
		return true;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    79
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    80
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    81
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    82
	 * Checks to see if editor supports the mime-type specified.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    83
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    84
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    85
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    86
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    87
	 * @param string $mime_type
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    88
	 * @return boolean
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    89
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    90
	public static function supports_mime_type( $mime_type ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    91
		$imagick_extension = strtoupper( self::get_extension( $mime_type ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    92
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    93
		if ( ! $imagick_extension )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    94
			return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    95
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    96
		// setIteratorIndex is optional unless mime is an animated format.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    97
		// Here, we just say no if you are missing it and aren't loading a jpeg.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    98
		if ( ! method_exists( 'Imagick', 'setIteratorIndex' ) && $mime_type != 'image/jpeg' )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    99
				return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   100
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   101
		try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   102
			return ( (bool) @Imagick::queryFormats( $imagick_extension ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   103
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   104
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   105
			return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   106
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   107
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   108
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   109
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   110
	 * Loads image from $this->file into new Imagick Object.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   111
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   112
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   113
	 * @access protected
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   114
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   115
	 * @return boolean|WP_Error True if loaded; WP_Error on failure.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   116
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   117
	public function load() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   118
		if ( $this->image instanceof Imagick )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   119
			return true;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   120
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   121
		if ( ! is_file( $this->file ) && ! preg_match( '|^https?://|', $this->file ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   122
			return new WP_Error( 'error_loading_image', __('File doesn&#8217;t exist?'), $this->file );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   123
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   124
		/** This filter is documented in wp-includes/class-wp-image-editor-imagick.php */
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   125
		// Even though Imagick uses less PHP memory than GD, set higher limit for users that have low PHP.ini limits
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   126
		@ini_set( 'memory_limit', apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   127
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   128
		try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   129
			$this->image = new Imagick( $this->file );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   130
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   131
			if( ! $this->image->valid() )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   132
				return new WP_Error( 'invalid_image', __('File is not an image.'), $this->file);
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   133
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   134
			// Select the first frame to handle animated images properly
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   135
			if ( is_callable( array( $this->image, 'setIteratorIndex' ) ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   136
				$this->image->setIteratorIndex(0);
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   137
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   138
			$this->mime_type = $this->get_mime_type( $this->image->getImageFormat() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   139
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   140
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   141
			return new WP_Error( 'invalid_image', $e->getMessage(), $this->file );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   142
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   143
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   144
		$updated_size = $this->update_size();
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   145
		if ( is_wp_error( $updated_size ) ) {
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   146
			return $updated_size;
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   147
		}
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   148
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   149
		return $this->set_quality();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   150
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   151
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   152
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   153
	 * Sets Image Compression quality on a 1-100% scale.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   154
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   155
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   156
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   157
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   158
	 * @param int $quality Compression Quality. Range: [1,100]
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   159
	 * @return boolean|WP_Error True if set successfully; WP_Error on failure.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   160
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   161
	public function set_quality( $quality = null ) {
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   162
		$quality_result = parent::set_quality( $quality );
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   163
		if ( is_wp_error( $quality_result ) ) {
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   164
			return $quality_result;
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   165
		} else {
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   166
			$quality = $this->get_quality();
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   167
		}
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   168
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   169
		try {
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   170
			if ( 'image/jpeg' == $this->mime_type ) {
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   171
				$this->image->setImageCompressionQuality( $quality );
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   172
				$this->image->setImageCompression( imagick::COMPRESSION_JPEG );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   173
			}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   174
			else {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   175
				$this->image->setImageCompressionQuality( $quality );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   176
			}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   177
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   178
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   179
			return new WP_Error( 'image_quality_error', $e->getMessage() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   180
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   181
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   182
		return true;
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   183
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   184
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   185
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   186
	 * Sets or updates current image size.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   187
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   188
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   189
	 * @access protected
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   190
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   191
	 * @param int $width
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   192
	 * @param int $height
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   193
	 *
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   194
	 * @return true|WP_Error
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   195
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   196
	protected function update_size( $width = null, $height = null ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   197
		$size = null;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   198
		if ( !$width || !$height ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   199
			try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   200
				$size = $this->image->getImageGeometry();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   201
			}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   202
			catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   203
				return new WP_Error( 'invalid_image', __('Could not read image size'), $this->file );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   204
			}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   205
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   206
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   207
		if ( ! $width )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   208
			$width = $size['width'];
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   209
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   210
		if ( ! $height )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   211
			$height = $size['height'];
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   212
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   213
		return parent::update_size( $width, $height );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   214
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   215
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   216
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   217
	 * Resizes current image.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   218
	 *
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   219
	 * At minimum, either a height or width must be provided.
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   220
	 * If one of the two is set to null, the resize will
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   221
	 * maintain aspect ratio according to the provided dimension.
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   222
	 *
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   223
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   224
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   225
	 *
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   226
	 * @param  int|null $max_w Image width.
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   227
	 * @param  int|null $max_h Image height.
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   228
	 * @param  boolean  $crop
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   229
	 * @return boolean|WP_Error
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   230
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   231
	public function resize( $max_w, $max_h, $crop = false ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   232
		if ( ( $this->size['width'] == $max_w ) && ( $this->size['height'] == $max_h ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   233
			return true;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   234
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   235
		$dims = image_resize_dimensions( $this->size['width'], $this->size['height'], $max_w, $max_h, $crop );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   236
		if ( ! $dims )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   237
			return new WP_Error( 'error_getting_dimensions', __('Could not calculate resized image dimensions') );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   238
		list( $dst_x, $dst_y, $src_x, $src_y, $dst_w, $dst_h, $src_w, $src_h ) = $dims;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   239
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   240
		if ( $crop ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   241
			return $this->crop( $src_x, $src_y, $src_w, $src_h, $dst_w, $dst_h );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   242
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   243
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   244
		try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   245
			/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   246
			 * @TODO: Thumbnail is more efficient, given a newer version of Imagemagick.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   247
			 * $this->image->thumbnailImage( $dst_w, $dst_h );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   248
			 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   249
			$this->image->scaleImage( $dst_w, $dst_h );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   250
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   251
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   252
			return new WP_Error( 'image_resize_error', $e->getMessage() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   253
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   254
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   255
		return $this->update_size( $dst_w, $dst_h );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   256
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   257
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   258
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   259
	 * Resize multiple images from a single source.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   260
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   261
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   262
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   263
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   264
	 * @param array $sizes {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   265
	 *     An array of image size arrays. Default sizes are 'small', 'medium', 'large'.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   266
	 *
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   267
	 *     Either a height or width must be provided.
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   268
	 *     If one of the two is set to null, the resize will
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   269
	 *     maintain aspect ratio according to the provided dimension.
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   270
	 *
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   271
	 *     @type array $size {
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   272
	 *         @type int  ['width']  Optional. Image width.
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   273
	 *         @type int  ['height'] Optional. Image height.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   274
	 *         @type bool $crop   Optional. Whether to crop the image. Default false.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   275
	 *     }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   276
	 * }
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   277
	 * @return array An array of resized images' metadata by size.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   278
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   279
	public function multi_resize( $sizes ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   280
		$metadata = array();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   281
		$orig_size = $this->size;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   282
		$orig_image = $this->image->getImage();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   283
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   284
		foreach ( $sizes as $size => $size_data ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   285
			if ( ! $this->image )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   286
				$this->image = $orig_image->getImage();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   287
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   288
			if ( ! isset( $size_data['width'] ) && ! isset( $size_data['height'] ) ) {
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   289
				continue;
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   290
			}
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   291
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   292
			if ( ! isset( $size_data['width'] ) ) {
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   293
				$size_data['width'] = null;
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   294
			}
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   295
			if ( ! isset( $size_data['height'] ) ) {
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   296
				$size_data['height'] = null;
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   297
			}
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   298
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   299
			if ( ! isset( $size_data['crop'] ) ) {
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   300
				$size_data['crop'] = false;
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   301
			}
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   302
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   303
			$resize_result = $this->resize( $size_data['width'], $size_data['height'], $size_data['crop'] );
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   304
			$duplicate = ( ( $orig_size['width'] == $size_data['width'] ) && ( $orig_size['height'] == $size_data['height'] ) );
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   305
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   306
			if ( ! is_wp_error( $resize_result ) && ! $duplicate ) {
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   307
				$resized = $this->_save( $this->image );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   308
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   309
				$this->image->clear();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   310
				$this->image->destroy();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   311
				$this->image = null;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   312
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   313
				if ( ! is_wp_error( $resized ) && $resized ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   314
					unset( $resized['path'] );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   315
					$metadata[$size] = $resized;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   316
				}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   317
			}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   318
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   319
			$this->size = $orig_size;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   320
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   321
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   322
		$this->image = $orig_image;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   323
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   324
		return $metadata;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   325
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   326
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   327
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   328
	 * Crops Image.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   329
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   330
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   331
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   332
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   333
	 * @param int $src_x The start x position to crop from.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   334
	 * @param int $src_y The start y position to crop from.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   335
	 * @param int $src_w The width to crop.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   336
	 * @param int $src_h The height to crop.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   337
	 * @param int $dst_w Optional. The destination width.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   338
	 * @param int $dst_h Optional. The destination height.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   339
	 * @param boolean $src_abs Optional. If the source crop points are absolute.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   340
	 * @return boolean|WP_Error
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   341
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   342
	public function crop( $src_x, $src_y, $src_w, $src_h, $dst_w = null, $dst_h = null, $src_abs = false ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   343
		if ( $src_abs ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   344
			$src_w -= $src_x;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   345
			$src_h -= $src_y;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   346
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   347
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   348
		try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   349
			$this->image->cropImage( $src_w, $src_h, $src_x, $src_y );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   350
			$this->image->setImagePage( $src_w, $src_h, 0, 0);
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   351
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   352
			if ( $dst_w || $dst_h ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   353
				// If destination width/height isn't specified, use same as
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   354
				// width/height from source.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   355
				if ( ! $dst_w )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   356
					$dst_w = $src_w;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   357
				if ( ! $dst_h )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   358
					$dst_h = $src_h;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   359
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   360
				$this->image->scaleImage( $dst_w, $dst_h );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   361
				return $this->update_size();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   362
			}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   363
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   364
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   365
			return new WP_Error( 'image_crop_error', $e->getMessage() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   366
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   367
		return $this->update_size();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   368
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   369
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   370
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   371
	 * Rotates current image counter-clockwise by $angle.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   372
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   373
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   374
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   375
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   376
	 * @param float $angle
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   377
	 * @return boolean|WP_Error
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   378
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   379
	public function rotate( $angle ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   380
		/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   381
		 * $angle is 360-$angle because Imagick rotates clockwise
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   382
		 * (GD rotates counter-clockwise)
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   383
		 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   384
		try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   385
			$this->image->rotateImage( new ImagickPixel('none'), 360-$angle );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   386
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   387
			// Since this changes the dimensions of the image, update the size.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   388
			$result = $this->update_size();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   389
			if ( is_wp_error( $result ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   390
				return $result;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   391
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   392
			$this->image->setImagePage( $this->size['width'], $this->size['height'], 0, 0 );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   393
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   394
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   395
			return new WP_Error( 'image_rotate_error', $e->getMessage() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   396
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   397
		return true;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   398
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   399
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   400
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   401
	 * Flips current image.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   402
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   403
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   404
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   405
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   406
	 * @param boolean $horz Flip along Horizontal Axis
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   407
	 * @param boolean $vert Flip along Vertical Axis
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   408
	 * @returns boolean|WP_Error
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   409
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   410
	public function flip( $horz, $vert ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   411
		try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   412
			if ( $horz )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   413
				$this->image->flipImage();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   414
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   415
			if ( $vert )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   416
				$this->image->flopImage();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   417
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   418
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   419
			return new WP_Error( 'image_flip_error', $e->getMessage() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   420
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   421
		return true;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   422
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   423
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   424
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   425
	 * Saves current image to file.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   426
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   427
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   428
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   429
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   430
	 * @param string $destfilename
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   431
	 * @param string $mime_type
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   432
	 * @return array|WP_Error {'path'=>string, 'file'=>string, 'width'=>int, 'height'=>int, 'mime-type'=>string}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   433
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   434
	public function save( $destfilename = null, $mime_type = null ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   435
		$saved = $this->_save( $this->image, $destfilename, $mime_type );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   436
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   437
		if ( ! is_wp_error( $saved ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   438
			$this->file = $saved['path'];
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   439
			$this->mime_type = $saved['mime-type'];
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   440
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   441
			try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   442
				$this->image->setImageFormat( strtoupper( $this->get_extension( $this->mime_type ) ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   443
			}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   444
			catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   445
				return new WP_Error( 'image_save_error', $e->getMessage(), $this->file );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   446
			}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   447
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   448
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   449
		return $saved;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   450
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   451
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   452
	protected function _save( $image, $filename = null, $mime_type = null ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   453
		list( $filename, $extension, $mime_type ) = $this->get_output_format( $filename, $mime_type );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   454
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   455
		if ( ! $filename )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   456
			$filename = $this->generate_filename( null, null, $extension );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   457
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   458
		try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   459
			// Store initial Format
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   460
			$orig_format = $this->image->getImageFormat();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   461
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   462
			$this->image->setImageFormat( strtoupper( $this->get_extension( $mime_type ) ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   463
			$this->make_image( $filename, array( $image, 'writeImage' ), array( $filename ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   464
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   465
			// Reset original Format
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   466
			$this->image->setImageFormat( $orig_format );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   467
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   468
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   469
			return new WP_Error( 'image_save_error', $e->getMessage(), $filename );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   470
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   471
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   472
		// Set correct file permissions
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   473
		$stat = stat( dirname( $filename ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   474
		$perms = $stat['mode'] & 0000666; //same permissions as parent folder, strip off the executable bits
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   475
		@ chmod( $filename, $perms );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   476
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   477
		/** This filter is documented in wp-includes/class-wp-image-editor-gd.php */
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   478
		return array(
5
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   479
			'path'      => $filename,
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   480
			'file'      => wp_basename( apply_filters( 'image_make_intermediate_size', $filename ) ),
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   481
			'width'     => $this->size['width'],
5e2f62d02dcd upgrade wordpress + plugins
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   482
			'height'    => $this->size['height'],
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   483
			'mime-type' => $mime_type,
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   484
		);
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   485
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   486
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   487
	/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   488
	 * Streams current image to browser.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   489
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   490
	 * @since 3.5.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   491
	 * @access public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   492
	 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   493
	 * @param string $mime_type
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   494
	 * @return boolean|WP_Error
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   495
	 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   496
	public function stream( $mime_type = null ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   497
		list( $filename, $extension, $mime_type ) = $this->get_output_format( null, $mime_type );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   498
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   499
		try {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   500
			// Temporarily change format for stream
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   501
			$this->image->setImageFormat( strtoupper( $extension ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   502
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   503
			// Output stream of image content
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   504
			header( "Content-Type: $mime_type" );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   505
			print $this->image->getImageBlob();
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   506
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   507
			// Reset Image to original Format
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   508
			$this->image->setImageFormat( $this->get_extension( $this->mime_type ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   509
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   510
		catch ( Exception $e ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   511
			return new WP_Error( 'image_stream_error', $e->getMessage() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   512
		}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   513
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   514
		return true;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   515
	}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   516
}