author | ymh <ymh.work@gmail.com> |
Fri, 05 Sep 2025 18:40:08 +0200 | |
changeset 21 | 48c4eec2b7e6 |
parent 19 | 3d72ae0968f4 |
child 22 | 8c2e4d02f4ef |
permissions | -rw-r--r-- |
0 | 1 |
<?php |
2 |
/** |
|
3 |
* WordPress Imagick Image Editor |
|
4 |
* |
|
5 |
* @package WordPress |
|
6 |
* @subpackage Image_Editor |
|
7 |
*/ |
|
8 |
||
9 |
/** |
|
10 |
* WordPress Image Editor Class for Image Manipulation through Imagick PHP Module |
|
11 |
* |
|
12 |
* @since 3.5.0 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
13 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
14 |
* @see WP_Image_Editor |
0 | 15 |
*/ |
16 |
class WP_Image_Editor_Imagick extends WP_Image_Editor { |
|
5 | 17 |
/** |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
18 |
* Imagick object. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
19 |
* |
5 | 20 |
* @var Imagick |
21 |
*/ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
22 |
protected $image; |
0 | 23 |
|
5 | 24 |
public function __destruct() { |
0 | 25 |
if ( $this->image instanceof Imagick ) { |
16 | 26 |
// We don't need the original in memory anymore. |
0 | 27 |
$this->image->clear(); |
28 |
$this->image->destroy(); |
|
29 |
} |
|
30 |
} |
|
31 |
||
32 |
/** |
|
33 |
* Checks to see if current environment supports Imagick. |
|
34 |
* |
|
35 |
* We require Imagick 2.2.0 or greater, based on whether the queryFormats() |
|
36 |
* method can be called statically. |
|
37 |
* |
|
38 |
* @since 3.5.0 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
39 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
40 |
* @param array $args |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
41 |
* @return bool |
0 | 42 |
*/ |
43 |
public static function test( $args = array() ) { |
|
44 |
||
45 |
// First, test Imagick's extension and classes. |
|
9 | 46 |
if ( ! extension_loaded( 'imagick' ) || ! class_exists( 'Imagick', false ) || ! class_exists( 'ImagickPixel', false ) ) { |
0 | 47 |
return false; |
9 | 48 |
} |
0 | 49 |
|
9 | 50 |
if ( version_compare( phpversion( 'imagick' ), '2.2.0', '<' ) ) { |
0 | 51 |
return false; |
9 | 52 |
} |
0 | 53 |
|
54 |
$required_methods = array( |
|
55 |
'clear', |
|
56 |
'destroy', |
|
57 |
'valid', |
|
58 |
'getimage', |
|
59 |
'writeimage', |
|
60 |
'getimageblob', |
|
61 |
'getimagegeometry', |
|
62 |
'getimageformat', |
|
63 |
'setimageformat', |
|
64 |
'setimagecompression', |
|
65 |
'setimagecompressionquality', |
|
66 |
'setimagepage', |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
67 |
'setoption', |
0 | 68 |
'scaleimage', |
69 |
'cropimage', |
|
70 |
'rotateimage', |
|
71 |
'flipimage', |
|
72 |
'flopimage', |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
73 |
'readimage', |
18 | 74 |
'readimageblob', |
0 | 75 |
); |
76 |
||
77 |
// Now, test for deep requirements within Imagick. |
|
9 | 78 |
if ( ! defined( 'imagick::COMPRESSION_JPEG' ) ) { |
0 | 79 |
return false; |
9 | 80 |
} |
0 | 81 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
82 |
$class_methods = array_map( 'strtolower', get_class_methods( 'Imagick' ) ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
83 |
if ( array_diff( $required_methods, $class_methods ) ) { |
0 | 84 |
return false; |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
85 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
86 |
|
0 | 87 |
return true; |
88 |
} |
|
89 |
||
90 |
/** |
|
91 |
* Checks to see if editor supports the mime-type specified. |
|
92 |
* |
|
93 |
* @since 3.5.0 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
94 |
* |
0 | 95 |
* @param string $mime_type |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
96 |
* @return bool |
0 | 97 |
*/ |
98 |
public static function supports_mime_type( $mime_type ) { |
|
99 |
$imagick_extension = strtoupper( self::get_extension( $mime_type ) ); |
|
100 |
||
9 | 101 |
if ( ! $imagick_extension ) { |
0 | 102 |
return false; |
9 | 103 |
} |
0 | 104 |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
105 |
/* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
106 |
* setIteratorIndex is optional unless mime is an animated format. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
107 |
* Here, we just say no if you are missing it and aren't loading a jpeg. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
108 |
*/ |
16 | 109 |
if ( ! method_exists( 'Imagick', 'setIteratorIndex' ) && 'image/jpeg' !== $mime_type ) { |
0 | 110 |
return false; |
9 | 111 |
} |
0 | 112 |
|
113 |
try { |
|
16 | 114 |
// phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged |
0 | 115 |
return ( (bool) @Imagick::queryFormats( $imagick_extension ) ); |
9 | 116 |
} catch ( Exception $e ) { |
0 | 117 |
return false; |
118 |
} |
|
119 |
} |
|
120 |
||
121 |
/** |
|
122 |
* Loads image from $this->file into new Imagick Object. |
|
123 |
* |
|
124 |
* @since 3.5.0 |
|
125 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
126 |
* @return true|WP_Error True if loaded; WP_Error on failure. |
0 | 127 |
*/ |
128 |
public function load() { |
|
9 | 129 |
if ( $this->image instanceof Imagick ) { |
0 | 130 |
return true; |
9 | 131 |
} |
0 | 132 |
|
18 | 133 |
if ( ! is_file( $this->file ) && ! wp_is_stream( $this->file ) ) { |
19 | 134 |
return new WP_Error( 'error_loading_image', __( 'File does not exist?' ), $this->file ); |
9 | 135 |
} |
0 | 136 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
137 |
/* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
138 |
* Even though Imagick uses less PHP memory than GD, set higher limit |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
139 |
* for users that have low PHP.ini limits. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
140 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
141 |
wp_raise_memory_limit( 'image' ); |
0 | 142 |
|
143 |
try { |
|
9 | 144 |
$this->image = new Imagick(); |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
145 |
$file_extension = strtolower( pathinfo( $this->file, PATHINFO_EXTENSION ) ); |
0 | 146 |
|
16 | 147 |
if ( 'pdf' === $file_extension ) { |
18 | 148 |
$pdf_loaded = $this->pdf_load_source(); |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
149 |
|
18 | 150 |
if ( is_wp_error( $pdf_loaded ) ) { |
151 |
return $pdf_loaded; |
|
152 |
} |
|
153 |
} else { |
|
154 |
if ( wp_is_stream( $this->file ) ) { |
|
155 |
// Due to reports of issues with streams with `Imagick::readImageFile()`, uses `Imagick::readImageBlob()` instead. |
|
156 |
$this->image->readImageBlob( file_get_contents( $this->file ), $this->file ); |
|
157 |
} else { |
|
158 |
$this->image->readImage( $this->file ); |
|
159 |
} |
|
160 |
} |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
161 |
|
9 | 162 |
if ( ! $this->image->valid() ) { |
163 |
return new WP_Error( 'invalid_image', __( 'File is not an image.' ), $this->file ); |
|
164 |
} |
|
0 | 165 |
|
16 | 166 |
// Select the first frame to handle animated images properly. |
9 | 167 |
if ( is_callable( array( $this->image, 'setIteratorIndex' ) ) ) { |
168 |
$this->image->setIteratorIndex( 0 ); |
|
169 |
} |
|
0 | 170 |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
171 |
if ( 'pdf' === $file_extension ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
172 |
$this->remove_pdf_alpha_channel(); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
173 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
174 |
|
0 | 175 |
$this->mime_type = $this->get_mime_type( $this->image->getImageFormat() ); |
9 | 176 |
} catch ( Exception $e ) { |
0 | 177 |
return new WP_Error( 'invalid_image', $e->getMessage(), $this->file ); |
178 |
} |
|
179 |
||
180 |
$updated_size = $this->update_size(); |
|
18 | 181 |
|
5 | 182 |
if ( is_wp_error( $updated_size ) ) { |
183 |
return $updated_size; |
|
184 |
} |
|
0 | 185 |
|
186 |
return $this->set_quality(); |
|
187 |
} |
|
188 |
||
189 |
/** |
|
190 |
* Sets Image Compression quality on a 1-100% scale. |
|
191 |
* |
|
192 |
* @since 3.5.0 |
|
193 |
* |
|
194 |
* @param int $quality Compression Quality. Range: [1,100] |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
195 |
* @return true|WP_Error True if set successfully; WP_Error on failure. |
0 | 196 |
*/ |
197 |
public function set_quality( $quality = null ) { |
|
5 | 198 |
$quality_result = parent::set_quality( $quality ); |
199 |
if ( is_wp_error( $quality_result ) ) { |
|
200 |
return $quality_result; |
|
201 |
} else { |
|
202 |
$quality = $this->get_quality(); |
|
203 |
} |
|
0 | 204 |
|
205 |
try { |
|
18 | 206 |
switch ( $this->mime_type ) { |
207 |
case 'image/jpeg': |
|
208 |
$this->image->setImageCompressionQuality( $quality ); |
|
209 |
$this->image->setImageCompression( imagick::COMPRESSION_JPEG ); |
|
210 |
break; |
|
211 |
case 'image/webp': |
|
212 |
$webp_info = wp_get_webp_info( $this->file ); |
|
213 |
||
214 |
if ( 'lossless' === $webp_info['type'] ) { |
|
215 |
// Use WebP lossless settings. |
|
216 |
$this->image->setImageCompressionQuality( 100 ); |
|
217 |
$this->image->setOption( 'webp:lossless', 'true' ); |
|
218 |
} else { |
|
219 |
$this->image->setImageCompressionQuality( $quality ); |
|
220 |
} |
|
221 |
break; |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
222 |
case 'image/avif': |
18 | 223 |
default: |
224 |
$this->image->setImageCompressionQuality( $quality ); |
|
0 | 225 |
} |
9 | 226 |
} catch ( Exception $e ) { |
0 | 227 |
return new WP_Error( 'image_quality_error', $e->getMessage() ); |
228 |
} |
|
5 | 229 |
return true; |
0 | 230 |
} |
231 |
||
18 | 232 |
|
0 | 233 |
/** |
234 |
* Sets or updates current image size. |
|
235 |
* |
|
236 |
* @since 3.5.0 |
|
237 |
* |
|
238 |
* @param int $width |
|
239 |
* @param int $height |
|
5 | 240 |
* @return true|WP_Error |
0 | 241 |
*/ |
242 |
protected function update_size( $width = null, $height = null ) { |
|
243 |
$size = null; |
|
9 | 244 |
if ( ! $width || ! $height ) { |
0 | 245 |
try { |
246 |
$size = $this->image->getImageGeometry(); |
|
9 | 247 |
} catch ( Exception $e ) { |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
248 |
return new WP_Error( 'invalid_image', __( 'Could not read image size.' ), $this->file ); |
0 | 249 |
} |
250 |
} |
|
251 |
||
9 | 252 |
if ( ! $width ) { |
0 | 253 |
$width = $size['width']; |
9 | 254 |
} |
0 | 255 |
|
9 | 256 |
if ( ! $height ) { |
0 | 257 |
$height = $size['height']; |
9 | 258 |
} |
0 | 259 |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
260 |
/* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
261 |
* If we still don't have the image size, fall back to `wp_getimagesize`. This ensures AVIF images |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
262 |
* are properly sized without affecting previous `getImageGeometry` behavior. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
263 |
*/ |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
264 |
if ( ( ! $width || ! $height ) && 'image/avif' === $this->mime_type ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
265 |
$size = wp_getimagesize( $this->file ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
266 |
$width = $size[0]; |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
267 |
$height = $size[1]; |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
268 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
269 |
|
0 | 270 |
return parent::update_size( $width, $height ); |
271 |
} |
|
272 |
||
273 |
/** |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
274 |
* Sets Imagick time limit. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
275 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
276 |
* Depending on configuration, Imagick processing may take time. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
277 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
278 |
* Multiple problems exist if PHP times out before ImageMagick completed: |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
279 |
* 1. Temporary files aren't cleaned by ImageMagick garbage collection. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
280 |
* 2. No clear error is provided. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
281 |
* 3. The cause of such timeout can be hard to pinpoint. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
282 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
283 |
* This function, which is expected to be run before heavy image routines, resolves |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
284 |
* point 1 above by aligning Imagick's timeout with PHP's timeout, assuming it is set. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
285 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
286 |
* However seems it introduces more problems than it fixes, |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
287 |
* see https://core.trac.wordpress.org/ticket/58202. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
288 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
289 |
* Note: |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
290 |
* - Imagick resource exhaustion does not issue catchable exceptions (yet). |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
291 |
* See https://github.com/Imagick/imagick/issues/333. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
292 |
* - The resource limit is not saved/restored. It applies to subsequent |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
293 |
* image operations within the time of the HTTP request. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
294 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
295 |
* @since 6.2.0 |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
296 |
* @since 6.3.0 This method was deprecated. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
297 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
298 |
* @return int|null The new limit on success, null on failure. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
299 |
*/ |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
300 |
public static function set_imagick_time_limit() { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
301 |
_deprecated_function( __METHOD__, '6.3.0' ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
302 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
303 |
if ( ! defined( 'Imagick::RESOURCETYPE_TIME' ) ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
304 |
return null; |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
305 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
306 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
307 |
// Returns PHP_FLOAT_MAX if unset. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
308 |
$imagick_timeout = Imagick::getResourceLimit( Imagick::RESOURCETYPE_TIME ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
309 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
310 |
// Convert to an integer, keeping in mind that: 0 === (int) PHP_FLOAT_MAX. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
311 |
$imagick_timeout = $imagick_timeout > PHP_INT_MAX ? PHP_INT_MAX : (int) $imagick_timeout; |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
312 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
313 |
$php_timeout = (int) ini_get( 'max_execution_time' ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
314 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
315 |
if ( $php_timeout > 1 && $php_timeout < $imagick_timeout ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
316 |
$limit = (float) 0.8 * $php_timeout; |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
317 |
Imagick::setResourceLimit( Imagick::RESOURCETYPE_TIME, $limit ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
318 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
319 |
return $limit; |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
320 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
321 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
322 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
323 |
/** |
0 | 324 |
* Resizes current image. |
325 |
* |
|
5 | 326 |
* At minimum, either a height or width must be provided. |
327 |
* If one of the two is set to null, the resize will |
|
328 |
* maintain aspect ratio according to the provided dimension. |
|
329 |
* |
|
0 | 330 |
* @since 3.5.0 |
331 |
* |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
332 |
* @param int|null $max_w Image width. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
333 |
* @param int|null $max_h Image height. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
334 |
* @param bool|array $crop { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
335 |
* Optional. Image cropping behavior. If false, the image will be scaled (default). |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
336 |
* If true, image will be cropped to the specified dimensions using center positions. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
337 |
* If an array, the image will be cropped using the array to specify the crop location: |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
338 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
339 |
* @type string $0 The x crop position. Accepts 'left' 'center', or 'right'. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
340 |
* @type string $1 The y crop position. Accepts 'top', 'center', or 'bottom'. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
341 |
* } |
18 | 342 |
* @return true|WP_Error |
0 | 343 |
*/ |
344 |
public function resize( $max_w, $max_h, $crop = false ) { |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
345 |
if ( ( $this->size['width'] === $max_w ) && ( $this->size['height'] === $max_h ) ) { |
0 | 346 |
return true; |
9 | 347 |
} |
0 | 348 |
|
349 |
$dims = image_resize_dimensions( $this->size['width'], $this->size['height'], $max_w, $max_h, $crop ); |
|
9 | 350 |
if ( ! $dims ) { |
351 |
return new WP_Error( 'error_getting_dimensions', __( 'Could not calculate resized image dimensions' ) ); |
|
352 |
} |
|
16 | 353 |
|
0 | 354 |
list( $dst_x, $dst_y, $src_x, $src_y, $dst_w, $dst_h, $src_w, $src_h ) = $dims; |
355 |
||
356 |
if ( $crop ) { |
|
357 |
return $this->crop( $src_x, $src_y, $src_w, $src_h, $dst_w, $dst_h ); |
|
358 |
} |
|
359 |
||
16 | 360 |
// Execute the resize. |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
361 |
$thumb_result = $this->thumbnail_image( $dst_w, $dst_h ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
362 |
if ( is_wp_error( $thumb_result ) ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
363 |
return $thumb_result; |
0 | 364 |
} |
365 |
||
366 |
return $this->update_size( $dst_w, $dst_h ); |
|
367 |
} |
|
368 |
||
369 |
/** |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
370 |
* Efficiently resize the current image |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
371 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
372 |
* This is a WordPress specific implementation of Imagick::thumbnailImage(), |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
373 |
* which resizes an image to given dimensions and removes any associated profiles. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
374 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
375 |
* @since 4.5.0 |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
376 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
377 |
* @param int $dst_w The destination width. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
378 |
* @param int $dst_h The destination height. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
379 |
* @param string $filter_name Optional. The Imagick filter to use when resizing. Default 'FILTER_TRIANGLE'. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
380 |
* @param bool $strip_meta Optional. Strip all profiles, excluding color profiles, from the image. Default true. |
18 | 381 |
* @return void|WP_Error |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
382 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
383 |
protected function thumbnail_image( $dst_w, $dst_h, $filter_name = 'FILTER_TRIANGLE', $strip_meta = true ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
384 |
$allowed_filters = array( |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
385 |
'FILTER_POINT', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
386 |
'FILTER_BOX', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
387 |
'FILTER_TRIANGLE', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
388 |
'FILTER_HERMITE', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
389 |
'FILTER_HANNING', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
390 |
'FILTER_HAMMING', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
391 |
'FILTER_BLACKMAN', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
392 |
'FILTER_GAUSSIAN', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
393 |
'FILTER_QUADRATIC', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
394 |
'FILTER_CUBIC', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
395 |
'FILTER_CATROM', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
396 |
'FILTER_MITCHELL', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
397 |
'FILTER_LANCZOS', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
398 |
'FILTER_BESSEL', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
399 |
'FILTER_SINC', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
400 |
); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
401 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
402 |
/** |
16 | 403 |
* Set the filter value if '$filter_name' name is in the allowed list and the related |
404 |
* Imagick constant is defined or fall back to the default filter. |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
405 |
*/ |
16 | 406 |
if ( in_array( $filter_name, $allowed_filters, true ) && defined( 'Imagick::' . $filter_name ) ) { |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
407 |
$filter = constant( 'Imagick::' . $filter_name ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
408 |
} else { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
409 |
$filter = defined( 'Imagick::FILTER_TRIANGLE' ) ? Imagick::FILTER_TRIANGLE : false; |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
410 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
411 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
412 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
413 |
* Filters whether to strip metadata from images when they're resized. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
414 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
415 |
* This filter only applies when resizing using the Imagick editor since GD |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
416 |
* always strips profiles by default. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
417 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
418 |
* @since 4.5.0 |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
419 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
420 |
* @param bool $strip_meta Whether to strip image metadata during resizing. Default true. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
421 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
422 |
if ( apply_filters( 'image_strip_meta', $strip_meta ) ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
423 |
$this->strip_meta(); // Fail silently if not supported. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
424 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
425 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
426 |
try { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
427 |
/* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
428 |
* To be more efficient, resample large images to 5x the destination size before resizing |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
429 |
* whenever the output size is less that 1/3 of the original image size (1/3^2 ~= .111), |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
430 |
* unless we would be resampling to a scale smaller than 128x128. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
431 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
432 |
if ( is_callable( array( $this->image, 'sampleImage' ) ) ) { |
9 | 433 |
$resize_ratio = ( $dst_w / $this->size['width'] ) * ( $dst_h / $this->size['height'] ); |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
434 |
$sample_factor = 5; |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
435 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
436 |
if ( $resize_ratio < .111 && ( $dst_w * $sample_factor > 128 && $dst_h * $sample_factor > 128 ) ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
437 |
$this->image->sampleImage( $dst_w * $sample_factor, $dst_h * $sample_factor ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
438 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
439 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
440 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
441 |
/* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
442 |
* Use resizeImage() when it's available and a valid filter value is set. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
443 |
* Otherwise, fall back to the scaleImage() method for resizing, which |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
444 |
* results in better image quality over resizeImage() with default filter |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
445 |
* settings and retains backward compatibility with pre 4.5 functionality. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
446 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
447 |
if ( is_callable( array( $this->image, 'resizeImage' ) ) && $filter ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
448 |
$this->image->setOption( 'filter:support', '2.0' ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
449 |
$this->image->resizeImage( $dst_w, $dst_h, $filter, 1 ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
450 |
} else { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
451 |
$this->image->scaleImage( $dst_w, $dst_h ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
452 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
453 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
454 |
// Set appropriate quality settings after resizing. |
16 | 455 |
if ( 'image/jpeg' === $this->mime_type ) { |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
456 |
if ( is_callable( array( $this->image, 'unsharpMaskImage' ) ) ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
457 |
$this->image->unsharpMaskImage( 0.25, 0.25, 8, 0.065 ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
458 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
459 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
460 |
$this->image->setOption( 'jpeg:fancy-upsampling', 'off' ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
461 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
462 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
463 |
if ( 'image/png' === $this->mime_type ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
464 |
$this->image->setOption( 'png:compression-filter', '5' ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
465 |
$this->image->setOption( 'png:compression-level', '9' ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
466 |
$this->image->setOption( 'png:compression-strategy', '1' ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
467 |
$this->image->setOption( 'png:exclude-chunk', 'all' ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
468 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
469 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
470 |
/* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
471 |
* If alpha channel is not defined, set it opaque. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
472 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
473 |
* Note that Imagick::getImageAlphaChannel() is only available if Imagick |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
474 |
* has been compiled against ImageMagick version 6.4.0 or newer. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
475 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
476 |
if ( is_callable( array( $this->image, 'getImageAlphaChannel' ) ) |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
477 |
&& is_callable( array( $this->image, 'setImageAlphaChannel' ) ) |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
478 |
&& defined( 'Imagick::ALPHACHANNEL_UNDEFINED' ) |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
479 |
&& defined( 'Imagick::ALPHACHANNEL_OPAQUE' ) |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
480 |
) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
481 |
if ( $this->image->getImageAlphaChannel() === Imagick::ALPHACHANNEL_UNDEFINED ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
482 |
$this->image->setImageAlphaChannel( Imagick::ALPHACHANNEL_OPAQUE ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
483 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
484 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
485 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
486 |
// Limit the bit depth of resized images to 8 bits per channel. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
487 |
if ( is_callable( array( $this->image, 'getImageDepth' ) ) && is_callable( array( $this->image, 'setImageDepth' ) ) ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
488 |
if ( 8 < $this->image->getImageDepth() ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
489 |
$this->image->setImageDepth( 8 ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
490 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
491 |
} |
9 | 492 |
} catch ( Exception $e ) { |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
493 |
return new WP_Error( 'image_resize_error', $e->getMessage() ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
494 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
495 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
496 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
497 |
/** |
16 | 498 |
* Create multiple smaller images from a single source. |
499 |
* |
|
500 |
* Attempts to create all sub-sizes and returns the meta data at the end. This |
|
501 |
* may result in the server running out of resources. When it fails there may be few |
|
502 |
* "orphaned" images left over as the meta data is never returned and saved. |
|
503 |
* |
|
504 |
* As of 5.3.0 the preferred way to do this is with `make_subsize()`. It creates |
|
505 |
* the new images one at a time and allows for the meta data to be saved after |
|
506 |
* each new image is created. |
|
0 | 507 |
* |
508 |
* @since 3.5.0 |
|
509 |
* |
|
510 |
* @param array $sizes { |
|
16 | 511 |
* An array of image size data arrays. |
0 | 512 |
* |
5 | 513 |
* Either a height or width must be provided. |
514 |
* If one of the two is set to null, the resize will |
|
515 |
* maintain aspect ratio according to the provided dimension. |
|
516 |
* |
|
19 | 517 |
* @type array ...$0 { |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
518 |
* Array of height, width values, and whether to crop. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
519 |
* |
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
520 |
* @type int $width Image width. Optional if `$height` is specified. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
521 |
* @type int $height Image height. Optional if `$width` is specified. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
522 |
* @type bool|array $crop Optional. Whether to crop the image. Default false. |
0 | 523 |
* } |
524 |
* } |
|
5 | 525 |
* @return array An array of resized images' metadata by size. |
0 | 526 |
*/ |
527 |
public function multi_resize( $sizes ) { |
|
16 | 528 |
$metadata = array(); |
529 |
||
530 |
foreach ( $sizes as $size => $size_data ) { |
|
531 |
$meta = $this->make_subsize( $size_data ); |
|
532 |
||
533 |
if ( ! is_wp_error( $meta ) ) { |
|
534 |
$metadata[ $size ] = $meta; |
|
535 |
} |
|
536 |
} |
|
537 |
||
538 |
return $metadata; |
|
539 |
} |
|
540 |
||
541 |
/** |
|
542 |
* Create an image sub-size and return the image meta data value for it. |
|
543 |
* |
|
544 |
* @since 5.3.0 |
|
545 |
* |
|
546 |
* @param array $size_data { |
|
547 |
* Array of size data. |
|
548 |
* |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
549 |
* @type int $width The maximum width in pixels. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
550 |
* @type int $height The maximum height in pixels. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
551 |
* @type bool|array $crop Whether to crop the image to exact dimensions. |
16 | 552 |
* } |
553 |
* @return array|WP_Error The image data array for inclusion in the `sizes` array in the image meta, |
|
554 |
* WP_Error object on error. |
|
555 |
*/ |
|
556 |
public function make_subsize( $size_data ) { |
|
557 |
if ( ! isset( $size_data['width'] ) && ! isset( $size_data['height'] ) ) { |
|
558 |
return new WP_Error( 'image_subsize_create_error', __( 'Cannot resize the image. Both width and height are not set.' ) ); |
|
559 |
} |
|
560 |
||
9 | 561 |
$orig_size = $this->size; |
0 | 562 |
$orig_image = $this->image->getImage(); |
563 |
||
16 | 564 |
if ( ! isset( $size_data['width'] ) ) { |
565 |
$size_data['width'] = null; |
|
566 |
} |
|
5 | 567 |
|
16 | 568 |
if ( ! isset( $size_data['height'] ) ) { |
569 |
$size_data['height'] = null; |
|
570 |
} |
|
0 | 571 |
|
16 | 572 |
if ( ! isset( $size_data['crop'] ) ) { |
573 |
$size_data['crop'] = false; |
|
0 | 574 |
} |
575 |
||
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
576 |
if ( ( $this->size['width'] === $size_data['width'] ) && ( $this->size['height'] === $size_data['height'] ) ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
577 |
return new WP_Error( 'image_subsize_create_error', __( 'The image already has the requested size.' ) ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
578 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
579 |
|
16 | 580 |
$resized = $this->resize( $size_data['width'], $size_data['height'], $size_data['crop'] ); |
581 |
||
582 |
if ( is_wp_error( $resized ) ) { |
|
583 |
$saved = $resized; |
|
584 |
} else { |
|
585 |
$saved = $this->_save( $this->image ); |
|
586 |
||
587 |
$this->image->clear(); |
|
588 |
$this->image->destroy(); |
|
589 |
$this->image = null; |
|
590 |
} |
|
591 |
||
592 |
$this->size = $orig_size; |
|
0 | 593 |
$this->image = $orig_image; |
594 |
||
16 | 595 |
if ( ! is_wp_error( $saved ) ) { |
596 |
unset( $saved['path'] ); |
|
597 |
} |
|
598 |
||
599 |
return $saved; |
|
0 | 600 |
} |
601 |
||
602 |
/** |
|
603 |
* Crops Image. |
|
604 |
* |
|
605 |
* @since 3.5.0 |
|
606 |
* |
|
16 | 607 |
* @param int $src_x The start x position to crop from. |
608 |
* @param int $src_y The start y position to crop from. |
|
609 |
* @param int $src_w The width to crop. |
|
610 |
* @param int $src_h The height to crop. |
|
611 |
* @param int $dst_w Optional. The destination width. |
|
612 |
* @param int $dst_h Optional. The destination height. |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
613 |
* @param bool $src_abs Optional. If the source crop points are absolute. |
18 | 614 |
* @return true|WP_Error |
0 | 615 |
*/ |
616 |
public function crop( $src_x, $src_y, $src_w, $src_h, $dst_w = null, $dst_h = null, $src_abs = false ) { |
|
617 |
if ( $src_abs ) { |
|
618 |
$src_w -= $src_x; |
|
619 |
$src_h -= $src_y; |
|
620 |
} |
|
621 |
||
622 |
try { |
|
623 |
$this->image->cropImage( $src_w, $src_h, $src_x, $src_y ); |
|
9 | 624 |
$this->image->setImagePage( $src_w, $src_h, 0, 0 ); |
0 | 625 |
|
626 |
if ( $dst_w || $dst_h ) { |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
627 |
/* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
628 |
* If destination width/height isn't specified, |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
629 |
* use same as width/height from source. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
630 |
*/ |
9 | 631 |
if ( ! $dst_w ) { |
0 | 632 |
$dst_w = $src_w; |
9 | 633 |
} |
634 |
if ( ! $dst_h ) { |
|
0 | 635 |
$dst_h = $src_h; |
9 | 636 |
} |
0 | 637 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
638 |
$thumb_result = $this->thumbnail_image( $dst_w, $dst_h ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
639 |
if ( is_wp_error( $thumb_result ) ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
640 |
return $thumb_result; |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
641 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
642 |
|
0 | 643 |
return $this->update_size(); |
644 |
} |
|
9 | 645 |
} catch ( Exception $e ) { |
0 | 646 |
return new WP_Error( 'image_crop_error', $e->getMessage() ); |
647 |
} |
|
18 | 648 |
|
0 | 649 |
return $this->update_size(); |
650 |
} |
|
651 |
||
652 |
/** |
|
653 |
* Rotates current image counter-clockwise by $angle. |
|
654 |
* |
|
655 |
* @since 3.5.0 |
|
656 |
* |
|
657 |
* @param float $angle |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
658 |
* @return true|WP_Error |
0 | 659 |
*/ |
660 |
public function rotate( $angle ) { |
|
661 |
/** |
|
662 |
* $angle is 360-$angle because Imagick rotates clockwise |
|
663 |
* (GD rotates counter-clockwise) |
|
664 |
*/ |
|
665 |
try { |
|
9 | 666 |
$this->image->rotateImage( new ImagickPixel( 'none' ), 360 - $angle ); |
0 | 667 |
|
19 | 668 |
// Normalize EXIF orientation data so that display is consistent across devices. |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
669 |
if ( is_callable( array( $this->image, 'setImageOrientation' ) ) && defined( 'Imagick::ORIENTATION_TOPLEFT' ) ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
670 |
$this->image->setImageOrientation( Imagick::ORIENTATION_TOPLEFT ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
671 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
672 |
|
0 | 673 |
// Since this changes the dimensions of the image, update the size. |
674 |
$result = $this->update_size(); |
|
9 | 675 |
if ( is_wp_error( $result ) ) { |
0 | 676 |
return $result; |
9 | 677 |
} |
0 | 678 |
|
679 |
$this->image->setImagePage( $this->size['width'], $this->size['height'], 0, 0 ); |
|
9 | 680 |
} catch ( Exception $e ) { |
0 | 681 |
return new WP_Error( 'image_rotate_error', $e->getMessage() ); |
682 |
} |
|
18 | 683 |
|
0 | 684 |
return true; |
685 |
} |
|
686 |
||
687 |
/** |
|
688 |
* Flips current image. |
|
689 |
* |
|
690 |
* @since 3.5.0 |
|
691 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
692 |
* @param bool $horz Flip along Horizontal Axis |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
693 |
* @param bool $vert Flip along Vertical Axis |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
694 |
* @return true|WP_Error |
0 | 695 |
*/ |
696 |
public function flip( $horz, $vert ) { |
|
697 |
try { |
|
9 | 698 |
if ( $horz ) { |
0 | 699 |
$this->image->flipImage(); |
9 | 700 |
} |
0 | 701 |
|
9 | 702 |
if ( $vert ) { |
0 | 703 |
$this->image->flopImage(); |
9 | 704 |
} |
16 | 705 |
|
19 | 706 |
// Normalize EXIF orientation data so that display is consistent across devices. |
16 | 707 |
if ( is_callable( array( $this->image, 'setImageOrientation' ) ) && defined( 'Imagick::ORIENTATION_TOPLEFT' ) ) { |
708 |
$this->image->setImageOrientation( Imagick::ORIENTATION_TOPLEFT ); |
|
709 |
} |
|
9 | 710 |
} catch ( Exception $e ) { |
0 | 711 |
return new WP_Error( 'image_flip_error', $e->getMessage() ); |
712 |
} |
|
16 | 713 |
|
0 | 714 |
return true; |
715 |
} |
|
716 |
||
717 |
/** |
|
16 | 718 |
* Check if a JPEG image has EXIF Orientation tag and rotate it if needed. |
719 |
* |
|
720 |
* As ImageMagick copies the EXIF data to the flipped/rotated image, proceed only |
|
721 |
* if EXIF Orientation can be reset afterwards. |
|
722 |
* |
|
723 |
* @since 5.3.0 |
|
724 |
* |
|
725 |
* @return bool|WP_Error True if the image was rotated. False if no EXIF data or if the image doesn't need rotation. |
|
726 |
* WP_Error if error while rotating. |
|
727 |
*/ |
|
728 |
public function maybe_exif_rotate() { |
|
729 |
if ( is_callable( array( $this->image, 'setImageOrientation' ) ) && defined( 'Imagick::ORIENTATION_TOPLEFT' ) ) { |
|
730 |
return parent::maybe_exif_rotate(); |
|
731 |
} else { |
|
732 |
return new WP_Error( 'write_exif_error', __( 'The image cannot be rotated because the embedded meta data cannot be updated.' ) ); |
|
733 |
} |
|
734 |
} |
|
735 |
||
736 |
/** |
|
0 | 737 |
* Saves current image to file. |
738 |
* |
|
739 |
* @since 3.5.0 |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
740 |
* @since 6.0.0 The `$filesize` value was added to the returned array. |
0 | 741 |
* |
19 | 742 |
* @param string $destfilename Optional. Destination filename. Default null. |
743 |
* @param string $mime_type Optional. The mime-type. Default null. |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
744 |
* @return array|WP_Error { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
745 |
* Array on success or WP_Error if the file failed to save. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
746 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
747 |
* @type string $path Path to the image file. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
748 |
* @type string $file Name of the image file. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
749 |
* @type int $width Image width. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
750 |
* @type int $height Image height. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
751 |
* @type string $mime-type The mime type of the image. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
752 |
* @type int $filesize File size of the image. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
753 |
* } |
0 | 754 |
*/ |
755 |
public function save( $destfilename = null, $mime_type = null ) { |
|
756 |
$saved = $this->_save( $this->image, $destfilename, $mime_type ); |
|
757 |
||
758 |
if ( ! is_wp_error( $saved ) ) { |
|
9 | 759 |
$this->file = $saved['path']; |
0 | 760 |
$this->mime_type = $saved['mime-type']; |
761 |
||
762 |
try { |
|
763 |
$this->image->setImageFormat( strtoupper( $this->get_extension( $this->mime_type ) ) ); |
|
9 | 764 |
} catch ( Exception $e ) { |
0 | 765 |
return new WP_Error( 'image_save_error', $e->getMessage(), $this->file ); |
766 |
} |
|
767 |
} |
|
768 |
||
769 |
return $saved; |
|
770 |
} |
|
771 |
||
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
772 |
/** |
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
773 |
* Removes PDF alpha after it's been read. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
774 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
775 |
* @since 6.4.0 |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
776 |
*/ |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
777 |
protected function remove_pdf_alpha_channel() { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
778 |
$version = Imagick::getVersion(); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
779 |
// Remove alpha channel if possible to avoid black backgrounds for Ghostscript >= 9.14. RemoveAlphaChannel added in ImageMagick 6.7.5. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
780 |
if ( $version['versionNumber'] >= 0x675 ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
781 |
try { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
782 |
// Imagick::ALPHACHANNEL_REMOVE mapped to RemoveAlphaChannel in PHP imagick 3.2.0b2. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
783 |
$this->image->setImageAlphaChannel( defined( 'Imagick::ALPHACHANNEL_REMOVE' ) ? Imagick::ALPHACHANNEL_REMOVE : 12 ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
784 |
} catch ( Exception $e ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
785 |
return new WP_Error( 'pdf_alpha_process_failed', $e->getMessage() ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
786 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
787 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
788 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
789 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
790 |
/** |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
791 |
* @since 3.5.0 |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
792 |
* @since 6.0.0 The `$filesize` value was added to the returned array. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
793 |
* |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
794 |
* @param Imagick $image |
16 | 795 |
* @param string $filename |
796 |
* @param string $mime_type |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
797 |
* @return array|WP_Error { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
798 |
* Array on success or WP_Error if the file failed to save. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
799 |
* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
800 |
* @type string $path Path to the image file. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
801 |
* @type string $file Name of the image file. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
802 |
* @type int $width Image width. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
803 |
* @type int $height Image height. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
804 |
* @type string $mime-type The mime type of the image. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
805 |
* @type int $filesize File size of the image. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
806 |
* } |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
807 |
*/ |
0 | 808 |
protected function _save( $image, $filename = null, $mime_type = null ) { |
809 |
list( $filename, $extension, $mime_type ) = $this->get_output_format( $filename, $mime_type ); |
|
810 |
||
9 | 811 |
if ( ! $filename ) { |
0 | 812 |
$filename = $this->generate_filename( null, null, $extension ); |
9 | 813 |
} |
0 | 814 |
|
815 |
try { |
|
16 | 816 |
// Store initial format. |
0 | 817 |
$orig_format = $this->image->getImageFormat(); |
818 |
||
819 |
$this->image->setImageFormat( strtoupper( $this->get_extension( $mime_type ) ) ); |
|
18 | 820 |
} catch ( Exception $e ) { |
821 |
return new WP_Error( 'image_save_error', $e->getMessage(), $filename ); |
|
822 |
} |
|
0 | 823 |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
824 |
if ( method_exists( $this->image, 'setInterlaceScheme' ) |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
825 |
&& method_exists( $this->image, 'getInterlaceScheme' ) |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
826 |
&& defined( 'Imagick::INTERLACE_PLANE' ) |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
827 |
) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
828 |
$orig_interlace = $this->image->getInterlaceScheme(); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
829 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
830 |
/** This filter is documented in wp-includes/class-wp-image-editor-gd.php */ |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
831 |
if ( apply_filters( 'image_save_progressive', false, $mime_type ) ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
832 |
$this->image->setInterlaceScheme( Imagick::INTERLACE_PLANE ); // True - line interlace output. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
833 |
} else { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
834 |
$this->image->setInterlaceScheme( Imagick::INTERLACE_NO ); // False - no interlace output. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
835 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
836 |
} |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
837 |
|
18 | 838 |
$write_image_result = $this->write_image( $this->image, $filename ); |
839 |
if ( is_wp_error( $write_image_result ) ) { |
|
840 |
return $write_image_result; |
|
841 |
} |
|
842 |
||
843 |
try { |
|
16 | 844 |
// Reset original format. |
0 | 845 |
$this->image->setImageFormat( $orig_format ); |
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
846 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
847 |
if ( isset( $orig_interlace ) ) { |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
848 |
$this->image->setInterlaceScheme( $orig_interlace ); |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
849 |
} |
9 | 850 |
} catch ( Exception $e ) { |
0 | 851 |
return new WP_Error( 'image_save_error', $e->getMessage(), $filename ); |
852 |
} |
|
853 |
||
16 | 854 |
// Set correct file permissions. |
9 | 855 |
$stat = stat( dirname( $filename ) ); |
16 | 856 |
$perms = $stat['mode'] & 0000666; // Same permissions as parent folder, strip off the executable bits. |
857 |
chmod( $filename, $perms ); |
|
0 | 858 |
|
859 |
return array( |
|
5 | 860 |
'path' => $filename, |
16 | 861 |
/** This filter is documented in wp-includes/class-wp-image-editor-gd.php */ |
5 | 862 |
'file' => wp_basename( apply_filters( 'image_make_intermediate_size', $filename ) ), |
863 |
'width' => $this->size['width'], |
|
864 |
'height' => $this->size['height'], |
|
0 | 865 |
'mime-type' => $mime_type, |
19 | 866 |
'filesize' => wp_filesize( $filename ), |
0 | 867 |
); |
868 |
} |
|
869 |
||
870 |
/** |
|
18 | 871 |
* Writes an image to a file or stream. |
872 |
* |
|
873 |
* @since 5.6.0 |
|
874 |
* |
|
875 |
* @param Imagick $image |
|
876 |
* @param string $filename The destination filename or stream URL. |
|
877 |
* @return true|WP_Error |
|
878 |
*/ |
|
879 |
private function write_image( $image, $filename ) { |
|
880 |
if ( wp_is_stream( $filename ) ) { |
|
881 |
/* |
|
882 |
* Due to reports of issues with streams with `Imagick::writeImageFile()` and `Imagick::writeImage()`, copies the blob instead. |
|
883 |
* Checks for exact type due to: https://www.php.net/manual/en/function.file-put-contents.php |
|
884 |
*/ |
|
885 |
if ( file_put_contents( $filename, $image->getImageBlob() ) === false ) { |
|
886 |
return new WP_Error( |
|
887 |
'image_save_error', |
|
888 |
sprintf( |
|
889 |
/* translators: %s: PHP function name. */ |
|
890 |
__( '%s failed while writing image to stream.' ), |
|
891 |
'<code>file_put_contents()</code>' |
|
892 |
), |
|
893 |
$filename |
|
894 |
); |
|
895 |
} else { |
|
896 |
return true; |
|
897 |
} |
|
898 |
} else { |
|
899 |
$dirname = dirname( $filename ); |
|
900 |
||
901 |
if ( ! wp_mkdir_p( $dirname ) ) { |
|
902 |
return new WP_Error( |
|
903 |
'image_save_error', |
|
904 |
sprintf( |
|
905 |
/* translators: %s: Directory path. */ |
|
906 |
__( 'Unable to create directory %s. Is its parent directory writable by the server?' ), |
|
907 |
esc_html( $dirname ) |
|
908 |
) |
|
909 |
); |
|
910 |
} |
|
911 |
||
912 |
try { |
|
913 |
return $image->writeImage( $filename ); |
|
914 |
} catch ( Exception $e ) { |
|
915 |
return new WP_Error( 'image_save_error', $e->getMessage(), $filename ); |
|
916 |
} |
|
917 |
} |
|
918 |
} |
|
919 |
||
920 |
/** |
|
0 | 921 |
* Streams current image to browser. |
922 |
* |
|
923 |
* @since 3.5.0 |
|
924 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
925 |
* @param string $mime_type The mime type of the image. |
18 | 926 |
* @return true|WP_Error True on success, WP_Error object on failure. |
0 | 927 |
*/ |
928 |
public function stream( $mime_type = null ) { |
|
929 |
list( $filename, $extension, $mime_type ) = $this->get_output_format( null, $mime_type ); |
|
930 |
||
931 |
try { |
|
16 | 932 |
// Temporarily change format for stream. |
0 | 933 |
$this->image->setImageFormat( strtoupper( $extension ) ); |
934 |
||
16 | 935 |
// Output stream of image content. |
0 | 936 |
header( "Content-Type: $mime_type" ); |
937 |
print $this->image->getImageBlob(); |
|
938 |
||
16 | 939 |
// Reset image to original format. |
0 | 940 |
$this->image->setImageFormat( $this->get_extension( $this->mime_type ) ); |
9 | 941 |
} catch ( Exception $e ) { |
0 | 942 |
return new WP_Error( 'image_stream_error', $e->getMessage() ); |
943 |
} |
|
944 |
||
945 |
return true; |
|
946 |
} |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
947 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
948 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
949 |
* Strips all image meta except color profiles from an image. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
950 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
951 |
* @since 4.5.0 |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
952 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
953 |
* @return true|WP_Error True if stripping metadata was successful. WP_Error object on error. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
954 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
955 |
protected function strip_meta() { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
956 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
957 |
if ( ! is_callable( array( $this->image, 'getImageProfiles' ) ) ) { |
18 | 958 |
return new WP_Error( |
959 |
'image_strip_meta_error', |
|
960 |
sprintf( |
|
961 |
/* translators: %s: ImageMagick method name. */ |
|
962 |
__( '%s is required to strip image meta.' ), |
|
963 |
'<code>Imagick::getImageProfiles()</code>' |
|
964 |
) |
|
965 |
); |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
966 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
967 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
968 |
if ( ! is_callable( array( $this->image, 'removeImageProfile' ) ) ) { |
18 | 969 |
return new WP_Error( |
970 |
'image_strip_meta_error', |
|
971 |
sprintf( |
|
972 |
/* translators: %s: ImageMagick method name. */ |
|
973 |
__( '%s is required to strip image meta.' ), |
|
974 |
'<code>Imagick::removeImageProfile()</code>' |
|
975 |
) |
|
976 |
); |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
977 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
978 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
979 |
/* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
980 |
* Protect a few profiles from being stripped for the following reasons: |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
981 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
982 |
* - icc: Color profile information |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
983 |
* - icm: Color profile information |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
984 |
* - iptc: Copyright data |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
985 |
* - exif: Orientation data |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
986 |
* - xmp: Rights usage data |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
987 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
988 |
$protected_profiles = array( |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
989 |
'icc', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
990 |
'icm', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
991 |
'iptc', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
992 |
'exif', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
993 |
'xmp', |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
994 |
); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
995 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
996 |
try { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
997 |
// Strip profiles. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
998 |
foreach ( $this->image->getImageProfiles( '*', true ) as $key => $value ) { |
16 | 999 |
if ( ! in_array( $key, $protected_profiles, true ) ) { |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1000 |
$this->image->removeImageProfile( $key ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1001 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1002 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1003 |
} catch ( Exception $e ) { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1004 |
return new WP_Error( 'image_strip_meta_error', $e->getMessage() ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1005 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1006 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1007 |
return true; |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1008 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1009 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1010 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1011 |
* Sets up Imagick for PDF processing. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1012 |
* Increases rendering DPI and only loads first page. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1013 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1014 |
* @since 4.7.0 |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1015 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1016 |
* @return string|WP_Error File to load or WP_Error on failure. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1017 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1018 |
protected function pdf_setup() { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1019 |
try { |
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1020 |
/* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1021 |
* By default, PDFs are rendered in a very low resolution. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1022 |
* We want the thumbnail to be readable, so increase the rendering DPI. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1023 |
*/ |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1024 |
$this->image->setResolution( 128, 128 ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1025 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1026 |
// Only load the first page. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1027 |
return $this->file . '[0]'; |
9 | 1028 |
} catch ( Exception $e ) { |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1029 |
return new WP_Error( 'pdf_setup_failed', $e->getMessage(), $this->file ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1030 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1031 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1032 |
|
18 | 1033 |
/** |
1034 |
* Load the image produced by Ghostscript. |
|
1035 |
* |
|
1036 |
* Includes a workaround for a bug in Ghostscript 8.70 that prevents processing of some PDF files |
|
1037 |
* when `use-cropbox` is set. |
|
1038 |
* |
|
1039 |
* @since 5.6.0 |
|
1040 |
* |
|
19 | 1041 |
* @return true|WP_Error |
18 | 1042 |
*/ |
1043 |
protected function pdf_load_source() { |
|
1044 |
$filename = $this->pdf_setup(); |
|
1045 |
||
1046 |
if ( is_wp_error( $filename ) ) { |
|
1047 |
return $filename; |
|
1048 |
} |
|
1049 |
||
1050 |
try { |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1051 |
/* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1052 |
* When generating thumbnails from cropped PDF pages, Imagemagick uses the uncropped |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1053 |
* area (resulting in unnecessary whitespace) unless the following option is set. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1054 |
*/ |
18 | 1055 |
$this->image->setOption( 'pdf:use-cropbox', true ); |
1056 |
||
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1057 |
/* |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1058 |
* Reading image after Imagick instantiation because `setResolution` |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1059 |
* only applies correctly before the image is read. |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1060 |
*/ |
18 | 1061 |
$this->image->readImage( $filename ); |
1062 |
} catch ( Exception $e ) { |
|
1063 |
// Attempt to run `gs` without the `use-cropbox` option. See #48853. |
|
1064 |
$this->image->setOption( 'pdf:use-cropbox', false ); |
|
1065 |
||
1066 |
$this->image->readImage( $filename ); |
|
1067 |
} |
|
1068 |
||
1069 |
return true; |
|
1070 |
} |
|
0 | 1071 |
} |