AddBorders - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T03:33:31Z

add link to avs+ documentation

← Older revision		Revision as of 05:33, 18 September 2022
Line 1:		Line 1:
			<div {{BlueBox2\|40\|0\|3px solid purple}} >
			{{AvsPlusFullname}}<br>
			Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/addborders.html https://avisynthplus.readthedocs.io]
			</div>


	Add black or colored borders, increasing frame size. This has several common uses:		Add black or colored borders, increasing frame size. This has several common uses:
	* Adjust the [[Aspect_ratios\|aspect ratio]] (make a 4:3 clip into 16:9 without stretching)		* Adjust the [[Aspect_ratios\|aspect ratio]] (make a 4:3 clip into 16:9 without stretching)

Pinterf: /* Examples and Notes */ Add color_yuv example

2019-12-06T12:22:35Z

Examples and Notes: Add color_yuv example

← Older revision		Revision as of 14:22, 6 December 2019
Line 28:		Line 28:
	<div style="max-width:54em" >		<div style="max-width:54em" >
	* Add ''letterbox'' (top and bottom) borders:		* Add ''letterbox'' (top and bottom) borders:
	<div {{BoxWidthIndent\|36\|2}} >		<div {{BoxWidthIndent\|42\|2}} >
	## add dark blue borders, using [[Colors\|hex color notation]]		## add dark blue borders, using [[Colors\|hex color notation]]
	AddBorders(0, 86, 0, 86, $00008B)		AddBorders(0, 86, 0, 86, $00008B)
Line 34:		Line 34:
	## same as above, using [[Preset_colors\|named preset color]]		## same as above, using [[Preset_colors\|named preset color]]
	AddBorders(0, 86, 0, 86, color_darkblue)		AddBorders(0, 86, 0, 86, color_darkblue)

			## full scale black border using color_yuv [[Colors\|hex color notation]]
			AddBorders(0, 86, 0, 86, color_yuv = $008080)

	</div>		</div>

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

2019-12-06T12:16:11Z

Syntax and Parameters: new parameter color_yuv

← Older revision		Revision as of 14:16, 6 December 2019
Line 8:		Line 8:
	== Syntax and Parameters ==		== Syntax and Parameters ==
	{{FuncDef		{{FuncDef
	\|AddBorders( clip ''clip'', int ''left'', int ''top'', int ''right'', int ''bottom'' [, int ''color'' ] )		\|AddBorders( clip ''clip'', int ''left'', int ''top'', int ''right'', int ''bottom'' [, int ''color'' ] [, int ''color_yuv'' {{AvsPluscon}}])
	}}		}}

Line 20:		Line 20:
	::Border color; specified as an RGB value. See [[Colors\|this page]] for more information on specifying colors.		::Border 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).

			:{{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

	== Examples and Notes ==		== Examples and Notes ==

Admin: /* Syntax and Parameters */

2016-03-22T18:50:35Z

Syntax and Parameters

← Older revision		Revision as of 20:50, 22 March 2016
Line 13:		Line 13:
	:{{Par2\|left, top, right, bottom\|int\|(required)}}		:{{Par2\|left, top, right, bottom\|int\|(required)}}
	::Border width in pixels.		::Border width in pixels.
	::*For [[YUY2]] sources, {{FuncArg\|left}} and {{FuncArg\|right}} must be [[Modulo\|mod2]] (divisible by 2).		::*For [[YUY2]] and [[YV16]] 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).
	::*For [[YV12]] sources, all four border widths must be mod2.		::*For [[YV12]] sources, all four border widths must be mod2.

Line 19:		Line 20:
	::Border color; specified as an RGB value. See [[Colors\|this page]] for more information on specifying colors.		::Border 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).


	== Examples and Notes ==		== Examples and Notes ==

Raffriff42: See also: Letterbox

2016-01-30T17:36:20Z

Raffriff42: one more touch-up

2016-01-30T16:11:20Z

one more touch-up

← Older revision		Revision as of 18:11, 30 January 2016
Line 1:		Line 1:
	Add black or colored borders, increasing frame size.		Add black or colored borders, increasing frame size. This has several common uses:
			* Adjust the [[Aspect_ratios\|aspect ratio]] (make a 4:3 clip into 16:9 without stretching)
			* [[Splice]] a smaller resolution clip to a larger one without resizing
			* Together with [[Crop]], shift a clip horizontally or vertically – see below.


	== Syntax and Parameters ==		== Syntax and Parameters ==

Raffriff42: one more touch-up

2016-01-30T14:34:11Z

one more touch-up

