X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=libs%2Fgst%2Fbase%2Fgstbasesink.h;h=f4ab7e60767327dc88d1b5b4a8c7931484748e00;hb=43abf99a8a064cbe74f110658937088b95d09437;hp=ec68ca357e9a3080ab9fee461c64b356639cb2c8;hpb=f0219b327de5f6bb58ca17f821b951eb9a607622;p=platform%2Fupstream%2Fgstreamer.git diff --git a/libs/gst/base/gstbasesink.h b/libs/gst/base/gstbasesink.h index ec68ca3..f4ab7e6 100644 --- a/libs/gst/base/gstbasesink.h +++ b/libs/gst/base/gstbasesink.h @@ -44,6 +44,19 @@ G_BEGIN_DECLS */ #define GST_BASE_SINK_PAD(obj) (GST_BASE_SINK_CAST (obj)->sinkpad) +#define GST_BASE_SINK_GET_PREROLL_LOCK(pad) (&GST_BASE_SINK_CAST(pad)->preroll_lock) +#define GST_BASE_SINK_PREROLL_LOCK(pad) (g_mutex_lock(GST_BASE_SINK_GET_PREROLL_LOCK(pad))) +#define GST_BASE_SINK_PREROLL_TRYLOCK(pad) (g_mutex_trylock(GST_BASE_SINK_GET_PREROLL_LOCK(pad))) +#define GST_BASE_SINK_PREROLL_UNLOCK(pad) (g_mutex_unlock(GST_BASE_SINK_GET_PREROLL_LOCK(pad))) + +#define GST_BASE_SINK_GET_PREROLL_COND(pad) (&GST_BASE_SINK_CAST(pad)->preroll_cond) +#define GST_BASE_SINK_PREROLL_WAIT(pad) \ + g_cond_wait (GST_BASE_SINK_GET_PREROLL_COND (pad), GST_BASE_SINK_GET_PREROLL_LOCK (pad)) +#define GST_BASE_SINK_PREROLL_WAIT_UNTIL(pad, end_time) \ + g_cond_wait_until (GST_BASE_SINK_GET_PREROLL_COND (pad), GST_BASE_SINK_GET_PREROLL_LOCK (pad), end_time) +#define GST_BASE_SINK_PREROLL_SIGNAL(pad) g_cond_signal (GST_BASE_SINK_GET_PREROLL_COND (pad)); +#define GST_BASE_SINK_PREROLL_BROADCAST(pad) g_cond_broadcast (GST_BASE_SINK_GET_PREROLL_COND (pad)); + typedef struct _GstBaseSink GstBaseSink; typedef struct _GstBaseSinkClass GstBaseSinkClass; typedef struct _GstBaseSinkPrivate GstBaseSinkPrivate; @@ -58,7 +71,7 @@ struct _GstBaseSink { /*< protected >*/ GstPad *sinkpad; - GstActivateMode pad_mode; + GstPadMode pad_mode; /*< protected >*/ /* with LOCK */ guint64 offset; @@ -66,13 +79,9 @@ struct _GstBaseSink { gboolean can_activate_push; /*< protected >*/ /* with PREROLL_LOCK */ - GQueue *preroll_queue; - gint preroll_queue_max_len; /* FIXME-0.11: the property is guint */ - gint preroll_queued; - gint buffers_queued; - gint events_queued; + GMutex preroll_lock; + GCond preroll_cond; gboolean eos; - gboolean eos_queued; gboolean need_preroll; gboolean have_preroll; gboolean playing_async; @@ -83,23 +92,16 @@ struct _GstBaseSink { /*< private >*/ /* with LOCK */ GstClockID clock_id; - GstClockTime end_time; gboolean sync; gboolean flushing; + gboolean running; - /*< private >*/ - union { - struct { - /* segment used for clipping incoming buffers */ - GstSegment *clip_segment; - /* max amount of time a buffer can be late, -1 no limit. */ - gint64 max_lateness; - gboolean running; - } ABI; - gpointer _gst_reserved[GST_PADDING_LARGE - 1]; - } abidata; + gint64 max_lateness; + /*< private >*/ GstBaseSinkPrivate *priv; + + gpointer _gst_reserved[GST_PADDING_LARGE]; }; /** @@ -107,9 +109,16 @@ struct _GstBaseSink { * @parent_class: Element parent class * @get_caps: Called to get sink pad caps from the subclass * @set_caps: Notify subclass of changed caps - * @buffer_alloc: Subclasses can override to perform custom buffer allocations + * @fixate: Only useful in pull mode. Implement if you have + * ideas about what should be the default values for the caps you support. + * @activate_pull: Subclasses should override this when they can provide an + * alternate method of spawning a thread to drive the pipeline in pull mode. + * Should start or stop the pulling thread, depending on the value of the + * "active" argument. Called after actually activating the sink pad in pull + * mode. The default implementation starts a task on the sink pad. * @get_times: Called to get the start and end times for synchronising * the passed buffer to the clock + * @propose_allocation: configure the allocation query * @start: Start processing. Ideal for opening resources in the subclass * @stop: Stop processing. Subclasses should use this to close resources. * @unlock: Unlock any pending access to the resource. Subclasses should @@ -117,22 +126,13 @@ struct _GstBaseSink { * @unlock_stop: Clear the previous unlock request. Subclasses should clear * any state they set during unlock(), such as clearing command queues. * @event: Override this to handle events arriving on the sink pad + * @wait_eos: Override this to implement custom logic to wait for the EOS time. + * subclasses should always first chain up to the default implementation. * @preroll: Called to present the preroll buffer if desired * @render: Called when a buffer should be presented or output, at the * correct moment if the #GstBaseSink has been set to sync to the clock. * @render_list: Same as @render but used whith buffer lists instead of * buffers. Since: 0.10.24 - * @async_play: Subclasses should override this when they need to perform - * special processing when changing to the PLAYING state asynchronously. - * Called with the OBJECT_LOCK held. - * @activate_pull: Subclasses should override this when they can provide an - * alternate method of spawning a thread to drive the pipeline in pull mode. - * Should start or stop the pulling thread, depending on the value of the - * "active" argument. Called after actually activating the sink pad in pull - * mode. The default implementation starts a task on the sink pad. - * @fixate: Only useful in pull mode, this vmethod will be called in response to - * gst_pad_fixate_caps() being called on the sink pad. Implement if you have - * ideas about what should be the default values for the caps you support. * @query: perform a #GstQuery on the element. Since: 0.10.36 * * Subclasses can override any of the available virtual methods or not, as @@ -143,18 +143,22 @@ struct _GstBaseSinkClass { GstElementClass parent_class; /* get caps from subclass */ - GstCaps* (*get_caps) (GstBaseSink *sink); + GstCaps* (*get_caps) (GstBaseSink *sink, GstCaps *filter); /* notify subclass of new caps */ gboolean (*set_caps) (GstBaseSink *sink, GstCaps *caps); - /* allocate a new buffer with given caps */ - GstFlowReturn (*buffer_alloc) (GstBaseSink *sink, guint64 offset, guint size, - GstCaps *caps, GstBuffer **buf); + /* fixate sink caps during pull-mode negotiation */ + GstCaps * (*fixate) (GstBaseSink *sink, GstCaps *caps); + /* start or stop a pulling thread */ + gboolean (*activate_pull)(GstBaseSink *sink, gboolean active); /* get the start and end times for syncing on this buffer */ void (*get_times) (GstBaseSink *sink, GstBuffer *buffer, GstClockTime *start, GstClockTime *end); + /* propose allocation parameters for upstream */ + gboolean (*propose_allocation) (GstBaseSink *sink, GstQuery *query); + /* start and stop processing, ideal for opening/closing the resource */ gboolean (*start) (GstBaseSink *sink); gboolean (*stop) (GstBaseSink *sink); @@ -162,36 +166,27 @@ struct _GstBaseSinkClass { /* unlock any pending access to the resource. subclasses should unlock * any function ASAP. */ gboolean (*unlock) (GstBaseSink *sink); - - /* notify subclass of event, preroll buffer or real buffer */ - gboolean (*event) (GstBaseSink *sink, GstEvent *event); - GstFlowReturn (*preroll) (GstBaseSink *sink, GstBuffer *buffer); - GstFlowReturn (*render) (GstBaseSink *sink, GstBuffer *buffer); - - /* ABI additions */ - - /* when an ASYNC state change to PLAYING happens */ /* with LOCK */ - GstStateChangeReturn (*async_play) (GstBaseSink *sink); - - /* start or stop a pulling thread */ - gboolean (*activate_pull)(GstBaseSink *sink, gboolean active); - - /* fixate sink caps during pull-mode negotiation */ - void (*fixate) (GstBaseSink *sink, GstCaps *caps); - /* Clear a previously indicated unlock request not that unlocking is * complete. Sub-classes should clear any command queue or indicator they * set during unlock */ gboolean (*unlock_stop) (GstBaseSink *sink); - /* Render a BufferList */ - GstFlowReturn (*render_list) (GstBaseSink *sink, GstBufferList *buffer_list); - /* notify subclass of query */ gboolean (*query) (GstBaseSink *sink, GstQuery *query); + /* notify subclass of event */ + gboolean (*event) (GstBaseSink *sink, GstEvent *event); + /* wait for eos, subclasses should chain up to parent first */ + GstFlowReturn (*wait_eos) (GstBaseSink *sink, GstEvent *event); + + /* notify subclass of preroll buffer or real buffer */ + GstFlowReturn (*preroll) (GstBaseSink *sink, GstBuffer *buffer); + GstFlowReturn (*render) (GstBaseSink *sink, GstBuffer *buffer); + /* Render a BufferList */ + GstFlowReturn (*render_list) (GstBaseSink *sink, GstBufferList *buffer_list); + /*< private >*/ - gpointer _gst_reserved[GST_PADDING_LARGE-6]; + gpointer _gst_reserved[GST_PADDING_LARGE]; }; GType gst_base_sink_get_type(void); @@ -219,10 +214,10 @@ gboolean gst_base_sink_is_async_enabled (GstBaseSink *sink); void gst_base_sink_set_ts_offset (GstBaseSink *sink, GstClockTimeDiff offset); GstClockTimeDiff gst_base_sink_get_ts_offset (GstBaseSink *sink); -/* last buffer */ -GstBuffer * gst_base_sink_get_last_buffer (GstBaseSink *sink); -void gst_base_sink_set_last_buffer_enabled (GstBaseSink *sink, gboolean enabled); -gboolean gst_base_sink_is_last_buffer_enabled (GstBaseSink *sink); +/* last sample */ +GstSample * gst_base_sink_get_last_sample (GstBaseSink *sink); +void gst_base_sink_set_last_sample_enabled (GstBaseSink *sink, gboolean enabled); +gboolean gst_base_sink_is_last_sample_enabled (GstBaseSink *sink); /* latency */ gboolean gst_base_sink_query_latency (GstBaseSink *sink, gboolean *live, gboolean *upstream_live,