gstreamer/docs/gst/tmpl/gstprops.sgml
Wim Taymans 9df69622d9 Documentation updates
Original commit message from CVS:
Documentation updates
2002-06-12 22:27:18 +00:00

540 lines
6.6 KiB
Text

<!-- ##### 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>
@refcount: a refcount for this struct
@fixed: indicates that this props has no lists or ranges
@properties: the properties
<!-- ##### 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>
<!-- ##### 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>
Create an integer property that can hold any int.
</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>
Create an integer property that can hold negative ints.
</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>
Create an integer property that can hold positive ints.
</para>
<!-- ##### STRUCT GstPropsEntry ##### -->
<para>
An entry hols one key/value pair.
</para>
<!-- ##### FUNCTION gst_props_new ##### -->
<para>
</para>
@firstname:
@Varargs:
@Returns:
<!-- ##### FUNCTION gst_props_newv ##### -->
<para>
</para>
@firstname:
@var_args:
@Returns:
<!-- ##### FUNCTION gst_props_empty_new ##### -->
<para>
</para>
@Returns:
<!-- ##### 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_has_property ##### -->
<para>
</para>
@props:
@name:
@Returns:
<!-- ##### FUNCTION gst_props_normalize ##### -->
<para>
</para>
@props:
@Returns:
<!-- ##### FUNCTION gst_props_set ##### -->
<para>
</para>
@props:
@name:
@Varargs:
@Returns:
<!-- # Unused Parameters # -->
@entry:
@value:
<!-- ##### FUNCTION gst_props_get ##### -->
<para>
</para>
@props:
@first_name:
@Varargs:
@Returns:
<!-- ##### FUNCTION gst_props_get_safe ##### -->
<para>
</para>
@props:
@first_name:
@Varargs:
@Returns:
<!-- ##### FUNCTION gst_props_has_property ##### -->
<para>
</para>
@props:
@name:
@Returns:
<!-- ##### FUNCTION gst_props_has_fixed_property ##### -->
<para>
</para>
@props:
@name:
@Returns:
<!-- ##### FUNCTION gst_props_has_property_typed ##### -->
<para>
</para>
@props:
@name:
@type:
@Returns:
<!-- ##### FUNCTION gst_props_intersect ##### -->
<para>
</para>
@props1:
@props2:
@Returns:
<!-- ##### FUNCTION gst_props_debug ##### -->
<para>
</para>
@props:
<!-- ##### FUNCTION gst_props_save_thyself ##### -->
<para>
</para>
@props:
@parent:
@Returns:
<!-- ##### FUNCTION gst_props_load_thyself ##### -->
<para>
</para>
@parent:
@Returns:
<!-- ##### FUNCTION gst_props_get_entry ##### -->
<para>
</para>
@props:
@name:
@Returns:
<!-- ##### FUNCTION gst_props_add_entry ##### -->
<para>
</para>
@props:
@entry:
<!-- ##### FUNCTION gst_props_entry_new ##### -->
<para>
</para>
@name:
@Varargs:
@Returns:
<!-- ##### FUNCTION gst_props_entry_get ##### -->
<para>
</para>
@entry:
@Varargs:
@Returns:
<!-- # Unused Parameters # -->
@props:
<!-- ##### FUNCTION gst_props_entry_get_boolean ##### -->
<para>
</para>
@entry:
@val:
@Returns:
<!-- ##### FUNCTION gst_props_entry_get_float ##### -->
<para>
</para>
@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:
@Returns: