Letterbox - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T05:24:25Z

add link to avs+ documentation

← Older revision		Revision as of 07:24, 18 September 2022
Line 1:		Line 1:
	<div style="max-width:54em" >		<div style="max-width:54em" >
			<div {{BlueBox2\|40\|0\|3px solid purple}} >
			{{AvsPlusFullname}}<br>
			Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/letterbox.html https://avisynthplus.readthedocs.io]
			</div>


	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:		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		* Black out video noise from the existing black bands in an image that's already letterboxed

Reel.Deal: /* Syntax and Parameters */ typo

2022-02-08T09:46:35Z

Syntax and Parameters: typo

← Older revision		Revision as of 11:46, 8 February 2022
Line 31:		Line 31:
	:{{Par2\|color\|int\|(black)}}		:{{Par2\|color\|int\|(black)}}
	::Fill color; specified as an RGB value. See [[Colors\|this page]] for more information on specifying colors.		::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}}		:{{Par2\|color_yuv\|int\|}} {{AvsPluscon}}

Pinterf: /* Changes */ Add color_yuv version since

2019-12-06T12:24:07Z

Changes: Add color_yuv version since

← Older revision		Revision as of 14:24, 6 December 2019
Line 39:		Line 39:
	== Changes ==		== Changes ==
	{\| border="1"		{\| border="1"
			\|-
			\| v3.4.1 AVS+
			\| Added color_yuv option.
	\|-		\|-
	\| v2.07		\| v2.07

Pinterf: /* Syntax and Parameters */ new parameter color_yuv

2019-12-06T12:16:04Z

Syntax and Parameters: new parameter color_yuv

← Older revision		Revision as of 14:16, 6 December 2019
Line 17:		Line 17:
	== Syntax and Parameters ==		== Syntax and Parameters ==
	{{FuncDef		{{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.		::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 YV-range (16{{D}}-235{{D}}).

			:{{Par2\|color_yuv\|int\|}} {{AvsPluscon}}
			::Specifies the color of the border using YUV values. It requires setting pixel_type to one of the YUV formats; otherwise it doesn't do anything.
			::Similar to {{FuncArg\|color_yuv}} in BlankClip

	== Changes ==		== Changes ==

Raffriff42: note AVS+ differences

2017-04-28T20:34:58Z

note AVS+ differences

← Older revision		Revision as of 22:34, 28 April 2017
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.		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.

			{{AvsPluscon}} also supports [[RGB64]], [[PlanarRGBA]] and [[YUVA]].
	</div>		</div>

Line 29:		Line 31:
	:{{Par2\|color\|int\|(black)}}		:{{Par2\|color\|int\|(black)}}
	::Fill color; specified as an RGB value. See [[Colors\|this page]] for more information on specifying colors.		::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~~–~~255) to tv-range (16~~–~~235).		::*For YUV clips, colors are converted from full-range (0{{D}}-255{{D}}) to YV-range (16{{D}}-235{{D}}).

	== Changes ==		== Changes ==

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

2016-03-26T18:11:48Z

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

← Older revision		Revision as of 20:11, 26 March 2016
Line 1:		Line 1:
	<div style="max-width:54em" >		<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:		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 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.		* Black out the video noise at the bottom of the frame in [[Wikipedia:VHS\|VHS]] tape sources.

Admin: /* Syntax and Parameters */

2016-03-22T19:05:44Z

Syntax and Parameters

← Older revision		Revision as of 21:05, 22 March 2016
Line 21:		Line 21:
	:{{Par2\|top, bottom\|int\|(required)}}		:{{Par2\|top, bottom\|int\|(required)}}
	::Number of {{FuncArg\|top}} and {{FuncArg\|bottom}} rows to blank out.		::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}}		:{{Par2\|x1, x2\|int\|0}}

Admin: /* Syntax and Parameters */

2016-03-22T19:05:32Z

Syntax and Parameters

← Older revision		Revision as of 21:05, 22 March 2016
Line 21:		Line 21:
	:{{Par2\|top, bottom\|int\|(required)}}		:{{Par2\|top, bottom\|int\|(required)}}
	::Number of {{FuncArg\|top}} and {{FuncArg\|bottom}} rows to blank out.		::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).

	:{{Par2\|x1, x2\|int\|0}}		:{{Par2\|x1, x2\|int\|0}}
	::Number of ''left'' ({{FuncArg\|x1}}) and ''right'' ({{FuncArg\|x2}}) columns to blank out.		::Number of ''left'' ({{FuncArg\|x1}}) and ''right'' ({{FuncArg\|x2}}) columns to blank out.
			::*For [[YUY2]], [[YV16]] and [[YV12]] sources, {{FuncArg\|left}} and {{FuncArg\|right}} must be [[Modulo\|mod2]] (divisible by 2).
			::*For [[YV411]] sources, {{FuncArg\|left}} and {{FuncArg\|right}} must be [[Modulo\|mod4]] (divisible by 4).

	:{{Par2\|color\|int\|(black)}}		:{{Par2\|color\|int\|(black)}}
	::Fill color; specified as an RGB value. See [[Colors\|this page]] for more information on specifying colors.		::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–255) to tv-range (16–235).		::*For YUV clips, colors are converted from full-range (0–255) to tv-range (16–235).


	== Changes ==		== Changes ==

Raffriff42: See also: AddBorders

2016-01-30T17:39:09Z

Raffriff42: one more touch-up

2016-01-30T16:07:23Z

one more touch-up

← Older revision		Revision as of 18:07, 30 January 2016
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:		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)		* Adjust the [[Aspect_ratios\|aspect ratio]] ([[Wikipedia:Letterboxing_(filming)\|letterboxing's]] traditional purpose)
	* [[Splice]] a smaller resolution clip to a larger one without resizing
	* Black out video noise from the existing black bands in an image that's already letterboxed		* 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.		* Black out the video noise at the bottom of the frame in [[Wikipedia:VHS\|VHS]] tape sources.

← Older revision		Revision as of 21:05, 22 March 2016
Line 21:		Line 21:
	:{{Par2\|top, bottom\|int\|(required)}}		:{{Par2\|top, bottom\|int\|(required)}}
	::Number of {{FuncArg\|top}} and {{FuncArg\|bottom}} rows to blank out.		::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}}		:{{Par2\|x1, x2\|int\|0}}

← Older revision		Revision as of 21:05, 22 March 2016
Line 21:		Line 21:
	:{{Par2\|top, bottom\|int\|(required)}}		:{{Par2\|top, bottom\|int\|(required)}}
	::Number of {{FuncArg\|top}} and {{FuncArg\|bottom}} rows to blank out.		::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).

	:{{Par2\|x1, x2\|int\|0}}		:{{Par2\|x1, x2\|int\|0}}
	::Number of ''left'' ({{FuncArg\|x1}}) and ''right'' ({{FuncArg\|x2}}) columns to blank out.		::Number of ''left'' ({{FuncArg\|x1}}) and ''right'' ({{FuncArg\|x2}}) columns to blank out.
			::*For [[YUY2]], [[YV16]] and [[YV12]] sources, {{FuncArg\|left}} and {{FuncArg\|right}} must be [[Modulo\|mod2]] (divisible by 2).
			::*For [[YV411]] sources, {{FuncArg\|left}} and {{FuncArg\|right}} must be [[Modulo\|mod4]] (divisible by 4).

	:{{Par2\|color\|int\|(black)}}		:{{Par2\|color\|int\|(black)}}
	::Fill color; specified as an RGB value. See [[Colors\|this page]] for more information on specifying colors.		::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–255) to tv-range (16–235).		::*For YUV clips, colors are converted from full-range (0–255) to tv-range (16–235).


	== Changes ==		== Changes ==

← Older revision		Revision as of 19:39, 30 January 2016
Line 6:		Line 6:
	* Black out [[Wikipedia:Overscan#Overscan_amounts\|overscan]] areas in [[Wikipedia:Video_CD\|VCD]] or [[Wikipedia:Super_Video_CD\|SVCD]] sources.		* 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 – a so-called "[[Wikipedia:Matte_(filmmaking)#Garbage_matte\|garbage matte]]"		* Create a quick rectangular [[Mask\|mask]] for other filters – a so-called "[[Wikipedia:Matte_(filmmaking)#Garbage_matte\|garbage matte]]"
			See also: [[AddBorders]], which increases frame size. '''Letterbox''' does not change frame size.

	The functionality of '''Letterbox''' can be duplicated with a combination of [[Crop]] and [[AddBorders]], but '''Letterbox''' is faster and easier.		The functionality of '''Letterbox''' can be duplicated with a combination of [[Crop]] and [[AddBorders]], but '''Letterbox''' is faster and easier.