mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2025-09-02 02:03:54 +00:00
Code Issues 1 Projects Releases Wiki Activity

docs: spell-check

Browse source
This commit is contained in:
Stefan Kost 2011-02-18 17:09:14 +02:00
parent 7caf301d3f
commit 14c40ff792
1 changed files with 21 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

29
docs/design/part-progress.txt
View file

@ -5,22 +5,22 @@ This document describes the design and use cases for the progress reporting
messages. messages.
PROGRESS messages are posted on the bus to inform the application about the PROGRESS messages are posted on the bus to inform the application about the
progress of asynchonous operations in the pipeline. This should not be confused progress of asynchronous operations in the pipeline. This should not be confused
with asynchronous state changes. with asynchronous state changes.
We accomodate for the following requirements: We accommodate for the following requirements:
- Application is informed when an async operation starts and completes. - Application is informed when an async operation starts and completes.
- It should be possible for the application to generically detect common - It should be possible for the application to generically detect common
operations and incorporate their progress into the GUI. operations and incorporate their progress into the GUI.
- Applications can cancel pending operations by doing regular state changes. - Applications can cancel pending operations by doing regular state changes.
- Applications should be abe able to wait for completion of async operations. - Applications should be able to wait for completion of async operations.
We allow for the following scenarios: We allow for the following scenarios:
- Elements want to inform the application about asynchronous DNS lookups and - Elements want to inform the application about asynchronous DNS lookups and
pending network requests. This includes starting and completing the lookup. pending network requests. This includes starting and completing the lookup.
- Elements opening devices and resources assynchronously. - Elements opening devices and resources asynchronously.
- Applications having more freedom to implement timeout and cancelation of - Applications having more freedom to implement timeout and cancelation of
operations that currently block the state changes or happen invisibly behind operations that currently block the state changes or happen invisibly behind
the scenes. the scenes.
@ -66,7 +66,7 @@ Async state changes
~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~
GStreamer currently has a GST_STATE_CHANGE_ASYNC return value to note to the GStreamer currently has a GST_STATE_CHANGE_ASYNC return value to note to the
application that a state change is happening assynchronously. application that a state change is happening asynchronously.
The main purpose of this return value is to make the pipeline wait for preroll The main purpose of this return value is to make the pipeline wait for preroll
and delay a future (upwards) state changes until the sinks are prerolled. and delay a future (upwards) state changes until the sinks are prerolled.
@ -74,9 +74,10 @@ and delay a future (upwards) state changes until the sinks are prerolled.
In the case of async operations on source, this will automatically force sinks In the case of async operations on source, this will automatically force sinks
to stay async because they will not preroll before the source can produce data. to stay async because they will not preroll before the source can produce data.
The fact that other asynchonous operations happen behind the scnes is irrelevant The fact that other asynchronous operations happen behind the scenes is
for the prerolling process so it is not implemented with the ASYNC state change irrelevant for the prerolling process so it is not implemented with the ASYNC
return value in order to not complicate the state changes and mix concepts. state change return value in order to not complicate the state changes and mix
concepts.
Use cases Use cases
@ -85,23 +86,23 @@ Use cases
* RTSP client (but also HTTP, MMS, ...) * RTSP client (but also HTTP, MMS, ...)
When the client goes from the READY to the PAUSED state, it opens a socket, When the client goes from the READY to the PAUSED state, it opens a socket,
performs a DNS lookup, retieves the SDP and negotiates the streams. All these performs a DNS lookup, retrieves the SDP and negotiates the streams. All these
operations currently block the state change function for an undefinite amount operations currently block the state change function for an indefinite amount
of time and while they are blocking cannot be canceled. of time and while they are blocking cannot be canceled.
Instead, a thread would be started to perform these operations assynchronously Instead, a thread would be started to perform these operations asynchronously
and the state change would complete with the usual NO_PREROLL return value. and the state change would complete with the usual NO_PREROLL return value.
Before starting the thread a PROGRESS message would be posted to mark the Before starting the thread a PROGRESS message would be posted to mark the
start of the async operation. start of the async operation.
As the DNS lookup completes and the connection is established, PROGRESS messages As the DNS lookup completes and the connection is established, PROGRESS
are posted on the bus to inform the application of the progress. When messages are posted on the bus to inform the application of the progress. When
something fails, an error is posted and a PROGRESS CANCELED message is posted. something fails, an error is posted and a PROGRESS CANCELED message is posted.
The application can then stop the pipeline. The application can then stop the pipeline.
If there are no errors and the setup of the streams completed successfully, a If there are no errors and the setup of the streams completed successfully, a
PROGRESS COMPLETED is posted on the bus. The thread then goes to sleep and the PROGRESS COMPLETED is posted on the bus. The thread then goes to sleep and the
assynchronous operation completed. asynchronous operation completed.
The RTSP protocol requires to send a TEARDOWN request to the server The RTSP protocol requires to send a TEARDOWN request to the server
before closing the connection and destroying the socket. A state change to the before closing the connection and destroying the socket. A state change to the