summaryrefslogtreecommitdiffstats
path: root/gst/videobox/README
diff options
context:
space:
mode:
Diffstat (limited to 'gst/videobox/README')
-rw-r--r--gst/videobox/README21
1 files changed, 21 insertions, 0 deletions
diff --git a/gst/videobox/README b/gst/videobox/README
new file mode 100644
index 00000000..e71da590
--- /dev/null
+++ b/gst/videobox/README
@@ -0,0 +1,21 @@
+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