mirror of
https://github.com/DrKLO/Telegram.git
synced 2025-03-23 15:19:32 +01:00
444 lines
14 KiB
C
444 lines
14 KiB
C
/*
|
|
* Copyright © 2018-2020, VideoLAN and dav1d authors
|
|
* Copyright © 2018, Two Orioles, LLC
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright notice, this
|
|
* list of conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
|
|
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef DAV1D_HEADERS_H
|
|
#define DAV1D_HEADERS_H
|
|
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// Constants from Section 3. "Symbols and abbreviated terms"
|
|
#define DAV1D_MAX_CDEF_STRENGTHS 8
|
|
#define DAV1D_MAX_OPERATING_POINTS 32
|
|
#define DAV1D_MAX_TILE_COLS 64
|
|
#define DAV1D_MAX_TILE_ROWS 64
|
|
#define DAV1D_MAX_SEGMENTS 8
|
|
#define DAV1D_NUM_REF_FRAMES 8
|
|
#define DAV1D_PRIMARY_REF_NONE 7
|
|
#define DAV1D_REFS_PER_FRAME 7
|
|
#define DAV1D_TOTAL_REFS_PER_FRAME (DAV1D_REFS_PER_FRAME + 1)
|
|
|
|
enum Dav1dObuType {
|
|
DAV1D_OBU_SEQ_HDR = 1,
|
|
DAV1D_OBU_TD = 2,
|
|
DAV1D_OBU_FRAME_HDR = 3,
|
|
DAV1D_OBU_TILE_GRP = 4,
|
|
DAV1D_OBU_METADATA = 5,
|
|
DAV1D_OBU_FRAME = 6,
|
|
DAV1D_OBU_REDUNDANT_FRAME_HDR = 7,
|
|
DAV1D_OBU_PADDING = 15,
|
|
};
|
|
|
|
enum Dav1dTxfmMode {
|
|
DAV1D_TX_4X4_ONLY,
|
|
DAV1D_TX_LARGEST,
|
|
DAV1D_TX_SWITCHABLE,
|
|
DAV1D_N_TX_MODES,
|
|
};
|
|
|
|
enum Dav1dFilterMode {
|
|
DAV1D_FILTER_8TAP_REGULAR,
|
|
DAV1D_FILTER_8TAP_SMOOTH,
|
|
DAV1D_FILTER_8TAP_SHARP,
|
|
DAV1D_N_SWITCHABLE_FILTERS,
|
|
DAV1D_FILTER_BILINEAR = DAV1D_N_SWITCHABLE_FILTERS,
|
|
DAV1D_N_FILTERS,
|
|
DAV1D_FILTER_SWITCHABLE = DAV1D_N_FILTERS,
|
|
};
|
|
|
|
enum Dav1dAdaptiveBoolean {
|
|
DAV1D_OFF = 0,
|
|
DAV1D_ON = 1,
|
|
DAV1D_ADAPTIVE = 2,
|
|
};
|
|
|
|
enum Dav1dRestorationType {
|
|
DAV1D_RESTORATION_NONE,
|
|
DAV1D_RESTORATION_SWITCHABLE,
|
|
DAV1D_RESTORATION_WIENER,
|
|
DAV1D_RESTORATION_SGRPROJ,
|
|
};
|
|
|
|
enum Dav1dWarpedMotionType {
|
|
DAV1D_WM_TYPE_IDENTITY,
|
|
DAV1D_WM_TYPE_TRANSLATION,
|
|
DAV1D_WM_TYPE_ROT_ZOOM,
|
|
DAV1D_WM_TYPE_AFFINE,
|
|
};
|
|
|
|
typedef struct Dav1dWarpedMotionParams {
|
|
enum Dav1dWarpedMotionType type;
|
|
int32_t matrix[6];
|
|
union {
|
|
struct {
|
|
int16_t alpha, beta, gamma, delta;
|
|
} p;
|
|
int16_t abcd[4];
|
|
} u;
|
|
} Dav1dWarpedMotionParams;
|
|
|
|
enum Dav1dPixelLayout {
|
|
DAV1D_PIXEL_LAYOUT_I400, ///< monochrome
|
|
DAV1D_PIXEL_LAYOUT_I420, ///< 4:2:0 planar
|
|
DAV1D_PIXEL_LAYOUT_I422, ///< 4:2:2 planar
|
|
DAV1D_PIXEL_LAYOUT_I444, ///< 4:4:4 planar
|
|
};
|
|
|
|
enum Dav1dFrameType {
|
|
DAV1D_FRAME_TYPE_KEY = 0, ///< Key Intra frame
|
|
DAV1D_FRAME_TYPE_INTER = 1, ///< Inter frame
|
|
DAV1D_FRAME_TYPE_INTRA = 2, ///< Non key Intra frame
|
|
DAV1D_FRAME_TYPE_SWITCH = 3, ///< Switch Inter frame
|
|
};
|
|
|
|
enum Dav1dColorPrimaries {
|
|
DAV1D_COLOR_PRI_BT709 = 1,
|
|
DAV1D_COLOR_PRI_UNKNOWN = 2,
|
|
DAV1D_COLOR_PRI_BT470M = 4,
|
|
DAV1D_COLOR_PRI_BT470BG = 5,
|
|
DAV1D_COLOR_PRI_BT601 = 6,
|
|
DAV1D_COLOR_PRI_SMPTE240 = 7,
|
|
DAV1D_COLOR_PRI_FILM = 8,
|
|
DAV1D_COLOR_PRI_BT2020 = 9,
|
|
DAV1D_COLOR_PRI_XYZ = 10,
|
|
DAV1D_COLOR_PRI_SMPTE431 = 11,
|
|
DAV1D_COLOR_PRI_SMPTE432 = 12,
|
|
DAV1D_COLOR_PRI_EBU3213 = 22,
|
|
DAV1D_COLOR_PRI_RESERVED = 255,
|
|
};
|
|
|
|
enum Dav1dTransferCharacteristics {
|
|
DAV1D_TRC_BT709 = 1,
|
|
DAV1D_TRC_UNKNOWN = 2,
|
|
DAV1D_TRC_BT470M = 4,
|
|
DAV1D_TRC_BT470BG = 5,
|
|
DAV1D_TRC_BT601 = 6,
|
|
DAV1D_TRC_SMPTE240 = 7,
|
|
DAV1D_TRC_LINEAR = 8,
|
|
DAV1D_TRC_LOG100 = 9, ///< logarithmic (100:1 range)
|
|
DAV1D_TRC_LOG100_SQRT10 = 10, ///< lograithmic (100*sqrt(10):1 range)
|
|
DAV1D_TRC_IEC61966 = 11,
|
|
DAV1D_TRC_BT1361 = 12,
|
|
DAV1D_TRC_SRGB = 13,
|
|
DAV1D_TRC_BT2020_10BIT = 14,
|
|
DAV1D_TRC_BT2020_12BIT = 15,
|
|
DAV1D_TRC_SMPTE2084 = 16, ///< PQ
|
|
DAV1D_TRC_SMPTE428 = 17,
|
|
DAV1D_TRC_HLG = 18, ///< hybrid log/gamma (BT.2100 / ARIB STD-B67)
|
|
DAV1D_TRC_RESERVED = 255,
|
|
};
|
|
|
|
enum Dav1dMatrixCoefficients {
|
|
DAV1D_MC_IDENTITY = 0,
|
|
DAV1D_MC_BT709 = 1,
|
|
DAV1D_MC_UNKNOWN = 2,
|
|
DAV1D_MC_FCC = 4,
|
|
DAV1D_MC_BT470BG = 5,
|
|
DAV1D_MC_BT601 = 6,
|
|
DAV1D_MC_SMPTE240 = 7,
|
|
DAV1D_MC_SMPTE_YCGCO = 8,
|
|
DAV1D_MC_BT2020_NCL = 9,
|
|
DAV1D_MC_BT2020_CL = 10,
|
|
DAV1D_MC_SMPTE2085 = 11,
|
|
DAV1D_MC_CHROMAT_NCL = 12, ///< Chromaticity-derived
|
|
DAV1D_MC_CHROMAT_CL = 13,
|
|
DAV1D_MC_ICTCP = 14,
|
|
DAV1D_MC_RESERVED = 255,
|
|
};
|
|
|
|
enum Dav1dChromaSamplePosition {
|
|
DAV1D_CHR_UNKNOWN = 0,
|
|
DAV1D_CHR_VERTICAL = 1, ///< Horizontally co-located with luma(0, 0)
|
|
///< sample, between two vertical samples
|
|
DAV1D_CHR_COLOCATED = 2, ///< Co-located with luma(0, 0) sample
|
|
};
|
|
|
|
typedef struct Dav1dContentLightLevel {
|
|
uint16_t max_content_light_level;
|
|
uint16_t max_frame_average_light_level;
|
|
} Dav1dContentLightLevel;
|
|
|
|
typedef struct Dav1dMasteringDisplay {
|
|
///< 0.16 fixed point
|
|
uint16_t primaries[3][2];
|
|
///< 0.16 fixed point
|
|
uint16_t white_point[2];
|
|
///< 24.8 fixed point
|
|
uint32_t max_luminance;
|
|
///< 18.14 fixed point
|
|
uint32_t min_luminance;
|
|
} Dav1dMasteringDisplay;
|
|
|
|
typedef struct Dav1dITUTT35 {
|
|
uint8_t country_code;
|
|
uint8_t country_code_extension_byte;
|
|
size_t payload_size;
|
|
uint8_t *payload;
|
|
} Dav1dITUTT35;
|
|
|
|
typedef struct Dav1dSequenceHeader {
|
|
/**
|
|
* Stream profile, 0 for 8-10 bits/component 4:2:0 or monochrome;
|
|
* 1 for 8-10 bits/component 4:4:4; 2 for 4:2:2 at any bits/component,
|
|
* or 12 bits/component at any chroma subsampling.
|
|
*/
|
|
uint8_t profile;
|
|
/**
|
|
* Maximum dimensions for this stream. In non-scalable streams, these
|
|
* are often the actual dimensions of the stream, although that is not
|
|
* a normative requirement.
|
|
*/
|
|
int max_width, max_height;
|
|
enum Dav1dPixelLayout layout; ///< format of the picture
|
|
enum Dav1dColorPrimaries pri; ///< color primaries (av1)
|
|
enum Dav1dTransferCharacteristics trc; ///< transfer characteristics (av1)
|
|
enum Dav1dMatrixCoefficients mtrx; ///< matrix coefficients (av1)
|
|
enum Dav1dChromaSamplePosition chr; ///< chroma sample position (av1)
|
|
/**
|
|
* 0, 1 and 2 mean 8, 10 or 12 bits/component, respectively. This is not
|
|
* exactly the same as 'hbd' from the spec; the spec's hbd distinguishes
|
|
* between 8 (0) and 10-12 (1) bits/component, and another element
|
|
* (twelve_bit) to distinguish between 10 and 12 bits/component. To get
|
|
* the spec's hbd, use !!our_hbd, and to get twelve_bit, use hbd == 2.
|
|
*/
|
|
uint8_t hbd;
|
|
/**
|
|
* Pixel data uses JPEG pixel range ([0,255] for 8bits) instead of
|
|
* MPEG pixel range ([16,235] for 8bits luma, [16,240] for 8bits chroma).
|
|
*/
|
|
uint8_t color_range;
|
|
|
|
uint8_t num_operating_points;
|
|
struct Dav1dSequenceHeaderOperatingPoint {
|
|
uint8_t major_level, minor_level;
|
|
uint8_t initial_display_delay;
|
|
uint16_t idc;
|
|
uint8_t tier;
|
|
uint8_t decoder_model_param_present;
|
|
uint8_t display_model_param_present;
|
|
} operating_points[DAV1D_MAX_OPERATING_POINTS];
|
|
|
|
uint8_t still_picture;
|
|
uint8_t reduced_still_picture_header;
|
|
uint8_t timing_info_present;
|
|
uint32_t num_units_in_tick;
|
|
uint32_t time_scale;
|
|
uint8_t equal_picture_interval;
|
|
uint32_t num_ticks_per_picture;
|
|
uint8_t decoder_model_info_present;
|
|
uint8_t encoder_decoder_buffer_delay_length;
|
|
uint32_t num_units_in_decoding_tick;
|
|
uint8_t buffer_removal_delay_length;
|
|
uint8_t frame_presentation_delay_length;
|
|
uint8_t display_model_info_present;
|
|
uint8_t width_n_bits, height_n_bits;
|
|
uint8_t frame_id_numbers_present;
|
|
uint8_t delta_frame_id_n_bits;
|
|
uint8_t frame_id_n_bits;
|
|
uint8_t sb128;
|
|
uint8_t filter_intra;
|
|
uint8_t intra_edge_filter;
|
|
uint8_t inter_intra;
|
|
uint8_t masked_compound;
|
|
uint8_t warped_motion;
|
|
uint8_t dual_filter;
|
|
uint8_t order_hint;
|
|
uint8_t jnt_comp;
|
|
uint8_t ref_frame_mvs;
|
|
enum Dav1dAdaptiveBoolean screen_content_tools;
|
|
enum Dav1dAdaptiveBoolean force_integer_mv;
|
|
uint8_t order_hint_n_bits;
|
|
uint8_t super_res;
|
|
uint8_t cdef;
|
|
uint8_t restoration;
|
|
uint8_t ss_hor, ss_ver, monochrome;
|
|
uint8_t color_description_present;
|
|
uint8_t separate_uv_delta_q;
|
|
uint8_t film_grain_present;
|
|
|
|
// Dav1dSequenceHeaders of the same sequence are required to be
|
|
// bit-identical until this offset. See 7.5 "Ordering of OBUs":
|
|
// Within a particular coded video sequence, the contents of
|
|
// sequence_header_obu must be bit-identical each time the
|
|
// sequence header appears except for the contents of
|
|
// operating_parameters_info.
|
|
struct Dav1dSequenceHeaderOperatingParameterInfo {
|
|
uint32_t decoder_buffer_delay;
|
|
uint32_t encoder_buffer_delay;
|
|
uint8_t low_delay_mode;
|
|
} operating_parameter_info[DAV1D_MAX_OPERATING_POINTS];
|
|
} Dav1dSequenceHeader;
|
|
|
|
typedef struct Dav1dSegmentationData {
|
|
int16_t delta_q;
|
|
int8_t delta_lf_y_v, delta_lf_y_h, delta_lf_u, delta_lf_v;
|
|
int8_t ref;
|
|
uint8_t skip;
|
|
uint8_t globalmv;
|
|
} Dav1dSegmentationData;
|
|
|
|
typedef struct Dav1dSegmentationDataSet {
|
|
Dav1dSegmentationData d[DAV1D_MAX_SEGMENTS];
|
|
uint8_t preskip;
|
|
int8_t last_active_segid;
|
|
} Dav1dSegmentationDataSet;
|
|
|
|
typedef struct Dav1dLoopfilterModeRefDeltas {
|
|
int8_t mode_delta[2 /* is_zeromv */];
|
|
int8_t ref_delta[DAV1D_TOTAL_REFS_PER_FRAME];
|
|
} Dav1dLoopfilterModeRefDeltas;
|
|
|
|
typedef struct Dav1dFilmGrainData {
|
|
unsigned seed;
|
|
int num_y_points;
|
|
uint8_t y_points[14][2 /* value, scaling */];
|
|
int chroma_scaling_from_luma;
|
|
int num_uv_points[2];
|
|
uint8_t uv_points[2][10][2 /* value, scaling */];
|
|
int scaling_shift;
|
|
int ar_coeff_lag;
|
|
int8_t ar_coeffs_y[24];
|
|
int8_t ar_coeffs_uv[2][25 + 3 /* padding for alignment purposes */];
|
|
uint64_t ar_coeff_shift;
|
|
int grain_scale_shift;
|
|
int uv_mult[2];
|
|
int uv_luma_mult[2];
|
|
int uv_offset[2];
|
|
int overlap_flag;
|
|
int clip_to_restricted_range;
|
|
} Dav1dFilmGrainData;
|
|
|
|
typedef struct Dav1dFrameHeader {
|
|
struct {
|
|
Dav1dFilmGrainData data;
|
|
uint8_t present, update;
|
|
} film_grain; ///< film grain parameters
|
|
enum Dav1dFrameType frame_type; ///< type of the picture
|
|
int width[2 /* { coded_width, superresolution_upscaled_width } */], height;
|
|
uint8_t frame_offset; ///< frame number
|
|
uint8_t temporal_id; ///< temporal id of the frame for SVC
|
|
uint8_t spatial_id; ///< spatial id of the frame for SVC
|
|
|
|
uint8_t show_existing_frame;
|
|
uint8_t existing_frame_idx;
|
|
uint32_t frame_id;
|
|
uint32_t frame_presentation_delay;
|
|
uint8_t show_frame;
|
|
uint8_t showable_frame;
|
|
uint8_t error_resilient_mode;
|
|
uint8_t disable_cdf_update;
|
|
uint8_t allow_screen_content_tools;
|
|
uint8_t force_integer_mv;
|
|
uint8_t frame_size_override;
|
|
uint8_t primary_ref_frame;
|
|
uint8_t buffer_removal_time_present;
|
|
struct Dav1dFrameHeaderOperatingPoint {
|
|
uint32_t buffer_removal_time;
|
|
} operating_points[DAV1D_MAX_OPERATING_POINTS];
|
|
uint8_t refresh_frame_flags;
|
|
int render_width, render_height;
|
|
struct {
|
|
uint8_t width_scale_denominator;
|
|
uint8_t enabled;
|
|
} super_res;
|
|
uint8_t have_render_size;
|
|
uint8_t allow_intrabc;
|
|
uint8_t frame_ref_short_signaling;
|
|
int8_t refidx[DAV1D_REFS_PER_FRAME];
|
|
uint8_t hp;
|
|
enum Dav1dFilterMode subpel_filter_mode;
|
|
uint8_t switchable_motion_mode;
|
|
uint8_t use_ref_frame_mvs;
|
|
uint8_t refresh_context;
|
|
struct {
|
|
uint8_t uniform;
|
|
uint8_t n_bytes;
|
|
uint8_t min_log2_cols, max_log2_cols, log2_cols, cols;
|
|
uint8_t min_log2_rows, max_log2_rows, log2_rows, rows;
|
|
uint16_t col_start_sb[DAV1D_MAX_TILE_COLS + 1];
|
|
uint16_t row_start_sb[DAV1D_MAX_TILE_ROWS + 1];
|
|
uint16_t update;
|
|
} tiling;
|
|
struct {
|
|
uint8_t yac;
|
|
int8_t ydc_delta;
|
|
int8_t udc_delta, uac_delta, vdc_delta, vac_delta;
|
|
uint8_t qm, qm_y, qm_u, qm_v;
|
|
} quant;
|
|
struct {
|
|
uint8_t enabled, update_map, temporal, update_data;
|
|
Dav1dSegmentationDataSet seg_data;
|
|
uint8_t lossless[DAV1D_MAX_SEGMENTS], qidx[DAV1D_MAX_SEGMENTS];
|
|
} segmentation;
|
|
struct {
|
|
struct {
|
|
uint8_t present;
|
|
uint8_t res_log2;
|
|
} q;
|
|
struct {
|
|
uint8_t present;
|
|
uint8_t res_log2;
|
|
uint8_t multi;
|
|
} lf;
|
|
} delta;
|
|
uint8_t all_lossless;
|
|
struct {
|
|
uint8_t level_y[2 /* dir */];
|
|
uint8_t level_u, level_v;
|
|
uint8_t mode_ref_delta_enabled;
|
|
uint8_t mode_ref_delta_update;
|
|
Dav1dLoopfilterModeRefDeltas mode_ref_deltas;
|
|
uint8_t sharpness;
|
|
} loopfilter;
|
|
struct {
|
|
uint8_t damping;
|
|
uint8_t n_bits;
|
|
uint8_t y_strength[DAV1D_MAX_CDEF_STRENGTHS];
|
|
uint8_t uv_strength[DAV1D_MAX_CDEF_STRENGTHS];
|
|
} cdef;
|
|
struct {
|
|
enum Dav1dRestorationType type[3 /* plane */];
|
|
uint8_t unit_size[2 /* y, uv */];
|
|
} restoration;
|
|
enum Dav1dTxfmMode txfm_mode;
|
|
uint8_t switchable_comp_refs;
|
|
uint8_t skip_mode_allowed, skip_mode_enabled;
|
|
int8_t skip_mode_refs[2];
|
|
uint8_t warp_motion;
|
|
uint8_t reduced_txtp_set;
|
|
Dav1dWarpedMotionParams gmv[DAV1D_REFS_PER_FRAME];
|
|
} Dav1dFrameHeader;
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#endif /* DAV1D_HEADERS_H */
|