From cbf41a7f5b7972eb867f1ba06041a5f1b6480bfb Mon Sep 17 00:00:00 2001 From: John Muccigrosso Date: Sat, 13 Nov 2021 14:05:42 -0500 Subject: [PATCH] add use of ration to -extent I'm aware that the beta has expanded capabilities for handling ratios, but this at least is a start and explains the current functionality. --- include/command-line-options.php | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/include/command-line-options.php b/include/command-line-options.php index 0c41da3e..a0e0b154 100644 --- a/include/command-line-options.php +++ b/include/command-line-options.php @@ -2964,7 +2964,7 @@ function (its frequency), and thus determines the number of 'waves' that will specify how to compose the image with the background, use -compose.

-

This command reduces or expands a JPEG image to fit on an 800x600 +

The following command reduces or expands a JPEG image to fit on an 800x600 display. If the aspect ratio of the input image isn't exactly 4:3, then the image is centered on an 800x600 black canvas:

@@ -2972,6 +2972,15 @@ function (its frequency), and thus determines the number of 'waves' that will -gravity center -extent 800x600 -quality 92 output.jpg +

The command can also be used with a ratio. If the image is not already at that ratio, +it will be cropped to fit it. The -gravity setting has +the expected effects. + +

The following command crops a JPEG image so that it has a 4:3 ratio:

+ + +