AddBorders
From Avisynth wiki
(Difference between revisions)
Raffriff42 (Talk | contribs) m (added category) |
Raffriff42 (Talk | contribs) (formatting, links, phrasing) |
||
| Line 1: | Line 1: | ||
| − | + | Add black or colored borders, increasing frame size. | |
| − | AddBorders | + | {{FuncDef |
| + | |AddBorders( clip ''clip'', int ''left'', int ''top'', int ''right'', int ''bottom'' [, int ''color'' ] ) | ||
| + | }} | ||
| − | + | :{{Par2|left, top, right, bottom|int|(required)}} | |
| + | ::Border width in pixels. | ||
| + | ::For [[YUV]] sources, all values must be even (divisible by 2). | ||
| − | + | :{{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). | ||
| − | + | ==== 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 | + | * 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, | + | |
| + | * 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> | ||
| − | |||
| − | |||
| − | |||
[[Category:Internal filters]] | [[Category:Internal filters]] | ||
[[Category:Borders_and_Cropping]] | [[Category:Borders_and_Cropping]] | ||
Revision as of 05:34, 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 YUV sources, all values 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.
