Skip to content
  • Geza Lore's avatar
    Make superblock size variable at the frame level. · 454989ff
    Geza Lore authored
    The uncompressed frame header contains a bit to signal whether the
    frame is encoded using 64x64 or 128x128 superblocks. This can vary
    between any 2 frames.
    
    vpxenc gained the --sb-size={64,128,dynamic} option, which allows the
    configuration of the superblock size used (default is dynamic). 64/128
    will force the encoder to always use the specified superblock size.
    Dynamic would enable the encoder to choose the sb size for each
    frame, but this is not implemented yet (dynamic does the same as 128
    for now).
    
    Constraints on tile sizes depend on the superblock size, the following
    is a summary of the current bitstream syntax and semantics:
    
    If both --enable-ext-tile is OFF and --enable-ext-partition is OFF:
         The tile coding in this case is the same as VP9. In particular,
         tiles have a minimum width of 256 pixels and a maximum width of
         4096 pixels. The tile width must be multiples of 64 pixels
         (except for the rightmost tile column). There can be a maximum
         of 64 tile columns and 4 tile rows.
    
    If --enable-ext-tile is OFF and --enable-ext-partition is ON:
         Same constraints as above, except that tile width must be
         multiples of 128 pixels (except for the rightmost tile column).
    
    There is no change in the bitstream syntax used for coding the tile
    configuration if --enable-ext-tile is OFF.
    
    If --enable-ext-tile is ON and --enable-ext-partition is ON:
         This is the new large scale tile coding configuration. The
         minimum/maximum tile width and height are 64/4096 pixels. Tile
         width and height must be multiples of 64 pixels. The uncompressed
         header contains two 6 bit fields that hold the tile width/heigh
         in units of 64 pixels. The maximum number of tile rows/columns
         is only limited by the maximum frame size of 65536x65536 pixels
         that can be coded in the bitstream. This yields a maximum of
         1024x1024 tile rows and columns (of 64x64 tiles in a 65536x65536
         frame).
    
    If both --enable-ext-tile is ON and --enable-ext-partition is ON:
         Same applies as above, except that in the bitstream the 2 fields
         containing the tile width/height are in units of the superblock
         size, and the superblock size itself is also coded in the bitstream.
         If the uncompressed header signals the use of 64x64 superblocks,
         then the tile width/height fields are 6 bits wide and are in units
         of 64 pixels. If the uncompressed header signals the use of 128x128
         superblocks, then the tile width/height fields are 5 bits wide and
         are in units of 128 pixels.
    
    The above is a summary of the bitstream. The user interface to vpxenc
    (and the equivalent encoder API) behaves a follows:
    
    If --enable-ext-tile is OFF:
         No change in the user interface. --tile-columns and --tile-rows
         specify the base 2 logarithm of the desired number of tile columns
         and tile rows. The actual number of tile rows and tile columns,
         and the particular tile width and tile height are computed by the
         codec ensuring all of the above constraints are respected.
    
    If --enable-ext-tile is ON, but --enable-ext-partition is OFF:
         No change in the user interface. --tile-columns and --tile-rows
         specify the WIDTH and HEIGHT of the tiles in unit of 64 pixels.
         The valid values are in the range [1, 64] (which corresponds to
         [64, 4096] pixels in increments of 64.
    
    If both --enable-ext-tile is ON and --enable-ext-partition is ON:
         If --sb-size=64 (default):
             The user interface is the same as in the previous point.
             --tile-columns and --tile-rows specify tile WIDTH and HEIGHT,
             in units of 64 pixels, in the range [1, 64] (which corresponds
             to [64, 4096] pixels in increments of 64).
         If --sb-size=128 or --sb-size=dynamic:
             --tile-columns and --tile-rows specify tile WIDTH and HEIGHT,
             in units of 128 pixels in the range [1, 32] (which corresponds
             to [128, 4096] pixels in increments of 128).
    
    Change-Id: Idc9beee1ad12ff1634e83671985d14c680f9179a
    454989ff