doc: create separate section for audio encoders

Having a separate section for audio encoders simplifies navigation
and is slightly more consistent with the rest of the manual.

Signed-off-by: Diego Biurrun <diego@biurrun.de>
This commit is contained in:
Stefano Sabatini 2011-05-19 19:41:19 +02:00 committed by Diego Biurrun
parent 6f7a280ead
commit a2ee2843c0
1 changed files with 17 additions and 13 deletions

View File

@ -17,11 +17,15 @@ with the options @code{--enable-encoder=@var{ENCODER}} /
The option @code{-codecs} of the ff* tools will display the list of The option @code{-codecs} of the ff* tools will display the list of
enabled encoders. enabled encoders.
A description of some of the currently available encoders follows. @c man end ENCODERS
@section Audio Encoders @chapter Audio Encoders
@c man begin AUDIO ENCODERS
@subsection ac3 and ac3_fixed A description of some of the currently available audio encoders
follows.
@section ac3 and ac3_fixed
AC-3 audio encoders. AC-3 audio encoders.
@ -36,7 +40,7 @@ quality audio for a given bitrate. The @var{ac3_fixed} encoder is not the
default codec for any of the output formats, so it must be specified explicitly default codec for any of the output formats, so it must be specified explicitly
using the option @code{-acodec ac3_fixed} in order to use it. using the option @code{-acodec ac3_fixed} in order to use it.
@subheading AC-3 Metadata @subsection AC-3 Metadata
The AC-3 metadata options are used to set parameters that describe the audio, The AC-3 metadata options are used to set parameters that describe the audio,
but in most cases do not affect the audio encoding itself. Some of the options but in most cases do not affect the audio encoding itself. Some of the options
@ -55,7 +59,7 @@ documents.
@item @uref{http://www.dolby.com/uploadedFiles/zz-_Shared_Assets/English_PDFs/Professional/46_DDEncodingGuidelines.pdf,Dolby Digital Professional Encoding Guidelines} @item @uref{http://www.dolby.com/uploadedFiles/zz-_Shared_Assets/English_PDFs/Professional/46_DDEncodingGuidelines.pdf,Dolby Digital Professional Encoding Guidelines}
@end itemize @end itemize
@subsubheading Metadata Control Options @subsubsection Metadata Control Options
@table @option @table @option
@ -72,7 +76,7 @@ Metadata values can be changed before encoding each frame.
@end table @end table
@subsubheading Downmix Levels @subsubsection Downmix Levels
@table @option @table @option
@ -106,7 +110,7 @@ Silence Surround Channel(s)
@end table @end table
@subsubheading Audio Production Information @subsubsection Audio Production Information
Audio Production Information is optional information describing the mixing Audio Production Information is optional information describing the mixing
environment. Either none or both of the fields are written to the bitstream. environment. Either none or both of the fields are written to the bitstream.
@ -140,7 +144,7 @@ Small Room
@end table @end table
@subsubheading Other Metadata Options @subsubsection Other Metadata Options
@table @option @table @option
@ -195,7 +199,7 @@ Original Source (default)
@end table @end table
@subsubheading Extended Bitstream Information @subsection Extended Bitstream Information
The extended bitstream options are part of the Alternate Bit Stream Syntax as The extended bitstream options are part of the Alternate Bit Stream Syntax as
specified in Annex D of the A/52:2010 standard. It is grouped into 2 parts. specified in Annex D of the A/52:2010 standard. It is grouped into 2 parts.
If any one parameter in a group is specified, all values in that group will be If any one parameter in a group is specified, all values in that group will be
@ -205,7 +209,7 @@ will use these values instead of the ones specified in the @code{center_mixlev}
and @code{surround_mixlev} options if it supports the Alternate Bit Stream and @code{surround_mixlev} options if it supports the Alternate Bit Stream
Syntax. Syntax.
@subsubheading Extended Bitstream Information - Part 1 @subsubsection Extended Bitstream Information - Part 1
@table @option @table @option
@ -302,7 +306,7 @@ Silence Surround Channel(s)
@end table @end table
@subsubheading Extended Bitstream Information - Part 2 @subsubsection Extended Bitstream Information - Part 2
@table @option @table @option
@ -353,7 +357,7 @@ HDCD A/D Converter
@end table @end table
@subheading Other AC-3 Encoding Options @subsection Other AC-3 Encoding Options
@table @option @table @option
@ -408,4 +412,4 @@ Selected by Encoder (default)
@end table @end table
@c man end ENCODERS @c man end AUDIO ENCODERS