AddBorders

Add black or colored borders, increasing frame size. This has several common uses:

  • Adjust the 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.

See also: Letterbox, which adds borders without changing frame size.

Syntax and Parameters

AddBorders (clip clip, int left, int top, int right, int bottom, int "color", int "color_yuv")
clip

Source clip; all color formats supported.

left, top, right, bottom

Border width in pixels.

  • For YUV411 sources, left and right must be mod4 (divisible by 4).

  • For YUV420 sources, all four border widths must be mod2 (divisible by 2).

  • For YUV422 sources, left and right must be mod2.

color
Specifies the border color; black by default.
Color is specified as an RGB value in either hexadecimal or decimal notation.
Hex numbers must be preceded with a $. See the colors page for more information on specifying colors.

  • For YUV clips, colors are converted from full range to limited range Rec.601.

  • Use color_yuv to specify full range YUV values or a color with a different matrix.

Default: $000000

color_yuv

Specifies the border color using YUV values. Input clip must be YUV; otherwise an error is raised. See the YUV colors for more information.

Examples

  • Add letterbox (top and bottom) borders:

    # add dark blue borders, using hex color notation
AddBorders(0, 86, 0, 86, color=$00008B)

# same as above, using named preset color
AddBorders(0, 86, 0, 86, color=color_darkblue)

# full scale black border using color_yuv hex color notation
AddBorders(0, 86, 0, 86, color_yuv=$008080)

  • Be aware that many older lossy compression algorithms don't deal well with solid-color borders, unless the border happens to fall on a macroblock boundary (16 pixels for MPEG).

  • Use AddBorders in combination with Crop to shift an image without changing the frame size:

    # Shift an image 2 pixels to the right
Crop(0, 0, Width-2, Height)
AddBorders(2, 0, 0, 0)

    • 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.

Changelog

Version

Changes

AviSynth+ 3.6.2

Fix: AddBorders did not pass frame properties

AviSynth+ 3.5.0

New color_yuv parameter like in BlankClip

AviSynth+ r2397

AddBorders missing l/r/top/bottom vs. subsampling check for YUVA

AviSynth 2.6.0

Bugfix: Fixed RGB24 AddBorders with right=0

AviSynth 2.0.7

New color parameter

$Date: 2022/04/17 11:37:04 $