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

audiocdsrc: mention TOCs in docs

Browse source
This commit is contained in:
Tim-Philipp Müller 2012-10-17 19:59:57 +01:00
parent 224fb90469
commit 3ee2ad255b
2 changed files with 21 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
gst-libs/gst/audio/gstaudiocdsrc.c
View file

@ -38,12 +38,12 @@
* SECTION:gstaudiocdsrc
* @short_description: Base class for Audio CD sources
*
* <refsect2>
* <para>
* Provides a base class for CD digital audio (CDDA) sources, which handles
* things like seeking, querying, discid calculation, tags, and buffer
* timestamping.
* </para>
* <refsect2>
* <title>Using GstAudioCdSrc-based elements in applications</title>
* <para>
* GstAudioCdSrc registers two #GstFormat<!-- -->s of its own, namely
@ -70,6 +70,8 @@
* setting a new cdda://n+1 URI on playbin (as setting a new URI on playbin
* involves closing and re-opening the CD device, which is much much slower).
* </para>
* <refsect2>
* </refsect2>
* <title>Tags and meta-information</title>
* <para>
* CDDA sources will automatically emit a number of tags, details about which
@ -79,6 +81,17 @@
* among others.
* </para>
* </refsect2>
* <refsect2>
* <title>Tracks and Table of Contents (TOC)</title>
* <para>
* Applications will be informed of the available tracks via a TOC message
* on the pipeline's #GstBus. The #GstToc will contain a #GstTocEntry for
* each track, with information about each track. The duration for each
* track can be retrieved via the #GST_TAG_DURATION tag from each entry's
* tag list, or calculated via gst_toc_entry_get_start_stop_times().
* The track entries in the TOC will be sorted by track number.
* </para>
* </refsect2>
*/
#ifdef HAVE_CONFIG_H

18
gst-libs/gst/audio/gstaudiocdsrc.h
View file

@ -61,7 +61,14 @@ typedef enum {
* @tags: Track-specific tags (e.g. from cd-text information), or NULL
*
* CD track abstraction to communicate TOC entries to the base class.
*
* This structure is only for use by sub-classed in connection with
* gst_audio_cd_src_add_track().
*
* Applications will be informed of the available tracks via a TOC message
* on the pipeline's #GstBus instead.
*/
/* FIXME 2.0: remove this struct and pass values directly to _add_track() */
struct _GstAudioCdSrcTrack {
gboolean is_audio; /* TRUE if this is an audio track */
guint num; /* real track number (usually starts from 1) */
@ -128,17 +135,6 @@ GType gst_audio_cd_src_mode_get_type (void);
gboolean gst_audio_cd_src_add_track (GstAudioCdSrc * src,
GstAudioCdSrcTrack * track);
#if 0
/*
* GST_TAG_CDDA_TRACK_TAGS:
*
* Tag details for all available tracks
* FiXME: find out which type we want for this!
*/
#define GST_TAG_CDDA_TRACK_TAGS "track-tags"
#endif
G_END_DECLS
#endif /* __GST_AUDIO_CD_SRC_H__ */