2000-12-30 16:13:17 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GstProps
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
Properties
|
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
|
|
|
GstProps is used to attach certain properties to a pad. Properties
|
|
|
|
are usually used in conjunction with GstCaps.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
2001-04-19 22:25:04 +00:00
|
|
|
#GstCaps
|
2000-12-30 16:13:17 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GstProps ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-03-21 21:43:56 +00:00
|
|
|
@refcount:
|
2001-03-27 16:25:00 +00:00
|
|
|
@lock:
|
2000-12-30 16:13:17 +00:00
|
|
|
@properties: the properties
|
|
|
|
|
2001-04-10 19:46:23 +00:00
|
|
|
<!-- ##### MACRO GST_MAKE_FOURCC ##### -->
|
|
|
|
<para>
|
2001-04-17 21:14:55 +00:00
|
|
|
Create a FOURCC value that can easily be used to construct
|
|
|
|
a fourcc property.
|
2001-04-22 16:04:19 +00:00
|
|
|
<programlisting>
|
|
|
|
...
|
|
|
|
"format", GST_PROPS_FOURCC (GST_MAKE_FOURCC ('Y','U','Y','2')),
|
|
|
|
...
|
|
|
|
</programlisting>
|
2001-04-10 19:46:23 +00:00
|
|
|
</para>
|
|
|
|
|
2001-04-17 21:14:55 +00:00
|
|
|
@a: first fourcc byte
|
|
|
|
@b: second fourcc byte
|
|
|
|
@c: third fourcc byte
|
|
|
|
@d: fourth fourcc byte
|
2001-04-10 19:46:23 +00:00
|
|
|
|
|
|
|
|
2001-04-22 16:04:19 +00:00
|
|
|
<!-- ##### MACRO GST_STR_FOURCC ##### -->
|
|
|
|
<para>
|
|
|
|
Create a FOURCC value from a string. example:
|
|
|
|
<programlisting>
|
|
|
|
...
|
|
|
|
"format", GST_PROPS_FOURCC (GST_STR_FOURCC ("YUY2")),
|
|
|
|
...
|
|
|
|
</programlisting>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@f: the string describing the fourcc value.
|
|
|
|
|
|
|
|
|
2000-12-30 16:13:17 +00:00
|
|
|
<!-- ##### MACRO GST_PROPS_LIST ##### -->
|
|
|
|
<para>
|
2001-01-06 22:05:15 +00:00
|
|
|
Create a list of properties.
|
2000-12-30 16:13:17 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
@a...: the list of GstProps
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_INT ##### -->
|
|
|
|
<para>
|
2001-01-06 22:05:15 +00:00
|
|
|
Create an integer property.
|
2000-12-30 16:13:17 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: the integer property
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_INT_RANGE ##### -->
|
|
|
|
<para>
|
2001-01-06 22:05:15 +00:00
|
|
|
Create an integer range property.
|
2000-12-30 16:13:17 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: the min value for the range
|
|
|
|
@b: the max value for the range
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_FOURCC ##### -->
|
|
|
|
<para>
|
2001-01-06 22:05:15 +00:00
|
|
|
Construct a fourcc property out of four bytes.
|
2000-12-30 16:13:17 +00:00
|
|
|
</para>
|
|
|
|
|
2001-04-17 21:14:55 +00:00
|
|
|
@a: a fourcc value usualy created with GST_FOURCC_MAKE ()
|
2000-12-30 16:13:17 +00:00
|
|
|
|
|
|
|
|
2001-04-10 19:46:23 +00:00
|
|
|
<!-- ##### MACRO GST_PROPS_BOOLEAN ##### -->
|
2000-12-30 16:13:17 +00:00
|
|
|
<para>
|
2001-04-10 19:46:23 +00:00
|
|
|
Create a boolean property.
|
2000-12-30 16:13:17 +00:00
|
|
|
</para>
|
|
|
|
|
2001-04-10 19:46:23 +00:00
|
|
|
@a: the boolean property
|
2000-12-30 16:13:17 +00:00
|
|
|
|
|
|
|
|
2001-04-10 19:46:23 +00:00
|
|
|
<!-- ##### MACRO GST_PROPS_STRING ##### -->
|
2000-12-30 16:13:17 +00:00
|
|
|
<para>
|
2001-04-17 21:14:55 +00:00
|
|
|
Create a string value.
|
2000-12-30 16:13:17 +00:00
|
|
|
</para>
|
|
|
|
|
2001-04-17 21:14:55 +00:00
|
|
|
@a: the string value.
|
2000-12-30 16:13:17 +00:00
|
|
|
|
|
|
|
|
2001-04-10 19:46:23 +00:00
|
|
|
<!-- ##### MACRO GST_PROPS_FLOAT ##### -->
|
|
|
|
<para>
|
2001-04-17 21:14:55 +00:00
|
|
|
Create a floating point value.
|
2001-04-10 19:46:23 +00:00
|
|
|
</para>
|
|
|
|
|
2001-04-17 21:14:55 +00:00
|
|
|
@a: the float value
|
2001-04-10 19:46:23 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_FLOAT_RANGE ##### -->
|
|
|
|
<para>
|
2001-04-17 21:14:55 +00:00
|
|
|
Create a float range value.
|
2001-04-10 19:46:23 +00:00
|
|
|
</para>
|
|
|
|
|
2001-04-17 21:14:55 +00:00
|
|
|
@a: lower float bounds
|
|
|
|
@b: upper float bounds
|
2001-04-10 19:46:23 +00:00
|
|
|
|
|
|
|
|
2001-04-14 18:56:37 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_new ##### -->
|
2000-12-31 17:02:47 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-04-14 18:56:37 +00:00
|
|
|
@firstname:
|
|
|
|
@Varargs:
|
2000-12-31 17:02:47 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-04-14 18:56:37 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_newv ##### -->
|
2000-12-30 16:13:17 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-04-14 18:56:37 +00:00
|
|
|
@firstname:
|
|
|
|
@var_args:
|
2000-12-30 16:13:17 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_merge ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@tomerge:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-03-21 21:43:56 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_copy ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_copy_on_write ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_destroy ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_ref ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_unref ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
|
|
|
|
|
2000-12-30 16:13:17 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_check_compatibility ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@fromprops:
|
|
|
|
@toprops:
|
|
|
|
@Returns:
|
|
|
|
<!-- # Unused Parameters # -->
|
|
|
|
@props1:
|
|
|
|
@props2:
|
|
|
|
|
|
|
|
|
2001-03-21 21:43:56 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_set ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
<!-- # Unused Parameters # -->
|
2001-04-14 18:56:37 +00:00
|
|
|
@entry:
|
2001-03-21 21:43:56 +00:00
|
|
|
@value:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_get_boolean ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_get_fourcc_int ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_get_int ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-03-27 17:34:39 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_get_string ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-05-03 20:06:18 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_get_float ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2000-12-30 16:13:17 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_save_thyself ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@parent:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_load_thyself ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@parent:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|