From f3a4bcb986db30b755c84cd8adec847c2ebf487a Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Catoire Date: Tue, 23 Dec 2025 14:26:52 +0100 Subject: [PATCH 1/7] Document legacy and clarify bestfit parameters for Imagick::resizeImage --- reference/imagick/imagick/resizeimage.xml | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/reference/imagick/imagick/resizeimage.xml b/reference/imagick/imagick/resizeimage.xml index 5e45f8958b09..addfb9fc45cb 100644 --- a/reference/imagick/imagick/resizeimage.xml +++ b/reference/imagick/imagick/resizeimage.xml @@ -64,7 +64,17 @@ bestfit - Optional fit parameter. + If set to true, the image is resized to fit within the given dimensions + while preserving the aspect ratio. + + + + + + legacy + + + If set to true, uses legacy ImageMagick resizing behavior for backward compatibility. From f1fef45f7b2ae4b1742d7eaa3fa9c8b1bae467b7 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Tue, 6 Jan 2026 09:51:16 +0100 Subject: [PATCH 2/7] Update reference/imagick/imagick/resizeimage.xml Co-authored-by: Jordi Kroon --- reference/imagick/imagick/resizeimage.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/reference/imagick/imagick/resizeimage.xml b/reference/imagick/imagick/resizeimage.xml index addfb9fc45cb..506d0a789fdb 100644 --- a/reference/imagick/imagick/resizeimage.xml +++ b/reference/imagick/imagick/resizeimage.xml @@ -64,6 +64,7 @@ bestfit + Optional bool parameter. If set to true, the image is resized to fit within the given dimensions while preserving the aspect ratio. From 372dbcf13f33edbc9b41839d2e241af3032a30f8 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Tue, 6 Jan 2026 09:51:37 +0100 Subject: [PATCH 3/7] Update reference/imagick/imagick/resizeimage.xml Co-authored-by: Jordi Kroon --- reference/imagick/imagick/resizeimage.xml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/reference/imagick/imagick/resizeimage.xml b/reference/imagick/imagick/resizeimage.xml index 506d0a789fdb..d1a4f078915c 100644 --- a/reference/imagick/imagick/resizeimage.xml +++ b/reference/imagick/imagick/resizeimage.xml @@ -75,7 +75,9 @@ legacy - If set to true, uses legacy ImageMagick resizing behavior for backward compatibility. + Optional bool parameter. + If set to true, the calculations are done with the small rounding bug that existed in + Imagick before 3.4.0. From 7d4c6e1ce78dd99d78cc277482fc0863245b2599 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Catoire Date: Tue, 6 Jan 2026 10:08:34 +0100 Subject: [PATCH 4/7] Document legacy parameter for Imagick resize and scaling methods --- reference/imagick/imagick/adaptiveresizeimage.xml | 14 +++++++++++++- reference/imagick/imagick/cropthumbnailimage.xml | 11 +++++++++++ reference/imagick/imagick/resizeimage.xml | 3 ++- reference/imagick/imagick/scaleimage.xml | 15 +++++++++++++++ 4 files changed, 41 insertions(+), 2 deletions(-) diff --git a/reference/imagick/imagick/adaptiveresizeimage.xml b/reference/imagick/imagick/adaptiveresizeimage.xml index e5c53733679b..d3a0565153f2 100644 --- a/reference/imagick/imagick/adaptiveresizeimage.xml +++ b/reference/imagick/imagick/adaptiveresizeimage.xml @@ -49,11 +49,23 @@ bestfit - Whether to fit the image inside a bounding box. + Whether to fit the image within the given dimensions while preserving + the aspect ratio. + + legacy + + + Optional bool parameter. + If set to true, the calculations are done with the small rounding bug + that existed in Imagick before 3.4.0. If set to false, the calculations + should produce the same results as the ImageMagick command-line tools. + + + diff --git a/reference/imagick/imagick/cropthumbnailimage.xml b/reference/imagick/imagick/cropthumbnailimage.xml index 1e2cef4fd822..b0b317073c53 100644 --- a/reference/imagick/imagick/cropthumbnailimage.xml +++ b/reference/imagick/imagick/cropthumbnailimage.xml @@ -40,6 +40,17 @@ + + legacy + + + Optional bool parameter. + If set to true, the calculations are done with the small rounding bug + that existed in Imagick before 3.4.0. If set to false, the calculations + should produce the same results as the ImageMagick command-line tools. + + + diff --git a/reference/imagick/imagick/resizeimage.xml b/reference/imagick/imagick/resizeimage.xml index d1a4f078915c..983ba9af07c6 100644 --- a/reference/imagick/imagick/resizeimage.xml +++ b/reference/imagick/imagick/resizeimage.xml @@ -77,7 +77,8 @@ Optional bool parameter. If set to true, the calculations are done with the small rounding bug that existed in - Imagick before 3.4.0. + Imagick before 3.4.0. If set to false, the calculations should produce the same results + as the ImageMagick command-line tools. diff --git a/reference/imagick/imagick/scaleimage.xml b/reference/imagick/imagick/scaleimage.xml index c2cc77b118af..066edb333fa7 100644 --- a/reference/imagick/imagick/scaleimage.xml +++ b/reference/imagick/imagick/scaleimage.xml @@ -30,6 +30,7 @@ columns + The number of columns in the scaled image. @@ -37,6 +38,7 @@ rows + The number of rows in the scaled image. @@ -44,6 +46,19 @@ bestfit + Whether to fit the image within the given dimensions while preserving + the aspect ratio. + + + + + legacy + + + Optional bool parameter. + If set to true, the calculations are done with the small rounding bug + that existed in Imagick before 3.4.0. If set to false, the calculations + should produce the same results as the ImageMagick command-line tools. From de3b00bdfffd628275e995d1878559b334bfe8e9 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Catoire Date: Tue, 6 Jan 2026 10:12:10 +0100 Subject: [PATCH 5/7] build error --- .../imagick/imagick/adaptiveresizeimage.xml | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/reference/imagick/imagick/adaptiveresizeimage.xml b/reference/imagick/imagick/adaptiveresizeimage.xml index d3a0565153f2..c3db4a2fd404 100644 --- a/reference/imagick/imagick/adaptiveresizeimage.xml +++ b/reference/imagick/imagick/adaptiveresizeimage.xml @@ -54,18 +54,18 @@ + + legacy + + + Optional bool parameter. + If set to true, the calculations are done with the small rounding bug + that existed in Imagick before 3.4.0. If set to false, the calculations + should produce the same results as the ImageMagick command-line tools. + + + - - legacy - - - Optional bool parameter. - If set to true, the calculations are done with the small rounding bug - that existed in Imagick before 3.4.0. If set to false, the calculations - should produce the same results as the ImageMagick command-line tools. - - - From 69c528a891ecde2f6c007adfa4d6be1bbc30b3de Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Catoire Date: Tue, 6 Jan 2026 10:17:33 +0100 Subject: [PATCH 6/7] add changelog --- .../imagick/imagick/adaptiveresizeimage.xml | 6 +++++ .../imagick/imagick/cropthumbnailimage.xml | 23 +++++++++++++++++++ reference/imagick/imagick/resizeimage.xml | 6 +++++ reference/imagick/imagick/scaleimage.xml | 6 +++++ 4 files changed, 41 insertions(+) diff --git a/reference/imagick/imagick/adaptiveresizeimage.xml b/reference/imagick/imagick/adaptiveresizeimage.xml index c3db4a2fd404..b3f4484c7f5e 100644 --- a/reference/imagick/imagick/adaptiveresizeimage.xml +++ b/reference/imagick/imagick/adaptiveresizeimage.xml @@ -106,6 +106,12 @@ Pass zero as either parameter for proportional scaling. + + PECL imagick 3.4.0 + + Added the legacy parameter. + + diff --git a/reference/imagick/imagick/cropthumbnailimage.xml b/reference/imagick/imagick/cropthumbnailimage.xml index b0b317073c53..21709423882b 100644 --- a/reference/imagick/imagick/cropthumbnailimage.xml +++ b/reference/imagick/imagick/cropthumbnailimage.xml @@ -55,6 +55,29 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + PECL imagick 3.4.0 + + Added the legacy parameter. + + + + + + + &reftitle.returnvalues; diff --git a/reference/imagick/imagick/resizeimage.xml b/reference/imagick/imagick/resizeimage.xml index 983ba9af07c6..8c6672374529 100644 --- a/reference/imagick/imagick/resizeimage.xml +++ b/reference/imagick/imagick/resizeimage.xml @@ -112,6 +112,12 @@ Pass zero as either parameter for proportional scaling. + + PECL imagick 3.4.0 + + Added the legacy parameter. + + diff --git a/reference/imagick/imagick/scaleimage.xml b/reference/imagick/imagick/scaleimage.xml index 066edb333fa7..a63aa1c486b5 100644 --- a/reference/imagick/imagick/scaleimage.xml +++ b/reference/imagick/imagick/scaleimage.xml @@ -99,6 +99,12 @@ Pass zero as either parameter for proportional scaling. + + PECL imagick 3.4.0 + + Added the legacy parameter. + + From 5d577cd6b48ec42dc8d5db213d2c90480f6ae26c Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Catoire Date: Tue, 6 Jan 2026 10:19:27 +0100 Subject: [PATCH 7/7] add order --- .../imagick/imagick/cropthumbnailimage.xml | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/reference/imagick/imagick/cropthumbnailimage.xml b/reference/imagick/imagick/cropthumbnailimage.xml index 21709423882b..ed54a6fb1462 100644 --- a/reference/imagick/imagick/cropthumbnailimage.xml +++ b/reference/imagick/imagick/cropthumbnailimage.xml @@ -55,6 +55,19 @@ + + &reftitle.returnvalues; + + &imagick.return.success; + + + + + &reftitle.errors; + + &imagick.imagick.throws; + + &reftitle.changelog; @@ -78,19 +91,6 @@ - - &reftitle.returnvalues; - - &imagick.return.success; - - - - - &reftitle.errors; - - &imagick.imagick.throws; - -