mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-06-09 09:39:27 +00:00
6bd5dcffab
Original commit message from CVS: The first wave of docs updates Added a little more comments about the API usage in the api docs. Some fixes for the capsnego testsuite.
328 lines
4.4 KiB
Plaintext
328 lines
4.4 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GstCaps
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
Capabilities of pads
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
GstCaps is used to attach capabilities to a pad. Capabilities are made of
|
|
a mime-type and a set of properties.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### MACRO GST_CAPS_LOCK ##### -->
|
|
<para>
|
|
Lock the caps structure
|
|
</para>
|
|
|
|
@caps: The caps structure to lock
|
|
|
|
|
|
<!-- ##### MACRO GST_CAPS_TRYLOCK ##### -->
|
|
<para>
|
|
Try to lock the caps structure
|
|
</para>
|
|
|
|
@caps: The caps structure to try to lock
|
|
|
|
|
|
<!-- ##### MACRO GST_CAPS_UNLOCK ##### -->
|
|
<para>
|
|
Unlock the caps structure
|
|
</para>
|
|
|
|
@caps: The caps structure to unlock
|
|
|
|
|
|
<!-- ##### MACRO GST_CAPS_NEW ##### -->
|
|
<para>
|
|
A convenience macro to create a new GstCaps structure.
|
|
</para>
|
|
|
|
@name: the name of the caps structure
|
|
@type: the mime type of the caps structure
|
|
@a...: the properties of this caps stucture.
|
|
|
|
|
|
<!-- ##### MACRO GST_CAPS_FACTORY ##### -->
|
|
<para>
|
|
A convenience macro to create a GstCaps factory.
|
|
</para>
|
|
|
|
@factoryname: the name of the factory
|
|
@a...: the caps to create with this factory, usualy specified
|
|
with GST_CAPS_NEW()
|
|
|
|
|
|
<!-- ##### MACRO GST_CAPS_GET ##### -->
|
|
<para>
|
|
A convenience macro to get a GstCaps from the given capsfactory.
|
|
</para>
|
|
|
|
@fact: the factory to use.
|
|
|
|
|
|
<!-- ##### STRUCT GstCaps ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name: the name of the capability, for the application
|
|
@id: the typeid of the capability
|
|
@refcount: a refcounter for this caps structure
|
|
@lock: the lock for this caps structure
|
|
@properties: the properties of the capability
|
|
@next: a pointer to the next caps.
|
|
|
|
<!-- ##### FUNCTION gst_caps_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@name:
|
|
@mime:
|
|
@props:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_destroy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_ref ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_unref ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_copy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_copy_on_write ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_chain ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Varargs:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_append ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@capstoadd:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_prepend ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@capstoadd:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_set_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@name:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_get_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_set_type_id ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@type_id:
|
|
<!-- # Unused Parameters # -->
|
|
@Param2:
|
|
@typeid:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_get_type_id ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_set_mime ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@mime:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_get_mime ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_set_props ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@props:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_get_props ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_check_compatibility ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@fromcaps:
|
|
@tocaps:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### MACRO gst_caps_set ##### -->
|
|
<para>
|
|
Set a property of a caps structure.
|
|
</para>
|
|
|
|
@caps: the caps structure to modify
|
|
@name: the name of the property to change
|
|
@args...: the new value of the property
|
|
|
|
|
|
<!-- ##### MACRO gst_caps_get_boolean ##### -->
|
|
<para>
|
|
Get the value of the named property as a boolean.
|
|
</para>
|
|
|
|
@caps: the caps to query
|
|
@name: the name of the property to get
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_get_by_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@name:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### MACRO gst_caps_get_fourcc_int ##### -->
|
|
<para>
|
|
Get the value of the named property as a fourcc.
|
|
</para>
|
|
|
|
@caps: the caps to query
|
|
@name: the name of the property to get
|
|
|
|
|
|
<!-- ##### MACRO gst_caps_get_int ##### -->
|
|
<para>
|
|
Get the value of the named property as an int.
|
|
</para>
|
|
|
|
@caps: the caps to query
|
|
@name: the name of the property to get
|
|
|
|
|
|
<!-- ##### MACRO gst_caps_get_string ##### -->
|
|
<para>
|
|
Get the value of the named property as a string.
|
|
</para>
|
|
|
|
@caps: the caps to query
|
|
@name: the name of the property to get
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_save_thyself ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@caps:
|
|
@parent:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_caps_load_thyself ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent:
|
|
@Returns:
|
|
|
|
|