1 <!-- ##### SECTION Title ##### -->
4 <!-- ##### SECTION Short_Description ##### -->
5 Structure describing events that are passed up and down a pipeline
7 <!-- ##### SECTION Long_Description ##### -->
9 The event classes are used to construct and query events.
13 Events are usually created with gst_event_new() which takes the event type as an argument.
14 properties specific to the event can be set afterwards with the provided macros.
15 The event should be unreferenced with gst_event_unref().
18 gst_event_new_seek() is a usually used to create a seek event and it takes the
19 needed parameters for a seek event.
22 gst_event_new_flush() creates a new flush event.
25 <!-- ##### SECTION See_Also ##### -->
30 <!-- ##### SECTION Stability_Level ##### -->
33 <!-- ##### STRUCT GstEvent ##### -->
44 <!-- ##### ENUM GstEventType ##### -->
46 The different major types of events.
49 @GST_EVENT_UNKNOWN: unknown event.
50 @GST_EVENT_FLUSH_START:
51 @GST_EVENT_FLUSH_STOP:
52 @GST_EVENT_EOS: an end-of-stream event.
53 @GST_EVENT_NEWSEGMENT:
56 @GST_EVENT_QOS: a quality of service event
57 @GST_EVENT_SEEK: a seek event.
58 @GST_EVENT_NAVIGATION:
59 @GST_EVENT_CUSTOM_START:
61 <!-- ##### MACRO GST_EVENT_TRACE_NAME ##### -->
63 The name used for memory allocation tracing
68 <!-- ##### MACRO GST_EVENT_TYPE ##### -->
73 @event: The event to query.
76 <!-- ##### MACRO GST_EVENT_TIMESTAMP ##### -->
78 Get the timestamp of the event.
81 @event: The event to query.
84 <!-- ##### MACRO GST_EVENT_SRC ##### -->
86 The source object that generated this event
89 @event: The event to query
92 <!-- ##### ENUM GstSeekType ##### -->
94 The different types of seek events. When constructing a seek event a format,
95 a seek method and optional flags are OR-ed together. The seek event is then
96 inserted into the graph with #gst_pad_send_event() or #gst_element_send_event().
98 Following example illustrates how to insert a seek event (1 second in the stream)
101 <title>Insertion of a seek event into a pipeline</title>
106 event = gst_event_new_seek (
107 GST_FORMAT_TIME | /* seek on time */
108 GST_SEEK_METHOD_SET | /* set the absolute position */
109 GST_SEEK_FLAG_FLUSH, /* flush any pending data */
110 1 * GST_SECOND); /* the seek offset (1 second) */
112 res = gst_element_send_event (GST_ELEMENT (osssink), event);
114 g_warning ("seek failed");
125 <!-- ##### MACRO gst_event_ref ##### -->
127 Increase the refcount of this event
130 @ev: The event to refcount
133 <!-- ##### MACRO gst_event_unref ##### -->
135 Decrease the refcount of an event, freeing it if the refcount reaches 0
138 @ev: The event to unref
141 <!-- ##### MACRO gst_event_copy ##### -->
143 Copy the event using the event specific copy function
146 @ev: The event to copy
147 @Returns: A new event that is a copy of the given input event
150 <!-- ##### FUNCTION gst_event_new_custom ##### -->
160 <!-- ##### FUNCTION gst_event_get_structure ##### -->
169 <!-- ##### FUNCTION gst_event_new_flush_start ##### -->
177 <!-- ##### FUNCTION gst_event_new_flush_stop ##### -->
185 <!-- ##### FUNCTION gst_event_new_eos ##### -->
193 <!-- ##### FUNCTION gst_event_new_newsegment ##### -->
206 <!-- ##### FUNCTION gst_event_parse_newsegment ##### -->
219 <!-- ##### FUNCTION gst_event_new_tag ##### -->
226 <!-- # Unused Parameters # -->
230 <!-- ##### FUNCTION gst_event_parse_tag ##### -->
239 <!-- ##### FUNCTION gst_event_new_filler ##### -->
241 Create a new dummy event that should be ignored
247 <!-- ##### FUNCTION gst_event_new_qos ##### -->
258 <!-- ##### FUNCTION gst_event_parse_qos ##### -->
269 <!-- ##### FUNCTION gst_event_new_seek ##### -->
282 <!-- # Unused Parameters # -->
287 <!-- ##### FUNCTION gst_event_parse_seek ##### -->
302 <!-- ##### FUNCTION gst_event_new_navigation ##### -->