← Older revision		Revision as of 16:34, 30 January 2016
Line 35:		Line 35:
	AddBorders(2, 0, 0, 0)		AddBorders(2, 0, 0, 0)
	</div>		</div>
	: Note, shifting this way ~~with YUV clips~~ must be done in 2-pixel increments.		: Note, shifting this way must be done in 1- or 2-pixel increments, depending on color format.
	: You can shift in ''sub''-pixel increments with [[Resize#General_information\|Resize]].		: You can shift in ''sub''-pixel increments with [[Resize#General_information\|Resize]].
	</div>		</div>

Raffriff42: one more touch-up

2016-01-30T08:03:30Z

one more touch-up

← Older revision		Revision as of 10:03, 30 January 2016
Line 1:		Line 1:
	Add black or colored borders, increasing frame size.		Add black or colored borders, increasing frame size.

			== Syntax and Parameters ==
	{{FuncDef		{{FuncDef
	\|AddBorders( clip ''clip'', int ''left'', int ''top'', int ''right'', int ''bottom'' [, int ''color'' ] )		\|AddBorders( clip ''clip'', int ''left'', int ''top'', int ''right'', int ''bottom'' [, int ''color'' ] )
Line 7:		Line 8:
	:{{Par2\|left, top, right, bottom\|int\|(required)}}		:{{Par2\|left, top, right, bottom\|int\|(required)}}
	::Border width in pixels.		::Border width in pixels.
	::For [[YUY2]] sources, {{FuncArg\|left}} and {{FuncArg\|right}} must be ~~even~~ (divisible by 2).		::*For [[YUY2]] sources, {{FuncArg\|left}} and {{FuncArg\|right}} must be [[Modulo\|mod2]] (divisible by 2).
	::For [[YV12]] sources, ''all'' widths must be ~~even (divisible by 2)~~.		::*For [[YV12]] sources, all four border widths must be mod2.

	:{{Par2\|color\|int\|(black)}}		:{{Par2\|color\|int\|(black)}}
	::Border color; specified as an RGB value. See [[Colors\|this page]] for more information on specifying colors.		::Border 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).

	==== Examples and Notes====
			== Examples and Notes ==
	<div style="max-width:54em" >		<div style="max-width:54em" >
	* Add ''letterbox'' (top and bottom) borders:		* Add ''letterbox'' (top and bottom) borders:

Raffriff42: correction

2016-01-30T04:40:46Z

correction

← Older revision		Revision as of 06:40, 30 January 2016
Line 7:		Line 7:
	:{{Par2\|left, top, right, bottom\|int\|(required)}}		:{{Par2\|left, top, right, bottom\|int\|(required)}}
	::Border width in pixels.		::Border width in pixels.
	::For [[~~YUV~~]] sources, all ~~values~~ must be even (divisible by 2).		::For [[YUY2]] sources, {{FuncArg\|left}} and {{FuncArg\|right}} must be even (divisible by 2).
			::For [[YV12]] sources, ''all'' widths must be even (divisible by 2).

	:{{Par2\|color\|int\|(black)}}		:{{Par2\|color\|int\|(black)}}

Raffriff42: formatting, links, phrasing

2016-01-30T04:34:25Z

formatting, links, phrasing

← Older revision		Revision as of 06:34, 30 January 2016
Line 1:		Line 1:
	~~{{Template:FuncDef\|AddBorders(clip ''clip''~~, ~~int ''left'', int ''top'', int ''right'', int ''bottom'' [, int ''color''])}}~~		Add black or colored borders, increasing frame size.

	AddBorders ~~adds black~~ (~~or specified color) borders around the image~~, ~~with the specified widths (in pixels). [[YV12]]/[[YUY2]] format only stores color information for every two pixels horizontally~~, ~~so if you~~'~~re processing in YV12/YUY2 mode~~, ~~left and~~ right ~~must be even.~~		{{FuncDef
			\|AddBorders( clip ''clip'', int ''left'', int ''top'', int ''right'', int ''bottom'' [, int ''color'' ] )
			}}

	~~The color parameter is optional~~ (~~added~~ in v2.~~07), default=0 <black>, and is specified as an [[RGB]] value regardless of whether the clip format is RGB or~~ [[YUV]] ~~based. Color presets can~~ be ~~found here: [[color presets]]. See [[Colors]] for more information on specifying colors~~.		:{{Par2\|left, top, right, bottom\|int\|(required)}}
			::Border width in pixels.
			::For [[YUV]] sources, all values must be even (divisible by 2).

	~~Be aware that many lossy compression algorithms don't deal well with solid-~~color ~~borders~~, ~~unless the border width happens~~ to ~~be a multiple of the block size~~ (16 ~~pixels for MPEG~~).		:{{Par2\|color\|int\|(black)}}
			::Border 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).

	~~You can use this filter in combination with~~ [[~~Crop~~]] ~~to shift an image around without changing the frame size. For example:~~		==== Examples and Notes====
			<div style="max-width:54em" >
			* Add ''letterbox'' (top and bottom) borders:
			<div {{BoxWidthIndent\|36\|2}} >
			## add dark blue borders, using [[Colors\|hex color notation]]
			AddBorders(0, 86, 0, 86, $00008B)

			## same as above, using [[Preset_colors\|named preset color]]
			AddBorders(0, 86, 0, 86, color_darkblue)
			</div>

	# Shift ~~a 352x240~~ image 2 pixels to the right		* Be aware that 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).
	Crop(0, 0, ~~350~~, ~~240~~)
			* Use '''AddBorders''' in combination with [[Crop]] to ''shift'' an image without changing the frame size:
			<div {{BoxWidthIndent\|36\|2}} >
			# Shift an image 2 pixels to the right
			Crop(0, 0, Width-2, Height)
	AddBorders(2, 0, 0, 0)		AddBorders(2, 0, 0, 0)
			</div>
			: Note, shifting this way with YUV clips must be done in 2-pixel increments.
			: You can shift in ''sub''-pixel increments with [[Resize#General_information\|Resize]].
			</div>

	~~# Add letterbox borders that are Black making a 720x308 image 720x480~~
	~~# For YUV colorspace it will be correct (for CCIR-601) color (luma=16)~~
	~~AddBorders(0, 86, 0, 86, $000000)~~

	[[Category:Internal filters]]		[[Category:Internal filters]]
	[[Category:Borders_and_Cropping]]		[[Category:Borders_and_Cropping]]

← Older revision		Revision as of 19:36, 30 January 2016
Line 3:		Line 3:
	* [[Splice]] a smaller resolution clip to a larger one without resizing		* [[Splice]] a smaller resolution clip to a larger one without resizing
	* Together with [[Crop]], shift a clip horizontally or vertically – see below.		* Together with [[Crop]], shift a clip horizontally or vertically – see below.
			See also: [[Letterbox]], which adds borders without changing frame size.