blob: 23767acbd55ed07d037af43698e1ebdae620f92f [file] [log] [blame]
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY % version-entities SYSTEM "version.entities">
%version-entities;
]>
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo>
<title>GStreamer Base Plugins &GST_API_VERSION; Library Reference Manual</title>
<releaseinfo>
for GStreamer Base Library &GST_API_VERSION; (&GST_VERSION;)
<ulink role="online-location" url="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/">http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/</ulink>.
</releaseinfo>
</bookinfo>
<part id="gstreamer-plugins-base">
<title>GStreamer Base Plugins Libraries</title>
<para>
This manual describes the libraries provided by the GStreamer Base Plugins
package.
</para>
<xi:include href="compiling.sgml" />
<chapter id="gstreamer-allocators">
<title>Allocators Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstallocators-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstdmabuf.xml" />
<xi:include href="xml/gstfdmemory.xml" />
<xi:include href="xml/gstphysmemoryallocator.xml" />
</chapter>
<chapter id="gstreamer-app">
<title>App Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstapp-&GST_API_VERSION;</filename> to the library flags.
</para>
<para>
To use it the functionality, insert an appsrc or appsink element into a pipeline and call the appropriate functions on the element.
</para>
<xi:include href="xml/gstappsrc.xml" />
<xi:include href="xml/gstappsink.xml" />
</chapter>
<chapter id="gstreamer-audio">
<title>Audio Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstaudio-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstaudio.xml" />
<xi:include href="xml/gstaudiometa.xml" />
<xi:include href="xml/gstaudioaggregator.xml" />
<xi:include href="xml/gstaudiocdsrc.xml" />
<xi:include href="xml/gstaudioclock.xml" />
<xi:include href="xml/gstaudiodecoder.xml" />
<xi:include href="xml/gstaudioencoder.xml" />
<xi:include href="xml/gstaudiofilter.xml" />
<xi:include href="xml/gstaudiosink.xml" />
<xi:include href="xml/gstaudiosrc.xml" />
<xi:include href="xml/gstaudiobasesink.xml" />
<xi:include href="xml/gstaudiobasesrc.xml" />
<xi:include href="xml/gstaudiochannels.xml" />
<xi:include href="xml/gstaudioconverter.xml" />
<xi:include href="xml/gstaudioquantize.xml" />
<xi:include href="xml/gstaudioringbuffer.xml" />
<xi:include href="xml/gstaudioiec61937.xml" />
<xi:include href="xml/gststreamvolume.xml" />
</chapter>
<chapter id="gstreamer-ffft">
<title>FFT Library</title>
<para>
The gstfft library is based on
<ulink role="online-location" url="http://sourceforge.net/projects/kissfft">kissfft</ulink>
by Mark Borgerding.
</para>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstfft-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstfft.xml" />
<xi:include href="xml/gstffts16.xml" />
<xi:include href="xml/gstffts32.xml" />
<xi:include href="xml/gstfftf32.xml" />
<xi:include href="xml/gstfftf64.xml" />
</chapter>
<chapter id="gstreamer-riff">
<title>Riff Media Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstriff-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstriff.xml" />
</chapter>
<chapter id="gstreamer-rtp">
<title>RTP Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstrtp-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstrtpbaseaudiopayload.xml" />
<xi:include href="xml/gstrtpbasedepayload.xml" />
<xi:include href="xml/gstrtpbasepayload.xml" />
<xi:include href="xml/gstrtpbuffer.xml" />
<xi:include href="xml/gstrtcpbuffer.xml" />
<xi:include href="xml/gstrtppayloads.xml" />
<xi:include href="xml/gstrtphdrext.xml" />
</chapter>
<chapter id="gstreamer-rtsp">
<title>RTSP Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstrtsp-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstrtspconnection.xml" />
<xi:include href="xml/gstrtspdefs.xml" />
<xi:include href="xml/gstrtspextension.xml" />
<xi:include href="xml/gstrtspmessage.xml" />
<xi:include href="xml/gstrtsprange.xml" />
<xi:include href="xml/gstrtsptransport.xml" />
<xi:include href="xml/gstrtspurl.xml" />
</chapter>
<chapter id="gstreamer-sdp">
<title>SDP Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstsdp-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstsdpmessage.xml" />
</chapter>
<chapter id="gstreamer-mikey">
<title>MIKEY Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstsdp-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstmikey.xml" />
</chapter>
<chapter id="gstreamer-tag">
<title>Tag Support Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgsttag-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gsttag.xml" />
<xi:include href="xml/gsttagvorbis.xml" />
<xi:include href="xml/gsttagid3.xml" />
<xi:include href="xml/gsttagexif.xml" />
<xi:include href="xml/gsttagxmp.xml" />
<xi:include href="xml/gsttagxmpwriter.xml" />
<xi:include href="xml/gsttagdemux.xml" />
<xi:include href="xml/gsttagmux.xml" />
<xi:include href="xml/gsttaglanguagecodes.xml" />
<xi:include href="xml/gsttaglicenses.xml" />
</chapter>
<chapter id="gstreamer-base-utils">
<title>Base Utils Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstpbutils-&GST_API_VERSION;</filename> to the library
flags.
</para>
<xi:include href="xml/gstpbutils.xml" />
<xi:include href="xml/gstpluginsbaseversion.xml" />
<xi:include href="xml/gstpbutilscodecutils.xml" />
<xi:include href="xml/gstpbutilsdescriptions.xml" />
<xi:include href="xml/gstpbutilsmissingplugins.xml" />
<xi:include href="xml/gstpbutilsinstallplugins.xml" />
<xi:include href="xml/gstdiscoverer.xml" />
<xi:include href="xml/encoding-profile.xml" />
</chapter>
<chapter id="gstreamer-video">
<title>Video Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
<filename>-lgstvideo-&GST_API_VERSION;</filename> to the library flags.
</para>
<xi:include href="xml/gstvideo.xml" />
<xi:include href="xml/gstvideometa.xml" />
<xi:include href="xml/gstvideoaffinetransformationmeta.xml" />
<xi:include href="xml/gstvideooverlaycomposition.xml" />
<xi:include href="xml/gstvideofilter.xml" />
<xi:include href="xml/gstvideodither.xml" />
<xi:include href="xml/gstvideochroma.xml" />
<xi:include href="xml/gstvideoresampler.xml" />
<xi:include href="xml/gstvideoscaler.xml" />
<xi:include href="xml/gstvideosink.xml" />
<xi:include href="xml/gstcolorbalance.xml" />
<xi:include href="xml/gstcolorbalancechannel.xml" />
<xi:include href="xml/gstvideodirection.xml" />
<xi:include href="xml/gstvideoorientation.xml" />
<xi:include href="xml/gstvideooverlay.xml" />
<xi:include href="xml/gstvideodecoder.xml" />
<xi:include href="xml/gstvideoencoder.xml" />
<xi:include href="xml/gstvideopool.xml" />
<xi:include href="xml/gstvideoutils.xml" />
<xi:include href="xml/gstnavigation.xml" />
</chapter>
<chapter id="gl">
<title>OpenGL Integration Library</title>
<para>
This library should be linked to by getting cflags and libs from
<filename>gstreamer-gl-&GST_API_VERSION;.pc</filename>
</para>
<xi:include href="xml/gstglapi.xml"/>
<xi:include href="xml/gstglbasefilter.xml"/>
<xi:include href="xml/gstglbasememory.xml"/>
<xi:include href="xml/gstglbuffer.xml"/>
<xi:include href="xml/gstglbufferpool.xml"/>
<xi:include href="xml/gstglcolorconvert.xml"/>
<xi:include href="xml/gstglcontext.xml"/>
<!-- Not exposed as public API
<xi:include href="xml/gstglcontextcocoa.xml"/>
<xi:include href="xml/gstglcontexteagl.xml"/>
<xi:include href="xml/gstglcontextegl.xml"/>
<xi:include href="xml/gstglcontextglx.xml"/>
<xi:include href="xml/gstglcontextwgl.xml"/>
-->
<xi:include href="xml/gstgldisplay.xml"/>
<!-- Not exposed as public API
<xi:include href="xml/gstgldisplaycocoa.xml"/>
<xi:include href="xml/gstgldisplayegl.xml"/>
-->
<xi:include href="xml/gstgldisplaywayland.xml"/>
<xi:include href="xml/gstgldisplayx11.xml"/>
<xi:include href="xml/gsteglimage.xml"/>
<xi:include href="xml/gstglfilter.xml"/>
<xi:include href="xml/gstglframebuffer.xml"/>
<xi:include href="xml/gstglmemory.xml"/>
<xi:include href="xml/gstglmemoryegl.xml"/>
<xi:include href="xml/gstglmemorypbo.xml"/>
<xi:include href="xml/gstgloverlaycompositor.xml"/>
<xi:include href="xml/gstglquery.xml"/>
<xi:include href="xml/gstglrenderbuffer.xml"/>
<xi:include href="xml/gstglshader.xml"/>
<xi:include href="xml/gstglsl.xml"/>
<xi:include href="xml/gstglslstage.xml"/>
<xi:include href="xml/gstglsyncmeta.xml"/>
<xi:include href="xml/gstglupload.xml"/>
<xi:include href="xml/gstglviewconvert.xml"/>
<xi:include href="xml/gstglwindow.xml"/>
<!-- Not exposed as public API
<xi:include href="xml/gstglwindowandroid.xml"/>
<xi:include href="xml/gstglwindowcocoa.xml"/>
<xi:include href="xml/gstglwindowdispmanx.xml"/>
<xi:include href="xml/gstglwindoweagl.xml"/>
<xi:include href="xml/gstglwindowwayland.xml"/>
<xi:include href="xml/gstglwindowwin32.xml"/>
<xi:include href="xml/gstglwindowx11.xml"/>
-->
<!-- Some utilities -->
<xi:include href="xml/gstgldebug.xml"/>
<xi:include href="xml/gstglformat.xml"/>
<xi:include href="xml/gstglutils.xml"/>
</chapter>
</part>
<part id="gstreamer-libs-hierarchy">
<title>Object Hierarchy</title>
<xi:include href="xml/tree_index.sgml" />
</part>
<index id="api-index-full">
<title>Index</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index>
<index id="api-index-deprecated" role="deprecated">
<title>Index of deprecated API</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.14</title>
<xi:include href="xml/api-index-1.14.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.12</title>
<xi:include href="xml/api-index-1.12.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.10</title>
<xi:include href="xml/api-index-1.10.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.8.1</title>
<xi:include href="xml/api-index-1.8.1.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.8</title>
<xi:include href="xml/api-index-1.8.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.6.1</title>
<xi:include href="xml/api-index-1.6.1.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.6</title>
<xi:include href="xml/api-index-1.6.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.4</title>
<xi:include href="xml/api-index-1.4.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.2.2</title>
<xi:include href="xml/api-index-1.2.2.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.2.1</title>
<xi:include href="xml/api-index-1.2.1.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.2</title>
<xi:include href="xml/api-index-1.2.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.0.3</title>
<xi:include href="xml/api-index-1.0.3.xml"><xi:fallback /></xi:include>
</index>
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
</book>