2002-10-27 20:59:41 +00:00
|
|
|
/* GStreamer
|
|
|
|
* Copyright (C) 1999,2000,2001,2002 Erik Walthinsen <omega@cse.ogi.edu>
|
|
|
|
* 2000,2001,2002 Wim Taymans <wtay@chello.be>
|
|
|
|
* 2002 Steve Baker <steve@stevebaker.org>
|
|
|
|
*
|
|
|
|
* play.h: GstPlay object code
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* 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 __GSTPLAY_H__
|
|
|
|
#define __GSTPLAY_H__
|
|
|
|
|
|
|
|
#include <gst/gst.h>
|
|
|
|
#include <gst/control/control.h>
|
|
|
|
|
|
|
|
/*
|
|
|
|
* GstPlay is a simple class for audio and video playback.
|
|
|
|
* It's job is to get the media (supplied by a URI) played.
|
|
|
|
* More specific it should get the media from source to the output elements.
|
|
|
|
* How that is done should not be relevant for developers using this class.
|
|
|
|
* A user using this class should not have to know very much about how
|
|
|
|
* GStreamer works, other than that it plays back media.
|
|
|
|
* Additionally it supplies signals to get information about the current
|
|
|
|
* playing state.
|
|
|
|
*/
|
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
GST_PLAY_OK,
|
|
|
|
GST_PLAY_UNKNOWN_MEDIA,
|
|
|
|
GST_PLAY_CANNOT_PLAY,
|
|
|
|
GST_PLAY_ERROR,
|
|
|
|
} GstPlayReturn;
|
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
GST_PLAY_PIPE_AUDIO,
|
|
|
|
GST_PLAY_PIPE_AUDIO_THREADED,
|
|
|
|
GST_PLAY_PIPE_AUDIO_HYPER_THREADED,
|
|
|
|
GST_PLAY_PIPE_VIDEO,
|
|
|
|
} GstPlayPipeType;
|
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
GST_PLAY_ERROR_FAKESINK,
|
|
|
|
GST_PLAY_ERROR_THREAD,
|
|
|
|
GST_PLAY_ERROR_QUEUE,
|
|
|
|
GST_PLAY_ERROR_GNOMEVFSSRC,
|
|
|
|
GST_PLAY_ERROR_VOLUME,
|
|
|
|
GST_PLAY_ERROR_COLORSPACE,
|
|
|
|
GST_PLAY_ERROR_LAST,
|
|
|
|
} GstPlayError;
|
|
|
|
|
|
|
|
#define GST_PLAY_ERROR gst_play_error_quark ()
|
|
|
|
|
|
|
|
#define GST_TYPE_PLAY (gst_play_get_type())
|
|
|
|
#define GST_PLAY(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_PLAY, GstPlay))
|
|
|
|
#define GST_PLAY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_PLAY, GstPlayClass))
|
|
|
|
#define GST_IS_PLAY(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_PLAY))
|
|
|
|
#define GST_IS_PLAY_CLASS(obj) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_PLAY))
|
|
|
|
#define GST_PLAY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_PLAY, GstPlayClass))
|
|
|
|
|
|
|
|
typedef struct _GstPlay GstPlay;
|
|
|
|
typedef struct _GstPlayClass GstPlayClass;
|
|
|
|
typedef struct _GstPlayIdleData GstPlayIdleData;
|
|
|
|
|
2003-01-07 19:02:44 +00:00
|
|
|
typedef guint (*GstPlayTimeoutAdd) (guint interval, GSourceFunc function, gpointer data);
|
|
|
|
typedef guint (*GstPlayIdleAdd) (GSourceFunc function, gpointer data);
|
2002-10-27 20:59:41 +00:00
|
|
|
|
|
|
|
struct _GstPlay
|
|
|
|
{
|
|
|
|
GObject parent;
|
|
|
|
|
|
|
|
gboolean (*setup_pipeline) (GstPlay *play, GError **error);
|
2003-01-18 04:37:32 +00:00
|
|
|
void (*teardown_pipeline) (GstPlay *play);
|
|
|
|
gboolean (*set_data_src) (GstPlay *play, GstElement *datasrc);
|
|
|
|
gboolean (*set_autoplugger) (GstPlay *play, GstElement *autoplugger);
|
2002-10-27 20:59:41 +00:00
|
|
|
gboolean (*set_video_sink) (GstPlay *play, GstElement *videosink);
|
|
|
|
gboolean (*set_audio_sink) (GstPlay *play, GstElement *audiosink);
|
|
|
|
|
|
|
|
/* core elements */
|
|
|
|
GstElement *pipeline;
|
|
|
|
GstElement *volume;
|
|
|
|
GstElement *source;
|
|
|
|
GstElement *autoplugger;
|
|
|
|
GstElement *video_sink;
|
|
|
|
GstElement *video_sink_element;
|
|
|
|
GstElement *audio_sink;
|
|
|
|
GstElement *audio_sink_element;
|
|
|
|
|
|
|
|
GstDParamManager *vol_dpman;
|
|
|
|
GstDParam *vol_dparam;
|
|
|
|
GHashTable *other_elements;
|
|
|
|
|
|
|
|
GstClock *clock;
|
|
|
|
|
|
|
|
GMutex *audio_bin_mutex;
|
|
|
|
GMutex *video_bin_mutex;
|
|
|
|
|
|
|
|
gboolean need_stream_length;
|
|
|
|
gboolean need_seek;
|
|
|
|
gint time_seconds;
|
|
|
|
gint get_length_attempt;
|
|
|
|
gint64 seek_time;
|
|
|
|
gint64 time_nanos;
|
|
|
|
gint64 length_nanos;
|
2003-01-07 19:02:44 +00:00
|
|
|
|
|
|
|
guint tick_timeout_id;
|
|
|
|
guint idle_timeout_id;
|
|
|
|
guint idle_signal_id;
|
2002-10-27 20:59:41 +00:00
|
|
|
|
|
|
|
GAsyncQueue *signal_queue;
|
|
|
|
|
|
|
|
GstPlayTimeoutAdd timeout_add_func;
|
|
|
|
GstPlayIdleAdd idle_add_func;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct _GstPlayClass
|
|
|
|
{
|
|
|
|
GObjectClass parent_class;
|
|
|
|
|
|
|
|
/* signals */
|
|
|
|
void (*information) (GstPlay* play, GstElement* element, GParamSpec *param);
|
|
|
|
void (*state_changed) (GstPlay* play, GstElementState old_state, GstElementState new_state);
|
|
|
|
void (*stream_end) (GstPlay* play);
|
|
|
|
void (*time_tick) (GstPlay* play, gint64 time_nanos);
|
|
|
|
void (*stream_length) (GstPlay* play, gint64 length_nanos);
|
|
|
|
void (*have_xid) (GstPlay* play, gint xid);
|
|
|
|
void (*have_video_size) (GstPlay* play, gint width, gint height);
|
|
|
|
};
|
|
|
|
|
|
|
|
struct _GstPlayIdleData
|
|
|
|
{
|
|
|
|
GSourceFunc func;
|
|
|
|
gpointer data;
|
|
|
|
};
|
|
|
|
|
|
|
|
GType gst_play_get_type (void);
|
|
|
|
|
|
|
|
GstPlay* gst_play_new (GstPlayPipeType pipe_type, GError **error);
|
|
|
|
|
|
|
|
void gst_play_seek_to_time (GstPlay *play, gint64 time_nanos);
|
|
|
|
|
|
|
|
GstElement* gst_play_get_sink_element (GstPlay *play, GstElement *element);
|
|
|
|
|
2003-01-18 04:37:32 +00:00
|
|
|
gboolean gst_play_set_data_src (GstPlay *play, GstElement *data_src);
|
2002-10-27 20:59:41 +00:00
|
|
|
gboolean gst_play_set_video_sink (GstPlay *play, GstElement *element);
|
|
|
|
gboolean gst_play_set_audio_sink (GstPlay *play, GstElement *element);
|
|
|
|
void gst_play_need_new_video_window (GstPlay *play);
|
|
|
|
|
|
|
|
GstElementStateReturn gst_play_set_state (GstPlay *play, GstElementState state);
|
|
|
|
GstElementState gst_play_get_state (GstPlay *play);
|
|
|
|
|
|
|
|
gboolean gst_play_set_location (GstPlay *play, const gchar *location);
|
|
|
|
gchar* gst_play_get_location (GstPlay *play);
|
|
|
|
|
|
|
|
void gst_play_set_volume (GstPlay *play, gfloat volume);
|
|
|
|
gfloat gst_play_get_volume (GstPlay *play);
|
|
|
|
|
|
|
|
void gst_play_set_mute (GstPlay *play, gboolean mute);
|
|
|
|
gboolean gst_play_get_mute (GstPlay *play);
|
|
|
|
|
|
|
|
void gst_play_set_idle_timeout_funcs (GstPlay *play, GstPlayTimeoutAdd timeout_add_func, GstPlayIdleAdd idle_add_func);
|
|
|
|
|
|
|
|
#endif /* __GSTPLAY_H__ */
|
|
|
|
|
|
|
|
/* modelines */
|
|
|
|
/* vim:set ts=8:sw=8:noet */
|
|
|
|
|