## textrender

textrender — Renders a text string to an image bitmap

## Synopsis

                        GstTextRender;

## Object Hierarchy

      GObject
       +----GstObject
             +----GstElement
                   +----GstTextRender

## Properties

      "font-desc"                gchar*                : Write
      "halignment"               GstTextRenderHAlign   : Read / Write
      "line-alignment"           GstTextRenderLineAlign  : Read / Write
      "valignment"               GstTextRenderVAlign   : Read / Write
      "xpad"                     gint                  : Read / Write
      "ypad"                     gint                  : Read / Write

## Description

This plugin renders text received on the text sink pad to a video buffer (retaining the alpha channel), so it can later be overlayed on top of video streams using other elements.

The text can contain newline characters. (FIXME: What about text wrapping? It does not make sense in this context)

### Example launch lines

    1

    gst-launch -v filesrc location=subtitles.srt ! subparse ! textrender ! xvimagesink

## Details

### GstTextRender

    typedef struct _GstTextRender GstTextRender;

Opaque textrender data structure.

## Property Details

### The `"font-desc"` property

      "font-desc"                gchar*                : Write

Pango font description of font to be used for rendering. See documentation of pango_font_description_from_string for syntax.

Default value: ""

### The `"halignment"` property

      "halignment"               GstTextRenderHAlign   : Read / Write

Horizontal alignment of the text.

Default value: center

### The `"line-alignment"` property

      "line-alignment"           GstTextRenderLineAlign  : Read / Write

Alignment of text lines relative to each other.

Default value: center

### The `"valignment"` property

      "valignment"               GstTextRenderVAlign   : Read / Write

Vertical alignment of the text.

Default value: baseline

### The `"xpad"` property

      "xpad"                     gint                  : Read / Write

Horizontal paddding when using left/right alignment.

Allowed values: >= 0

Default value: 25

### The `"ypad"` property

      "ypad"                     gint                  : Read / Write

Vertical padding when using top/bottom alignment.

Allowed values: >= 0

Default value: 25

## See Also

GstTextOverlay