mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-23 18:21:04 +00:00
46d2c100f8
Original commit message from CVS: * docs/design/part-TODO.txt: * docs/design/part-activation.txt: * docs/design/part-block.txt: * docs/design/part-buffering.txt: * docs/design/part-clocks.txt: * docs/design/part-element-source.txt: * docs/design/part-events.txt: * docs/design/part-gstbin.txt: * docs/design/part-gstbus.txt: * docs/design/part-gstpipeline.txt: * docs/design/part-live-source.txt: * docs/design/part-messages.txt: * docs/design/part-overview.txt: * docs/design/part-qos.txt: * docs/design/part-query.txt: * docs/design/part-states.txt: * docs/design/part-trickmodes.txt: Some doc updates. Start renaming from stream_time to running_time where it was used wrongly.
129 lines
4 KiB
Text
129 lines
4 KiB
Text
Messages
|
|
--------
|
|
|
|
Messages are refcounted lightweight objects to signal the application
|
|
of pipeline events.
|
|
|
|
Messages are implemented as a subclass of GstMiniObject with a generic
|
|
GstStructure as the content. This allows for writing custom messages without
|
|
requiring an API change while allowing a wide range of different types
|
|
of messages.
|
|
|
|
Messages are posted by objects in the pipeline and are passed to the
|
|
application using the GstBus.
|
|
|
|
|
|
Message types
|
|
-------------
|
|
|
|
GST_MESSAGE_EOS:
|
|
|
|
Posted by sink elements. This message is posted to the application when
|
|
all the sinks in a pipeline posted an EOS message. When performing a seek,
|
|
the EOS state of the pipeline and sinks is undone.
|
|
|
|
GST_MESSAGE_ERROR:
|
|
|
|
An element in the pipeline got into an error state. The message carries
|
|
a GError and a debug string describing the error. This usually means that
|
|
part of the pipeline is not streaming anymore.
|
|
|
|
GST_MESSAGE_WARNING:
|
|
|
|
An element in the pipeline encountered a condition that made it produce a
|
|
warning. This could be a recoverable decoding error or some other non fatal
|
|
event. The pipeline continues streaming after a warning.
|
|
|
|
GST_MESSAGE_INFO:
|
|
|
|
An element produced an informational message.
|
|
|
|
GST_MESSAGE_TAG:
|
|
|
|
An element decoded metadata about the stream. The message carries a GstTagList
|
|
with the tag information.
|
|
|
|
GST_MESSAGE_BUFFERING:
|
|
|
|
An element is buffering data and that could potentially take some time. This
|
|
message is typically emited by elements that perform some sort of network
|
|
buffering. While the pipeline is buffering it should remain in the PAUSED
|
|
state. When the buffering is finished, it can resume PLAYING.
|
|
|
|
GST_MESSAGE_STATE_CHANGED:
|
|
|
|
An element changed state in the pipeline. The message carries the old, new
|
|
and pending state of the element.
|
|
|
|
GST_MESSAGE_STATE_DIRTY:
|
|
|
|
An internal message used to instruct a pipeline hierarchy that a state
|
|
recalculation must be performed because of an ASYNC state change completed.
|
|
|
|
GST_MESSAGE_STEP_DONE:
|
|
|
|
An element stepping frames has finished. This is currently not used.
|
|
|
|
GST_MESSAGE_CLOCK_PROVIDE:
|
|
|
|
An element notifies it capability of providing a clock for the pipeline.
|
|
|
|
GST_MESSAGE_CLOCK_LOST:
|
|
|
|
The current clock as selected by the pipeline became unusable. The pipeline
|
|
will select a new clock on the next PLAYING state change.
|
|
|
|
GST_MESSAGE_NEW_CLOCK:
|
|
|
|
A new clock was selected for the pipeline.
|
|
|
|
GST_MESSAGE_STRUCTURE_CHANGE:
|
|
|
|
The pipeline changed of structure, This means elements were added or removed or
|
|
pads were linked or unlinked. This messages is not yet used.
|
|
|
|
GST_MESSAGE_STREAM_STATUS:
|
|
|
|
Posted by an element when it start/stop/pauses a streaming task. It
|
|
contains information about the reason why the stream state changed along
|
|
with the thread id. The application can use this information to detect
|
|
failures in streaming threads. It can also be used to adjust streaming
|
|
thread priorities by the application.
|
|
|
|
GST_MESSAGE_APPLICATION:
|
|
|
|
The application posted a message.
|
|
|
|
GST_MESSAGE_ELEMENT:
|
|
|
|
Element-specific message, see the specific element's documentation
|
|
|
|
GST_MESSAGE_SEGMENT_START:
|
|
|
|
An element started playback of a new segment. This message is not forwarded
|
|
the the application but is used internally to schedule SEGMENT_DONE messages.
|
|
|
|
GST_MESSAGE_SEGMENT_DONE:
|
|
|
|
An element or bin completed playback of a segment. This message is only posted
|
|
on the bus if a SEGMENT seek is performed on a pipeline.
|
|
|
|
GST_MESSAGE_DURATION:
|
|
|
|
An element posts this message when it has detected or updated the stream duration.
|
|
|
|
GST_MESSAGE_LOST_PREROLL:
|
|
|
|
Posted by sinks when they lose their preroll buffer in the PAUSED or PLAYING
|
|
state caused by a FLUSH_START event.
|
|
|
|
GST_MESSAGE_PREROLLED:
|
|
|
|
Posted by sinks when they receive the first data buffer.
|
|
|
|
GST_MESSAGE_LATENCY:
|
|
|
|
Posted by elements when the latency in a pipeline changed and a new global
|
|
latency should be calculated by the pipeline or application.
|
|
|
|
|