AOM decoder control functions.
This set of macros define the control functions available for the AOM decoder interface.
Enumerator |
---|
AOMD_GET_LAST_REF_UPDATES | Codec control function to get info on which reference frames were updated by the last decode, int* parameter.
|
AOMD_GET_FRAME_CORRUPTED | Codec control function to check if the indicated frame is corrupted, int* parameter.
|
AOMD_GET_LAST_REF_USED | Codec control function to get info on which reference frames were used by the last decode, int* parameter.
|
AV1D_GET_FRAME_SIZE | Codec control function to get the dimensions that the current frame is decoded at, int* parameter. This may be different to the intended display size for the frame as specified in the wrapper or frame header (see AV1D_GET_DISPLAY_SIZE).
|
AV1D_GET_DISPLAY_SIZE | Codec control function to get the current frame's intended display dimensions (as specified in the wrapper or frame header), int* parameter. This may be different to the decoded dimensions of this frame (see AV1D_GET_FRAME_SIZE).
|
AV1D_GET_BIT_DEPTH | Codec control function to get the bit depth of the stream, unsigned int* parameter.
|
AV1D_GET_IMG_FORMAT | Codec control function to get the image format of the stream, aom_img_fmt_t* parameter.
|
AV1D_GET_TILE_SIZE | Codec control function to get the size of the tile, unsigned int parameter.
|
AV1D_GET_TILE_COUNT | Codec control function to get the tile count in a tile list, int* parameter.
|
AV1_SET_BYTE_ALIGNMENT | Codec control function to set the byte alignment of the planes in the reference buffers, int parameter.
Valid values are power of 2, from 32 to 1024. A value of 0 sets legacy alignment. I.e. Y plane is aligned to 32 bytes, U plane directly follows Y plane, and V plane directly follows U plane. Default value is 0.
|
AV1_INVERT_TILE_DECODE_ORDER | Codec control function to invert the decoding order to from right to left, int parameter.
The function is used in a test to confirm the decoding independence of tile columns. The function may be used in application where this order of decoding is desired. int parameter
TODO(yaowu): Rework the unit test that uses this control, and in a future release, this test-only control shall be removed.
|
AV1_SET_SKIP_LOOP_FILTER | Codec control function to set the skip loop filter flag, int parameter.
Valid values are integers. The decoder will skip the loop filter when its value is set to nonzero. If the loop filter is skipped the decoder may accumulate decode artifacts. The default value is 0.
|
AV1_GET_ACCOUNTING | Codec control function to retrieve a pointer to the Accounting struct, takes Accounting** as parameter.
If called before a frame has been decoded, this returns AOM_CODEC_ERROR. The caller should ensure that AOM_CODEC_OK is returned before attempting to dereference the Accounting pointer.
- Attention
- When compiled without –enable-accounting, this returns AOM_CODEC_INCAPABLE.
|
AOMD_GET_LAST_QUANTIZER | Codec control function to get last decoded frame quantizer, int* parameter.
Returned value uses internal quantizer scale defined by the codec.
|
AV1_SET_DECODE_TILE_ROW | Codec control function to set the range of tile decoding, int parameter.
A value that is greater and equal to zero indicates only the specific row/column is decoded. A value that is -1 indicates the whole row/column is decoded. A special case is both values are -1 that means the whole frame is decoded.
|
AV1_SET_TILE_MODE | Codec control function to set the tile coding mode, int parameter.
- 0 = tiles are coded in normal tile mode
- 1 = tiles are coded in large-scale tile mode
|
AV1D_GET_FRAME_HEADER_INFO | Codec control function to get the frame header information of an encoded frame, unsigned int* parameter.
|
AV1D_GET_TILE_DATA | Codec control function to get the start address and size of a tile in the coded bitstream, aom_tile_data* parameter.
|
AV1D_SET_EXT_REF_PTR | Codec control function to set the external references' pointers in the decoder, av1_ext_ref_frame_t* parameter.
This is used while decoding the tile list OBU in large-scale tile coding mode.
|
AV1D_EXT_TILE_DEBUG | Codec control function to enable the ext-tile software debug and testing code in the decoder, unsigned int parameter.
|
AV1D_SET_ROW_MT | Codec control function to enable the row based multi-threading of decoding, unsigned int parameter.
- 0 = disabled
- 1 = enabled (default)
|
AV1D_SET_IS_ANNEXB | Codec control function to indicate whether bitstream is in Annex-B format, unsigned int parameter.
|
AV1D_SET_OPERATING_POINT | Codec control function to indicate which operating point to use, int parameter.
A scalable stream may define multiple operating points, each of which defines a set of temporal and spatial layers to be processed. The operating point index may take a value between 0 and operating_points_cnt_minus_1 (which is at most 31).
|
AV1D_SET_OUTPUT_ALL_LAYERS | Codec control function to indicate whether to output one frame per temporal unit (the default), or one frame per spatial layer. int parameter.
In a scalable stream, each temporal unit corresponds to a single "frame" of video, and within a temporal unit there may be multiple spatial layers with different versions of that frame. For video playback, only the highest-quality version (within the selected operating point) is needed, but for some use cases it is useful to have access to multiple versions of a frame when they are available.
|
AV1_SET_INSPECTION_CALLBACK | Codec control function to set an aom_inspect_cb callback that is invoked each time a frame is decoded, aom_inspect_init* parameter.
- Attention
- When compiled without –enable-inspection, this returns AOM_CODEC_INCAPABLE.
|
AV1D_SET_SKIP_FILM_GRAIN | Codec control function to set the skip film grain flag, int parameter.
Valid values are integers. The decoder will skip the film grain when its value is set to nonzero. The default value is 0.
|