Letterbox - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T05:24:25Z

add link to avs+ documentation

2022-02-08T09:46:35Z

‎Syntax and Parameters: typo

2019-12-06T12:24:07Z

‎Changes: Add color_yuv version since

2019-12-06T12:16:04Z

‎Syntax and Parameters: new parameter color_yuv

2017-04-28T20:34:58Z

note AVS+ differences

2016-03-26T18:11:48Z

letterbox, crop and addborders don't change the (pixel) aspect ratio

2016-03-22T19:05:44Z

‎Syntax and Parameters

2016-03-22T19:05:32Z

‎Syntax and Parameters

2016-01-30T17:39:09Z

2016-01-30T16:07:23Z

one more touch-up

@@ Line 1: / Line 1: @@
 <div style="max-width:54em" >
 Fills the top and bottom ''rows'' of each frame, and optionally the left and right ''columns'', with black or color. This has several common uses:
 * Black out video noise from the existing black bands in an image that's already letterboxed

@@ Line 31: / Line 31: @@
 :{{Par2|color|int|(black)}}
 ::Fill color; specified as an RGB value. See [[Colors|this page]] for more information on specifying colors.
-::*For YUV clips, colors are converted from full-range (0{{D}}-255{{D}}) to YV-range (16{{D}}-235{{D}}).
+::*For YUV clips, colors are converted from full-range (0{{D}}-255{{D}}) to TV-range (16{{D}}-235{{D}}).
 :{{Par2|color_yuv|int|}} {{AvsPluscon}}

@@ Line 39: / Line 39: @@
 == Changes ==
 {| border="1"
 |-
 | v2.07

@@ Line 17: / Line 17: @@
 == Syntax and Parameters ==
 {{FuncDef
-|Letterbox(clip ''clip'', int ''top'', int ''bottom'' [, int ''x1'' , int ''x2'' , int ''color'' ] )
+|Letterbox(clip ''clip'', int ''top'', int ''bottom'' [, int ''x1'' , int ''x2'' , int ''color'' ] [, int ''color_yuv'' {{AvsPluscon}}])
 }}
@@ Line 32: / Line 32: @@
 ::Fill color; specified as an RGB value. See [[Colors|this page]] for more information on specifying colors.
 ::*For YUV clips, colors are converted from full-range (0{{D}}-255{{D}}) to YV-range (16{{D}}-235{{D}}).
 == Changes ==

@@ Line 10: / Line 10: @@
 Generally, it's better to '''Crop''' video noise off than to black it out; many older lossy compression algorithms don't deal well with solid-color borders, unless the border happens to fall on a [[Wikipedia:Macroblock|macroblock]] boundary (16 pixels for MPEG). However, in some cases, particularly for certain hardware players, it's better to use '''Letterbox''' because it lets you keep a standard frame size.
 </div>
@@ Line 29: / Line 31: @@
 :{{Par2|color|int|(black)}}
 ::Fill color; specified as an RGB value. See [[Colors|this page]] for more information on specifying colors.
-::*For YUV clips, colors are converted from full-range (0&ndash;255) to tv-range (16&ndash;235).
+::*For YUV clips, colors are converted from full-range (0{{D}}-255{{D}}) to YV-range (16{{D}}-235{{D}}).
 == Changes ==

@@ Line 21: / Line 21: @@
 :{{Par2|top, bottom|int|(required)}}
 ::Number of {{FuncArg|top}} and {{FuncArg|bottom}} rows to blank out.
-\::*For [[YV12]] sources, {{FuncArg|top}} and {{FuncArg|bottom}} must be [[Modulo|mod2]] (divisible by 2).
+::*For [[YV12]] sources, {{FuncArg|top}} and {{FuncArg|bottom}} must be [[Modulo|mod2]] (divisible by 2).
 :{{Par2|x1, x2|int|0}}

@@ Line 6: / Line 6: @@
 * Black out [[Wikipedia:Overscan#Overscan_amounts|overscan]] areas in [[Wikipedia:Video_CD|VCD]] or [[Wikipedia:Super_Video_CD|SVCD]] sources.
 * Create a quick rectangular [[Mask|mask]] for other filters &ndash; a so-called "[[Wikipedia:Matte_(filmmaking)#Garbage_matte|garbage matte]]"
 The functionality of '''Letterbox''' can be duplicated with a combination of [[Crop]] and [[AddBorders]], but '''Letterbox''' is faster and easier.

@@ Line 2: / Line 2: @@
 Fills the top and bottom ''rows'' of each frame, and optionally the left and right ''columns'', with black or color. This has several common uses:
 * Adjust the [[Aspect_ratios|aspect ratio]] ([[Wikipedia:Letterboxing_(filming)|letterboxing's]] traditional purpose)
 * Black out video noise from the existing black bands in an image that's already letterboxed
 * Black out the video noise at the bottom of the frame in [[Wikipedia:VHS|VHS]] tape sources.