diff -r 000000000000 -r 0e761a78d257 gst_plugins_base/gst-libs/gst/cdda/gstcddabasesrc.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/gst_plugins_base/gst-libs/gst/cdda/gstcddabasesrc.h Thu Dec 17 08:53:32 2009 +0200 @@ -0,0 +1,162 @@ +/* GStreamer + * Copyright (C) 1999 Erik Walthinsen + * Copyright (C) 2005 Tim-Philipp Müller + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the + * Free Software Foundation, Inc., 59 Temple Place - Suite 330, + * Boston, MA 02111-1307, USA. + */ + +#ifndef __GST_CDDA_BASE_SRC_H__ +#define __GST_CDDA_BASE_SRC_H__ + +#include +#include + +/* must include this for backwards-compatibility so the + * GST_TAG_CDDA_* defines are included. Remove in 0.11 */ +#include + +G_BEGIN_DECLS + +#define GST_TYPE_CDDA_BASE_SRC (gst_cdda_base_src_get_type()) +#define GST_CDDA_BASE_SRC(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), GST_TYPE_CDDA_BASE_SRC, GstCddaBaseSrc)) +#define GST_CDDA_BASE_SRC_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), GST_TYPE_CDDA_BASE_SRC, GstCddaBaseSrcClass)) +#define GST_IS_CDDA_BASE_SRC(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), GST_TYPE_CDDA_BASE_SRC)) +#define GST_IS_CDDA_BASE_SRC_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), GST_TYPE_CDDA_BASE_SRC)) +#define GST_CDDA_BASE_SRC_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_CDDA_BASE_SRC, GstCddaBaseSrcClass)) + +typedef struct _GstCddaBaseSrc GstCddaBaseSrc; +typedef struct _GstCddaBaseSrcClass GstCddaBaseSrcClass; +typedef struct _GstCddaBaseSrcTrack GstCddaBaseSrcTrack; + +/** + * GstCddaBaseSrcMode: + * @GST_CDDA_BASE_SRC_MODE_NORMAL : each single track is a stream + * @GST_CDDA_BASE_SRC_MODE_CONTINUOUS : the entire disc is a single stream + * + * Mode in which the CD audio source operates. Influences timestamping, + * EOS handling and seeking. + */ +typedef enum { + GST_CDDA_BASE_SRC_MODE_NORMAL, /* stream = one track */ + GST_CDDA_BASE_SRC_MODE_CONTINUOUS /* stream = whole disc */ +} GstCddaBaseSrcMode; + +/** + * GstCddaBaseSrcTrack: + * @is_audio: Whether this is an audio track + * @num: Track number in TOC (usually starts from 1, but not always) + * @start: The first sector of this track (LBA) + * @end: The last sector of this track (LBA) + * @tags: Track-specific tags (e.g. from cd-text information), or NULL + * + * CD track abstraction to communicate TOC entries to the base class. + */ +struct _GstCddaBaseSrcTrack { + gboolean is_audio; /* TRUE if this is an audio track */ + guint num; /* real track number (usually starts from 1) */ + guint start; /* first sector of track (LBA, not LSN!) */ + guint end; /* last sector of track (LBA, not LSN!) */ + GstTagList *tags; /* NULL or tags for track (e.g. from cd-text) */ + + /*< private >*/ + guint _gst_reserved1[GST_PADDING/2]; + gpointer _gst_reserved2[GST_PADDING/2]; +}; + +struct _GstCddaBaseSrc { + GstPushSrc pushsrc; + + /*< protected >*/ /* for use by sub-classes only */ + GstTagList *tags; /* tags that apply to all tracks */ + + /*< private >*/ + GstCddaBaseSrcMode mode; + + gchar *device; + + guint num_tracks; + guint num_all_tracks; + GstCddaBaseSrcTrack *tracks; + + gint cur_track; /* current track (starting from 0) */ + gint prev_track; /* current track last time */ + gint cur_sector; /* current sector */ + gint seek_sector; /* -1 or sector to seek to */ + + gint uri_track; + gchar *uri; + + guint32 discid; /* cddb disc id (for unit test) */ + gchar mb_discid[32]; /* musicbrainz discid */ + + GstIndex *index; + gint index_id; + + gint toc_offset; + gboolean toc_bias; + + /*< private >*/ + guint _gst_reserved1[GST_PADDING/2]; + gpointer _gst_reserved2[GST_PADDING/2]; +}; + +struct _GstCddaBaseSrcClass { + GstPushSrcClass pushsrc_class; + + /* open/close the CD device */ + gboolean (*open) (GstCddaBaseSrc *src, const gchar *device); + void (*close) (GstCddaBaseSrc *src); + + /* read one sector (LBA) */ + GstBuffer * (*read_sector) (GstCddaBaseSrc *src, gint sector); + + /* return default device or NULL (optional) */ + gchar * (*get_default_device) (GstCddaBaseSrc *src); + + /* return NULL-terminated string array of CD devices, or NULL (optional) */ + gchar ** (*probe_devices) (GstCddaBaseSrc *src); + + /*< private >*/ + gpointer _gst_reserved[GST_PADDING]; +}; +#ifdef __SYMBIAN32__ +IMPORT_C +#endif + + +GType gst_cdda_base_src_get_type (void); +#ifdef __SYMBIAN32__ +IMPORT_C +#endif + + +gboolean gst_cdda_base_src_add_track (GstCddaBaseSrc * src, + GstCddaBaseSrcTrack * 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_CDDA_BASE_SRC_H__ */ +