mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2025-04-26 04:56:14 +00:00
design/part-toc.txt: update design docs
This commit is contained in:
parent
9e125e7bab
commit
fb2140b627
1 changed files with 11 additions and 10 deletions
|
@ -2,14 +2,14 @@ Implementing GstToc support in GStreamer elements
|
||||||
|
|
||||||
1. General info about GstToc structure
|
1. General info about GstToc structure
|
||||||
|
|
||||||
GstToc introduces a general way to handle chapters within multimedia
|
GstToc introduces a general way to handle chapters within multimedia formats.
|
||||||
formats. GstToc can be represented as tree structure with arbitrary
|
GstToc can be represented as tree structure with arbitrary hierarchy. Tree item
|
||||||
hierarchy. Tree item can be either of two types: chapter or edition.
|
can be either of two types: sequence or alternative. Sequence types acts like a
|
||||||
Chapter acts like a part of the media data, for example audio track
|
part of the media data, for example audio track in CUE sheet, or part of the
|
||||||
in CUE sheet, or part of the movie. Edition acts like some kind of
|
movie. Alternative types acts like some kind of selection to process a different
|
||||||
alternative way to process media content, for example DVD angles.
|
version of the media content, for example DVD angles.
|
||||||
GstToc has one limitation on tree structure: on the same level of
|
GstToc has one constraint on the tree structure: it does not allow different
|
||||||
hierarchy there couldn't be items of different type, i.e. you shouldn't
|
entry types on the same level of the hierarchy, i.e. you shouldn't
|
||||||
have editions and chapters mixed together. Here is an example of right TOC:
|
have editions and chapters mixed together. Here is an example of right TOC:
|
||||||
|
|
||||||
------- TOC -------
|
------- TOC -------
|
||||||
|
@ -19,8 +19,9 @@ have editions and chapters mixed together. Here is an example of right TOC:
|
||||||
-chapter1 -chapter3
|
-chapter1 -chapter3
|
||||||
-chapter2
|
-chapter2
|
||||||
|
|
||||||
Here are two editions, the first contains two chapters, and the second
|
Here are two editions (alternatives), the first contains two chapters (sequence
|
||||||
has only one chapter. And here is an example of invalid TOC:
|
type), and the second has only one chapter. And here is an example of invalid
|
||||||
|
TOC:
|
||||||
|
|
||||||
------- TOC -------
|
------- TOC -------
|
||||||
/ \
|
/ \
|
||||||
|
|
Loading…
Reference in a new issue