AddBorders - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T03:33:31Z

add link to avs+ documentation

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

2019-12-06T12:22:35Z

‎Examples and Notes: Add color_yuv example

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

2019-12-06T12:16:11Z

‎Syntax and Parameters: new parameter color_yuv

Admin: /* Syntax and Parameters */

2016-03-22T18:50:35Z

‎Syntax and Parameters

Raffriff42: See also: Letterbox

2016-01-30T17:36:20Z

Raffriff42: one more touch-up

2016-01-30T16:11:20Z

one more touch-up

Raffriff42: one more touch-up

2016-01-30T14:34:11Z

one more touch-up

Raffriff42: one more touch-up

2016-01-30T08:03:30Z

one more touch-up

Raffriff42: correction

2016-01-30T04:40:46Z

correction

Raffriff42: formatting, links, phrasing

2016-01-30T04:34:25Z

formatting, links, phrasing

← Older revision		Revision as of 03: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)

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

@@ Line 8: / Line 8: @@
 == Syntax and Parameters ==
 {{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.
 ::*For YUV clips, colors are converted from full-range (0&ndash;255) to tv-range (16&ndash;235).
 == Examples and Notes ==

@@ Line 13: / Line 13: @@
 :{{Par2|left, top, right, bottom|int|(required)}}
 ::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 [[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.
 ::*For YUV clips, colors are converted from full-range (0&ndash;255) to tv-range (16&ndash;235).
 == Examples and Notes ==

← Older revision		Revision as of 17: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.

← Older revision		Revision as of 16: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 ==

@@ Line 35: / Line 35: @@
   AddBorders(2, 0, 0, 0)
 </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]].
 </div>

@@ Line 7: / Line 7: @@
 :{{Par2|left, top, right, bottom|int|(required)}}
 ::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).
 :{{Par2|color|int|(black)}}

@@ 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
-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)}}
-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)}}
-You can use this filter in combination with [[Crop]] to shift an image around without changing the frame size. For example:
+==== Examples and Notes====
-  # 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)
   AddBorders(2, 0, 0, 0)
 [[Category:Internal filters]]
 [[Category:Borders_and_Cropping]]