Changes between Version 53 and Version 54 of Scaling

Timestamp:

Jun 9, 2024, 6:00:20 AM (2 years ago)

Author:

MasterQuestionable

Comment:

Explanation on fitting. ͏"pad" example.

Scaling

@@ -50 +50 @@
 == Simple Rescaling ==
 
-If you need to simply resize your video to a specific size (e.g 320×240), you can use the scale filter in its most basic form:
+If you need to simply resize your video to a specific size (e.g 320x240), you can use the scale filter in its most basic form:
 {{{
 ffmpeg -i input.avi -vf scale=320:240 output.avi
@@ -72 +72 @@
 will set the width of the output image to 320 pixels and will calculate the height of the output image according to the aspect ratio of the input image.
 
-The resulting image will have a dimension of 320×207 pixels.\\
+The resulting image will have a dimension of 320x207 pixels.\\
 [[Image( "input.jpg", 320px )]]
 
@@ -79 +79 @@
 ffmpeg -i input.jpg -vf scale=320:-2 output_320.png
 }}}
-The output will now be 320×206 pixels.
+The output will now be 320x206 pixels.
 
 
@@ -121 +121 @@
 
 
-== Fitting into a Rectangle / Statically-sized Player ==
-
-Sometimes you need to scale the input image so that it fits into a specified rectangle, e.g. when consolidating material from different sources.
-
-You can achieve this with the `force_original_aspect_ratio` option. It has two possible values:
-* `decrease`: The output video dimensions will automatically be decreased if needed.
-* `increase`: The output video dimensions will automatically be increased if needed.
-
-This allows you to force the image to fit into a 320×240 box, downscaling it with the correct aspect ratio:
-{{{
-ffmpeg -i input.jpg -vf scale=w=320:h=240:force_original_aspect_ratio=decrease output_320.png
-}}}
-
-This produces our 320×207 image that we had seen [#KeepingtheAspectRatio before].\\
+== Fitting into a Rectangle / Statically-sized Player == #fit
+
+Sometimes you need to scale the input image so that it fits into a specified rectangle, e.g. when consolidating material from different sources.\\
+͏    Achievable with "force_original_aspect_ratio". Accepts 3 possible values:\\
+͏    |0| "disable" (default)\\
+͏    |1| "decrease": auto-decrease output dimensions on need.\\
+͏    |2| "increase": auto-increase output dimensions on need.
+
+This allows you to force the image to fit into a 320x240 box, downscaling it with the correct aspect ratio:
+{{{#!shell
+ffmpeg -i "input.jpg" -vf "scale=w=320:h=240:force_original_aspect_ratio=decrease" "output_320.png"
+}}}
+
+This produces our 320x207 image that we had seen [#KeepingtheAspectRatio before].\\
 [[Image( "input.jpg", 320px )]]
 
-You may have additional constraints such as adding black bars (pillar- and letterboxing) to fill up the remaining space when scaling to a certain rectangle. You can additionally add a black border using the `pad` filter:
-{{{
-ffmpeg -i input.jpg -vf "scale=320:240:force_original_aspect_ratio=decrease,pad=320:240:(ow-iw)/2:(oh-ih)/2" output_320_padding.png
-}}}
+͏    You may have additional constraints such as adding black bars (pillar- and letterboxing) to fill up the remaining space when scaling to a certain rectangle.\\
+͏    You can additionally add a black border using the [https://ffmpeg.org/ffmpeg-filters.html#pad ͏"pad"] filter:\\
+͏    `ffmpeg -i "input.jpg" -vf "scale=320:240:force_original_aspect_ratio=1,pad=320:240:(( (ow - iw)/2 )):(( (oh - ih)/2 ))" "output_320_padding.png"`
 {{{#!div style="display: inline-block; margin-left: 0; overflow: hidden; width: 320px; height: 240px; padding: 0; background-color: #000"
 [[Image( "input.jpg", width="100%" )]]