![]() |
![]() |
![]() |
GStreamer Good Plugins 1.0 Plugins Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
GObject +----GInitiallyUnowned +----GstObject +----GstElement +----GstBaseTransform +----GstVideoFilter +----GstGdkPixbufOverlay
"location" gchar* : Read / Write "offset-x" gint : Read / Write "offset-y" gint : Read / Write "overlay-height" gint : Read / Write "overlay-width" gint : Read / Write "relative-x" gdouble : Read / Write "relative-y" gdouble : Read / Write "alpha" gdouble : Read / Write "pixbuf" GdkPixbuf* : Read / Write "positioning-mode" GstGdkPixbufPositioningMode : Read / Write
The gdkpixbufoverlay element overlays an image loaded from file onto a video stream.
Changing the positioning or overlay width and height properties at runtime
is supported, but it might be prudent to to protect the property setting
code with GST_BASE_TRANSFORM_LOCK and GST_BASE_TRANSFORM_UNLOCK, as
g_object_set()
is not atomic for multiple properties passed in one go.
Changing the image at runtime is currently not supported.
Negative offsets are also not yet supported.
1 |
gst-launch-1.0 -v videotestsrc ! gdkpixbufoverlay location=image.png ! autovideosink |
plugin |
gdkpixbuf |
author |
Tim-Philipp Müller <tim centricular net> |
class |
Filter/Effect/Video |
name |
sink |
direction |
sink |
presence |
always |
details |
video/x-raw, format=(string){ RGBx, RGB, BGR, BGRx, xRGB, xBGR, RGBA, BGRA, ARGB, ABGR, I420, YV12, AYUV, YUY2, UYVY, v308, v210, v216, Y41B, Y42B, Y444, YVYU, NV12, NV21, UYVP, RGB16, BGR16, RGB15, BGR15, UYVP, A420, YUV9, YVU9, IYU1, ARGB64, AYUV64, r210, I420_10LE, I420_10BE, GRAY8, GRAY16_BE, GRAY16_LE }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ] |
name |
src |
direction |
source |
presence |
always |
details |
video/x-raw, format=(string){ RGBx, RGB, BGR, BGRx, xRGB, xBGR, RGBA, BGRA, ARGB, ABGR, I420, YV12, AYUV, YUY2, UYVY, v308, v210, v216, Y41B, Y42B, Y444, YVYU, NV12, NV21, UYVP, RGB16, BGR16, RGB15, BGR15, UYVP, A420, YUV9, YVU9, IYU1, ARGB64, AYUV64, r210, I420_10LE, I420_10BE, GRAY8, GRAY16_BE, GRAY16_LE }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ] |
"location"
property "location" gchar* : Read / Write
Location of image file to overlay.
Default value: NULL
"offset-x"
property "offset-x" gint : Read / Write
For positive value, horizontal offset of overlay image in pixels from left of video image. For negative value, horizontal offset of overlay image in pixels from right of video image.
Default value: 0
"offset-y"
property "offset-y" gint : Read / Write
For positive value, vertical offset of overlay image in pixels from top of video image. For negative value, vertical offset of overlay image in pixels from bottom of video image.
Default value: 0
"overlay-height"
property "overlay-height" gint : Read / Write
Height of overlay image in pixels (0 = same as overlay image).
Allowed values: >= 0
Default value: 0
"overlay-width"
property "overlay-width" gint : Read / Write
Width of overlay image in pixels (0 = same as overlay image).
Allowed values: >= 0
Default value: 0
"relative-x"
property "relative-x" gdouble : Read / Write
Horizontal offset of overlay image in fractions of video image width, from top-left corner of video image.
Allowed values: [0,1]
Default value: 0
"relative-y"
property "relative-y" gdouble : Read / Write
Vertical offset of overlay image in fractions of video image height, from top-left corner of video image.
Allowed values: [0,1]
Default value: 0
"alpha"
property "alpha" gdouble : Read / Write
Global alpha of overlay image.
Allowed values: [0,1]
Default value: 1
"positioning-mode"
property "positioning-mode" GstGdkPixbufPositioningMode : Read / Write
Positioning mode of offset-x and offset-y properties. Determines how negative x/y offsets will be interpreted. By default negative values are for positioning relative to the right/bottom edge of the video image, but you can use this property to select absolute positioning relative to a (0, 0) origin in the top-left corner. That way negative offsets will be to the left/above the video image, which allows you to smoothly slide logos into and out of the frame if desired.
Default value: pixels-relative-to-edges
Since 1.6