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