FaSTTUBe/GST-Tensordecoder-ov_ep
37
0
Fork 0
Code Issues Pull Requests 1 Actions Packages 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 * SECTION:gstaudiocdsrc
* @short_description: Base class for Audio CD sources * @short_description: Base class for Audio CD sources
* *
* <refsect2>
* <para> * <para>
* Provides a base class for CD digital audio (CDDA) sources, which handles * Provides a base class for CD digital audio (CDDA) sources, which handles
* things like seeking, querying, discid calculation, tags, and buffer * things like seeking, querying, discid calculation, tags, and buffer
* timestamping. * timestamping.
* </para> * </para>
* <refsect2>
* <title>Using GstAudioCdSrc-based elements in applications</title> * <title>Using GstAudioCdSrc-based elements in applications</title>
* <para> * <para>
* GstAudioCdSrc registers two #GstFormat<!-- -->s of its own, namely * 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 * 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). * involves closing and re-opening the CD device, which is much much slower).
* </para> * </para>
* <refsect2>
* </refsect2>
* <title>Tags and meta-information</title> * <title>Tags and meta-information</title>
* <para> * <para>
* CDDA sources will automatically emit a number of tags, details about which * CDDA sources will automatically emit a number of tags, details about which
@ -79,6 +81,17 @@
* among others. * among others.
* </para> * </para>
* </refsect2> * </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 #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 * @tags: Track-specific tags (e.g. from cd-text information), or NULL
* *
* CD track abstraction to communicate TOC entries to the base class. * 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 { struct _GstAudioCdSrcTrack {
gboolean is_audio; /* TRUE if this is an audio track */ gboolean is_audio; /* TRUE if this is an audio track */
guint num; /* real track number (usually starts from 1) */ 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, gboolean gst_audio_cd_src_add_track (GstAudioCdSrc * src,
GstAudioCdSrcTrack * track); 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 G_END_DECLS
#endif /* __GST_AUDIO_CD_SRC_H__ */ #endif /* __GST_AUDIO_CD_SRC_H__ */