## gdkpixbufoverlay gdkpixbufoverlay — Overlay an image onto a video stream |

## Synopsis

    struct              GstGdkPixbufOverlay;

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GstObject
                   +----GstElement
                         +----GstBaseTransform
                               +----GstVideoFilter
                                     +----GstGdkPixbufOverlay

## Properties

      "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

## Description

## Synopsis

### Element Information

plugin | gdkpixbuf
author | Tim-Philipp Müller <tim centricular net>
class | Filter/Effect/Video

### Element Pads

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 ]

## Details

### struct GstGdkPixbufOverlay

    struct GstGdkPixbufOverlay;

## Property Details

### The `"location"` property

      "location"                 gchar*                : Read / Write

Location of image file to overlay.

Default value: NULL

### The `"offset-x"` property

      "offset-x"                 gint                  : Read / Write

Horizontal offset of overlay image in pixels from top-left corner of video image.

Default value: 0

### The `"offset-y"` property

      "offset-y"                 gint                  : Read / Write

Vertical offset of overlay image in pixels from top-left corner of video image.

Default value: 0

### The `"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

### The `"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

### The `"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

### The `"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

### The `"alpha"` property

      "alpha"                    gdouble               : Read / Write

Global alpha of overlay image.

Allowed values: [0,1]

Default value: 1