mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-12-24 01:00:37 +00:00
Code Issues 1 Projects Releases Wiki Activity

flacparse: add documentation

Browse source
This commit is contained in:
Mark Nauwelaerts 2010-01-05 14:48:49 +01:00
parent 59855f35a7
commit d517e1c034
5 changed files with 50 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
docs/plugins/Makefile.am
View file

@ -126,6 +126,7 @@ EXTRA_HFILES = \
$(top_srcdir)/gst/aiff/aiffmux.h \
$(top_srcdir)/gst/audioparsers/gstaacparse.h \
$(top_srcdir)/gst/audioparsers/gstamrparse.h \
$(top_srcdir)/gst/audioparsers/gstflacparse.h \
$(top_srcdir)/gst/autoconvert/gstautoconvert.h \
$(top_srcdir)/gst/camerabin/gstcamerabin.h \
$(top_srcdir)/gst/dccp/gstdccpclientsink.h \

1
docs/plugins/gst-plugins-bad-plugins-docs.sgml
View file

@ -42,6 +42,7 @@
<xi:include href="xml/element-dvdspu.xml" />
<xi:include href="xml/element-faac.xml" />
<xi:include href="xml/element-festival.xml" />
<xi:include href="xml/element-flacparse.xml" />
<xi:include href="xml/element-fpsdisplaysink.xml" />
<xi:include href="xml/element-input-selector.xml" />
<xi:include href="xml/element-ivorbisdec.xml" />

14
docs/plugins/gst-plugins-bad-plugins-sections.txt
View file

@ -407,6 +407,20 @@ FESTIVAL_DEFAULT_SERVER_PORT
FESTIVAL_DEFAULT_TEXT_MODE
</SECTION>
<SECTION>
<FILE>element-flacparse</FILE>
<TITLE>flacparse</TITLE>
GstFlacParse
<SUBSECTION Standard>
GstFlacParseClass
GST_FLAC_PARSE
GST_FLAC_PARSE_CLASS
GST_IS_FLAC_PARSE
GST_IS_FLAC_PARSE_CLASS
GST_TYPE_FLAC_PARSE
gst_flac_parse_get_type
</SECTION>
<SECTION>
<FILE>element-fpsdisplaysink</FILE>
<TITLE>fpsdisplaysink</TITLE>

31
gst/audioparsers/gstflacparse.c
View file

@ -1,6 +1,9 @@
/* GStreamer
*
* Copyright (C) 2008 Sebastian Dröge <sebastian.droege@collabora.co.uk>.
* Copyright (C) 2009 Mark Nauwelaerts <mark.nauwelaerts@collabora.co.uk>
* Copyright (C) 2009 Nokia Corporation. All rights reserved.
* Contact: Stefan Kost <stefan.kost@nokia.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
@ -18,6 +21,34 @@
* Boston, MA 02111-1307, USA.
*/
/**
* SECTION:element-flacparse
* @see_also: flacdec, oggdemux, vorbisparse
*
* The flacparse element will parse the header packets of the FLAC
* stream and put them as the streamheader in the caps. This is used in the
* multifdsink case where you want to stream live FLAC streams to multiple
* clients, each client has to receive the streamheaders first before they can
* consume the FLAC packets.
*
* This element also makes sure that the buffers that it pushes out are properly
* timestamped and that their offset and offset_end are set. The buffers that
* flacparse outputs have all of the metadata that oggmux expects to receive,
* which allows you to (for example) remux an ogg/flac or convert a native FLAC
* format file to an ogg bitstream.
*
* <refsect2>
* <title>Example pipelines</title>
* |[
* gst-launch -v filesrc location=sine.flac ! flacparse ! identity \
* ! oggmux ! filesink location=sine-remuxed.ogg
* ]| This pipeline converts a native FLAC format file to an ogg bitstream.
* It also illustrates that the streamheader is set in the caps, and that each
* buffer has the timestamp, duration, offset, and offset_end set.
* </refsect2>
*
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

3
gst/audioparsers/gstflacparse.h
View file

@ -1,6 +1,9 @@
/* GStreamer
*
* Copyright (C) 2008 Sebastian Dröge <sebastian.droege@collabora.co.uk>.
* Copyright (C) 2009 Mark Nauwelaerts <mark.nauwelaerts@collabora.co.uk>
* Copyright (C) 2009 Nokia Corporation. All rights reserved.
* Contact: Stefan Kost <stefan.kost@nokia.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public