design/part-toc.txt: update design docs

This commit is contained in:
Stefan Sauer 2014-01-02 20:17:58 +01:00
parent 9e125e7bab
commit fb2140b627

View file

@ -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 -------
/ \ / \