gstreamer/docs/gst/tmpl/gstformat.sgml
Andy Wingo ad1970eae2 tools/gst-typefind.c: Update, add copyright block.
Original commit message from CVS:
2005-07-15  Andy Wingo  <wingo@pobox.com>

* tools/gst-typefind.c: Update, add copyright block.

* gst/base/gstbasesrc.c (gst_base_src_default_negotiate):
Normalize and truncate caps before fixation.

* gst/gstcaps.h:
* gst/gstcaps.c (gst_caps_truncate): New function, destructively
discards all but the first structure from its argument.
2005-07-15 11:04:18 +00:00

105 lines
1.9 KiB
Text

<!-- ##### SECTION Title ##### -->
GstFormat
<!-- ##### SECTION Short_Description ##### -->
Dynamically register new formats
<!-- ##### SECTION Long_Description ##### -->
<para>
GstFormats functions are used to register a new format to the gstreamer core.
formats can be used to perform seeking or conversions/query operations.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GstPad, #GstElement
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### ENUM GstFormat ##### -->
<para>
Standard predefined formats
</para>
@GST_FORMAT_UNDEFINED: undefined format
@GST_FORMAT_DEFAULT: the default format of the pad/element
@GST_FORMAT_BYTES: bytes
@GST_FORMAT_TIME: time in nanoseconds
@GST_FORMAT_BUFFERS: buffers
@GST_FORMAT_PERCENT: percentage of stream
<!-- ##### MACRO GST_FORMAT_PERCENT_MAX ##### -->
<para>
The PERCENT format is between 0 and this value
</para>
<!-- ##### MACRO GST_FORMAT_PERCENT_SCALE ##### -->
<para>
The value used to scale down the reported PERCENT format value to
its real value.
</para>
<!-- ##### STRUCT GstFormatDefinition ##### -->
<para>
A format definition
</para>
@value: The unique id of this format
@nick: A short nick of the format
@description: A longer description of the format
<!-- ##### MACRO GST_FORMATS_FUNCTION ##### -->
<para>
A convenience function to define a function that returns an array
of formats.
</para>
@type: The type of the first argument of the function
@functionname: The name of the function
@...: comma separated list of functions closed with 0
<!-- ##### FUNCTION gst_format_register ##### -->
<para>
</para>
@nick:
@description:
@Returns:
<!-- ##### FUNCTION gst_format_get_by_nick ##### -->
<para>
</para>
@nick:
@Returns:
<!-- ##### FUNCTION gst_formats_contains ##### -->
<para>
</para>
@formats:
@format:
@Returns:
<!-- ##### FUNCTION gst_format_get_details ##### -->
<para>
</para>
@format:
@Returns: