Changeset 1313 in 3DVCSoftware for trunk/doc/software-manual.tex


Ignore:
Timestamp:
13 Aug 2015, 17:38:13 (9 years ago)
Author:
tech
Message:

Merged 14.1-update-dev1@1312.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/software-manual.tex

    r964 r1313  
    6767}
    6868
     69\newenvironment{OptionTableNoShorthand}[2]{%
     70        \footnotesize
     71        \def\arraystretch{1.8}
     72        \clearOptions
     73        \begin{longtable}{l<{\makecell[tl]{\optOption}}%
     74                          c<{\makecell[tc]{\optDefault}}%
     75                          >{\def\arraystretch{1.0}}p{0.5\textwidth}<{\clearOptions}}
     76        \caption{#1} \label{#2} \\
     77        \hspace*{12em}&\hspace*{8em}&\kill
     78        \hline
     79         \thead{Option} &
     80         \thead{Default} &
     81         \thead{Description} \\
     82        \hline
     83        \endfirsthead
     84        \caption[]{#1 (Continued)} \\
     85        \hspace*{12em}&\hspace*{8em}&\kill
     86        \hline
     87         \thead{Option} &
     88         \thead{Default} &
     89         \thead{Description} \\
     90        \hline
     91        \endhead
     92         \multicolumn{3}{r}{Continued...}\\
     93         \hline
     94        \endfoot
     95         \hline
     96        \endlastfoot
     97}{%
     98        \hline
     99        \end{longtable}
     100}
     101
     102\newenvironment{SEIListTable}[1]{%
     103        \footnotesize
     104        \def\arraystretch{1.8}
     105        \clearOptions
     106        \begin{longtable}{c<{\makecell[tl]{\optOption}}%
     107                          l<{\makecell[tc]{\optDefault}}%
     108                          >{\def\arraystretch{1.0}}p{0.3\textwidth}<{\clearOptions}}
     109        \caption{#1} \\
     110        \hspace*{12em}&\hspace*{8em}&\kill
     111        \hline
     112         \thead{SEI Number} &
     113         \thead{SEI Name} &
     114         \thead{Table number of encoder controls, if available} \\
     115        \hline
     116        \endfirsthead
     117        \caption[]{#1 (Continued)} \\
     118        \hspace*{12em}&\hspace*{8em}&\kill
     119        \hline
     120         \thead{SEI Number} &
     121         \thead{SEI Name} &
     122         \thead{Table number of encoder controls, if available} \\
     123        \hline
     124        \endhead
     125         \multicolumn{3}{r}{Continued...}\\
     126         \hline
     127        \endfoot
     128         \hline
     129        \endlastfoot
     130}{%
     131        \hline
     132        \end{longtable}
     133}
     134
    69135\newenvironment{MacroTable}[1]{%
    70136        \footnotesize
    … …  
    104170        \email{dflynn@blackberry.com}
    105171        \and
     172  Karl Sharman
     173        \email{karl.sharman@eu.sony.com}
     174        \and
    106175        Karsten S\"uhring
    107176        \email{karsten.suehring@hhi.fraunhofer.de}
    … …  
    118187\begin{abstract}
    119188This document is a user manual describing usage of reference software
    120 for the HEVC project. It applies to version 14.0
     189for the HEVC project. It applies to version 16.6
    121190of the software.
    122191\end{abstract}
    … …  
    125194\listoftables
    126195
     196
     197
    127198\section{General Information}
    128199Reference software is being made available to provide a reference
    129 implementation of the draft HEVC standard being developed by the Joint
     200implementation of the HEVC standard being developed by the Joint
    130201Collaborative Team on Video Coding (JCT-VC) regrouping experts from
    131202ITU-T SG 16 and ISO/IEC SC29 WG11. One of the main goals of the
    … …  
    172243MS Visual Studio 8   & build/HM_vc8.sln \\
    173244MS Visual Studio 9   & build/HM_vc9.sln \\
     245MS Visual Studio 10  & build/HM_vc10.sln \\
    174246Xcode                & HM.xcodeproj \\
    175247Linux                & build/linux/makefile \\
    … …  
    186258\section{Using the encoder}
    187259\begin{verbatim}
    188 TAppEncoder     [-h] [-c config.cfg] [--parameter=value]
     260TAppEncoder     [--help] [-c config.cfg] [--parameter=value]
    189261\end{verbatim}
    190262
    … …  
    197269 \thead{Description} \\
    198270\hline
    199 \texttt{-h} & Prints parameter usage. \\
     271\texttt{--help} & Prints parameter usage. \\
    200272\texttt{-c} & Defines configuration file to use.  Multiple configuration files
    201273     may be used with repeated --c options. \\
    … …  
    203275    & Assigns value to a given parameter as further described below.
    204276      Some parameters are also supported by shorthand
    205       "--\em{opt}~\emph{value}".\\
     277      "--\em{opt}~\emph{value}". These are shown in brackets after the parameter
     278      name in the tables of this document\\
    206279\hline
    207280\end{tabular}
    … …  
    209282
    210283Sample configuration files are provided in the cfg/ folder.
     284Parameters are defined by the last value encountered on the command line.
     285Therefore if a setting is set via a configuration file, and then a subsequent
     286command line parameter changes that same setting, the command line parameter
     287value will be used.
    211288
    212289\subsection{GOP structure table}
    … …  
    220297includes pictures that are used for reference for the current
    221298picture as well as pictures that will be used for reference in
    222 the future. The encoder will not automatically calculate what
    223 pictures that has to be kept for future references, they have to
     299the future. The encoder will not automatically calculate which
     300pictures have to be kept for future references, they must
    224301be specified. Note that some specified reference frames for
    225302pictures encoded in the very first GOP after an IDR frame might
    … …  
    450527%% File, I/O and source parameters
    451528%%
    452 \begin{OptionTable}{File, I/O and source parameters}
    453 \Option{InputFile} &
    454 \ShortOption{-i} &
     529Shorthand alternatives for the parameter that can be used on the command line are shown in brackets after the parameter name.
     530
     531\begin{OptionTableNoShorthand}{File, I/O and source parameters.}{tab:fileIO}
     532\Option{InputFile (-i)} &
     533%\ShortOption{-i} &
    455534\Default{\NotSet} &
    456535Specifies the input video file.
    457536
    458 Video data must be in a raw 4:2:0 planar format (Y$'$CbCr).
     537Video data must be in a raw 4:2:0, or 4:2:2 planar format, 4:4:4 planar format (Y$'$CbCr, RGB or GBR), or in a raw 4:0:0 format.
    459538
    460539Note: When the bit depth of samples is larger than 8, each sample is encoded in
    … …  
    462541\\
    463542
    464 \Option{BitstreamFile} &
    465 \ShortOption{-b} &
     543\Option{BitstreamFile (-b)} &
     544%\ShortOption{-b} &
    466545\Default{\NotSet} &
    467546Specifies the output coded bit stream file.
    468547\\
    469548
    470 \Option{ReconFile} &
    471 \ShortOption{-o} &
     549\Option{ReconFile (-o)} &
     550%\ShortOption{-o} &
    472551\Default{\NotSet} &
    473552Specifies the output locally reconstructed video file.
    474553\\
    475554
    476 \Option{SourceWidth}%
    477 \Option{SourceHeight} &
    478 \ShortOption{-wdt}%
    479 \ShortOption{-hgt} &
     555\Option{SourceWidth (-wdt)}%
     556\Option{SourceHeight (-hgt)} &
     557%\ShortOption{-wdt}%
     558%\ShortOption{-hgt} &
    480559\Default{0}%
    481560\Default{0} &
    … …  
    483562\\
    484563
    485 \Option{InputBitDepth} &
    486 \ShortOption{\None} &
     564\Option{InputBitDepth}
     565 &
     566%\ShortOption{\None} &
    487567\Default{8} &
    488568Specifies the bit depth of the input video.
    489569\\
    490570
     571\Option{MSBExtendedBitDepth} &
     572%\ShortOption{\None} &
     573\Default{0} &
     574Extends the input video by adding MSBs of value 0. When 0, no extension is applied and the InputBitDepth is used.
     575
     576The MSBExtendedBitDepth becomes the effective file InputBitDepth for subsequent processing.
     577\\
     578
    491579\Option{InternalBitDepth} &
    492 \ShortOption{\None} &
    493 \Default{0 \\ (InputBitDepth)} &
    494 Specifies the bit depth used for coding.
     580%\ShortOption{\None} &
     581\Default{0} &
     582Specifies the bit depth used for coding. When 0, the setting defaults to the
     583value of the MSBExtendedBitDepth.
    495584
    496585If the input video is a different bit depth to InternalBitDepth, it is
    … …  
    499588\left\lfloor
    500589 \frac{\mathrm{Pel} * 2^{\mathrm{InternalBitDepth}}}{
    501      2^{\mathrm{InputBitDepth}}}
     590     2^{\mathrm{MSBExtendedBitDepth}}}
    502591\right\rfloor
    503592\end{displaymath}
    504593
    505594Note: The effect of this option is as if the input video is externally
    506 converted to the InternalBitDepth and then coded with this value as
    507 InputBitDepth.  The codec has no notion of two different bit depths.
     595converted to the MSBExtendedBitDepth and then to the InternalBitDepth
     596and then coded with this value as InputBitDepth. The codec has no
     597notion of different bit depths.
    508598\\
    509599
    510600\Option{OutputBitDepth} &
    511 \ShortOption{\None} &
    512 \Default{0 \\ (InternalBitDepth)} &
     601%\ShortOption{\None} &
     602\Default{0} &
    513603Specifies the bit depth of the output locally reconstructed video file.
    514 
     604When 0, the setting defaults to the value of InternalBitDepth.
    515605Note: This option has no effect on the decoding process.
    516606\\
    517607
    518608\Option{InputBitDepthC}%
     609\Option{MSBExtendedBitDepthC}%
    519610\Option{InternalBitDepthC}%
    520611\Option{OutputBitDepthC} &
    521 \ShortOption{\None} &
    522 \Default{(InputBitDepth)}%
    523 \Default{(InternalBitDepth)}%
    524 \Default{(InternalBitDepthC)} &
     612%\ShortOption{\None} &
     613\Default{0}%
     614\Default{0}%
     615\Default{0}%
     616\Default{0} &
    525617Specifies the various bit-depths for chroma components.  These only need
    526618to be specified if non-equal luma and chroma bit-depth processing is
    527 required.
    528 \\
    529 
    530 \Option{ConformanceMode} &
    531 \ShortOption{\None} &
    532 \Default{0} &
    533 Specifies the conformance mode (cropping/padding parameters) to be applied to the input
    534 video. The following modes are available:
    535 \par
    536 \begin{tabular}{cp{0.45\textwidth}}
     619required. When 0, the setting defaults to the corresponding non-Chroma value.
     620\\
     621
     622\Option{InputColourSpaceConvert} &
     623%\ShortOption{\None} &
     624\Default{\NotSet} &
     625The colour space conversion to apply to input video. Permitted values are:
     626\par
     627\begin{tabular}{lp{0.3\textwidth}}
     628  UNCHANGED & No colour space conversion is applied \\
     629  YCbCrToYCrCb & Swap the second and third components \\
     630  YCbCrtoYYY & Set the second and third components to the values in the first \\
     631  RGBtoGBR & Reorder the three components \\
     632\end{tabular}
     633\par
     634If no value is specified, no colour space conversion is applied. The list may eventually also include RGB to YCbCr or YCgCo conversions.
     635\\
     636
     637\Option{SNRInternalColourSpace} &
     638%\ShortOption{\None} &
     639\Default{false} &
     640When this is set true, then no colour space conversion is applied prior to PSNR calculation, otherwise the inverse of InputColourSpaceConvert is applied.
     641\\
     642
     643\Option{OutputInternalColourSpace} &
     644%\ShortOption{\None} &
     645\Default{false} &
     646When this is set true, then no colour space conversion is applied to the reconstructed video, otherwise the inverse of InputColourSpaceConvert is applied.
     647\\
     648
     649\Option{InputChromaFormat} &
     650%\ShortOption{\None} &
     651\Default{420} &
     652Specifies the chroma format used in the input file. Permitted values (depending on the profile) are 400, 420, 422 or 444.
     653\\
     654
     655\Option{ChromaFormatIDC (-cf)} &
     656%\ShortOption{-cf} &
     657\Default{0} &
     658Specifies the chroma format to use for processing. Permitted values (depending on the profile) are 400, 420, 422 or 444; the value of 0 indicates that the value of InputChromaFormat should be used instead.
     659\\
     660
     661\Option{MSEBasedSequencePSNR} &
     662%\ShortOption{\None} &
     663\Default{false} &
     664When 0, the PSNR output is a linear average of the frame PSNRs; when 1, additional PSNRs are output which are formed from the average MSE of all the frames. The latter is useful when coding near-losslessly, where occasional frames become lossless.
     665\\
     666
     667\Option{PrintFrameMSE} &
     668%\ShortOption{\None} &
     669\Default{false} &
     670When 1, the Mean Square Error (MSE) values of each frame will also be output alongside the default PSNR values.
     671\\
     672
     673\Option{PrintSequenceMSE} &
     674%\ShortOption{\None} &
     675\Default{false} &
     676When 1, the Mean Square Error (MSE) values of the entire sequence will also be output alongside the default PSNR values.
     677\\
     678
     679\Option{SummaryOutFilename} &
     680%\ShortOption{\None} &
     681\Default{false} &
     682Filename to use for producing summary output file. If empty, do not produce a file.
     683\\
     684
     685\Option{SummaryPicFilenameBase} &
     686%\ShortOption{\None} &
     687\Default{false} &
     688Base filename to use for producing summary picture output files. The actual filenames used will have I.txt, P.txt and B.txt appended. If empty, do not produce a file.
     689\\
     690
     691\Option{SummaryVerboseness} &
     692%\ShortOption{\None} &
     693\Default{false} &
     694Specifies the level of the verboseness of the text output.
     695\\
     696
     697\Option{CabacZeroWordPaddingEnabled} &
     698%\ShortOption{\None} &
     699\Default{false} &
     700When 1, CABAC zero word padding will be enabled. This is currently not the default value for the setting.
     701\\
     702
     703\Option{ConformanceWindowMode} &
     704%\ShortOption{\None} &
     705\Default{0} &
     706Specifies how the parameters related to the conformance window are interpreted (cropping/padding).
     707The following modes are available:
     708\par
     709\begin{tabular}{cp{0.43\textwidth}}
    5377100 & No cropping / padding \\
    5387111 & Automatic padding to the next minimum CU size \\
    5397122 & Padding according to parameters HorizontalPadding and VerticalPadding \\
    540 3 & Cropping according to parameters ConfLeft, ConfRight, ConfTop and ConfBottom \\
    541 \end{tabular}
    542 \\
    543 
    544 \Option{HorizontalPadding}%
    545 \Option{VerticalPadding} &
    546 \ShortOption{-pdx}%
    547 \ShortOption{-pdy} &
     7133 & Cropping according to parameters ConfWinLeft, ConfWinRight, ConfWinTop and ConfWinBottom \\
     714\end{tabular}
     715\\
     716
     717\Option{HorizontalPadding (-pdx)}%
     718\Option{VerticalPadding (-pdy)} &
     719%\ShortOption{-pdx}%
     720%\ShortOption{-pdy} &
    548721\Default{0} &
    549722Specifies the horizontal and vertical padding to be applied to the input
    550 video in luma samples.  Must be a multiple of the chroma resolution
    551 (e.g. a multiple of two for 4:2:0).
    552 \\
    553 
    554 \Option{ConfLeft}%
    555 \Option{ConfRight}%
    556 \Option{ConfTop}%
    557 \Option{ConfBottom} &
    558 \ShortOption{\None} &
     723video in luma samples when ConformanceWindowMode is 2.  Must be a multiple of
     724the chroma resolution (e.g. a multiple of two for 4:2:0).
     725\\
     726
     727\Option{ConfWinLeft}%
     728\Option{ConfWinRight}%
     729\Option{ConfWinTop}%
     730\Option{ConfWinBottom} &
     731%\ShortOption{\None} &
    559732\Default{0} &
    560733Specifies the horizontal and vertical cropping to be applied to the
    561 input video in luma samples.  Must be a multiple of the chroma
    562 resolution (e.g. a multiple of two for 4:2:0).
    563 \\
    564 
    565 \Option{FrameRate} &
    566 \ShortOption{-fr} &
     734input video in luma samples when ConformanceWindowMode is 3.
     735Must be a multiple of the chroma resolution (e.g. a multiple of
     736two for 4:2:0).
     737\\
     738
     739\Option{FrameRate (-fr)} &
     740%\ShortOption{-fr} &
    567741\Default{0} &
    568742Specifies the frame rate of the input video.
    … …  
    571745\\
    572746
    573 \Option{FrameSkip} &
    574 \ShortOption{-fs} &
     747\Option{FrameSkip (-fs)} &
     748%\ShortOption{-fs} &
    575749\Default{0} &
    576750Specifies a number of frames to skip at beginning of input video file.
    577751\\
    578752
    579 \Option{FramesToBeEncoded} &
    580 \ShortOption{-f} &
    581 \Default{0 \\ (all)} &
    582 Specifies the number of frames to be encoded.
    583 \\
    584 \end{OptionTable}
     753\Option{FramesToBeEncoded (-f)} &
     754%\ShortOption{-f} &
     755\Default{0} &
     756Specifies the number of frames to be encoded. When 0, all frames are coded.
     757\\
     758
     759\Option{FieldCoding} &
     760%\ShortOption{\None} &
     761\Default{false} &
     762When 1, indicates that field-based coding is to be applied.
     763\\
     764
     765\Option{TopFieldFirst (-Tff)} &
     766%\ShortOption{\None} &
     767\Default{0} &
     768Indicates the order of the fields packed into the input frame. When 1, the top field is temporally first.
     769\\
     770
     771\Option{ClipInputVideoToRec709Range} &
     772%\ShortOption{\None} &
     773\Default{0} &
     774If 1 then clip input video to the Rec. 709 Range on loading when InternalBitDepth is less than MSBExtendedBitDepth.
     775\\
     776
     777\Option{ClipOutputVideoToRec709Range} &
     778%\ShortOption{\None} &
     779\Default{0} &
     780If 1 then clip output video to the Rec. 709 Range on saving when OutputBitDepth is less than InternalBitDepth.
     781\\
     782
     783\Option{EfficientFieldIRAPEnabled} &
     784%\ShortOption{\None} &
     785\Default{1} &
     786Enable to code fields in a specific, potentially more efficient, order.
     787\\
     788
     789\Option{HarmonizeGopFirstFieldCoupleEnabled} &
     790%\ShortOption{\None} &
     791\Default{1} &
     792Enables harmonization of Gop first field couple.
     793\\
     794
     795\end{OptionTableNoShorthand}
    585796
    586797%%
    587798%% profile, level and conformance options
    588799%%
    589 \begin{OptionTable}{Profile and level parameters}
     800\begin{OptionTableNoShorthand}{Profile and level parameters}{tab:profile}
    590801\Option{Profile} &
    591 \ShortOption{\None} &
     802%\ShortOption{\None} &
    592803\Default{none} &
    593804Specifies the profile to which the encoded bitstream complies.
    594 Valid values are: none, main, main10, main-still-picture.
     805
     806Valid HEVC Ver. 1 values are: none, main, main10, main-still-picture
     807
     808Valid HEVC Ver. 2 (RExt) values are: main-RExt, high-throughput-RExt,
     809monochrome, monochrome12, monochrome16, main12, main_422_10,
     810main_422_12, main_444, main_444_10, main_444_12, main_444_16,
     811main_intra, main_10_intra, main_12_intra, main_422_10_intra, main_422_12_intra,
     812main_444_intra, main_444_10_intra, main_444_12_intra, main_444_16_intra.
     813
     814When main-RExt is specified, the constraint flags are either manually specified, or calculated via the other supplied settings.
    595815
    596816Compatibility flags are automatically determined according to the profile.
    597 If --Profile=main, then main10 will always be signalled as compatible.
    598 If --Profile=main10, then main will be signalled as compatible if the bit-depth is 8-bit.
    599 
    600 NB: There is currently no validation that the encoder configuration complies with the profile and level constraints.
     817NB: There is currently only limited validation that the encoder configuration complies with the profile, level and tier constraints.
    601818\\
    602819
    603820\Option{Level} &
    604 \ShortOption{\None} &
     821%\ShortOption{\None} &
    605822\Default{none} &
    606823Specifies the level to which the encoded bitstream complies.
    607 Valid values are: none, 1, 2, 2.1, 3, 3.1, 4, 4.1, 5, 5.1, 5.2, 6, 6.1, 6.2.
    608 
    609 NB: There is currently no validation that the encoder configuration complies with the profile and level constraints.
     824Valid values are: none, 1, 2, 2.1, 3, 3.1, 4, 4.1, 5, 5.1, 5.2, 6, 6.1, 6.2, 8.5
     825
     826NB: There is currently only limited validation that the encoder configuration complies with the profile, level and tier constraints.
    610827\\
    611828
    612829\Option{Tier} &
    613 \ShortOption{\None} &
     830%\ShortOption{\None} &
    614831\Default{main} &
    615832Specifies the level tier to which the encoded bitsream complies.
    616833Valid values are: main, high.
    617834
    618 NB: There is currently no validation that the encoder configuration complies with the profile and level constraints.
     835NB: There is currently only limited validation that the encoder configuration complies with the profile, level and tier constraints.
     836\\
     837
     838\Option{MaxBitDepthConstraint} &
     839%\ShortOption{\None} &
     840\Default{0} &
     841For --profile=main-RExt, specifies the value to use to derive the general_max_bit_depth constraint flags for RExt profiles; when 0, use $\max(InternalBitDepth, InternalBitDepthC)$
     842\\
     843
     844\Option{MaxChromaFormatConstraint} &
     845%\ShortOption{\None} &
     846\Default{0} &
     847For --profile=main-RExt, specifies the chroma-format to use for the general profile constraints for RExt profiles; when 0, use the value of ChromaFormatIDC.
     848\\
     849
     850\Option{IntraConstraintFlag} &
     851%\ShortOption{\None} &
     852\Default{false} &
     853For --profile=main-RExt, specifies the value of general_intra_constraint_flag to use for RExt profiles.
     854\\
     855
     856\Option{OnePictureOnlyConstraintFlag} &
     857%\ShortOption{\None} &
     858\Default{false} &
     859For --profile=main-RExt, specifies the value of general_one_picture_only_constraint_flag to use for RExt profiles.
     860\\
     861
     862\Option{LowerBitRateConstraintFlag} &
     863%\ShortOption{\None} &
     864\Default{true} &
     865Specifies the value of general_lower_bit_constraint_flag to use for RExt profiles.
    619866\\
    620867
    621868\Option{ProgressiveSource} &
    622 \ShortOption{\None} &
     869%\ShortOption{\None} &
    623870\Default{false} &
    624871Specifies the value of general_progressive_source_flag
    … …  
    626873
    627874\Option{InterlacedSource} &
    628 \ShortOption{\None} &
     875%\ShortOption{\None} &
    629876\Default{false} &
    630877Specifies the value of general_interlaced_source_flag
    … …  
    632879
    633880\Option{NonPackedSource} &
    634 \ShortOption{\None} &
     881%\ShortOption{\None} &
    635882\Default{false} &
    636883Specifies the value of general_non_packed_constraint_flag
    … …  
    638885
    639886\Option{FrameOnly} &
    640 \ShortOption{\None} &
     887%\ShortOption{\None} &
    641888\Default{false} &
    642889Specifies the value of general_frame_only_constraint_flag
    643890\\
    644891
    645 \end{OptionTable}
     892\end{OptionTableNoShorthand}
    646893
    647894
    … …  
    649896%% Unit definition parameters
    650897%%
    651 \begin{OptionTable}{Unit definition parameters}
     898
     899\begin{OptionTableNoShorthand}{Unit definition parameters}{tab:unit}
    652900\Option{MaxCUWidth} &
    653 \ShortOption{\None} &
     901%\ShortOption{\None} &
    654902\Default{64} &
    655903Defines the maximum CU width.
    … …  
    657905
    658906\Option{MaxCUHeight} &
    659 \ShortOption{\None} &
     907%\ShortOption{\None} &
    660908\Default{64} &
    661909Defines the maximum CU height.
    662910\\
    663911
    664 \Option{MaxCUSize} &
    665 \ShortOption{\None} &
     912\Option{MaxCUSize (-s)} &
     913%\ShortOption{\None} &
    666914\Default{64} &
    667915Defines the maximum CU size.
    668916\\
    669917
    670 \Option{MaxPartitionDepth} &
    671 \ShortOption{-h} &
     918\Option{MaxPartitionDepth (-h)} &
     919%\ShortOption{-h} &
    672920\Default{4} &
    673921Defines the depth of the CU tree.
    … …  
    675923
    676924\Option{QuadtreeTULog2MaxSize} &
    677 \ShortOption{\None} &
     925%\ShortOption{\None} &
    678926\Default{6 \\ ($= \mathrm{log}_2(64)$)} &
    679927Defines the Maximum TU size in logarithm base 2.
    … …  
    681929
    682930\Option{QuadtreeTULog2MinSize} &
    683 \ShortOption{\None} &
     931%\ShortOption{\None} &
    684932\Default{2 \\ ($= \mathrm{log}_2(4)$)} &
    685933Defines the Minimum TU size in logarithm base 2.
    … …  
    687935
    688936\Option{QuadtreeTUMaxDepthIntra} &
    689 \ShortOption{\None} &
     937%\ShortOption{\None} &
    690938\Default{1} &
    691939Defines the depth of the TU tree for intra CUs.
    … …  
    693941
    694942\Option{QuadtreeTUMaxDepthInter} &
    695 \ShortOption{\None} &
     943%\ShortOption{\None} &
    696944\Default{2} &
    697945Defines the depth of the TU tree for inter CUs.
    698946\\
    699 \end{OptionTable}
     947
     948\end{OptionTableNoShorthand}
    700949
    701950
    … …  
    703952%% Coding structure parameters
    704953%%
    705 \begin{OptionTable}{Coding structure parameters}
    706 \Option{IntraPeriod} &
    707 \ShortOption{-ip} &
     954
     955\begin{OptionTableNoShorthand}{Coding structure parameters}{tab:coding-structure}
     956\Option{IntraPeriod (-ip)} &
     957%\ShortOption{-ip} &
    708958\Default{$-1$} &
    709959Specifies the intra frame period.
    … …  
    711961\\
    712962
    713 \Option{DecodingRefreshType} &
    714 \ShortOption{-dr} &
     963\Option{DecodingRefreshType (-dr)} &
     964%\ShortOption{-dr} &
    715965\Default{0} &
    716966Specifies the type of decoding refresh to apply at the intra frame period
    … …  
    718968\par
    719969\begin{tabular}{cp{0.45\textwidth}}
    720 0 & Applies an I picture (not a clean random access point). \\
    721 1 & Applies a non-IDR clean random access point (open GOP). \\
    722 2 & Applies an IDR random access point (closed GOP). \\
    723 \end{tabular}
    724 \\
    725 
    726 \Option{GOPSize} &
    727 \ShortOption{-g} &
     9700 & Applies an I picture (not a intra random access point). \\
     9711 & Applies a CRA intra random access point (open GOP). \\
     9722 & Applies an IDR intra random access point (closed GOP). \\
     9733 & Use recovery point SEI messages to indicate random access. \\
     974\end{tabular}
     975\\
     976
     977\Option{GOPSize (-g)} &
     978%\ShortOption{-g} &
    728979\Default{1} &
    729980Specifies the size of the cyclic GOP structure.
    … …  
    731982
    732983\Option{Frame\emph{N}} &
    733 \ShortOption{\None} &
     984%\ShortOption{\None} &
    734985\Default{\NotSet} &
    735986Multiple options that define the cyclic GOP structure that will be used
    … …  
    739990See section~\ref{sec:gop-structure} for further details.
    740991\\
    741 
    742 \Option{ListCombination} &
    743 \ShortOption{-lc} &
    744 \Default{true} &
    745 Enables or disables the use of the combined reference list for uni-prediction
    746 in B-slices.
    747 \par
    748 \begin{tabular}{cp{0.45\textwidth}}
    749   0 & Reference list~0 and reference list~1 are identical and reference
    750       list~0 is used as the combined reference list. \\
    751   1 & The combined reference list is derived from reference list~0 and
    752       reference list~1. \\
    753 \end{tabular}
    754 NB: LComb can only be 0 in low delay coding (more precisely, when list 0
    755 and list 1 are the same)
    756 \\
    757 \end{OptionTable}
    758 
     992\end{OptionTableNoShorthand}
    759993
    760994%%
    761995%% Motion estimation parameters
    762996%%
    763 \begin{OptionTable}{Motion estimation parameters}
     997
     998\begin{OptionTableNoShorthand}{Motion estimation parameters}{tab:motion-estimation}
    764999\Option{FastSearch} &
    765 \ShortOption{\None} &
    766 \Default{true} &
     1000%\ShortOption{\None} &
     1001\Default{1} &
    7671002Enables or disables the use of a fast motion search.
    7681003\par
    … …  
    7701005 0 & Full search method \\
    7711006 1 & Fast search method \\
    772 \end{tabular}
    773 \\
    774 
    775 \Option{SearchRange} &
    776 \ShortOption{-sr} &
     1007 2 & Previous motion vector fast search method \\
     1008\end{tabular}
     1009\\
     1010
     1011\Option{SearchRange (-sr)} &
     1012%\ShortOption{-sr} &
    7771013\Default{96} &
    7781014Specifies the search range used for motion estimation.
    … …  
    7841020
    7851021\Option{BipredSearchRange} &
    786 \ShortOption{\None} &
     1022%\ShortOption{\None} &
    7871023\Default{4} &
    7881024Specifies the search range used for bi-prediction refinement in motion
    … …  
    7901026\\
    7911027
     1028\Option{ClipForBiPredMEEnabled} &
     1029%\ShortOption{\None} &
     1030\Default{0} &
     1031Enables clipping in the Bi-Pred ME, which prevents values over- or under-flowing. It is usually disabled to reduce encoder run-time.
     1032\\
     1033
     1034\Option{FastMEAssumingSmootherMVEnabled} &
     1035%\ShortOption{\None} &
     1036\Default{0} &
     1037Enables fast ME assuming a smoother MV.
     1038\\
     1039
    7921040\Option{HadamardME} &
    793 \ShortOption{\None} &
     1041%\ShortOption{\None} &
    7941042\Default{true} &
    7951043Enables or disables the use of the Hadamard transform in fractional-pel motion
    … …  
    8031051
    8041052\Option{ASR} &
    805 \ShortOption{\None} &
     1053%\ShortOption{\None} &
    8061054\Default{false} &
    8071055Enables or disables the use of adaptive search ranges, where the motion
    … …  
    8191067\end{displaymath}
    8201068\\
    821 \end{OptionTable}
     1069
     1070\Option{MaxNumMergeCand} &
     1071%\ShortOption{\None} &
     1072\Default{5} &
     1073Specifies the maximum number of merge candidates to use.
     1074\\
     1075
     1076\Option{DisableIntraInInter} &
     1077%\ShortOption{\None} &
     1078\Default{0} &
     1079Flag to disable intra PUs in inter slices.
     1080\\
     1081
     1082\end{OptionTableNoShorthand}
    8221083
    8231084
    … …  
    8251086%% Mode decision parameters
    8261087%%
    827 \begin{OptionTable}{Mode decision parameters}
    828 \Option{LambdaModifier$N$} &
    829 \ShortOption{-LM$N$} &
     1088
     1089\begin{OptionTableNoShorthand}{Mode decision parameters}{tab:mode-decision}
     1090\Option{LambdaModifier$N$ (-LM$N$)} &
     1091%\ShortOption{-LM$N$} &
    8301092\Default{1.0} &
    8311093Specifies a value that is multiplied with the Lagrange multiplier
    … …  
    8331095when encoding temporal layer~$N$.
    8341096\par
    835 $N$ may be in the range 0--7.
     1097$N$ may be in the range 0 (inclusive) to 7 (exclusive).
     1098\\
     1099
     1100\Option{ECU} &
     1101%\ShortOption{\None} &
     1102\Default{false} &
     1103Enables or disables the use of early CU determination.  When enabled, skipped CUs will not be split further.
     1104\\
     1105
     1106\Option{CFM} &
     1107%\ShortOption{\None} &
     1108\Default{false} &
     1109Enables or disables the use of Cbf-based fast encoder mode.  When enabled, once a 2Nx2N CU has been evaluated, if the RootCbf is 0, further PU splits will not be evaluated.
     1110\\
     1111
     1112\Option{ESD} &
     1113%\ShortOption{\None} &
     1114\Default{false} &
     1115Enables or disables the use of early skip detection.  When enabled, the skip mode will be tested before any other.
    8361116\\
    8371117
    8381118\Option{FEN} &
    839 \ShortOption{\None} &
     1119%\ShortOption{\None} &
    8401120\Default{false} &
    8411121Enables or disables the use of fast encoder mode.  When enabled,
    … …  
    8501130
    8511131\Option{FDM} &
    852 \ShortOption{\None} &
     1132%\ShortOption{\None} &
    8531133\Default{true} &
    8541134Enables or disables the use of fast encoder decisions for 2Nx2N merge
    … …  
    8591139
    8601140\Option{RDpenalty} &
    861 \ShortOption{\None} &
     1141%\ShortOption{\None} &
    8621142\Default{0} &
    8631143RD-penalty for 32x32 TU for intra in non-intra slices.
    … …  
    8711151\\
    8721152
    873 \end{OptionTable}
     1153\end{OptionTableNoShorthand}
    8741154
    8751155%%
    8761156%% Quantization parameters
    8771157%%
    878 \begin{OptionTable}{Quantization parameters}
    879 \Option{QP} &
    880 \ShortOption{-q} &
     1158\begin{OptionTableNoShorthand}{Quantization parameters}{tab:quantization}
     1159\Option{QP (-q)} &
     1160%\ShortOption{-q} &
    8811161\Default{30.0} &
    882 Specifies the base value of the quantization parameter.
    883 \\
    884 
    885 \Option{CbQpOffset}%
    886 \Option{CrQpOffset} &
    887 \ShortOption{-cbqpofs}%
    888 \ShortOption{-crqpofs} &
     1162Specifies the base value of the quantization parameter. If it is non-integer, the QP is switched once during encoding.
     1163\\
     1164
     1165\Option{CbQpOffset (-cbqpofs)}%
     1166\Option{CrQpOffset (-crqpofs)} &
     1167%\ShortOption{-cbqpofs}%
     1168%\ShortOption{-crqpofs} &
    8891169\Default{0}%
    8901170\Default{0} &
    … …  
    8951175\\
    8961176
    897 \Option{MaxCuDQPDepth} &
    898 \ShortOption{\None} &
     1177\Option{MaxCuDQPDepth (-dqd)} &
     1178%\ShortOption{\None} &
    8991179\Default{0} &
    9001180Defines maximum depth of a minimum CuDQP for sub-LCU-level delta QP.
    … …  
    9031183
    9041184\Option{RDOQ} &
    905 \ShortOption{\None} &
     1185%\ShortOption{\None} &
    9061186\Default{true} &
    907 Enables or disables rate-distortion-optimized quantization.
     1187Enables or disables rate-distortion-optimized quantization for transformed TUs.
    9081188\\
    9091189
    9101190\Option{RDOQTS} &
    911 \ShortOption{\None} &
     1191%\ShortOption{\None} &
    9121192\Default{true} &
    9131193Enables or disables rate-distortion-optimized quantization for transform-skipped TUs.
    9141194\\
    9151195
    916 \Option{DeltaQpRD} &
    917 \ShortOption{-dqr} &
     1196\Option{SelectiveRDOQ} &
     1197%\ShortOption{\None} &
     1198\Default{false} &
     1199Enables or disables selective rate-distortion-optimized quantization.
     1200A simple quantization is use to pre-analyze, whether to bypass the RDOQ process or not.
     1201If all the coefficients are quantized to 0, the RDOQ process is bypassed.
     1202Otherwise, the RDOQ process is performed as usual.
     1203\\
     1204
     1205\Option{DeltaQpRD (-dqr)} &
     1206%\ShortOption{-dqr} &
    9181207\Default{0} &
    9191208Specifies the maximum QP offset at slice level for multi-pass slice
    … …  
    9231212\\
    9241213
    925 \Option{MaxDeltaQP} &
    926 \ShortOption{-d} &
     1214\Option{MaxDeltaQP (-d)} &
     1215%\ShortOption{-d} &
    9271216\Default{0} &
    9281217Specifies the maximum QP offset at the largest coding unit level for
    … …  
    9331222\\
    9341223
    935 \Option{dQPFile} &
    936 \ShortOption{-m} &
     1224\Option{dQPFile (-m)} &
     1225%\ShortOption{-m} &
    9371226\Default{\NotSet} &
    9381227Specifies a file containing a list of QP deltas. The $n$-th line
    … …  
    9411230\\
    9421231
    943 \Option{AdaptiveQpSelection} &
    944 \ShortOption{-aqps} &
     1232\Option{AdaptiveQp (-aq)} &
     1233%\ShortOption{-aq} &
     1234\Default{false} &
     1235Enable or disable QP adaptation based upon a psycho-visual model.
     1236\\
     1237
     1238\Option{MaxQPAdaptationRange (-aqr)} &
     1239%\ShortOption{-aqps} &
     1240\Default{6} &
     1241Specifies the maximum QP adaptation range.
     1242\\
     1243
     1244\Option{AdaptiveQpSelection (-aqps)} &
     1245%\ShortOption{-aqps} &
    9451246\Default{false} &
    9461247Specifies whether QP values for non-I frames will be calculated on the
    9471248fly based on statistics of previously coded frames.
    9481249\\
    949 \Option{RecalculateQPAccordingToLambda} &
    950 \ShortOption{\None} &
     1250
     1251\Option{RecalculateQP...} \Option{AccordingToLambda} &
     1252%\ShortOption{\None} &
    9511253\Default{false} &
    9521254Recalculate QP values according to lambda values. Do not suggest to be enabled in all intra case.
    9531255\\
    954 \end{OptionTable}
     1256
     1257\Option{ScalingList} &
     1258%\ShortOption{\None} &
     1259\Default{0} &
     1260Controls the specification of scaling lists:
     1261\par
     1262\begin{tabular}{cp{0.45\textwidth}}
     1263 0 & Scaling lists are disabled \\
     1264 1 & Use default scaling lists \\
     1265 2 & Scaling lists are specified in the file indicated by ScalingListFile \\
     1266\end{tabular}
     1267\\
     1268
     1269\Option{ScalingListFile} &
     1270%\ShortOption{\None} &
     1271\Default{\NotSet} &
     1272When ScalingList is set to 2, this parameter indicates the name of the file, which contains the defined scaling lists.
     1273If ScalingList is set to 2 and this parameter is an empty string, information on the format of the scaling list file
     1274is output and the encoder stops.
     1275\\
     1276
     1277\Option{MaxCUChromaQpAdjustmentDepth} &
     1278%\ShortOption{\None} &
     1279\Default{-1} &
     1280Specifies the maximum depth for CU chroma QP adjustment; if negative, CU chroma QP adjustment is disabled.
     1281\\
     1282
     1283\end{OptionTableNoShorthand}
    9551284
    9561285
    … …  
    9581287%% Slice coding parameters
    9591288%%
    960 \begin{OptionTable}{Slice coding parameters}
     1289\begin{OptionTableNoShorthand}{Slice coding parameters}{tab:slice-coding}
    9611290%\Option{SliceGranularity} &
    9621291%\ShortOption{\None} &
    … …  
    9761305
    9771306\Option{SliceMode} &
    978 \ShortOption{\None} &
     1307%\ShortOption{\None} &
    9791308\Default{0} &
    9801309Controls the slice partitioning method in conjunction with
    … …  
    9901319
    9911320\Option{SliceArgument} &
    992 \ShortOption{\None} &
     1321%\ShortOption{\None} &
    9931322\Default{\NotSet} &
    9941323Specifies the maximum number of CTUs, bytes or tiles in a slice depending on the
    … …  
    9971326
    9981327\Option{SliceSegmentMode} &
    999 \ShortOption{\None} &
     1328%\ShortOption{\None} &
    10001329\Default{0} &
    10011330Enables (dependent) slice segment coding in conjunction with
    … …  
    10111340
    10121341\Option{SliceSegmentArgument} &
    1013 \ShortOption{\None} &
     1342%\ShortOption{\None} &
    10141343\Default{\NotSet} &
    10151344Defines the maximum number of CTUs, bytes or tiles a slice segment
    … …  
    10181347
    10191348\Option{WaveFrontSynchro} &
    1020 \ShortOption{\None} &
     1349%\ShortOption{\None} &
    10211350\Default{false} &
    10221351Enables the use of specific CABAC probabilities synchronization at the
    … …  
    10251354\\
    10261355
     1356\Option{TileUniformSpacing} &
     1357%\ShortOption{\None} &
     1358\Default{false} &
     1359Controls the mode used to determine per row and column tile sizes.
     1360\par
     1361\begin{tabular}{cp{0.45\textwidth}}
     1362 0 & Each tile column width and tile row height is explicitly set
     1363     by TileColumnWidthArray and TileRowHeightArray respectively \\
     1364 1 & Tile columns and tile rows are uniformly spaced. \\
     1365\end{tabular}
     1366\\
     1367
    10271368\Option{NumTileColumnsMinus1}%
    10281369\Option{NumTileRowsMinus1} &
    1029 \ShortOption{\None} &
     1370%\ShortOption{\None} &
    10301371\Default{0} &
    10311372Specifies the tile based picture partitioning geometry as
    … …  
    10341375\\
    10351376
    1036 \Option{UniformSpacingIdc} &
    1037 \ShortOption{\None} &
    1038 \Default{0} &
    1039 Controls the mode used to determine per row and column tile sizes.
    1040 \par
    1041 \begin{tabular}{cp{0.45\textwidth}}
    1042  0 & Each tile column width and tile row height is explicitly set
    1043      by ColumnWidthArray and RowHeightArray respectively \\
    1044  1 & Tile columns and tile rows are uniformly spaced. \\
    1045 \end{tabular}
    1046 \\
    1047 
    1048 \Option{ColumnWidthArray}%
    1049 \Option{RowHeightArray} &
    1050 \ShortOption{\None} &
     1377\Option{TileColumnWidthArray}%
     1378\Option{TileRowHeightArray} &
     1379%\ShortOption{\None} &
    10511380\Default{\NotSet} &
    10521381Specifies a space or comma separated list of widths and heights,
    … …  
    10541383list corresponds to the leftmost tile column or topmost tile row.
    10551384\\
    1056 \end{OptionTable}
     1385\end{OptionTableNoShorthand}
    10571386
    10581387
    … …  
    10611390%% Deblocking filter parameters
    10621391%%
    1063 \begin{OptionTable}{Deblocking filter parameters}
     1392\begin{OptionTableNoShorthand}{Deblocking filter parameters}{tab:deblocking-filter}
    10641393\Option{LoopFilterDisable} &
    1065 \ShortOption{\None} &
     1394%\ShortOption{\None} &
    10661395\Default{false} &
    10671396Enables or disables the in-loop deblocking filter.
    … …  
    10691398
    10701399\Option{LFCrossSliceBoundaryFlag} &
    1071 \ShortOption{\None} &
     1400%\ShortOption{\None} &
    10721401\Default{true} &
    10731402Enables or disables the use of in-loop filtering across slice
    … …  
    10751404\\
    10761405
    1077 \Option{DeblockingFilterControlPresent}&
    1078 \ShortOption{\None}&
    1079 \Default{false}&
    1080 Enables or disables the presence of the deblocking filter control
    1081 parameters in the picture parameter set and in the slice segment header.
    1082 When disabled, the default deblocking filter parameters are used.
    1083 \\
    1084 
    10851406\Option{LoopFilterOffsetInPPS}&
    1086 \ShortOption{\None}&
     1407%\ShortOption{\None}&
    10871408\Default{false}&
    10881409If enabled, the in-loop deblocking filter control parameters are sent in PPS.
    … …  
    10971418
    10981419\Option{LoopFilterTcOffset_div2}&
    1099 \ShortOption{\None}&
     1420%\ShortOption{\None}&
    11001421\Default{0}&
    11011422Specifies the base value for the in-loop deblocking filter parameter tc_offset_div2. The final value of tc_offset_div2
    … …  
    11041425
    11051426\Option{LoopFilterBetaOffset_div2}&
    1106 \ShortOption{\None}&
     1427%\ShortOption{\None}&
    11071428\Default{0}&
    11081429Specifies the base value for the in-loop deblocking filter parameter beta_offset_div2. The final value of beta_offset_div2
    … …  
    11101431\\
    11111432
    1112 \end{OptionTable}
     1433\Option{DeblockingFilterMetric}&
     1434%\ShortOption{\None}&
     1435\Default{false}&
     1436Enables or disables the use of a deblocking filter metric to evaluate the suitability of deblocking. If enabled then
     1437LoopFilterOffsetInPPS and LoopFilterDisable must be 0.
     1438\\
     1439
     1440\Option{LFCrossSliceBoundaryFlag}&
     1441%\ShortOption{\None}&
     1442\Default{true}&
     1443Enables or disables the use of a deblocking across tile boundaries.
     1444\\
     1445
     1446\end{OptionTableNoShorthand}
    11131447
    11141448
    … …  
    11171451%% Coding tools parameters
    11181452%%
    1119 \begin{OptionTable}{Coding tools parameters}
    1120 %\Option{ALF} &
    1121 %\ShortOption{\None} &
    1122 %\Default{true} &
    1123 %Enables or disables the adaptive loop filter.
    1124 %\\
    1125 
    1126 %\Option{ALFLowLatencyEncode} &
    1127 %\ShortOption{\None} &
    1128 %\Default{false} &
    1129 %Specifies the operating mode (low latency or high efficiency) of the
    1130 %adaptive loop filter.
    1131 %\\
     1453
     1454\begin{OptionTableNoShorthand}{Coding tools parameters}{tab:coding-tools}
     1455
     1456\Option{AMP} &
     1457%\ShortOption{\None} &
     1458\Default{true} &
     1459Enables or disables the use of asymmetric motion partitions.
     1460\\
    11321461
    11331462\Option{SAO} &
    1134 \ShortOption{\None} &
     1463%\ShortOption{\None} &
    11351464\Default{true} &
    11361465Enables or disables the sample adaptive offset (SAO) filter.
    11371466\\
    11381467
     1468\Option{TestSAODisableAtPictureLevel} &
     1469%\ShortOption{\None} &
     1470\Default{false} &
     1471Enables the testing of disabling SAO at the picture level after having analysed all blocks.
     1472\\
     1473
     1474\Option{SaoEncodingRate} &
     1475%\ShortOption{\None} &
     1476\Default{0.75} &
     1477When >0 SAO early picture termination is enabled for luma and chroma.
     1478\\
     1479
     1480\Option{SaoEncodingRateChroma} &
     1481%\ShortOption{\None} &
     1482\Default{0.5} &
     1483The SAO early picture termination rate to use for chroma (when m_SaoEncodingRate is >0). If <=0, use results for luma.
     1484\\
     1485
    11391486\Option{SAOLcuBoundary} &
    1140 \ShortOption{\None} &
     1487%\ShortOption{\None} &
    11411488\Default{false} &
    11421489Enables or disables SAO parameter estimation using non-deblocked pixels
    … …  
    11441491\\
    11451492
    1146 %\Option{LMChroma} &
    1147 %\ShortOption{\None} &
    1148 %\Default{true} &
    1149 %Enables or disables the intra chroma-from-luma prediction mode.
    1150 %\\
    1151 
    1152 %\Option{NSQT} &
    1153 %\ShortOption{\None} &
    1154 %\Default{true} &
    1155 %Enables or disables the non-square quadtree transform.
    1156 %\\
    1157 
    11581493\Option{ConstrainedIntraPred} &
    1159 \ShortOption{\None} &
     1494%\ShortOption{\None} &
    11601495\Default{false} &
    11611496Enables or disables constrained intra prediction.  Constrained intra
    … …  
    11641499\\
    11651500
     1501\Option{FastUDIUseMPMEnabled} &
     1502%\ShortOption{\None} &
     1503\Default{true} &
     1504If enabled, adapt intra direction search, accounting for MPM
     1505\\
     1506
     1507\Option{FastMEForGenBLowDelayEnabled} &
     1508%\ShortOption{\None} &
     1509\Default{true} &
     1510If enabled use a fast ME for generalised B Low Delay slices
     1511\\
     1512
     1513\Option{UseBLambdaForNonKeyLowDelayPictures} &
     1514%\ShortOption{\None} &
     1515\Default{true} &
     1516Enables use of B-Lambda for non-key low-delay pictures
     1517\\
     1518
    11661519\Option{TransquantBypassEnableFlag} &
    1167 \ShortOption{\None} &
     1520%\ShortOption{\None} &
    11681521\Default{false} &
    11691522Enables or disables the ability to bypass the transform,
    … …  
    11761529
    11771530\Option{CUTransquantBypassFlagForce} &
    1178 \ShortOption{\None} &
     1531%\ShortOption{\None} &
    11791532\Default{0} &
    11801533Controls the per CU transformation, quantization and filtering
    … …  
    11911544
    11921545\Option{PCMEnabledFlag} &
    1193 \ShortOption{\None} &
     1546%\ShortOption{\None} &
    11941547\Default{false} &
    11951548Enables or disables the use of PCM. The encoder will use cost measures on a CU-by-CU basis to determine if PCM mode is to be applied.
    … …  
    11971550
    11981551\Option{PCMLog2MaxSize} &
    1199 \ShortOption{\None} &
     1552%\ShortOption{\None} &
    12001553\Default{5 \\ ($= \mathrm{log}_2(32)$)} &
    12011554Specifies log2 of the maximum PCM block size. When PCM is enabled, the
    … …  
    12051558
    12061559\Option{PCMLog2MinSize} &
    1207 \ShortOption{\None} &
     1560%\ShortOption{\None} &
    12081561\Default{3} &
    12091562Specifies log2 of the minimum PCM block size. When PCM is enabled, the
    … …  
    12151568
    12161569\Option{PCMInputBitDepthFlag} &
    1217 \ShortOption{\None} &
    1218 \Default{1} &
     1570%\ShortOption{\None} &
     1571\Default{true} &
    12191572If enabled specifies that PCM sample bit-depth is set equal to
    12201573InputBitDepth. Otherwise, it specifies that PCM sample bit-depth is set
    … …  
    12231576
    12241577\Option{PCMFilterDisableFlag} &
    1225 \ShortOption{\None} &
     1578%\ShortOption{\None} &
    12261579\Default{false} &
    12271580If enabled specifies that loop-filtering on reconstructed samples of PCM
    … …  
    12311584\\
    12321585
    1233 \Option{WeightedPredP} &
    1234 \ShortOption{-wpP} &
     1586\Option{WeightedPredP (-wpP)} &
     1587%\ShortOption{-wpP} &
    12351588\Default{false} &
    12361589Enables the use of weighted prediction in P slices.
    12371590\\
    12381591
    1239 \Option{WeightedPredB} &
    1240 \ShortOption{-wpB} &
     1592\Option{WeightedPredB (-wpB)} &
     1593%\ShortOption{-wpB} &
    12411594\Default{false} &
    12421595Enables the use of weighted prediction in B slices.
    12431596\\
    12441597
    1245 \Option{SignHideFlag} &
    1246 \ShortOption{-SBH} &
     1598\Option{Log2ParallelMergeLevel} &
     1599%\ShortOption{\None} &
     1600\Default{2} &
     1601Defines the PPS-derived Log2ParMrgLevel variable.
     1602\\
     1603
     1604\Option{SignHideFlag (-SBH)} &
     1605%\ShortOption{-SBH} &
    12471606\Default{true} &
    12481607If enabled specifies that for each 4x4 coefficient group for which the
    … …  
    12541613\\
    12551614
    1256 \Option{StrongIntraSmoothing} &
    1257 \ShortOption{-sis} &
     1615\Option{StrongIntraSmoothing (-sis)} &
     1616%\ShortOption{-sis} &
    12581617\Default{true} &
    12591618If enabled specifies that for 32x32 intra prediction block, the intra smoothing
    … …  
    12651624
    12661625\Option{TMVPMode} &
    1267 \ShortOption{\None} &
     1626%\ShortOption{\None} &
    12681627\Default{1} &
    12691628Controls the temporal motion vector prediction mode.
    … …  
    12771636
    12781637\Option{TransformSkip} &
    1279 \ShortOption{\None} &
    1280 \Default{false} &
    1281 Enables or disables transform-skipping mode decision for 4x4 TUs
    1282 \footnote{Enables transform_skip_enabled and per 4x4 TU tests}.
     1638%\ShortOption{\None} &
     1639\Default{false} &
     1640Enables or disables transform-skipping mode decision.
    12831641\\
    12841642
    12851643\Option{TransformSkipFast} &
    1286 \ShortOption{\None} &
     1644%\ShortOption{\None} &
    12871645\Default{false} &
    12881646Enables or disables reduced testing of the transform-skipping mode
    … …  
    12931651This option has no effect if TransformSkip is disabled.
    12941652\\
    1295 \end{OptionTable}
     1653\end{OptionTableNoShorthand}
    12961654
    12971655%%
    12981656%% Rate control parameters
    12991657%%
    1300 \begin{OptionTable}{Rate control parameters}
     1658
     1659\begin{OptionTableNoShorthand}{Rate control parameters}{tab:rate-control}
    13011660
    13021661\Option{RateControl} &
    1303 \ShortOption{\None} &
     1662%\ShortOption{\None} &
    13041663\Default{false} &
    13051664Rate control: enables rate control or not.
    … …  
    13071666
    13081667\Option{TargetBitrate} &
    1309 \ShortOption{\None} &
     1668%\ShortOption{\None} &
    13101669\Default{0} &
    13111670Rate control: target bitrate, in bps.
    … …  
    13131672
    13141673\Option{KeepHierarchicalBit} &
    1315 \ShortOption{\None} &
     1674%\ShortOption{\None} &
    13161675\Default{0} &
    13171676Rate control: 0: equal bit allocation among pictures;
    … …  
    13211680
    13221681\Option{LCULevelRateControl} &
    1323 \ShortOption{\None} &
     1682%\ShortOption{\None} &
    13241683\Default{true} &
    13251684Rate control: true: LCU level RC; false: picture level RC.
    … …  
    13271686
    13281687\Option{RCLCUSeparateModel} &
    1329 \ShortOption{\None} &
     1688%\ShortOption{\None} &
    13301689\Default{true} &
    13311690Rate control: use LCU level separate R-lambda model or not.
    … …  
    13341693
    13351694\Option{InitialQP} &
    1336 \ShortOption{\None} &
     1695%\ShortOption{\None} &
    13371696\Default{0} &
    13381697Rate control: initial QP value for the first picture.
    … …  
    13411700
    13421701\Option{RCForceIntraQP} &
    1343 \ShortOption{\None} &
     1702%\ShortOption{\None} &
    13441703\Default{false} &
    13451704Rate control: force intra QP to be equal to initial QP or not.
    13461705\\
    1347 \end{OptionTable}
     1706\end{OptionTableNoShorthand}
    13481707
    13491708%%
    13501709%% VUI parameters
    13511710%%
    1352 \begin{OptionTable}{VUI parameters}
    1353 \Option{VuiParametersPresent} &
    1354 \ShortOption{-vui} &
     1711\begin{OptionTableNoShorthand}{VUI parameters}{tab:VUI}
     1712\Option{VuiParametersPresent (-vui)} &
    13551713\Default{false} &
    13561714Enable generation of vui_parameters().
    13571715\\
    13581716\Option{AspectRatioInfoPresent} &
    1359 \ShortOption{} &
    13601717\Default{false} &
    13611718Signals whether aspect_ratio_idc is present.
    13621719\\
    13631720\Option{AspectRatioIdc} &
    1364 \ShortOption{} &
    13651721\Default{0} &
    13661722aspect_ratio_idc
    13671723\\
    13681724\Option{SarWidth} &
    1369 \ShortOption{} &
    13701725\Default{0} &
    13711726Specifies the horizontal size of the sample aspect ratio.
    13721727\\
    13731728\Option{SarHeight} &
    1374 \ShortOption{} &
    13751729\Default{0} &
    13761730Specifies the vertical size of the sample aspect ratio.
    13771731\\
    13781732\Option{OverscanInfoPresent} &
    1379 \ShortOption{} &
    13801733\Default{false} &
    13811734Signals whether overscan_info_present_flag is present.
    13821735\\
    13831736\Option{OverscanAppropriate} &
    1384 \ShortOption{} &
    13851737\Default{false} &
    13861738Indicates whether cropped decoded pictures are suitable for display using overscan.
    … …  
    13921744\\
    13931745\Option{VideoSignalTypePresent} &
    1394 \ShortOption{} &
    13951746\Default{false} &
    13961747Signals whether video_format, video_full_range_flag, and colour_description_present_flag are present.
    13971748\\
    13981749\Option{VideoFormat} &
    1399 \ShortOption{} &
    14001750\Default{5} &
    14011751Indicates representation of pictures.
    14021752\\
    14031753\Option{VideoFullRange} &
    1404 \ShortOption{} &
    14051754\Default{false} &
    14061755Indicates the black level and range of luma and chroma signals.
    … …  
    14121761\\
    14131762\Option{ColourDescriptionPresent} &
    1414 \ShortOption{} &
    14151763\Default{false} &
    14161764Signals whether colour_primaries, transfer_characteristics and matrix_coefficients are present.
    14171765\\
    14181766\Option{ColourPrimaries} &
    1419 \ShortOption{} &
    14201767\Default{2} &
    14211768Indicates chromaticity coordinates of the source primaries.
    14221769\\
    14231770\Option{TransferCharateristics} &
    1424 \ShortOption{} &
    14251771\Default{2} &
    14261772Indicates the opto-electronic transfer characteristics of the source.
    14271773\\
    14281774\Option{MatrixCoefficients} &
    1429 \ShortOption{} &
    14301775\Default{2} &
    14311776Describes the matrix coefficients used in deriving luma and chroma from RGB primaries.
    14321777\\
    14331778\Option{ChromaLocInfoPresent} &
    1434 \ShortOption{} &
    14351779\Default{false} &
    14361780Signals whether chroma_sample_loc_type_top_field and chroma_sample_loc_type_bottom_field are present.
    14371781\\
    14381782\Option{ChromaSampleLocTypeTopField} &
    1439 \ShortOption{} &
    14401783\Default{0} &
    14411784Specifies the location of chroma samples for top field.
    14421785\\
    14431786\Option{ChromaSampleLocTypeBottomField} &
    1444 \ShortOption{} &
    14451787\Default{0} &
    14461788Specifies the location of chroma samples for bottom field.
    14471789\\
    14481790\Option{NeutralChromaIndication} &
    1449 \ShortOption{} &
    14501791\Default{false} &
    14511792Indicates that the value of all decoded chroma samples is equal to 1<<(BitDepthCr-1).
    … …  
    14531794
    14541795\Option{DefaultDisplayWindowFlag} &
    1455 \ShortOption{\None} &
    1456 \Default{0} &
     1796\Default{flag} &
    14571797Indicates the presence of the Default Window parameters.
    14581798\par
    14591799\begin{tabular}{cp{0.45\textwidth}}
    1460 0 & Disabled \\
    1461 1 & Enabled \\
     1800false & Disabled \\
     1801true & Enabled \\
    14621802\end{tabular}
    14631803\\
    … …  
    14671807\Option{DefDispWinTopOffset}%
    14681808\Option{DefDispWinBottomOffset} &
    1469 \ShortOption{\None} &
    14701809\Default{0} &
    14711810Specifies the horizontal and vertical offset to be applied to the
    … …  
    14741813\\
    14751814
     1815\Option{FrameFieldInfoPresentFlag} &
     1816\Default{false} &
     1817Specificies the value of the VUI syntax element `frame_field_info_present_flag', which indicates that pic_struct and field coding related values are present in picture timing SEI messages.
     1818\\
     1819
     1820\Option{PocProportionalToTimingFlag} &
     1821\Default{false} &
     1822Specificies the value of the VUI syntax element `vui_poc_proportional_to_timing_flag', which indicates that the POC value is proportional to the output time with respect to the first picture in the CVS.
     1823\\
     1824
     1825\Option{NumTicksPocDiffOneMinus} &
     1826\Default{0} &
     1827Specificies the value of the VUI syntax element `vui_num_ticks_poc_diff_one_minus1', which specifies the number of clock ticks corresponding to a difference of picture order count values equal to 1, and is used only when PocProportionalToTimingFlag is true.
     1828\\
     1829
    14761830\Option{BitstreamRestriction} &
    1477 \ShortOption{} &
    14781831\Default{false} &
    14791832Signals whether bitstream restriction parameters are present.
    14801833\\
    14811834\Option{TilesFixedStructure} &
    1482 \ShortOption{} &
    14831835\Default{false} &
    14841836Indicates that each active picture parameter set has the same values of the syntax elements related to tiles.
    14851837\\
    14861838\Option{MotionVectorsOverPicBoundaries} &
    1487 \ShortOption{} &
    14881839\Default{false} &
    14891840Indicates that no samples outside the picture boundaries are used for inter prediction.
    14901841\\
    14911842\Option{MaxBytesPerPicDenom} &
    1492 \ShortOption{} &
    14931843\Default{2} &
    14941844Indicates a number of bytes not exceeded by the sum of the sizes of the VCL NAL units associated with any coded picture.
    14951845\\
    14961846\Option{MaxBitsPerMinCuDenom} &
    1497 \ShortOption{} &
    14981847\Default{1} &
    14991848Indicates an upper bound for the number of bits of coding_unit() data.
    15001849\\
    15011850\Option{Log2MaxMvLengthHorizontal} &
    1502 \ShortOption{} &
    15031851\Default{15} &
    15041852Indicate the maximum absolute value of a decoded horizontal MV component in quarter-pel luma units.
    15051853\\
    15061854\Option{Log2MaxMvLengthVertical} &
    1507 \ShortOption{} &
    15081855\Default{15} &
    15091856Indicate the maximum absolute value of a decoded vertical MV component in quarter-pel luma units.
    15101857\\
    1511 \end{OptionTable}
    1512 
     1858\end{OptionTableNoShorthand}
     1859
     1860
     1861\begin{OptionTableNoShorthand}{Range Extensions (Version 2) tool parameters}{tab:rext-tools}
     1862
     1863\Option{CostMode} &
     1864\Default{lossy} &
     1865Specifies the cost mode to use.
     1866\par
     1867\begin{tabular}{lp{0.3\textwidth}}
     1868  lossy                   & $cost=distortion+\lambda \times bits$ \\
     1869  sequence_level_lossless & $cost=distortion / \lambda + bits$. \\
     1870  lossless                & As with sequence_level_lossless, but QP is also set to 0 (this will be deprecated in the future) \\
     1871  mixed_lossless_lossy    & As with sequence_level_lossless, but QP'=4 is used for pre-estimates of transquant-bypass blocks \\
     1872\end{tabular}
     1873\\
     1874
     1875\Option{ExtendedPrecision} &
     1876\Default{false} &
     1877Specifies the use of extended_precision_processing flag. Note that unless the HIGH_BIT_DEPTH_SUPPORT macro in TypeDef.h is enabled, all internal bit depths must be 8 when the ExtendedPrecision setting is enabled.
     1878This setting is only valid for the 16-bit RExt profiles.
     1879\\
     1880
     1881\Option{HighPrecisionPredictionWeighting} &
     1882\Default{false} &
     1883Specifies the value of high_precision_prediction_weighting_flag. This setting is only valid for the 16-bit or 4:4:4 RExt profiles.
     1884\\
     1885
     1886\Option{CrossComponentPrediction} &
     1887\Default{false} &
     1888When true, specifies the use of the cross component prediction tool (4:4:4 processing only). Version 1 and some Version 2 (RExt) profiles require this to be false.
     1889\\
     1890
     1891\Option{ReconBasedCrossCPredictionEstimate} &
     1892\Default{false} &
     1893If true, then when determining the alpha value for cross-component prediction, use the reconstructed residual rather than the pre-transform encoder-side residual
     1894\\
     1895
     1896\Option{SaoLumaOffsetBitShift}
     1897\Option{SaoChromaOffsetBitShift}&
     1898\Default{0}
     1899\Default{0} &
     1900Specifies the shift to apply to the SAO parameters. If negative, an estimate will be calculated based upon the initial QP. Version 1 and some Version 2 (RExt) profiles require this to be 0.
     1901\\
     1902
     1903\Option{TransformSkipLog2MaxSize} &
     1904\Default{2} &
     1905Specifies the maximum TU size for which transform-skip can be used; the minimum value is 2. Version 1 and some Version 2 (RExt) profiles require this to be 2.
     1906\\
     1907
     1908\Option{ImplicitResidualDPCM} &
     1909\Default{false} &
     1910When true, specifies the use of the implicitly signalled residual RDPCM tool (for intra). Version 1 and some Version 2 (RExt) profiles require this to be false.
     1911\\
     1912
     1913\Option{ExplicitResidualDPCM} &
     1914\Default{false} &
     1915When true, specifies the use of the explicitly signalled residual RDPCM tool (for intra-block-copy and inter). Version 1 and some Version 2 (RExt) profiles require this to be false.
     1916\\
     1917
     1918\Option{ResidualRotation} &
     1919\Default{false} &
     1920When true, specifies the use of the residual rotation tool. Version 1 and some Version 2 (RExt) profiles require this to be false.
     1921\\
     1922
     1923\Option{SingleSignificanceMapContext} &
     1924\Default{false} &
     1925When true, specifies the use of a single significance map context for transform-skipped and transquant-bypassed TUs. Version 1 and some Version 2 (RExt) profiles require this to be false.
     1926\\
     1927
     1928\Option{GolombRiceParameterAdaptation} &
     1929\Default{false} &
     1930When true, enable the adaptation of the Golomb-Rice parameter over the course of each slice. Version 1 and some Version 2 (RExt) profiles require this to be false.
     1931\\
     1932
     1933\Option{AlignCABACBeforeBypass} &
     1934\Default{false} &
     1935When true, align the CABAC engine to a defined fraction of a bit prior to coding bypass data (including sign bits) when coeff_abs_level_remaining syntax elements are present in the group.
     1936This must always be true for the high-throughput-RExt profile, and false otherwise.
     1937\\
     1938
     1939\Option{IntraReferenceSmoothing} &
     1940\Default{true} &
     1941When true, enable intra reference smoothing, otherwise disable it. Version 1 and some Version 2 (RExt) profiles require this to be true.
     1942\\
     1943
     1944\end{OptionTableNoShorthand}
     1945
     1946\subsection{Encoder SEI parameters}
     1947The table below lists the SEI messages defined for Version 1 and Range-Extensions, and if available, the respective table that lists the controls within the HM Encoder to include the messages within the bit stream.
     1948
     1949\begin{SEIListTable}{List of Version 1 and RExt SEI messages}
     1950    0 & Buffering period                         & Table \ref{tab:sei-buffering-period} \\
     1951    1 & Picture timing                           & Table \ref{tab:sei-picture-timing} \\
     1952    2 & Pan-scan rectangle                       & (Not handled)\\
     1953    3 & Filler payload                           & (Not handled)\\
     1954    4 & User data registered by Rec. ITU-T T.35  & (Not handled)\\
     1955    5 & User data unregistered                   & Decoded only\\
     1956    6 & Recovery point                           & Table \ref{tab:sei-recovery-point} \\
     1957    9 & Scene information                        & (Not handled)\\
     1958   15 & Picture snapshot                         & (Not handled)\\
     1959   16 & Progressive refinement segment start     & (Not handled)\\
     1960   17 & Progressive refinement segment end       & (Not handled)\\
     1961   19 & Film grain characteristics               & (Not handled)\\
     1962   22 & Post-filter hint                         & (Not handled)\\
     1963   23 & Tone mapping information                 & Table \ref{tab:sei-tone-mapping-info} \\
     1964   45 & Frame packing arrangement                & Table \ref{tab:sei-frame-packing-arrangement} \\
     1965   47 & Display orientation                      & Table \ref{tab:sei-display-orientation} \\
     1966  128 & Structure of pictures information        & Table \ref{tab:sei-sop-info} \\
     1967  129 & Active parameter sets                    & Table \ref{tab:sei-active-parameter-sets} \\
     1968  130 & Decoding unit information                & Table \ref{tab:sei-decoding-unit-info} \\
     1969  131 & Temporal sub-layer zero index            & Table \ref{tab:sei-temporal-level-0} \\
     1970  132 & Decoded picture hash                     & Table \ref{tab:sei-decoded-picture-hash} \\
     1971  133 & Scalable nesting                         & Table \ref{tab:sei-scalable-nesting} \\
     1972  134 & Region refresh information               & Table \ref{tab:sei-region-refresh-info} \\
     1973  135 & No display                               & Table \ref{tab:sei-no-display} \\
     1974  136 & Time code                                & Table \ref{tab:sei-time-code} \\
     1975  137 & Mastering display colour volume          & Table \ref{tab:sei-mastering-display-colour-volume} \\
     1976  138 & Segmented rectangular frame packing arrangement & Table \ref{tab:sei-seg-rect-fpa}\\
     1977  139 & Temporal motion-constrained tile sets    & Table \ref{tab:sei-tmcts} \\
     1978  140 & Chroma resampling filter hint            & Table \ref{tab:chroma-resampling-filter-hint} \\
     1979  141 & Knee function information                & Table \ref{tab:sei-knee-function} \\
     1980  142 & Colour remapping information             & (Not handled)\\
     1981  143 & Deinterlaced field identification        & (Not handled)\\
     1982\end{SEIListTable}
    15131983%%
    15141984%% SEI messages
    15151985%%
    1516 \begin{OptionTable}{SEI messages}
     1986
     1987 
     1988
     1989\begin{OptionTableNoShorthand}{Buffering period SEI message encoder parameters}{tab:sei-buffering-period}
     1990\Option{SEIBufferingPeriod} &
     1991\Default{0} &
     1992Enables or disables the insertion of the Buffering period
     1993SEI messages. This option has no effect if VuiParametersPresent is disabled.
     1994SEIBufferingPeriod requires SEIActiveParameterSets to be enabled.
     1995\\
     1996\end{OptionTableNoShorthand}
     1997
     1998
     1999
     2000\begin{OptionTableNoShorthand}{Picture timing SEI message encoder parameters}{tab:sei-picture-timing}
     2001\Option{SEIPictureTiming} &
     2002\Default{0} &
     2003Enables or disables the insertion of the Picture timing
     2004SEI messages. This option has no effect if VuiParametersPresent is disabled.
     2005\\
     2006\end{OptionTableNoShorthand}
     2007
     2008
     2009
     2010\begin{OptionTableNoShorthand}{Recovery point SEI message encoder parameters}{tab:sei-recovery-point}
     2011\Option{SEIRecoveryPoint} &
     2012\Default{0} &
     2013Enables or disables the insertion of the Recovery point
     2014SEI messages.
     2015\\
     2016\end{OptionTableNoShorthand}
     2017
     2018
     2019
     2020\begin{OptionTableNoShorthand}{Tone mapping information SEI message encoder parameters}{tab:sei-tone-mapping-info}
     2021\Option{SEIToneMappingInfo} &
     2022\Default{0} &
     2023Enables or disables the insertion of the Tone Mapping SEI message.
     2024\\
     2025\Option{SEIToneMapId} &
     2026\Default{0} &
     2027Specifies Id of Tone Mapping SEI message for a given session.
     2028\\
     2029\Option{SEIToneMapCancelFlag} &
     2030\Default{false} &
     2031Indicates that Tone Mapping SEI message cancels the persistance or follows.
     2032\\
     2033\Option{SEIToneMapPersistenceFlag} &
     2034\Default{true} &
     2035Specifies the persistence of the Tone Mapping SEI message.
     2036\\
     2037\Option{SEIToneMapCodedDataBitDepth} &
     2038\Default{8} &
     2039Specifies Coded Data BitDepth of Tone Mapping SEI messages.
     2040\\
     2041\Option{SEIToneMapTargetBitDepth} &
     2042\Default{8} &
     2043Specifies Output BitDepth of Tome mapping function.
     2044\\
     2045\Option{SEIToneMapModelId} &
     2046\Default{0} &
     2047Specifies Model utilized for mapping coded data into
     2048target_bit_depth range.
     2049\par
     2050\begin{tabular}{cp{0.35\textwidth}}
     2051  0 & linear mapping with clipping \\
     2052  1 & sigmoidal mapping \\
     2053  2 & user-defined table mapping \\
     2054  3 & piece-wise linear mapping \\
     2055  4 & luminance dynamic range mapping \\
     2056\end{tabular}
     2057\\
     2058\Option{SEIToneMapMinValue} &
     2059\Default{0} &
     2060Specifies the minimum value in mode 0.
     2061\\
     2062\Option{SEIToneMapMaxValue} &
     2063\Default{1023} &
     2064Specifies the maxmum value in mode 0.
     2065\\
     2066\Option{SEIToneMapSigmoidMidpoint} &
     2067\Default{512} &
     2068Specifies the centre point in mode 1.
     2069\\
     2070\Option{SEIToneMapSigmoidWidth} &
     2071\Default{960} &
     2072Specifies the distance between 5% and 95% values of
     2073the target_bit_depth in mode 1.
     2074\\
     2075\Option{SEIToneMapStartOfCodedInterval} &
     2076\Default{\None} &
     2077Array of user-defined mapping table.
     2078Default table can be set to the following:
     2079\par
     2080\begin{tabular}{cp{0.35\textwidth}}
     20810 12 24 36 48 60 72 84 96 108 120 132 144 156 168 180
     2082\\
     2083192 192 196 204 208 216 220 228 232 240 248 252 260 264
     2084\\
     2085272 276 284 292 292 296 300 304 308 312 320 324 328 332
     2086\\
     2087336 344 348 352 356 360 368 372 376 380 384 388 396 400
     2088\\
     2089404 408 412 420 424 428 432 436 444 444 444 448 452 456
     2090\\
     2091460 464 468 472 476 476 480 484 488 492 496 500 504 508
     2092\\
     2093508 512 516 520 524 528 532 536 540 540 544 548 552 556
     2094\\
     2095560 564 568 572 572 576 580 584 588 592 596 600 604 604
     2096\\
     2097608 612 616 620 624 628 632 636 636 640 644 648 652 656
     2098\\
     2099660 664 668 672 672 672 676 680 680 684 688 692 692 696
     2100\\
     2101700 704 704 708 712 716 716 720 724 724 728 732 736 736
     2102\\
     2103740 744 748 748 752 756 760 760 764 768 768 772 776 780
     2104\\
     2105780 784 788 792 792 796 800 804 804 808 812 812 816 820
     2106\\
     2107824 824 828 832 836 836 840 844 848 848 852 856 860 860
     2108\\
     2109860 864 864 868 872 872 876 880 880 884 884 888 892 892
     2110\\
     2111896 900 900 904 908 908 912 912 916 920 920 924 928 928
     2112\\
     2113932 936 936 940 940 944 948 948 952 956 956 960 964 964
     2114\\
     2115968 968 972 976 976 980 984 984 988 992 992 996 996 1000
     2116\\
     21171004 1004 1008 1012 1012 1016 1020 1024
     2118\\
     2119\end{tabular}
     2120\\
     2121\Option{SEIToneMapNumPivots} &
     2122\Default{0} &
     2123Specifies the number of pivot points in mode 3.
     2124\\
     2125\Option{SEIToneMapCodedPivotValue} &
     2126\Default{\None} &
     2127Array of coded pivot point in mode 3.
     2128A suggested table is:
     2129\par
     2130\begin{tabular}{cp{0.45\textwidth}}
     213164 128 256 512 768
     2132\end{tabular}
     2133\\
     2134\Option{SEIToneMapTargetPivotValue} &
     2135\Default{\None} &
     2136Array of target pivot point in mode 3.
     2137A suggested table is:
     2138\par
     2139\begin{tabular}{cp{0.45\textwidth}}
     214048 73 111 168 215
     2141\end{tabular}
     2142\\
     2143\Option{SEIToneMap...} \Option{CameraIsoSpeedIdc} &
     2144\Default{0} &
     2145Indicates the camera ISO speed for daylight illumination.
     2146\\
     2147\Option{SEIToneMap...} \Option{CameraIsoSpeedValue} &
     2148\Default{400} &
     2149Specifies the camera ISO speed for daylight illumination of Extended_ISO.
     2150\\
     2151\Option{SEIToneMap...} \Option{ExposureIndexIdc} &
     2152\Default{0} &
     2153Indicates the exposure index setting of the camera.
     2154\\
     2155\Option{SEIToneMap...} \Option{ExposureIndexValue} &
     2156\Default{400} &
     2157Specifies the exposure index setting of the cameran of Extended_ISO.
     2158\\
     2159\Option{SEIToneMapExposure...} \Option{CompensationValueSignFlag} &
     2160\Default{0} &
     2161Specifies the sign of ExposureCompensationValue.
     2162\\
     2163\Option{SEIToneMapExposure...} \Option{CompensationValueNumerator} &
     2164\Default{0} &
     2165Specifies the numerator of ExposureCompensationValue.
     2166\\
     2167\Option{SEIToneMapExposure...} \Option{CompensationValueDenomIdc} &
     2168\Default{2} &
     2169Specifies the denominator of ExposureCompensationValue.
     2170\\
     2171\Option{SEIToneMapRef...} \Option{ScreenLuminanceWhite} &
     2172\Default{350} &
     2173Specifies reference screen brightness setting in units of candela per square metre.
     2174\\
     2175\Option{SEIToneMapExtended...} \Option{RangeWhiteLevel} &
     2176\Default{800} &
     2177Indicates the luminance dynamic range.
     2178\\
     2179\Option{SEIToneMapNominal...} \Option{BlackLevelLumaCodeValue} &
     2180\Default{16} &
     2181Specifies luma sample value of the nominal black level assigned decoded pictures.
     2182\\
     2183\Option{SEIToneMapNominal...} \Option{WhiteLevelLumaCodeValue} &
     2184\Default{235} &
     2185Specifies luma sample value of the nominal white level assigned decoded pictures.
     2186\\
     2187\Option{SEIToneMapExtended...} \Option{WhiteLevelLumaCodeValue} &
     2188\Default{300} &
     2189Specifies luma sample value of the extended dynamic range assigned decoded pictures.
     2190\\
     2191\end{OptionTableNoShorthand}
     2192
     2193
     2194
     2195\begin{OptionTableNoShorthand}{Frame packing arrangement SEI message encoder parameters}{tab:sei-frame-packing-arrangement}
     2196\Option{SEIFramePacking} &
     2197\Default{0} &
     2198Enables or disables the insertion of the Frame packing arrangement SEI messages.
     2199\\
     2200\Option{SEIFramePackingType} &
     2201\Default{0} &
     2202Indicates the arrangement type in the Frame packing arrangement SEI message.
     2203This option has no effect if SEIFramePacking is disabled.
     2204\par
     2205\begin{tabular}{cp{0.35\textwidth}}
     2206  3 & Side by Side \\
     2207  4 & Top Bottom \\
     2208  5 & Frame Alternate \\
     2209\end{tabular}
     2210\\
     2211\Option{SEIFramePackingInterpretation} &
     2212\Default{0} &
     2213Indicates the constituent frames relationship in the Frame packing arrangement SEI message.
     2214This option has no effect if SEIFramePacking is disabled.
     2215\par
     2216\begin{tabular}{cp{0.35\textwidth}}
     2217  0 & Unspecified \\
     2218  1 & Frame 0 is associated with the left view of a stereo pair \\
     2219  2 & Frame 0 is associated with the right view of a stereo pair \\
     2220\end{tabular}
     2221\\
     2222\Option{SEIFramePackingQuincunx} &
     2223\Default{0} &
     2224Enables or disables the quincunx_sampling signalling in the
     2225Frame packing arrangement SEI messages. This option has no
     2226effect if SEIFramePacking is disabled.
     2227\\
     2228\Option{SEIFramePackingId} &
     2229\Default{0} &
     2230Indicates the session number in the Frame packing arrangement
     2231SEI messages. This option has no effect if SEIFramePacking is
     2232disabled.
     2233\\
     2234\end{OptionTableNoShorthand}
     2235
     2236
     2237
     2238\begin{OptionTableNoShorthand}{Display orientation SEI message encoder parameters}{tab:sei-display-orientation}
     2239\Option{SEIDisplayOrientation} &
     2240\Default{0} &
     2241Enables or disables the insertion of the Display orientation
     2242SEI messages.
     2243\par
     2244\begin{tabular}{cp{0.20\textwidth}}
     2245  0 & Disabled \\
     2246  N: $0 < N < (2^{16} - 1)$ & Enable display orientation SEI message with
     2247  \mbox{anticlockwise_rotation = N}
     2248  and \mbox{display_orientation_repetition_period = 1} \\
     2249\end{tabular}
     2250\\
     2251\end{OptionTableNoShorthand}
     2252
     2253
     2254
     2255\begin{OptionTableNoShorthand}{Structure of pictures information SEI message encoder parameters}{tab:sei-sop-info}
     2256\Option{SEISOPDescription} &
     2257\Default{0} &
     2258Enables or disables the insertion of the Structure of pictures information SEI messages.
     2259\\
     2260\end{OptionTableNoShorthand}
     2261
     2262
     2263
     2264\begin{OptionTableNoShorthand}{Active parameter sets SEI message encoder parameters}{tab:sei-active-parameter-sets}
     2265\Option{SEIActiveParameterSets} &
     2266\Default{0} &
     2267Enables or disables the insertion of the Active parameter sets
     2268SEI messages.
     2269\\
     2270\end{OptionTableNoShorthand}
     2271
     2272
     2273
     2274\begin{OptionTableNoShorthand}{Decoding unit information SEI message encoder parameters}{tab:sei-decoding-unit-info}
     2275\Option{SEIDecodingUnitInfo} &
     2276\Default{0} &
     2277Enables or disables the insertion of the Decoding unit information
     2278SEI messages. This option has no effect if VuiParametersPresent is disabled.
     2279\\
     2280\end{OptionTableNoShorthand}
     2281
     2282
     2283
     2284\begin{OptionTableNoShorthand}{Temporal sub-layer zero index SEI message encoder parameters}{tab:sei-temporal-level-0}
     2285\Option{SEITemporalLevel0Index} &
     2286\Default{0} &
     2287Enables or disables the insertion of the Temporal level zero index
     2288SEI messages.
     2289\\
     2290\end{OptionTableNoShorthand}
     2291
     2292
     2293
     2294\begin{OptionTableNoShorthand}{Decoded picture hash SEI message encoder parameters}{tab:sei-decoded-picture-hash}
    15172295\Option{SEIDecodedPictureHash} &
    1518 \ShortOption{\None} &
    15192296\Default{0} &
    15202297Enables or disables the calculation and insertion of the Decoded picture hash
    15212298SEI messages.
    15222299\par
    1523 \begin{tabular}{cp{0.45\textwidth}}
     2300\begin{tabular}{cp{0.35\textwidth}}
    15242301  0 & Disabled \\
    15252302  1 & Transmits MD5 in SEI message and writes the value to the encoder
    … …  
    15312308\end{tabular}
    15322309\\
    1533 \Option{SEIpictureDigest} &
    1534 \ShortOption{\None} &
    1535 \Default{0} &
    1536 Deprecated alias for SEIDecodedPictureHash.
    1537 Do not use anymore.
    1538 \\
    1539 \Option{SEIRecoveryPoint} &
    1540 \ShortOption{\None} &
    1541 \Default{0} &
    1542 Enables or disables the insertion of the Recovery point
    1543 SEI messages.
    1544 \\
    1545 \Option{SEIActiveParameterSets} &
    1546 \ShortOption{\None} &
    1547 \Default{0} &
    1548 Enables or disables the insertion of the Active parameter sets
    1549 SEI messages.
    1550 \\
    1551 \Option{SEIBufferingPeriod} &
    1552 \ShortOption{\None} &
    1553 \Default{0} &
    1554 Enables or disables the insertion of the Buffering period
    1555 SEI messages. This option has no effect if VuiParametersPresent is disabled.
    1556 SEIBufferingPeriod requires SEIActiveParameterSets to be enabled.
    1557 \\
    1558 \Option{SEIPictureTiming} &
    1559 \ShortOption{\None} &
    1560 \Default{0} &
    1561 Enables or disables the insertion of the Picture timing
    1562 SEI messages. This option has no effect if VuiParametersPresent is disabled.
    1563 \\
    1564 \Option{SEIDecodingUnitInfo} &
    1565 \ShortOption{\None} &
    1566 \Default{0} &
    1567 Enables or disables the insertion of the Decoding unit information
    1568 SEI messages. This option has no effect if VuiParametersPresent is disabled.
    1569 \\
     2310\end{OptionTableNoShorthand}
     2311
     2312
     2313
     2314\begin{OptionTableNoShorthand}{Scalable nesting SEI message encoder parameters}{tab:sei-scalable-nesting}
     2315\Option{SEIScalableNesting} &
     2316\Default{0} &
     2317Enables or disables the use of the scalable nesting SEI messages.
     2318\\
     2319\end{OptionTableNoShorthand}
     2320
     2321
     2322       
     2323\begin{OptionTableNoShorthand}{Region refresh information SEI message encoder parameters}{tab:sei-region-refresh-info}
    15702324\Option{SEIGradualDecodingRefreshInfo} &
    1571 \ShortOption{\None} &
    15722325\Default{0} &
    15732326Enables or disables the insertion of the Gradual decoding refresh information
    15742327SEI messages.
    15752328\\
    1576 \Option{SEITemporalLevel0Index} &
    1577 \ShortOption{\None} &
    1578 \Default{0} &
    1579 Enables or disables the insertion of the Temporal level zero index
    1580 SEI messages.
    1581 \\
    1582 \Option{SEIDisplayOrientation} &
    1583 \ShortOption{\None} &
    1584 \Default{0} &
    1585 Enables or disables the insertion of the Display orientation
    1586 SEI messages.
    1587 \par
    1588 \begin{tabular}{cp{0.30\textwidth}}
    1589   0 & Disabled \\
    1590   N: $0 < N < (2^{16} - 1)$ & Enable display orientation SEI message with
    1591   \mbox{anticlockwise_rotation = N}
    1592   and \mbox{display_orientation_repetition_period = 1} \\
    1593 \end{tabular}
    1594 \\
    1595 \Option{SEIFramePacking} &
    1596 \ShortOption{\None} &
    1597 \Default{0} &
    1598 Enables or disables the insertion of the Frame packing arrangement SEI messages.
    1599 \\
    1600 \Option{SEIFramePackingType} &
    1601 \ShortOption{\None} &
    1602 \Default{0} &
    1603 Indicates the arrangement type in the Frame packing arrangement SEI message.
    1604 This option has no effect if SEIFramePacking is disabled.
     2329\end{OptionTableNoShorthand}
     2330
     2331
     2332
     2333\begin{OptionTableNoShorthand}{No display SEI message encoder parameters}{tab:sei-no-display}
     2334\Option{SEINoDisplay} &
     2335\Default{0} &
     2336When non-zero, generate no-display SEI message for temporal layer N or higher.
     2337\\
     2338\end{OptionTableNoShorthand}
     2339
     2340
     2341       
     2342\begin{OptionTableNoShorthand}{Time code SEI message encoder parameters}{tab:sei-time-code}
     2343\Option{SEITimeCodeEnabled} &
     2344\Default{false} &
     2345When true (non-zero), generate Time code SEI messages.
     2346\\
     2347\Option{SEITimeCodeNumClockTs} &
     2348\Default{0} &
     2349Number of clock time sets, in the range of 0 to 3 (inclusive).
     2350\\
     2351\Option{SEITimeCodeTimeStampFlag} &
     2352\Default{\None} &
     2353Time stamp flag associated to each time set (comma or space separated list of entries).
     2354\\
     2355\Option{SEITimeCodeFieldBasedFlag} &
     2356\Default{\None} &
     2357Field based flag associated to each time set (comma or space separated list of entries).
     2358\\
     2359\Option{SEITimeCodeCountingType} &
     2360\Default{\None} &
     2361Counting type associated to each time set (comma or space separated list of entries).
     2362\\
     2363\Option{SEITimeCodeFullTsFlag} &
     2364\Default{\None} &
     2365Full time stamp flag associated to each time set (comma or space separated list of entries).
     2366\\
     2367\Option{SEITimeCodeDiscontinuityFlag} &
     2368\Default{\None} &
     2369Discontinuity flag associated to each time set (comma or space separated list of entries).
     2370\\
     2371\Option{SEITimeCodeCntDroppedFlag} &
     2372\Default{\None} &
     2373Counter dropped flag associated to each time set (comma or space separated list of entries).
     2374\\
     2375\Option{SEITimeCodeNumFrames} &
     2376\Default{\None} &
     2377Number of frames associated to each time set (comma or space separated list of entries).
     2378\\
     2379\Option{SEITimeCodeSecondsFlag} &
     2380\Default{\None} &
     2381Flag to signal seconds value presence in each time set (comma or space separated list of entries).
     2382\\
     2383\Option{SEITimeCodeMinutesFlag} &
     2384\Default{\None} &
     2385Flag to signal minutes value presence in each time set (comma or space separated list of entries).
     2386\\
     2387\Option{SEITimeCodeHoursFlag} &
     2388\Default{\None} &
     2389Flag to signal hours value presence in each time set (comma or space separated list of entries).
     2390\\
     2391\Option{SEITimeCodeSecondsValue} &
     2392\Default{\None} &
     2393Seconds value for each time set (comma or space separated list of entries).
     2394\\
     2395\Option{SEITimeCodeMinutesValue} &
     2396\Default{\None} &
     2397Minutes value for each time set (comma or space separated list of entries).
     2398\\
     2399\Option{SEITimeCodeHoursValue} &
     2400\Default{\None} &
     2401Hours value for each time set (comma or space separated list of entries).
     2402\\
     2403\Option{SEITimeCodeOffsetLength} &
     2404\Default{\None} &
     2405Time offset length associated to each time set (comma or space separated list of entries).
     2406\\
     2407\Option{SEITimeCodeTimeOffset} &
     2408\Default{\None} &
     2409Time offset associated to each time set (comma or space separated list of entries).
     2410\\
     2411\end{OptionTableNoShorthand}
     2412
     2413
     2414
     2415\begin{OptionTableNoShorthand}{Mastering display colour volume SEI message encoder parameters}{tab:sei-mastering-display-colour-volume}
     2416\Option{SEIMasteringDisplayColourVolume} &
     2417\Default{false} &
     2418When true (non-zero), generate Mastering display colour volume SEI message.
     2419\\
     2420\Option{SEIMasteringDisplayMaxLuminance} &
     2421\Default{10000} &
     2422Specifies the mastering display maximum luminance value in units of 1/10000 candela per square metre.
     2423\\
     2424\Option{SEIMasteringDisplayMinLuminance} &
     2425\Default{0} &
     2426Specifies the mastering display minimum luminance value in units of 1/10000 candela per square metre.
     2427\\
     2428\Option{SEIMasteringDisplayPrimaries} &
     2429\Default{0,50000, 0,0, 50000,0} &
     2430Mastering display primaries for all three colour planes in CIE xy coordinates in increments of 1/50000 (results in the ranges 0 to 50000 inclusive).
     2431\\
     2432\Option{SEIMasteringDisplayWhitePoint} &
     2433\Default{16667, 16667} &
     2434Mastering display white point CIE xy coordinates in normalized increments of 1/50000 (e.g. 0.333 = 16667).
     2435\\
     2436\end{OptionTableNoShorthand}
     2437
     2438
     2439
     2440\begin{OptionTableNoShorthand}{Segmented rectangular frame packing arrangement SEI message encoder parameters}{tab:sei-seg-rect-fpa}
     2441\Option{SEISegmentedRectFramePacking} &
     2442\Default{0} &
     2443Controls generation of segmented rectangular frame packing SEI messages.
     2444\\
     2445\Option{SEISegmentedRectFramePackingCancel} &
     2446\Default{false} &
     2447If true, cancels the persistence of any previous SRFPA SEI message.
     2448\\
     2449\Option{SEISegmentedRectFramePackingType} &
     2450\Default{0} &
     2451Specifies the arrangement of the frames in the reconstructed picture.
     2452\\
     2453\Option{SEISegmentedRectFramePackingPersistence} &
     2454\Default{false} &
     2455If false the SEI applies to the current frame only.
     2456\\
     2457\end{OptionTableNoShorthand}
     2458
     2459
     2460
     2461\begin{OptionTableNoShorthand}{Temporal motion-constrained tile sets SEI message encoder parameters}{tab:sei-tmcts}
     2462\Option{SEITempMotionConstrainedTileSets} &
     2463\Default{false} &
     2464When true (non-zero), generates example temporal motion constrained tile sets SEI messages.
     2465\\
     2466\end{OptionTableNoShorthand}
     2467
     2468
     2469
     2470\begin{OptionTableNoShorthand}{Chroma resampling filter hint SEI message encoder parameters}{tab:chroma-resampling-filter-hint}
     2471\Option{SEIChromaSamplingFilterHint} &
     2472\Default{false} &
     2473When true (non-zero), generates example chroma sampling filter hint SEI messages.
     2474\\
     2475\Option{SEIChromaSamplingHorizontalFilterType} &
     2476\Default{2} &
     2477Defines the index of the chroma sampling horizontal filter:
     2478\par
     2479\begin{tabular}{cp{0.35\textwidth}}
     2480  0 & Unspecified \\
     2481  1 & Filters signalled within the SEI message \\
     2482  2 & Filters as described by SMPTE RP 2050-1:2012\\
     2483\end{tabular}
     2484\\
     2485\Option{SEIChromaSamplingVerticalFilterType} &
     2486\Default{2} &
     2487Defines the index of the chroma sampling vertical filter:
     2488\par
     2489\begin{tabular}{cp{0.35\textwidth}}
     2490  0 & Unspecified \\
     2491  1 & Filters signalled within the SEI message \\
     2492  2 & Filters as described in the 5/3 filter description of ITU-T Rec. T.800 | ISO/IEC 15444-1\\
     2493\end{tabular}
     2494\\
     2495\end{OptionTableNoShorthand}
     2496
     2497
     2498
     2499\begin{OptionTableNoShorthand}{Knee function SEI message encoder parameters}{tab:sei-knee-function}
     2500\Option{SEIKneeFunctionInfo} &
     2501\Default{false} &
     2502Enables (true) or disables (false) the insertion of the Knee function SEI messages.
     2503\\
     2504\Option{SEIKneeFunctionId} &
     2505\Default{0} &
     2506Specifies Id of Knee function SEI message for a given session.
     2507\\
     2508\Option{SEIKneeFunctionCancelFlag} &
     2509\Default{false} &
     2510Indicates that Knee function SEI message cancels the persistance (true) or follows (false).
     2511\\
     2512\Option{SEIKneeFunctionPersistenceFlag} &
     2513\Default{true} &
     2514Specifies the persistence of the Knee function SEI message.
     2515\\
     2516\Option{SEIKneeFunctionInputDrange} &
     2517\Default{1000} &
     2518Specifies the peak luminance level for the input picture of Knee function SEI messages.
     2519\\
     2520\Option{SEIKneeFunctionInputDispLuminance} &
     2521\Default{100} &
     2522Specifies the expected display brightness for the input picture of Knee function SEI messages.
     2523\\
     2524\Option{SEIKneeFunctionOutputDrange} &
     2525\Default{4000} &
     2526Specifies the peak luminance level for the output picture of Knee function SEI messages.
     2527\\
     2528\Option{SEIKneeFunctionOutputDispLuminance} &
     2529\Default{800} &
     2530Specifies the expected display brightness for the output picture of Knee function SEI messages.
     2531\\
     2532\Option{SEIKneeFunctionNumKneePointsMinus1} &
     2533\Default{2} &
     2534Specifies the number of knee points - 1.
     2535\\
     2536\Option{SEIKneeFunctionInputKneePointValue} &
     2537\Default{} &
     2538Array of input knee point. Default table can be set to the following:
    16052539\par
    16062540\begin{tabular}{cp{0.45\textwidth}}
    1607   3 & Side by Side \\
    1608   4 & Top Bottom \\
    1609   5 & Frame Alternate \\
    1610 \end{tabular}
    1611 \\
    1612 \Option{SEIFramePackingInterpretation} &
    1613 \ShortOption{\None} &
    1614 \Default{0} &
    1615 Indicates the constituent frames relationship in the Frame packing arrangement SEI message.
    1616 This option has no effect if SEIFramePacking is disabled.
     2541600 800 900
     2542\end{tabular}
     2543\\
     2544\Option{SEIKneeFunctionOutputKneePointValue} &
     2545\Default{} &
     2546Array of output knee point. Default table can be set to the following:
    16172547\par
    16182548\begin{tabular}{cp{0.45\textwidth}}
    1619   0 & Unspecified \\
    1620   1 & Frame 0 is associated with the left view of a stereo pair \\
    1621   2 & Frame 0 is associated with the right view of a stereo pair \\
    1622 \end{tabular}
    1623 \\
    1624 \Option{SEIFramePackingQuincunx} &
    1625 \ShortOption{\None} &
    1626 \Default{0} &
    1627 Enables or disables the quincunx_sampling signalling in the
    1628 Frame packing arrangement SEI messages. This option has no
    1629 effect if SEIFramePacking is disabled.
    1630 \\
    1631 \Option{SEIFramePackingId} &
    1632 \ShortOption{\None} &
    1633 \Default{0} &
    1634 Indicates the session number in the Frame packing arrangement
    1635 SEI messages. This option has no effect if SEIFramePacking is
    1636 disabled.
    1637 \\
    1638 \Option{SEIToneMappingInfo} &
    1639 \ShortOption{\None} &
    1640 \Default{0} &
    1641 Enables or disables the insertion of the Tone Mapping SEI message.
    1642 \\
    1643 \Option{SEIToneMapId} &
    1644 \ShortOption{\None} &
    1645 \Default{0} &
    1646 Specifies Id of Tone Mapping SEI message for a given session.
    1647 \\
    1648 \Option{SEIToneMapCancelFlag} &
    1649 \ShortOption{\None} &
    1650 \Default{0} &
    1651 Indicates that Tone Mapping SEI message cancels the persistance or follows.
    1652 \\
    1653 \Option{SEIToneMapPersistenceFlag} &
    1654 \ShortOption{\None} &
    1655 \Default{1} &
    1656 Specifies the persistence of the Tone Mapping SEI message.
    1657 \\
    1658 \Option{SEIToneMapCodedDataBitDepth} &
    1659 \ShortOption{\None} &
    1660 \Default{10} &
    1661 Specifies Coded Data BitDepth of Tone Mapping SEI messages.
    1662 \\
    1663 \Option{SEIToneMapTargetBitDepth} &
    1664 \ShortOption{\None} &
    1665 \Default{8} &
    1666 Specifies Output BitDepth of Tome mapping function.
    1667 \\
    1668 \Option{SEIToneMapModelId} &
    1669 \ShortOption{\None} &
    1670 \Default{0} &
    1671 Specifies Model utilized for mapping coded data into
    1672 target_bit_depth range.
    1673 \par
    1674 \begin{tabular}{cp{0.45\textwidth}}
    1675   0 & linear mapping with clipping \\
    1676   1 & sigmoidal mapping \\
    1677   2 & user-defined table mapping \\
    1678   3 & piece-wise linear mapping \\
    1679   4 & luminance dynamic range mapping \\
    1680 \end{tabular}
    1681 \\
    1682 \Option{SEIToneMapMinValue} &
    1683 \ShortOption{\None} &
    1684 \Default{0} &
    1685 Specifies the minimum value in mode 0.
    1686 \\
    1687 \Option{SEIToneMapMaxValue} &
    1688 \ShortOption{\None} &
    1689 \Default{1023} &
    1690 Specifies the maxmum value in mode 0.
    1691 \\
    1692 \Option{SEIToneMapSigmoidMidpoint} &
    1693 \ShortOption{\None} &
    1694 \Default{512} &
    1695 Specifies the centre point in mode 1.
    1696 \\
    1697 \Option{SEIToneMapSigmoidWidth} &
    1698 \ShortOption{\None} &
    1699 \Default{960} &
    1700 Specifies the distance between 5% and 95% values of
    1701 the target_bit_depth in mode 1.
    1702 \\
    1703 \Option{SEIToneMapStartOfCodedInterval} &
    1704 \ShortOption{\None} &
    1705 \Default{\None} &
    1706 Array of user-defined mapping table.
    1707 Default table can be set to the following:
    1708 \par
    1709 \begin{tabular}{cp{0.45\textwidth}}
    1710 0 12 24 36 48 60 72 84 96 108 120 132 144 156 168 180
    1711 192 192 196 204 208 216 220 228 232 240 248 252 260 264
    1712 272 276 284 292 292 296 300 304 308 312 320 324 328 332
    1713 336 344 348 352 356 360 368 372 376 380 384 388 396 400
    1714 404 408 412 420 424 428 432 436 444 444 444 448 452 456
    1715 460 464 468 472 476 476 480 484 488 492 496 500 504 508
    1716 508 512 516 520 524 528 532 536 540 540 544 548 552 556
    1717 560 564 568 572 572 576 580 584 588 592 596 600 604 604
    1718 608 612 616 620 624 628 632 636 636 640 644 648 652 656
    1719 660 664 668 672 672 672 676 680 680 684 688 692 692 696
    1720 700 704 704 708 712 716 716 720 724 724 728 732 736 736
    1721 740 744 748 748 752 756 760 760 764 768 768 772 776 780
    1722 780 784 788 792 792 796 800 804 804 808 812 812 816 820
    1723 824 824 828 832 836 836 840 844 848 848 852 856 860 860
    1724 860 864 864 868 872 872 876 880 880 884 884 888 892 892
    1725 896 900 900 904 908 908 912 912 916 920 920 924 928 928
    1726 932 936 936 940 940 944 948 948 952 956 956 960 964 964
    1727 968 968 972 976 976 980 984 984 988 992 992 996 996 1000
    1728 1004 1004 1008 1012 1012 1016 1020 1024
    1729 \end{tabular}
    1730 \\
    1731 \Option{SEIToneMapNumPivots} &
    1732 \ShortOption{\None} &
    1733 \Default{5} &
    1734 Specifies the number of pivot points in mode 3.
    1735 \\
    1736 \Option{SEIToneMapCodedPivotValue} &
    1737 \ShortOption{\None} &
    1738 \Default{\None} &
    1739 Array of coded pivot point in mode 3.
    1740 Default table can be set to the following:
    1741 \par
    1742 \begin{tabular}{cp{0.45\textwidth}}
    1743 64 128 256 512 768
    1744 \end{tabular}
    1745 \\
    1746 \Option{SEIToneMapTargetPivotValue} &
    1747 \ShortOption{\None} &
    1748 \Default{\None} &
    1749 Array of target pivot point in mode 3.
    1750 Default table can be set to the following:
    1751 \par
    1752 \begin{tabular}{cp{0.45\textwidth}}
    1753 48 73 111 168 215
    1754 \end{tabular}
    1755 \\
    1756 \Option{SEIToneMapCameraIsoSpeedIdc} &
    1757 \ShortOption{\None} &
    1758 \Default{0} &
    1759 Indicates the camera ISO speed for daylight illumination.
    1760 \\
    1761 \Option{SEIToneMapCameraIsoSpeedValue} &
    1762 \ShortOption{\None} &
    1763 \Default{400} &
    1764 Specifies the camera ISO speed for daylight illumination of Extended_ISO.
    1765 \\
    1766 \Option{SEIToneMapExposureIndexIdc} &
    1767 \ShortOption{\None} &
    1768 \Default{0} &
    1769 Indicates the exposure index setting of the camera.
    1770 \\
    1771 \Option{SEIToneMapExposureIndexValue} &
    1772 \ShortOption{\None} &
    1773 \Default{400} &
    1774 Specifies the exposure index setting of the cameran of Extended_ISO.
    1775 \\
    1776 \Option{SEIToneMapExposureCompensationValueSignFlag} &
    1777 \ShortOption{\None} &
    1778 \Default{0} &
    1779 Specifies the sign of ExposureCompensationValue.
    1780 \\
    1781 \Option{SEIToneMapExposureCompensationValueNumerator} &
    1782 \ShortOption{\None} &
    1783 \Default{0} &
    1784 Specifies the numerator of ExposureCompensationValue.
    1785 \\
    1786 \Option{SEIToneMapExposureCompensationValueDenomIdc} &
    1787 \ShortOption{\None} &
    1788 \Default{2} &
    1789 Specifies the denominator of ExposureCompensationValue.
    1790 \\
    1791 \Option{SEIToneMapRefScreenLuminanceWhite} &
    1792 \ShortOption{\None} &
    1793 \Default{350} &
    1794 Specifies reference screen brightness setting in units of candela per square metre.
    1795 \\
    1796 \Option{SEIToneMapExtendedRangeWhiteLevel} &
    1797 \ShortOption{\None} &
    1798 \Default{800} &
    1799 Indicates the luminance dynamic range.
    1800 \\
    1801 \Option{SEIToneMapNominalBlackLevelLumaCodeValue} &
    1802 \ShortOption{\None} &
    1803 \Default{16} &
    1804 Specifies luma sample value of the nominal black level assigned decoded pictures.
    1805 \\
    1806 \Option{SEIToneMapNominalWhiteLevelLumaCodeValue} &
    1807 \ShortOption{\None} &
    1808 \Default{235} &
    1809 Specifies luma sample value of the nominal white level assigned decoded pictures.
    1810 \\
    1811 \Option{SEIToneMapExtendedWhiteLevelLumaCodeValue} &
    1812 \ShortOption{\None} &
    1813 \Default{300} &
    1814 Specifies luma sample value of the extended dynamic range assigned decoded pictures.
    1815 \\
    1816 \end{OptionTable}
     2549100 250 450
     2550\end{tabular}
     2551\\
     2552\end{OptionTableNoShorthand}
     2553
     2554
     2555
     2556%\Option{SEITimeCode} &
     2557%\Default{false} &
     2558%When true, generate time code SEI messages.
     2559%\\
    18172560
    18182561%%
    … …  
    18652608\\
    18662609
    1867 HB_LAMBDA_FOR_LDC &
    1868 on &
    1869 use of B-style lambda for non-key pictures in low-delay mode
    1870 \\
    1871 
    1872 GPB_SIMPLE &
    1873 on &
    1874 Fast estimation of generalized B in low-delay mode
    1875 \\
    1876 
    1877 GPB_SIMPLE_UNI &
    1878 on &
    1879 Fast estimation of generalized B in low-delay mode for uni-direction
    1880 \\
    1881 
    1882 FASTME_SMOOTHER_MV &
    1883 on &
    1884 Fast ME using smoother MV assumption
    1885 \\
    1886 
    18872610ADAPT_SR_SCALE &
    18882611on &
    … …  
    18902613\\
    18912614
    1892 CLIP_TO_709_RANGE &
    1893 off &
    1894 \\
    1895 
    18962615EARLY_SKIP_THRES &
    189726161.5 &
    … …  
    19122631\url{source/Lib/TLibCommon/TypeDef.h}.
    19132632
     2633
    19142634%%
    19152635%%
    … …  
    19172637\clearpage
    19182638\section{Using the decoder}
     2639\subsection{General}
    19192640\begin{verbatim}
    19202641TAppDecoder -b str.bin -o dec.yuv [options]
    19212642\end{verbatim}
    19222643
    1923 \begin{OptionTable}{Decoder options}
    1924 \Option{} &
    1925 \ShortOption{-h} &
     2644\begin{OptionTableNoShorthand}{Decoder options}{tab:decoder-options}
     2645\Option{(--help)} &
     2646%\ShortOption{\None} &
    19262647\Default{\None} &
    19272648Prints usage information.
    19282649\\
    19292650
    1930 \Option{} &
    1931 \ShortOption{-o} &
     2651\Option{BitStreamFile (-b)} &
     2652%\ShortOption{-b} &
    19322653\Default{\NotSet} &
    1933 Defines reconstructed YUV file name.
    1934 \\
    1935 
    1936 \Option{} &
    1937 \ShortOption{-s} &
     2654Defines the input bit stream file name.
     2655\\
     2656
     2657\Option{ReconFile (-o)} &
     2658%\ShortOption{-o} &
     2659\Default{\NotSet} &
     2660Defines reconstructed YUV file name. If empty, no file is generated.
     2661\\
     2662
     2663\Option{SkipFrames (-s)} &
     2664%\ShortOption{-s} &
    19382665\Default{0} &
    19392666Defines the number of pictures in decoding order to skip.
    19402667\\
    19412668
    1942 \Option{OutputBitDepth} &
    1943 \ShortOption{-d} &
     2669\Option{MaxTemporalLayer (-t)} &
     2670%\ShortOption{-t} &
     2671\Default{-1} &
     2672Defines the maximum temporal layer to be decoded. If -1, then all layers are decoded.
     2673\\
     2674
     2675\Option{TarDecLayerIdSetFile (-l)} &
     2676%\ShortOption{-t} &
     2677\Default{\NotSet} &
     2678Specifies the targetDecLayerIdSet file name. The file would contain white-space separated LayerId values of the layers that are to be decoded.
     2679Omitting the parameter, or using a value of -1 in the file decodes all layers.
     2680\\
     2681
     2682\Option{OutputBitDepth (-d)} &
     2683%\ShortOption{-d} &
    19442684\Default{0 \\ (Native)} &
    19452685Specifies the luma bit-depth of the reconstructed YUV file (the value 0 indicates
    … …  
    19482688
    19492689\Option{OutputBitDepthC} &
    1950 \ShortOption{\None} &
     2690%\ShortOption{\None} &
    19512691\Default{0 \\ (Native)} &
    19522692Defines the chroma bit-depth of the reconstructed YUV file (the value 0 indicates
    … …  
    19542694\\
    19552695
    1956 \Option{SEIPictureDigest} &
    1957 \ShortOption{\None} &
     2696\Option{SEIDecodedPictureHash} &
     2697%\ShortOption{\None} &
    19582698\Default{1} &
    19592699Enable or disable verification of any Picture hash SEI messages. When
    … …  
    19632703\begin{itemize}
    19642704\item
    1965   If Picture hash SEI messages are included in the bitstream, the same type
     2705  If Picture hash SEI messages are included in the bit stream, the same type
    19662706  of hash is calculated for each decoded picture and written to the
    19672707  log together with an indication whether the calculted value matches
    … …  
    19852725\\
    19862726
    1987 \Option{RespectDefDispWindow} &
    1988 \ShortOption{-w} &
     2727\Option{OutputDecodedSEIMessagesFilename} &
     2728%\ShortOption{\None} &
     2729\Default{\NotSet} &
     2730When a non-empty file name is specified, information regarding any decoded SEI messages will be output to the indicated file. If the file name is '-', then stdout is used instead.
     2731\\
     2732
     2733\Option{RespectDefDispWindow (-w)} &
     2734%\ShortOption{-w} &
    19892735\Default{0} &
    19902736Video region to be output by the decoder.
    … …  
    19962742\\
    19972743
    1998 \end{OptionTable}
     2744\Option{OutputColourSpaceConvert} &
     2745\Default{\NotSet} &
     2746Specifies the colour space conversion to apply to 444 video. Permitted values are:
     2747\par
     2748\begin{tabular}{lp{0.45\textwidth}}
     2749  UNCHANGED   & No colour space conversion is applied \\
     2750  YCrCbToYCbCr & Swap the second and third components \\
     2751  GBRtoRGB     & Reorder the three components \\
     2752\end{tabular}
     2753If no value is specified, no colour space conversion is applied. The list may eventually also include RGB to YCbCr or YCgCo conversions.\\
     2754\\
     2755
     2756\Option{SEINoDisplay} &
     2757\Default{false} &
     2758When true, do not output frames for which there is an SEI NoDisplay message.
     2759\\
     2760
     2761\Option{ClipOutputVideoToRec709Range} &
     2762%\ShortOption{\None} &
     2763\Default{0} &
     2764If 1 then clip output video to the Rec. 709 Range on saving when OutputBitDepth is less than InternalBitDepth.
     2765\\
     2766
     2767\end{OptionTableNoShorthand}
     2768
     2769
     2770\subsection{Using the decoder analyser}
     2771If the decoder is compiled with the macro RExt__DECODER_DEBUG_BIT_STATISTICS defined as 1 (either externally, or by editing TypeDef.h), the decoder will gather fractional bit counts associated with the different syntax elements, producing a table of the number of bits per syntax element, and where appropriate, according to block size and colour component/channel.
     2772The Linux makefile will compile both the analyser and standard version when the `all' or `everything' target is used (where the latter will also build  high-bit-depth executables).
    19992773
    20002774
Note: See TracChangeset for help on using the changeset viewer.