Skip to content

[Sync-EN] Document the imagick legacy parameter and clarify bestfit - #1799

Open
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/1652
Open

[Sync-EN] Document the imagick legacy parameter and clarify bestfit#1799
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/1652

Conversation

@lacatoire

Copy link
Copy Markdown
Member

Syncs the four reference/imagick/imagick/ resize pages with php/doc-en#5056.

  • The legacy parameter is documented on adaptiveResizeImage(), cropThumbnailImage(), resizeImage() and scaleImage(): when true the calculations keep the small rounding bug Imagick had before 3.4.0, when false they match the ImageMagick command-line tools. Each page gains the matching "PECL imagick 3.4.0" changelog row, and cropThumbnailImage() gains a changelog section, which it had none.
  • bestfit is described as fitting the image within the given dimensions while preserving the aspect ratio, instead of "whether to fit the image inside a bounding box" or "optional fit parameter".
  • scaleImage() had three empty parameter descriptions (columns, rows, bestfit); they are filled in.
  • The four refentry elements put xml:id before xmlns, and the three changelog informaltables are no longer wrapped in a para, as upstream.

EN-Revision bumped to 2fae40e40323696cab1d4108c8cfb3a424321a88 on the four files.

Fixes: #1652

@lacatoire
lacatoire requested a review from a team as a code owner August 31, 2026 11:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Sync EN] Document legacy and clarify bestfit parameters for Imagick::resizeImage

1 participant