# faceoverlay

Overlays a SVG image over a detected face in a video stream. x, y, w, and h properties are optional, and change the image position and size relative to the detected face position and size.

## Example launch line

     gst-launch-1.0 autovideosrc ! videoconvert ! faceoverlay location=/path/to/gnome-video-effects/pixmaps/bow.svg x=0.5 y=0.5 w=0.7 h=0.7 ! videoconvert ! autovideosink

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstBin
                        ╰──faceoverlay

## Implemented interfaces

    GstChildProxy

## Factory details

Authors: – Laura Lucas Alday

Classification: – `Filter/Editor/Video`

Rank – none

Plugin – faceoverlay

Package – GStreamer Bad Plug-ins

## Pad Templates

### `sink`

    video/x-raw:
             format: { RGB }
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]

Presence – always

Direction – sink

Object type – GstPad

### `src`

    video/x-raw:
             format: { BGRA }
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]

Presence – always

Direction – src

Object type – GstPad

## Properties

### h

    “h” gfloat

Specify image height relative to face height.

Flags : Read / Write

Default value : 1

### location

    “location” gchararray

Location of SVG file to use for face overlay

Flags : Read / Write

Default value : NULL

### w

    “w” gfloat

Specify image width relative to face width.

Flags : Read / Write

Default value : 1

### x

    “x” gfloat

Specify image x relative to detected face x.

Flags : Read / Write

Default value : 0

### y

    “y” gfloat

Specify image y relative to detected face y.

Flags : Read / Write

Default value : 0

The results of the search are