mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-28 12:41:05 +00:00
140 lines
5.3 KiB
C
140 lines
5.3 KiB
C
/* GStreamer
|
|
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
|
|
* 2000 Wim Taymans <wtay@chello.be>
|
|
* 2005 Wim Taymans <wim@fluendo.com>
|
|
*
|
|
* gstbasesrc.h:
|
|
*
|
|
* 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_BASESRC_H__
|
|
#define __GST_BASESRC_H__
|
|
|
|
#include <gst/gst.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GST_TYPE_BASESRC (gst_basesrc_get_type())
|
|
#define GST_BASESRC(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_BASESRC,GstBaseSrc))
|
|
#define GST_BASESRC_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_BASESRC,GstBaseSrcClass))
|
|
#define GST_BASESRC_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_BASESRC, GstBaseSrcClass))
|
|
#define GST_IS_BASESRC(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_BASESRC))
|
|
#define GST_IS_BASESRC_CLASS(obj) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_BASESRC))
|
|
|
|
typedef enum {
|
|
GST_BASESRC_STARTED = GST_ELEMENT_FLAG_LAST,
|
|
|
|
GST_BASESRC_FLAG_LAST = GST_ELEMENT_FLAG_LAST + 2
|
|
} GstBaseSrcFlags;
|
|
|
|
/* base class for random access sources
|
|
*
|
|
* This class is mostly usefull for elements that do byte based
|
|
* access to a random access resource, like files.
|
|
*
|
|
* Seeking, flushing, scheduling and sync is all handled by this
|
|
* base class.
|
|
*/
|
|
typedef struct _GstBaseSrc GstBaseSrc;
|
|
typedef struct _GstBaseSrcClass GstBaseSrcClass;
|
|
|
|
#define GST_BASESRC_PAD(obj) (GST_BASESRC (obj)->srcpad)
|
|
|
|
#define GST_LIVE_GET_LOCK(elem) (GST_BASESRC(elem)->live_lock)
|
|
#define GST_LIVE_LOCK(elem) g_mutex_lock(GST_LIVE_GET_LOCK(elem))
|
|
#define GST_LIVE_TRYLOCK(elem) g_mutex_trylock(GST_LIVE_GET_LOCK(elem))
|
|
#define GST_LIVE_UNLOCK(elem) g_mutex_unlock(GST_LIVE_GET_LOCK(elem))
|
|
#define GST_LIVE_GET_COND(elem) (GST_BASESRC(elem)->live_cond)
|
|
#define GST_LIVE_WAIT(elem) g_cond_wait (GST_LIVE_GET_COND (elem), GST_LIVE_GET_LOCK (elem))
|
|
#define GST_LIVE_TIMED_WAIT(elem, timeval) g_cond_timed_wait (GST_LIVE_GET_COND (elem), GST_LIVE_GET_LOCK (elem),\
|
|
timeval)
|
|
#define GST_LIVE_SIGNAL(elem) g_cond_signal (GST_LIVE_GET_COND (elem));
|
|
#define GST_LIVE_BROADCAST(elem) g_cond_broadcast (GST_LIVE_GET_COND (elem));
|
|
|
|
|
|
struct _GstBaseSrc {
|
|
GstElement element;
|
|
|
|
GstPad *srcpad;
|
|
|
|
/*< protected >*/ /* with LIVE_LOCK */
|
|
GMutex *live_lock;
|
|
GCond *live_cond;
|
|
gboolean is_live;
|
|
gboolean live_running;
|
|
/*< protected >*/ /* with LOCK */
|
|
gint blocksize; /* size of buffers when operating push based */
|
|
gboolean has_loop; /* some scheduling properties */
|
|
gboolean has_getrange;
|
|
gboolean seekable;
|
|
gboolean random_access;
|
|
|
|
GstClockID clock_id; /* for syncing */
|
|
GstClockTime end_time;
|
|
|
|
/* with STREAM_LOCK */
|
|
gint64 segment_start; /* start and end positions for seeking */
|
|
gint64 segment_end;
|
|
gboolean segment_loop;
|
|
|
|
guint64 offset; /* current offset in the resource */
|
|
guint64 size; /* total size of the resource */
|
|
};
|
|
|
|
struct _GstBaseSrcClass {
|
|
GstElementClass parent_class;
|
|
|
|
/*< public >*/
|
|
/* get caps from subclass */
|
|
GstCaps* (*get_caps) (GstBaseSrc *src);
|
|
/* notify the subclass of new caps */
|
|
gboolean (*set_caps) (GstBaseSrc *src, GstCaps *caps);
|
|
|
|
/* start and stop processing, ideal for opening/closing the resource */
|
|
gboolean (*start) (GstBaseSrc *src);
|
|
gboolean (*stop) (GstBaseSrc *src);
|
|
|
|
/* given a buffer, return start and stop time when it should be pushed
|
|
* out. The base class will sync on the clock using these times. */
|
|
void (*get_times) (GstBaseSrc *src, GstBuffer *buffer,
|
|
GstClockTime *start, GstClockTime *end);
|
|
|
|
/* get the total size of the resource in bytes */
|
|
gboolean (*get_size) (GstBaseSrc *src, guint64 *size);
|
|
|
|
/* check if the resource is seekable */
|
|
gboolean (*is_seekable) (GstBaseSrc *src);
|
|
/* unlock any pending access to the resource. subclasses should unlock
|
|
* any function ASAP. */
|
|
gboolean (*unlock) (GstBaseSrc *src);
|
|
|
|
/* notify subclasses of an event */
|
|
gboolean (*event) (GstBaseSrc *src, GstEvent *event);
|
|
|
|
/* ask the subclass to create a buffer with offset and size */
|
|
GstFlowReturn (*create) (GstBaseSrc *src, guint64 offset, guint size,
|
|
GstBuffer **buf);
|
|
};
|
|
|
|
GType gst_basesrc_get_type(void);
|
|
|
|
void gst_basesrc_set_live (GstBaseSrc *src, gboolean live);
|
|
gboolean gst_basesrc_is_live (GstBaseSrc *src);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GST_BASESRC_H__ */
|