/* 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_THREADSAFE,
	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;

typedef void (*GstPlayTimeoutAdd) (guint interval, GSourceFunc function, gpointer data);
typedef void (*GstPlayIdleAdd)    (GSourceFunc function, gpointer data);

struct _GstPlay
{
	GObject parent;
	
	gboolean (*setup_pipeline)     (GstPlay *play, GError **error);
	void (*teardown_pipeline)  (GstPlay *play);
	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;
};

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);

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 */