AddBorders

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(formatting, links, phrasing)
m (correction)
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)}}

Revision as of 05:40, 30 January 2016

Add black or colored borders, increasing frame size.

AddBorders( clip clip, int left, int top, int right, int bottom [, int color ] )

int  left, top, right, bottom = (required)
Border width in pixels.
For YUY2 sources, left and right must be even (divisible by 2).
For YV12 sources, all widths must be even (divisible by 2).
int  color = (black)
Border color; specified as an RGB value. See this page for more information on specifying colors.
For YUV clips, colors are converted from full-range (0–255) to tv-range (16–235).

Examples and Notes

  • Add letterbox (top and bottom) borders:
## add dark blue borders, using hex color notation
AddBorders(0, 86, 0, 86, $00008B) 

## same as above, using named preset color
AddBorders(0, 86, 0, 86, color_darkblue) 
  • 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 with YUV clips must be done in 2-pixel increments.
You can shift in sub-pixel increments with Resize.
Personal tools