gstbasesrc.h   gstbasesrc.h 
skipping to change at line 31 skipping to change at line 31
* Boston, MA 02111-1307, USA. * Boston, MA 02111-1307, USA.
*/ */
#ifndef __GST_BASE_SRC_H__ #ifndef __GST_BASE_SRC_H__
#define __GST_BASE_SRC_H__ #define __GST_BASE_SRC_H__
#include <gst/gst.h> #include <gst/gst.h>
G_BEGIN_DECLS G_BEGIN_DECLS
#define GST_TYPE_BASE_SRC (gst_base_src_get_type()) #define GST_TYPE_BASE_SRC (gst_base_src_get_type())
#define GST_BASE_SRC(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GS #define GST_BASE_SRC(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),G
T_TYPE_BASE_SRC,GstBaseSrc)) ST_TYPE_BASE_SRC,GstBaseSrc))
#define GST_BASE_SRC_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST #define GST_BASE_SRC_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GS
_TYPE_BASE_SRC,GstBaseSrcClass)) T_TYPE_BASE_SRC,GstBaseSrcClass))
#define GST_BASE_SRC_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_BASE_SRC, GstBaseSrcClass)) #define GST_BASE_SRC_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_BASE_SRC, GstBaseSrcClass))
#define GST_IS_BASE_SRC(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GS #define GST_IS_BASE_SRC(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),G
T_TYPE_BASE_SRC)) ST_TYPE_BASE_SRC))
#define GST_IS_BASE_SRC_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST #define GST_IS_BASE_SRC_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GS
_TYPE_BASE_SRC)) T_TYPE_BASE_SRC))
#define GST_BASE_SRC_CAST(obj) ((GstBaseSrc *)(obj)) #define GST_BASE_SRC_CAST(obj) ((GstBaseSrc *)(obj))
/** /**
* GstBaseSrcFlags: * GstBaseSrcFlags:
* @GST_BASE_SRC_STARTED: has source been started * @GST_BASE_SRC_STARTED: has source been started
* @GST_BASE_SRC_FLAG_LAST: offset to define more flags * @GST_BASE_SRC_FLAG_LAST: offset to define more flags
* *
* The #GstElement flags that a basesrc element may have. * The #GstElement flags that a basesrc element may have.
*/ */
typedef enum { typedef enum {
GST_BASE_SRC_STARTED = (GST_ELEMENT_FLAG_LAST << 0), GST_BASE_SRC_STARTED = (GST_ELEMENT_FLAG_LAST << 0),
skipping to change at line 66 skipping to change at line 66
/** /**
* GST_BASE_SRC_PAD: * GST_BASE_SRC_PAD:
* @obj: base source instance * @obj: base source instance
* *
* Gives the pointer to the #GstPad object of the element. * Gives the pointer to the #GstPad object of the element.
*/ */
#define GST_BASE_SRC_PAD(obj) (GST_BASE_SRC_CAST (obj)->src pad) #define GST_BASE_SRC_PAD(obj) (GST_BASE_SRC_CAST (obj)->src pad)
/** /**
* GstBaseSrc: * GstBaseSrc:
* @element: the parent element.
* *
* The opaque #GstBaseSrc data structure. * The opaque #GstBaseSrc data structure.
*/ */
struct _GstBaseSrc { struct _GstBaseSrc {
GstElement element; GstElement element;
/*< protected >*/ /*< protected >*/
GstPad *srcpad; GstPad *srcpad;
/* available to subclass implementations */ /* available to subclass implementations */
/* MT-protected (with LIVE_LOCK) */ /* MT-protected (with LIVE_LOCK) */
GMutex *live_lock; GMutex *live_lock;
GCond *live_cond; GCond *live_cond;
gboolean is_live; gboolean is_live;
gboolean live_running; gboolean live_running;
/* MT-protected (with LOCK) */ /* MT-protected (with LOCK) */
gint blocksize; /* size of buffers when operating push based gint blocksize; /* size of buffers when operating push base
*/ d */
gboolean can_activate_push; /* some scheduling properties */ gboolean can_activate_push; /* some scheduling properties */
GstActivateMode pad_mode; GstActivateMode pad_mode;
gboolean seekable; /* not used anymore */ gboolean seekable; /* not used anymore */
gboolean random_access; gboolean random_access;
GstClockID clock_id; /* for syncing */ GstClockID clock_id; /* for syncing */
GstClockTime end_time; GstClockTime end_time;
/* MT-protected (with STREAM_LOCK) */ /* MT-protected (with STREAM_LOCK *and* OBJECT_LOCK) */
GstSegment segment; GstSegment segment;
gboolean need_newsegment; /* MT-protected (with STREAM_LOCK) */
gboolean need_newsegment;
guint64 offset; /* current offset in the resource, unused */ guint64 offset; /* current offset in the resource, unused *
guint64 size; /* total size of the resource, unused */ /
guint64 size; /* total size of the resource, unused */
gint num_buffers; gint num_buffers;
gint num_buffers_left; gint num_buffers_left;
/*< private >*/ /*< private >*/
union { union {
struct { struct {
/* FIXME: those fields should be moved into the private struct */ /* FIXME: those fields should be moved into the private struct */
gboolean typefind; gboolean typefind;
gboolean running; gboolean running;
skipping to change at line 133 skipping to change at line 133
* @newsegment: Generate and send a new_segment event (UNUSED) * @newsegment: Generate and send a new_segment event (UNUSED)
* @start: Start processing. Subclasses should open resources and prepare * @start: Start processing. Subclasses should open resources and prepare
* to produce data. * to produce data.
* @stop: Stop processing. Subclasses should use this to close resources. * @stop: Stop processing. Subclasses should use this to close resources.
* @get_times: Given a buffer, return the start and stop time when it * @get_times: Given a buffer, return the start and stop time when it
* should be pushed out. The base class will sync on the clock using * should be pushed out. The base class will sync on the clock using
* these times. * these times.
* @get_size: Return the total size of the resource, in the configured form at. * @get_size: Return the total size of the resource, in the configured form at.
* @is_seekable: Check if the source can seek * @is_seekable: Check if the source can seek
* @unlock: Unlock any pending access to the resource. Subclasses should * @unlock: Unlock any pending access to the resource. Subclasses should
* unblock any blocked function ASAP * unblock any blocked function ASAP. In particular, any create() functi
on in
* progress should be unblocked and should return GST_FLOW_WRONG_STATE.
Any
* future create() function call should also return GST_FLOW_WRONG_STATE
* until the unlock_stop() function has been called.
* @unlock_stop: Clear the previous unlock request. Subclasses should clear * @unlock_stop: Clear the previous unlock request. Subclasses should clear
* any state they set during unlock(), such as clearing command queues. * any state they set during unlock(), such as clearing command queues.
* @event: Override this to implement custom event handling. * @event: Override this to implement custom event handling.
* @create: Ask the subclass to create a buffer with offset and size. * @create: Ask the subclass to create a buffer with offset and size.
* When the subclass returns GST_FLOW_OK, it MUST return a buffer of the
* requested size unless fewer bytes are available because an EOS conditi
on
* is near. No buffer should be returned when the return value is differe
nt
* from GST_FLOW_OK. A return value of GST_FLOW_UNEXPECTED signifies that
the
* end of stream is reached.
* @do_seek: Perform seeking on the resource to the indicated segment. * @do_seek: Perform seeking on the resource to the indicated segment.
* @prepare_seek_segment: Prepare the GstSegment that will be passed to the * @prepare_seek_segment: Prepare the GstSegment that will be passed to the
* do_seek vmethod for executing a seek request. Sub-classes should overr ide * do_seek vmethod for executing a seek request. Sub-classes should overr ide
* this if they support seeking in formats other than the configured nati ve * this if they support seeking in formats other than the configured nati ve
* format. By default, it tries to convert the seek arguments to the * format. By default, it tries to convert the seek arguments to the
* configured native format and prepare a segment in that format. * configured native format and prepare a segment in that format.
* Since: 0.10.13 * Since: 0.10.13
* @query: Handle a requested query. * @query: Handle a requested query.
* @check_get_range: Check whether the source would support pull-based * @check_get_range: Check whether the source would support pull-based
* operation if it were to be opened now. This vfunc is optional, but * operation if it were to be opened now. This vfunc is optional, but
skipping to change at line 199 skipping to change at line 207
gboolean (*is_seekable) (GstBaseSrc *src); gboolean (*is_seekable) (GstBaseSrc *src);
/* unlock any pending access to the resource. subclasses should unlock /* unlock any pending access to the resource. subclasses should unlock
* any function ASAP. */ * any function ASAP. */
gboolean (*unlock) (GstBaseSrc *src); gboolean (*unlock) (GstBaseSrc *src);
/* notify subclasses of an event */ /* notify subclasses of an event */
gboolean (*event) (GstBaseSrc *src, GstEvent *event); gboolean (*event) (GstBaseSrc *src, GstEvent *event);
/* ask the subclass to create a buffer with offset and size */ /* ask the subclass to create a buffer with offset and size */
GstFlowReturn (*create) (GstBaseSrc *src, guint64 offset, guint siz e, GstFlowReturn (*create) (GstBaseSrc *src, guint64 offset, guint siz e,
GstBuffer **buf); GstBuffer **buf);
/* additions that change padding... */ /* additions that change padding... */
/* notify subclasses of a seek */ /* notify subclasses of a seek */
gboolean (*do_seek) (GstBaseSrc *src, GstSegment *segment); gboolean (*do_seek) (GstBaseSrc *src, GstSegment *segment);
/* notify subclasses of a query */ /* notify subclasses of a query */
gboolean (*query) (GstBaseSrc *src, GstQuery *query); gboolean (*query) (GstBaseSrc *src, GstQuery *query);
/* check whether the source would support pull-based operation if /* check whether the source would support pull-based operation if
* it were to be opened now. This vfunc is optional, but should be * it were to be opened now. This vfunc is optional, but should be
* implemented if possible to avoid unnecessary start/stop cycles. * implemented if possible to avoid unnecessary start/stop cycles.
* The default implementation will open and close the resource to * The default implementation will open and close the resource to
* find out whether get_range is supported and that is usually * find out whether get_range is supported and that is usually
* undesirable. */ * undesirable. */
gboolean (*check_get_range) (GstBaseSrc *src); gboolean (*check_get_range) (GstBaseSrc *src);
/* called if, in negotiation, caps need fixating */ /* called if, in negotiation, caps need fixating */
void (*fixate) (GstBaseSrc *src, GstCaps *caps); void (*fixate) (GstBaseSrc *src, GstCaps *caps);
/* Clear any pending unlock request, as we succeeded in unlocking */ /* Clear any pending unlock request, as we succeeded in unlocking */
gboolean (*unlock_stop) (GstBaseSrc *src); gboolean (*unlock_stop) (GstBaseSrc *src);
/* Prepare the segment on which to perform do_seek(), converting to the /* Prepare the segment on which to perform do_seek(), converting to the
* current basesrc format. */ * current basesrc format. */
gboolean (*prepare_seek_segment) (GstBaseSrc *src, GstEvent *seek, gboolean (*prepare_seek_segment) (GstBaseSrc *src, GstEvent *seek,
GstSegment *segment); GstSegment *segment);
/*< private >*/ /*< private >*/
gpointer _gst_reserved[GST_PADDING_LARGE - 6]; gpointer _gst_reserved[GST_PADDING_LARGE - 6];
}; };
GType gst_base_src_get_type (void); GType gst_base_src_get_type (void);
GstFlowReturn gst_base_src_wait_playing (GstBaseSrc *src); GstFlowReturn gst_base_src_wait_playing (GstBaseSrc *src);
void gst_base_src_set_live (GstBaseSrc *src, gboolean live); void gst_base_src_set_live (GstBaseSrc *src, gboolean li
gboolean gst_base_src_is_live (GstBaseSrc *src); ve);
gboolean gst_base_src_is_live (GstBaseSrc *src);
void gst_base_src_set_format (GstBaseSrc *src, GstFormat forma t); void gst_base_src_set_format (GstBaseSrc *src, GstFormat f ormat);
gboolean gst_base_src_query_latency (GstBaseSrc *src, gboolean * liv gboolean gst_base_src_query_latency (GstBaseSrc *src, gboolean *
e, live,
GstClockTime * min_latency, GstClockTime * min_latency,
GstClockTime * max_latency); GstClockTime * max_latency);
void gst_base_src_set_blocksize (GstBaseSrc *src, gulong block size); void gst_base_src_set_blocksize (GstBaseSrc *src, gulong bloc ksize);
gulong gst_base_src_get_blocksize (GstBaseSrc *src); gulong gst_base_src_get_blocksize (GstBaseSrc *src);
void gst_base_src_set_do_timestamp (GstBaseSrc *src, gboolean tim void gst_base_src_set_do_timestamp (GstBaseSrc *src, gboolean ti
estamp); mestamp);
gboolean gst_base_src_get_do_timestamp (GstBaseSrc *src); gboolean gst_base_src_get_do_timestamp (GstBaseSrc *src);
gboolean gst_base_src_new_seamless_segment (GstBaseSrc *src, gint64 start, gint64 stop, gint64 position);
G_END_DECLS G_END_DECLS
#endif /* __GST_BASE_SRC_H__ */ #endif /* __GST_BASE_SRC_H__ */
 End of changes. 21 change blocks. 
39 lines changed or deleted 55 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/