mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-24 09:10:36 +00:00
efcf227524
Original commit message from CVS: gst_play_get_sink_element has been improved : - Recursively searches in bins - Able to find sink_element of a specified GstPlaySinkType (audio,video,any) This now allow us to send very complex bins to GstPlay for audio/video sink without breaking length querying, eos signaling, etc..
232 lines
6.1 KiB
C
232 lines
6.1 KiB
C
/* 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>
|
|
* 2003 Julien Moutte <julien@moutte.net>
|
|
*
|
|
* 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;
|
|
|
|
typedef enum {
|
|
GST_PLAY_SINK_TYPE_AUDIO,
|
|
GST_PLAY_SINK_TYPE_VIDEO,
|
|
GST_PLAY_SINK_TYPE_ANY,
|
|
} GstPlaySinkType;
|
|
|
|
#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;
|
|
|
|
typedef guint (*GstPlayTimeoutAdd) ( guint interval,
|
|
GSourceFunc function,
|
|
gpointer data);
|
|
typedef guint (*GstPlayIdleAdd) (GSourceFunc function, gpointer data);
|
|
|
|
struct _GstPlay
|
|
{
|
|
GObject parent;
|
|
|
|
gboolean (*setup_pipeline) (GstPlay *play, GError **error);
|
|
void (*teardown_pipeline) (GstPlay *play);
|
|
gboolean (*set_data_src) (GstPlay *play, GstElement *datasrc);
|
|
gboolean (*set_autoplugger) (GstPlay *play, GstElement *autoplugger);
|
|
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;
|
|
|
|
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;
|
|
};
|
|
|
|
|
|
void
|
|
gst_play_seek_to_time ( GstPlay *play,
|
|
gint64 time_nanos);
|
|
|
|
void
|
|
gst_play_need_new_video_window (GstPlay *play);
|
|
|
|
void
|
|
gst_play_set_idle_timeout_funcs ( GstPlay *play,
|
|
GstPlayTimeoutAdd timeout_add_func,
|
|
GstPlayIdleAdd idle_add_func);
|
|
GstElement*
|
|
gst_play_get_sink_element ( GstPlay *play,
|
|
GstElement *element,
|
|
GstPlaySinkType sink_type);
|
|
|
|
/* Set/Get state */
|
|
|
|
GstElementStateReturn
|
|
gst_play_set_state ( GstPlay *play,
|
|
GstElementState state);
|
|
GstElementState
|
|
gst_play_get_state (GstPlay *play);
|
|
|
|
/* Set/Get location */
|
|
|
|
gboolean
|
|
gst_play_set_location ( GstPlay *play,
|
|
const gchar *location);
|
|
gchar*
|
|
gst_play_get_location (GstPlay *play);
|
|
|
|
/* Set/Get volume */
|
|
|
|
void
|
|
gst_play_set_volume ( GstPlay *play,
|
|
gfloat volume);
|
|
gfloat
|
|
gst_play_get_volume (GstPlay *play);
|
|
|
|
/* Set/Get mute */
|
|
|
|
void
|
|
gst_play_set_mute ( GstPlay *play,
|
|
gboolean mute);
|
|
gboolean
|
|
gst_play_get_mute (GstPlay *play);
|
|
|
|
/* Set sinks and data src */
|
|
|
|
gboolean
|
|
gst_play_set_data_src ( GstPlay *play,
|
|
GstElement *data_src);
|
|
gboolean
|
|
gst_play_set_video_sink ( GstPlay *play,
|
|
GstElement *video_sink);
|
|
gboolean
|
|
gst_play_set_audio_sink ( GstPlay *play,
|
|
GstElement *audio_sink);
|
|
|
|
GType
|
|
gst_play_get_type (void);
|
|
|
|
GstPlay *
|
|
gst_play_new ( GstPlayPipeType pipe_type,
|
|
GError **error);
|
|
|
|
#endif /* __GSTPLAY_H__ */
|