Browse code

doc: add dash muxer

Signed-off-by: Peter Große <pegro@friiks.de>
Signed-off-by: Martin Storsjö <martin@martin.st>

Peter Große authored on 2017/01/29 23:26:33
Showing 1 changed files
... ...
@@ -53,6 +53,68 @@ avconv -i INPUT -c:a pcm_u8 -c:v mpeg2video -f crc -
53 53
 
54 54
 See also the @ref{framecrc} muxer.
55 55
 
56
+@anchor{dash}
57
+@section dash
58
+
59
+Dynamic Adaptive Streaming over HTTP (DASH) muxer that creates segments
60
+and manifest files according to the MPEG-DASH standard ISO/IEC 23009-1:2014.
61
+
62
+For more information see:
63
+
64
+@itemize @bullet
65
+@item
66
+ISO DASH Specification: @url{http://standards.iso.org/ittf/PubliclyAvailableStandards/c065274_ISO_IEC_23009-1_2014.zip}
67
+@item
68
+WebM DASH Specification: @url{https://sites.google.com/a/webmproject.org/wiki/adaptive-streaming/webm-dash-specification}
69
+@end itemize
70
+
71
+It creates a MPD manifest file and segment files for each stream.
72
+
73
+The segment filename might contain pre-defined identifiers used with SegmentTemplate
74
+as defined in section 5.3.9.4.4 of the standard. Available identifiers are "$RepresentationID$",
75
+"$Number$", "$Bandwidth$" and "$Time$".
76
+
77
+@example
78
+avconv -re -i <input> -map 0 -map 0 -c:a libfdk_aac -c:v libx264
79
+-b:v:0 800k -b:v:1 300k -s:v:1 320x170 -profile:v:1 baseline
80
+-profile:v:0 main -bf 1 -keyint_min 120 -g 120 -sc_threshold 0
81
+-b_strategy 0 -ar:a:1 22050 -use_timeline 1 -use_template 1
82
+-window_size 5 -adaptation_sets "id=0,streams=v id=1,streams=a"
83
+-f dash /path/to/out.mpd
84
+@end example
85
+
86
+@table @option
87
+@item -min_seg_duration @var{microseconds}
88
+Set the segment length in microseconds.
89
+@item -window_size @var{size}
90
+Set the maximum number of segments kept in the manifest.
91
+@item -extra_window_size @var{size}
92
+Set the maximum number of segments kept outside of the manifest before removing from disk.
93
+@item -remove_at_exit @var{remove}
94
+Enable (1) or disable (0) removal of all segments when finished.
95
+@item -use_template @var{template}
96
+Enable (1) or disable (0) use of SegmentTemplate instead of SegmentList.
97
+@item -use_timeline @var{timeline}
98
+Enable (1) or disable (0) use of SegmentTimeline in SegmentTemplate.
99
+@item -single_file @var{single_file}
100
+Enable (1) or disable (0) storing all segments in one file, accessed using byte ranges.
101
+@item -single_file_name @var{file_name}
102
+DASH-templated name to be used for baseURL. Implies @var{single_file} set to "1".
103
+@item -init_seg_name @var{init_name}
104
+DASH-templated name to used for the initialization segment. Default is "init-stream$RepresentationID$.m4s"
105
+@item -media_seg_name @var{segment_name}
106
+DASH-templated name to used for the media segments. Default is "chunk-stream$RepresentationID$-$Number%05d$.m4s"
107
+@item -utc_timing_url @var{utc_url}
108
+URL of the page that will return the UTC timestamp in ISO format. Example: "https://time.akamai.com/?iso"
109
+@item -adaptation_sets @var{adaptation_sets}
110
+Assign streams to AdaptationSets. Syntax is "id=x,streams=a,b,c id=y,streams=d,e" with x and y being the IDs
111
+of the adaptation sets and a,b,c,d and e are the indices of the mapped streams.
112
+
113
+To map all video (or audio) streams to an AdaptationSet, "v" (or "a") can be used as stream identifier instead of IDs.
114
+
115
+When no assignment is defined, this defaults to an AdaptationSet for each stream.
116
+@end table
117
+
56 118
 @anchor{framecrc}
57 119
 @section framecrc
58 120