title-clip: Enhance documentation

This commit is contained in:
Thibault Saunier 2019-05-01 11:53:07 -04:00
parent e7816eba1d
commit 4cd054dea0

View file

@ -162,8 +162,9 @@ ges_title_clip_class_init (GESTitleClipClass * klass)
* *
* The text to diplay * The text to diplay
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties or
* underlying GESTrackElement instead * #ges_timeline_element_get_children_properties instead.
* See #GESTitleSource for more information about exposed properties
*/ */
g_object_class_install_property (object_class, PROP_TEXT, g_object_class_install_property (object_class, PROP_TEXT,
g_param_spec_string ("text", "Text", "The text to display", g_param_spec_string ("text", "Text", "The text to display",
@ -175,8 +176,9 @@ ges_title_clip_class_init (GESTitleClipClass * klass)
* *
* Pango font description string * Pango font description string
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties or
* underlying GESTrackElement instead * #ges_timeline_element_get_children_properties instead.
* See #GESTitleSource for more information about exposed properties
*/ */
g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_FONT_DESC, g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_FONT_DESC,
g_param_spec_string ("font-desc", "font description", g_param_spec_string ("font-desc", "font description",
@ -191,8 +193,9 @@ ges_title_clip_class_init (GESTitleClipClass * klass)
* *
* Vertical alignent of the text * Vertical alignent of the text
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties or
* underlying GESTrackElement instead * #ges_timeline_element_get_children_properties instead.
* See #GESTitleSource for more information about exposed properties
*/ */
g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_VALIGNMENT, g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_VALIGNMENT,
g_param_spec_enum ("valignment", "vertical alignment", g_param_spec_enum ("valignment", "vertical alignment",
@ -205,8 +208,9 @@ ges_title_clip_class_init (GESTitleClipClass * klass)
* *
* Horizontal alignment of the text * Horizontal alignment of the text
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties or
* underlying GESTrackElement instead * #ges_timeline_element_get_children_properties instead.
* See #GESTitleSource for more information about exposed properties
*/ */
g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_HALIGNMENT, g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_HALIGNMENT,
g_param_spec_enum ("halignment", "horizontal alignment", g_param_spec_enum ("halignment", "horizontal alignment",
@ -226,8 +230,9 @@ ges_title_clip_class_init (GESTitleClipClass * klass)
* *
* The color of the text * The color of the text
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties or
* underlying GESTrackElement instead * #ges_timeline_element_get_children_properties instead.
* See #GESTitleSource for more information about exposed properties
*/ */
g_object_class_install_property (object_class, PROP_COLOR, g_object_class_install_property (object_class, PROP_COLOR,
@ -240,8 +245,9 @@ ges_title_clip_class_init (GESTitleClipClass * klass)
* *
* The background of the text * The background of the text
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties or
* underlying GESTrackElement instead * #ges_timeline_element_get_children_properties instead.
* See #GESTitleSource for more information about exposed properties
*/ */
g_object_class_install_property (object_class, PROP_BACKGROUND, g_object_class_install_property (object_class, PROP_BACKGROUND,
@ -254,8 +260,9 @@ ges_title_clip_class_init (GESTitleClipClass * klass)
* *
* The horizontal position of the text * The horizontal position of the text
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties or
* underlying GESTrackElement instead * #ges_timeline_element_get_children_properties instead.
* See #GESTitleSource for more information about exposed properties
*/ */
g_object_class_install_property (object_class, PROP_XPOS, g_object_class_install_property (object_class, PROP_XPOS,
@ -268,8 +275,9 @@ ges_title_clip_class_init (GESTitleClipClass * klass)
* *
* The vertical position of the text * The vertical position of the text
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties or
* underlying GESTrackElement instead * #ges_timeline_element_get_children_properties instead.
* See #GESTitleSource for more information about exposed properties
*/ */
g_object_class_install_property (object_class, PROP_YPOS, g_object_class_install_property (object_class, PROP_YPOS,
@ -295,8 +303,8 @@ ges_title_clip_init (GESTitleClip * self)
* *
* Sets the text this clip will render. * Sets the text this clip will render.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
void void
ges_title_clip_set_text (GESTitleClip * self, const gchar * text) ges_title_clip_set_text (GESTitleClip * self, const gchar * text)
@ -317,8 +325,8 @@ ges_title_clip_set_text (GESTitleClip * self, const gchar * text)
* *
* Sets the pango font description of the text. * Sets the pango font description of the text.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
void void
ges_title_clip_set_font_desc (GESTitleClip * self, const gchar * font_desc) ges_title_clip_set_font_desc (GESTitleClip * self, const gchar * font_desc)
@ -340,8 +348,8 @@ ges_title_clip_set_font_desc (GESTitleClip * self, const gchar * font_desc)
* *
* Sets the horizontal aligment of the text. * Sets the horizontal aligment of the text.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
void void
ges_title_clip_set_halignment (GESTitleClip * self, GESTextHAlign halign) ges_title_clip_set_halignment (GESTitleClip * self, GESTextHAlign halign)
@ -363,8 +371,8 @@ ges_title_clip_set_halignment (GESTitleClip * self, GESTextHAlign halign)
* *
* Sets the vertical aligment of the text. * Sets the vertical aligment of the text.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
void void
ges_title_clip_set_valignment (GESTitleClip * self, GESTextVAlign valign) ges_title_clip_set_valignment (GESTitleClip * self, GESTextVAlign valign)
@ -386,8 +394,8 @@ ges_title_clip_set_valignment (GESTitleClip * self, GESTextVAlign valign)
* *
* Sets the color of the text. * Sets the color of the text.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
void void
ges_title_clip_set_color (GESTitleClip * self, guint32 color) ges_title_clip_set_color (GESTitleClip * self, guint32 color)
@ -408,8 +416,8 @@ ges_title_clip_set_color (GESTitleClip * self, guint32 color)
* *
* Sets the background of the text. * Sets the background of the text.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
void void
ges_title_clip_set_background (GESTitleClip * self, guint32 background) ges_title_clip_set_background (GESTitleClip * self, guint32 background)
@ -432,8 +440,8 @@ ges_title_clip_set_background (GESTitleClip * self, guint32 background)
* *
* Sets the horizontal position of the text. * Sets the horizontal position of the text.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
void void
ges_title_clip_set_xpos (GESTitleClip * self, gdouble position) ges_title_clip_set_xpos (GESTitleClip * self, gdouble position)
@ -454,8 +462,8 @@ ges_title_clip_set_xpos (GESTitleClip * self, gdouble position)
* *
* Sets the vertical position of the text. * Sets the vertical position of the text.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_set_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
void void
ges_title_clip_set_ypos (GESTitleClip * self, gdouble position) ges_title_clip_set_ypos (GESTitleClip * self, gdouble position)
@ -477,8 +485,8 @@ ges_title_clip_set_ypos (GESTitleClip * self, gdouble position)
* *
* Returns: The text currently set on @self. * Returns: The text currently set on @self.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_get_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
const gchar * const gchar *
ges_title_clip_get_text (GESTitleClip * self) ges_title_clip_get_text (GESTitleClip * self)
@ -499,8 +507,8 @@ ges_title_clip_get_text (GESTitleClip * self)
* *
* Returns: The pango font description used by @self. * Returns: The pango font description used by @self.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_get_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
const char * const char *
ges_title_clip_get_font_desc (GESTitleClip * self) ges_title_clip_get_font_desc (GESTitleClip * self)
@ -521,8 +529,8 @@ ges_title_clip_get_font_desc (GESTitleClip * self)
* *
* Returns: The horizontal aligment used by @self. * Returns: The horizontal aligment used by @self.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_get_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
GESTextHAlign GESTextHAlign
ges_title_clip_get_halignment (GESTitleClip * self) ges_title_clip_get_halignment (GESTitleClip * self)
@ -543,8 +551,8 @@ ges_title_clip_get_halignment (GESTitleClip * self)
* *
* Returns: The vertical aligment used by @self. * Returns: The vertical aligment used by @self.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_get_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
GESTextVAlign GESTextVAlign
ges_title_clip_get_valignment (GESTitleClip * self) ges_title_clip_get_valignment (GESTitleClip * self)
@ -565,8 +573,8 @@ ges_title_clip_get_valignment (GESTitleClip * self)
* *
* Returns: The color used by @self. * Returns: The color used by @self.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_get_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
const guint32 const guint32
ges_title_clip_get_text_color (GESTitleClip * self) ges_title_clip_get_text_color (GESTitleClip * self)
@ -587,8 +595,8 @@ ges_title_clip_get_text_color (GESTitleClip * self)
* *
* Returns: The color used by @self. * Returns: The color used by @self.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_get_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
const guint32 const guint32
ges_title_clip_get_background_color (GESTitleClip * self) ges_title_clip_get_background_color (GESTitleClip * self)
@ -609,8 +617,8 @@ ges_title_clip_get_background_color (GESTitleClip * self)
* *
* Returns: The horizontal position used by @self. * Returns: The horizontal position used by @self.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_get_children_properties instead.
* underlying GESTrackElement instead * See #GESTitleSource for more information about exposed properties
*/ */
const gdouble const gdouble
ges_title_clip_get_xpos (GESTitleClip * self) ges_title_clip_get_xpos (GESTitleClip * self)
@ -631,8 +639,7 @@ ges_title_clip_get_xpos (GESTitleClip * self)
* *
* Returns: The vertical position used by @self. * Returns: The vertical position used by @self.
* *
* Deprecated: use ges_track_element_get/set_children_properties on the * Deprecated:1.6: use #ges_timeline_element_get_children_property instead
* underlying GESTrackElement instead
*/ */
const gdouble const gdouble
ges_title_clip_get_ypos (GESTitleClip * self) ges_title_clip_get_ypos (GESTitleClip * self)