2002-01-15 00:41:22 +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>
|
|
|
|
#GstCaps
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GstProps ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
@refcount: a refcount for this struct
|
|
|
|
@fixed: indicates that this props has no lists or ranges
|
2002-01-15 00:41:22 +00:00
|
|
|
@properties: the properties
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### ENUM GstPropsType ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@GST_PROPS_END_TYPE:
|
|
|
|
@GST_PROPS_INVALID_TYPE:
|
|
|
|
@GST_PROPS_INT_TYPE:
|
|
|
|
@GST_PROPS_FLOAT_TYPE:
|
|
|
|
@GST_PROPS_FOURCC_TYPE:
|
|
|
|
@GST_PROPS_BOOL_TYPE:
|
|
|
|
@GST_PROPS_STRING_TYPE:
|
|
|
|
@GST_PROPS_VAR_TYPE:
|
|
|
|
@GST_PROPS_LIST_TYPE:
|
|
|
|
@GST_PROPS_FLOAT_RANGE_TYPE:
|
|
|
|
@GST_PROPS_INT_RANGE_TYPE:
|
|
|
|
@GST_PROPS_LAST_TYPE:
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_TYPE_PROPS ##### -->
|
|
|
|
<para>
|
|
|
|
The GType of the props boxed type, for use in GValues.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
2002-01-15 00:41:22 +00:00
|
|
|
<!-- ##### MACRO GST_MAKE_FOURCC ##### -->
|
|
|
|
<para>
|
|
|
|
Create a FOURCC value that can easily be used to construct
|
|
|
|
a fourcc property.
|
|
|
|
<programlisting>
|
|
|
|
...
|
|
|
|
"format", GST_PROPS_FOURCC (GST_MAKE_FOURCC ('Y','U','Y','2')),
|
|
|
|
...
|
|
|
|
</programlisting>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: first fourcc byte
|
|
|
|
@b: second fourcc byte
|
|
|
|
@c: third fourcc byte
|
|
|
|
@d: fourth fourcc byte
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### 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.
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_LIST ##### -->
|
|
|
|
<para>
|
|
|
|
Create a list of properties.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a...: the list of GstProps
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_INT ##### -->
|
|
|
|
<para>
|
|
|
|
Create an integer property.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: the integer property
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_INT_ANY ##### -->
|
|
|
|
<para>
|
2002-03-31 14:00:33 +00:00
|
|
|
Create an integer property that can hold any int.
|
2002-01-15 00:41:22 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_INT_RANGE ##### -->
|
|
|
|
<para>
|
|
|
|
Create an integer range property.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: the min value for the range
|
|
|
|
@b: the max value for the range
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_INT_NEGATIVE ##### -->
|
|
|
|
<para>
|
2002-03-31 14:00:33 +00:00
|
|
|
Create an integer property that can hold negative ints.
|
2002-01-15 00:41:22 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_FOURCC ##### -->
|
|
|
|
<para>
|
|
|
|
Construct a fourcc property out of four bytes.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: a fourcc value usualy created with GST_FOURCC_MAKE ()
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_BOOLEAN ##### -->
|
|
|
|
<para>
|
|
|
|
Create a boolean property.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: the boolean property
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_STRING ##### -->
|
|
|
|
<para>
|
|
|
|
Create a string value.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: the string value.
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_FLOAT ##### -->
|
|
|
|
<para>
|
|
|
|
Create a floating point value.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: the float value
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_FLOAT_RANGE ##### -->
|
|
|
|
<para>
|
|
|
|
Create a float range value.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@a: lower float bounds
|
|
|
|
@b: upper float bounds
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_PROPS_INT_POSITIVE ##### -->
|
|
|
|
<para>
|
2002-03-31 14:00:33 +00:00
|
|
|
Create an integer property that can hold positive ints.
|
2002-01-15 00:41:22 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
2002-06-12 22:27:18 +00:00
|
|
|
<!-- ##### STRUCT GstPropsEntry ##### -->
|
|
|
|
<para>
|
|
|
|
An entry hols one key/value pair.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2002-01-15 00:41:22 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@firstname:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_newv ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@firstname:
|
|
|
|
@var_args:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-06-12 22:27:18 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_empty_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-01-15 00:41:22 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_merge ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@tomerge:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### 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:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_check_compatibility ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@fromprops:
|
|
|
|
@toprops:
|
|
|
|
@Returns:
|
|
|
|
<!-- # Unused Parameters # -->
|
|
|
|
@props1:
|
|
|
|
@props2:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_normalize ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_set ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
<!-- # Unused Parameters # -->
|
|
|
|
@entry:
|
|
|
|
@value:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_get ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
2002-03-31 14:00:33 +00:00
|
|
|
@first_name:
|
|
|
|
@Varargs:
|
2002-01-15 00:41:22 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-06-12 22:27:18 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_get_safe ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@first_name:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_has_property ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_has_fixed_property ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_has_property_typed ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@name:
|
2002-03-31 14:00:33 +00:00
|
|
|
@type:
|
2002-01-15 00:41:22 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_intersect ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
@props1:
|
|
|
|
@props2:
|
2002-01-15 00:41:22 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_debug ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
2002-03-31 14:00:33 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_save_thyself ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@parent:
|
2002-01-15 00:41:22 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_load_thyself ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
@parent:
|
2002-01-15 00:41:22 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_get_entry ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
2002-03-31 14:00:33 +00:00
|
|
|
@name:
|
|
|
|
@Returns:
|
2002-01-15 00:41:22 +00:00
|
|
|
|
|
|
|
|
2002-06-12 22:27:18 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_add_entry ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@props:
|
|
|
|
@entry:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@name:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_entry_get ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
@entry:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
<!-- # Unused Parameters # -->
|
2002-01-15 00:41:22 +00:00
|
|
|
@props:
|
2002-03-31 14:00:33 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_boolean ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@val:
|
2002-01-15 00:41:22 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_float ##### -->
|
2002-01-15 00:41:22 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-03-31 14:00:33 +00:00
|
|
|
@entry:
|
|
|
|
@val:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_float_range ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@min:
|
|
|
|
@max:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_fourcc_int ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@val:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_int ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@val:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_int_range ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@min:
|
|
|
|
@max:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_list ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@val:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_string ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@val:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_get_type ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_props_entry_is_fixed ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@entry:
|
2002-01-15 00:41:22 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|