mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-10-04 17:52:29 +00:00
design/preroll: grammar and reflow fixes
This commit is contained in:
parent
8273bae135
commit
7821f05e72
1 changed files with 5 additions and 5 deletions
|
@ -3,7 +3,7 @@
|
||||||
A sink element can only complete the state change to `PAUSED` after a
|
A sink element can only complete the state change to `PAUSED` after a
|
||||||
buffer has been queued on the input pad or pads. This process is called
|
buffer has been queued on the input pad or pads. This process is called
|
||||||
prerolling and is needed to fill the pipeline with buffers so that the
|
prerolling and is needed to fill the pipeline with buffers so that the
|
||||||
transition to `PLAYING` goes as fast as possible with no visual delay for
|
transition to `PLAYING` goes as fast as possible, with no visual delay for
|
||||||
the user.
|
the user.
|
||||||
|
|
||||||
Preroll is also crucial in maintaining correct audio and video
|
Preroll is also crucial in maintaining correct audio and video
|
||||||
|
@ -15,13 +15,13 @@ EOS message. While waiting, the sink will wait for the preroll cond to
|
||||||
be signalled.
|
be signalled.
|
||||||
|
|
||||||
Several things can happen that require the preroll cond to be signalled.
|
Several things can happen that require the preroll cond to be signalled.
|
||||||
This include state changes or flush events. The prerolling is
|
These include state changes or flush events. The prerolling is
|
||||||
implemented in sinks (see [element-sink](design/element-sink.md)
|
implemented in sinks (see [element-sink](design/element-sink.md)
|
||||||
|
|
||||||
## Committing the state
|
## Committing the state
|
||||||
|
|
||||||
When going to `PAUSED` and `PLAYING` a buffer should be queued in the pad.
|
When going to `PAUSED` and `PLAYING` a buffer should be queued in the pad.
|
||||||
We also make this requirement for going to `PLAYING` since a flush event
|
We also make this a requirement for going to `PLAYING` since a flush event
|
||||||
in the `PAUSED` state could unqueue the buffer again.
|
in the `PAUSED` state could unqueue the buffer again.
|
||||||
|
|
||||||
The state is commited in the following conditions:
|
The state is commited in the following conditions:
|
||||||
|
@ -30,8 +30,8 @@ The state is commited in the following conditions:
|
||||||
- an GAP event is received on a sinkpad.
|
- an GAP event is received on a sinkpad.
|
||||||
- an EOS event is received on a sinkpad.
|
- an EOS event is received on a sinkpad.
|
||||||
|
|
||||||
We require the state change to be commited in EOS as well since an EOS
|
We require the state change to be commited in EOS as well, since an EOS
|
||||||
means by definition that no buffer is going to arrive anymore.
|
, by definition, means no buffer is going to arrive anymore.
|
||||||
|
|
||||||
After the state is commited, a blocking wait should be performed for the
|
After the state is commited, a blocking wait should be performed for the
|
||||||
next event. Some sinks might render the preroll buffer before starting
|
next event. Some sinks might render the preroll buffer before starting
|
||||||
|
|
Loading…
Reference in a new issue