## GESTitleSource GESTitleSource — render stand-alone text titles |

## Synopsis

    #include <ges/ges.h>

                        GESTitleSource;
    GESTitleSource *    ges_title_source_new                (void);
    void                ges_title_source_set_text           (GESTitleSource *self,
                                                             const gchar *text);
    void                ges_title_source_set_font_desc      (GESTitleSource *self,
                                                             const gchar *font_desc);
    void                ges_title_source_set_halignment     (GESTitleSource *self,
                                                             GESTextHAlign halign);
    void                ges_title_source_set_valignment     (GESTitleSource *self,
                                                             GESTextVAlign valign);
    void                ges_title_source_set_text_color     (GESTitleSource *self,
                                                             guint32 color);
    void                ges_title_clip_set_background_color_color
                                                            (GESTitleSource *self,
                                                             guint32 color);
    void                ges_title_source_set_xpos           (GESTitleSource *self,
                                                             gdouble position);
    void                ges_title_source_set_ypos           (GESTitleSource *self,
                                                             gdouble position);
    const gchar *       ges_title_source_get_text           (GESTitleSource *source);
    const gchar *       ges_title_source_get_font_desc      (GESTitleSource *source);
    GESTextHAlign       ges_title_source_get_halignment     (GESTitleSource *source);
    GESTextVAlign       ges_title_source_get_valignment     (GESTitleSource *source);
    const guint32       ges_title_source_get_text_color     (GESTitleSource *source);
    const guint32       ges_title_source_get_background_color
                                                            (GESTitleSource *source);
    const gdouble       ges_title_source_get_xpos           (GESTitleSource *source);
    const gdouble       ges_title_source_get_ypos           (GESTitleSource *source);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GESTimelineElement
                   +----GESTrackElement
                         +----GESSource
                               +----GESVideoSource
                                     +----GESTitleSource

## Implemented Interfaces

GESTitleSource implements GESExtractable and GESMetaContainer.

## Description

## Details

### GESTitleSource

    typedef struct _GESTitleSource GESTitleSource;

### ges_title_source_new ()

    GESTitleSource *    ges_title_source_new                (void);

Creates a new GESTitleSource.

Returns : | The newly created GESTitleSource, or `NULL` if there was an error.

### ges_title_source_set_text ()

    void                ges_title_source_set_text           (GESTitleSource *self,
                                                             const gchar *text);

Sets the text this track element will render.

`self` : | the GESTitleSource* to set text on
`text` : | the text to render. an internal copy of this text will be made.

### ges_title_source_set_font_desc ()

    void                ges_title_source_set_font_desc      (GESTitleSource *self,
                                                             const gchar *font_desc);

Set the pango font description this source will use to render the text.

`self` : | the GESTitleSource
`font_desc` : | the pango font description

### ges_title_source_set_halignment ()

    void                ges_title_source_set_halignment     (GESTitleSource *self,
                                                             GESTextHAlign halign);

Sets the vertical aligment of the text.

`self` : | the GESTitleSource* to set text on
`halign` : | GESTextHAlign

### ges_title_source_set_valignment ()

    void                ges_title_source_set_valignment     (GESTitleSource *self,
                                                             GESTextVAlign valign);

Sets the vertical aligment of the text.

`self` : | the GESTitleSource* to set text on
`valign` : | GESTextVAlign

### ges_title_source_set_text_color ()

    void                ges_title_source_set_text_color     (GESTitleSource *self,
                                                             guint32 color);

Sets the color of the text.

`self` : | the GESTitleSource* to set
`color` : | the color `self` is being set to

Since 0.10.2

### ges_title_clip_set_background_color_color ()

    void                ges_title_clip_set_background_color_color
                                                            (GESTitleSource *self,
                                                             guint32 color);

Sets the color of the background

`self` : | the GESTitleSource* to set
`color` : | the color `self` is being set to

### ges_title_source_set_xpos ()

    void                ges_title_source_set_xpos           (GESTitleSource *self,
                                                             gdouble position);

Sets the horizontal position of the text.

`self` : | the GESTitleSource* to set
`position` : | the horizontal position `self` is being set to

Since 0.10.2

### ges_title_source_set_ypos ()

    void                ges_title_source_set_ypos           (GESTitleSource *self,
                                                             gdouble position);

Sets the vertical position of the text.

`self` : | the GESTitleSource* to set
`position` : | the color `self` is being set to

Since 0.10.2

### ges_title_source_get_text ()

    const gchar *       ges_title_source_get_text           (GESTitleSource *source);

Get the text currently set on the `source`.

`source` : | a GESTitleSource
Returns : | The text currently set on the `source`. [transfer none]

### ges_title_source_get_font_desc ()

    const gchar *       ges_title_source_get_font_desc      (GESTitleSource *source);

Get the pango font description used by `source`.

`source` : | a GESTitleSource
Returns : | The pango font description used by this `source`. [transfer none]

### ges_title_source_get_halignment ()

    GESTextHAlign       ges_title_source_get_halignment     (GESTitleSource *source);

Get the horizontal aligment used by `source`.

`source` : | a GESTitleSource
Returns : | The horizontal aligment used by `source`.

### ges_title_source_get_valignment ()

    GESTextVAlign       ges_title_source_get_valignment     (GESTitleSource *source);

Get the vertical aligment used by `source`.

`source` : | a GESTitleSource
Returns : | The vertical aligment used by `source`.

### ges_title_source_get_text_color ()

    const guint32       ges_title_source_get_text_color     (GESTitleSource *source);

Get the color used by `source`.

`source` : | a GESTitleSource
Returns : | The color used by `source`.

Since 0.10.2

### ges_title_source_get_background_color ()

    const guint32       ges_title_source_get_background_color
                                                            (GESTitleSource *source);

Get the background used by `source`.

`source` : | a GESTitleSource
Returns : | The background used by `source`.

### ges_title_source_get_xpos ()

    const gdouble       ges_title_source_get_xpos           (GESTitleSource *source);

Get the horizontal position used by `source`.

`source` : | a GESTitleSource
Returns : | The horizontal position used by `source`.

Since 0.10.2

### ges_title_source_get_ypos ()

    const gdouble       ges_title_source_get_ypos           (GESTitleSource *source);

Get the vertical position used by `source`.

`source` : | a GESTitleSource
Returns : | The vertical position used by `source`.

Since 0.10.2