# subtitleoverlay

GstBin that auto-magically overlays a video stream with subtitles by autoplugging the required elements.

It supports raw, timestamped text, different textual subtitle formats and DVD subpicture subtitles.

## Examples

     gst-launch-1.0 -v filesrc location=test.mkv ! matroskademux name=demux ! video/x-h264 ! queue ! decodebin ! subtitleoverlay name=overlay ! videoconvert ! autovideosink  demux. ! subpicture/x-dvd ! queue ! overlay.

This will play back the given Matroska file with h264 video and dvd subpicture style subtitles.

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstBin
                        ╰──subtitleoverlay

## Implemented interfaces

    GstChildProxy

## Factory details

Authors: – Sebastian Dröge <sebastian.droege@collabora.co.uk></sebastian.droege@collabora.co.uk>

Classification: – `Video/Overlay/Subtitle`

Rank – none

Plugin – playback

Package – GStreamer Base Plug-ins

## Pad Templates

### `src`

    ANY

Presence – always

Direction – src

Object type – GstPad

### `subtitle_sink`

    ANY

Presence – always

Direction – sink

Object type – GstPad

### `video_sink`

    ANY

Presence – always

Direction – sink

Object type – GstPad

## Properties

### font-desc

    “font-desc” gchararray

Pango font description of font to be used for subtitle rendering

Flags : Read / Write

Default value : NULL

### silent

    “silent” gboolean

Whether to show subtitles

Flags : Read / Write

Default value : false

### subtitle-encoding

    “subtitle-encoding” gchararray

Encoding to assume if input subtitles are not in UTF-8 encoding. If not set, the GST_SUBTITLE_ENCODING environment variable will be checked for an encoding to use. If that is not set either, ISO-8859-15 will be assumed.

Flags : Read / Write

Default value : NULL

### subtitle-ts-offset

    “subtitle-ts-offset” gint64

The synchronisation offset between text and video in nanoseconds

Flags : Read / Write

Default value : 0

The results of the search are