mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-15 22:01:27 +00:00
109 lines
2.5 KiB
Text
109 lines
2.5 KiB
Text
<!-- ##### SECTION Title ##### -->
|
|
Gstreamer
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
Media library supporting arbitrary formats and filter graphs.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
GStreamer is a framework for constructing graphs of various filters
|
|
(termed elements here) that will handle streaming media. Any discreet
|
|
(packetizable) media type is supported, with provisions for automatically
|
|
determining source type. Metadata can be passed with all data to provide
|
|
formatting/framing information. Plugins are heavily used to provide for
|
|
all elements, allowing one to construct plugins outside of the GST
|
|
library, even released binary-only if license require (please don't).
|
|
</para>
|
|
|
|
<para>
|
|
GStreamer borrows heavily from both the <ulink
|
|
url="http://www.cse.ogi.edu/sysl/">OGI media pipeline</ulink> and
|
|
Microsoft's DirectShow, hopefully taking the best of both and leaving the
|
|
cruft behind. Its interface is still very fluid (I've redesigned the
|
|
metadata handling twice already), and thus can be changed to increase the
|
|
sanity/noise ratio.
|
|
</para>
|
|
|
|
<para>
|
|
The <application>GStreamer</application> library should be initialized with gst_init() before
|
|
it can be used. You should pass a pointer to the main argc and argv variables so that GStreamer can
|
|
process its own command line options, as shown in the following example.
|
|
|
|
<programlisting>
|
|
int
|
|
main (int argc, char *argv[])
|
|
{
|
|
// initialize the GStreamer library
|
|
gst_init (&argc, &argv);
|
|
...
|
|
}
|
|
</programlisting>
|
|
</para>
|
|
<para>
|
|
Use gst_version() to query the library version at runtime or use the GST_VERSION_* macros
|
|
to find the version at compile time.
|
|
</para>
|
|
<para>
|
|
gst_main() and gst_main_quit() enter and exit the main loop.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
Check out both <ulink url="http://www.cse.ogi.edu/sysl/">OGI's
|
|
pipeline</ulink> and Microsoft's DirectShow for some background.
|
|
</para>
|
|
|
|
<!-- ##### FUNCTION gst_init ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@argc:
|
|
@argv:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_version ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@major:
|
|
@minor:
|
|
@micro:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_main ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_main_quit ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_VERSION_MAJOR ##### -->
|
|
<para>
|
|
The major version of GStreamer at compile time
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_VERSION_MINOR ##### -->
|
|
<para>
|
|
The minor version of GStreamer at compile time
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_VERSION_MICRO ##### -->
|
|
<para>
|
|
The micro version of GStreamer at compile time
|
|
</para>
|
|
|
|
|
|
|