gstreamer/gst/videobox
Tim-Philipp Müller 31ff328727 meson: add update-orc-dist target
Add target to update backup orc -dist.[ch] files.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-good/-/merge_requests/662>
2020-07-04 15:04:59 +01:00
..
gstvideobox.c plugins: uddate gst_type_mark_as_plugin_api() calls 2020-06-06 00:42:25 +02:00
gstvideobox.h Fix FSF address 2012-11-04 00:07:18 +00:00
gstvideoboxorc-dist.c Update ORC files 2018-02-09 09:00:46 +01:00
gstvideoboxorc-dist.h Release 1.1.1 2013-06-05 18:31:40 +02:00
gstvideoboxorc.orc videobox: prefix orc functions with video_box_orc_ 2012-07-24 09:13:48 +02:00
meson.build meson: add update-orc-dist target 2020-07-04 15:04:59 +01:00
README A plugin to add an alpha channel to I420 video. Can optionally do chroma keying. 2004-05-28 18:01:34 +00:00

Videobox
--------

This plugin crops or enlarges the image. It takes 4 values as input, a
top, bottom, left and right offset. Positive values will crop that much
pixels from the respective border of the image, negative values will add
that much pixels. When pixels are added, you can specify their color. 
Some predefined colors are usable with an enum property.

The plugin is alpha channel aware and will try to negotiate with a format
that supports alpha channels first. When alpha channel is active two
other properties, alpha and border_alpha can be used to set the alpha
values of the inner picture and the border respectively. an alpha value of
0.0 means total transparency, 1.0 is opaque.

The videobox plugin has many uses such as doing a mosaic of pictures, 
letterboxing video, cutting out pieces of video, picture in picture, etc..

TODO

- add enum to specify common aspect ratios/sizes and add borders/crop