av1.h (5368B)
1 /* 2 * This file is part of FFmpeg. 3 * 4 * FFmpeg is free software; you can redistribute it and/or 5 * modify it under the terms of the GNU Lesser General Public 6 * License as published by the Free Software Foundation; either 7 * version 2.1 of the License, or (at your option) any later version. 8 * 9 * FFmpeg is distributed in the hope that it will be useful, 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of 11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 12 * Lesser General Public License for more details. 13 * 14 * You should have received a copy of the GNU Lesser General Public 15 * License along with FFmpeg; if not, write to the Free Software 16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 17 */ 18 19 /** 20 * @file 21 * AV1 common definitions 22 */ 23 24 #ifndef AVCODEC_AV1_H 25 #define AVCODEC_AV1_H 26 27 // OBU types (section 6.2.2). 28 typedef enum { 29 // 0 reserved. 30 AV1_OBU_SEQUENCE_HEADER = 1, 31 AV1_OBU_TEMPORAL_DELIMITER = 2, 32 AV1_OBU_FRAME_HEADER = 3, 33 AV1_OBU_TILE_GROUP = 4, 34 AV1_OBU_METADATA = 5, 35 AV1_OBU_FRAME = 6, 36 AV1_OBU_REDUNDANT_FRAME_HEADER = 7, 37 AV1_OBU_TILE_LIST = 8, 38 // 9-14 reserved. 39 AV1_OBU_PADDING = 15, 40 } AV1_OBU_Type; 41 42 // Metadata types (section 6.7.1). 43 enum { 44 AV1_METADATA_TYPE_HDR_CLL = 1, 45 AV1_METADATA_TYPE_HDR_MDCV = 2, 46 AV1_METADATA_TYPE_SCALABILITY = 3, 47 AV1_METADATA_TYPE_ITUT_T35 = 4, 48 AV1_METADATA_TYPE_TIMECODE = 5, 49 }; 50 51 // Frame types (section 6.8.2). 52 enum { 53 AV1_FRAME_KEY = 0, 54 AV1_FRAME_INTER = 1, 55 AV1_FRAME_INTRA_ONLY = 2, 56 AV1_FRAME_SWITCH = 3, 57 }; 58 59 // Reference frames (section 6.10.24). 60 enum { 61 AV1_REF_FRAME_NONE = -1, 62 AV1_REF_FRAME_INTRA = 0, 63 AV1_REF_FRAME_LAST = 1, 64 AV1_REF_FRAME_LAST2 = 2, 65 AV1_REF_FRAME_LAST3 = 3, 66 AV1_REF_FRAME_GOLDEN = 4, 67 AV1_REF_FRAME_BWDREF = 5, 68 AV1_REF_FRAME_ALTREF2 = 6, 69 AV1_REF_FRAME_ALTREF = 7, 70 }; 71 72 // Constants (section 3). 73 enum { 74 AV1_MAX_OPERATING_POINTS = 32, 75 76 AV1_MAX_SB_SIZE = 128, 77 AV1_MI_SIZE = 4, 78 79 AV1_MAX_TILE_WIDTH = 4096, 80 AV1_MAX_TILE_AREA = 4096 * 2304, 81 AV1_MAX_TILE_ROWS = 64, 82 AV1_MAX_TILE_COLS = 64, 83 84 AV1_NUM_REF_FRAMES = 8, 85 AV1_REFS_PER_FRAME = 7, 86 AV1_TOTAL_REFS_PER_FRAME = 8, 87 AV1_PRIMARY_REF_NONE = 7, 88 89 AV1_MAX_SEGMENTS = 8, 90 AV1_SEG_LVL_MAX = 8, 91 92 AV1_SEG_LVL_ALT_Q = 0, 93 AV1_SEG_LVL_ALT_LF_Y_V = 1, 94 AV1_SEG_LVL_REF_FRAME = 5, 95 AV1_SEG_LVL_SKIP = 6, 96 AV1_SEG_LVL_GLOBAL_MV = 7, 97 98 AV1_SELECT_SCREEN_CONTENT_TOOLS = 2, 99 AV1_SELECT_INTEGER_MV = 2, 100 101 AV1_SUPERRES_NUM = 8, 102 AV1_SUPERRES_DENOM_MIN = 9, 103 104 AV1_INTERPOLATION_FILTER_SWITCHABLE = 4, 105 106 AV1_GM_ABS_ALPHA_BITS = 12, 107 AV1_GM_ALPHA_PREC_BITS = 15, 108 AV1_GM_ABS_TRANS_ONLY_BITS = 9, 109 AV1_GM_TRANS_ONLY_PREC_BITS = 3, 110 AV1_GM_ABS_TRANS_BITS = 12, 111 AV1_GM_TRANS_PREC_BITS = 6, 112 AV1_WARPEDMODEL_PREC_BITS = 16, 113 114 AV1_WARP_MODEL_IDENTITY = 0, 115 AV1_WARP_MODEL_TRANSLATION = 1, 116 AV1_WARP_MODEL_ROTZOOM = 2, 117 AV1_WARP_MODEL_AFFINE = 3, 118 AV1_WARP_PARAM_REDUCE_BITS = 6, 119 120 AV1_DIV_LUT_BITS = 8, 121 AV1_DIV_LUT_PREC_BITS = 14, 122 AV1_DIV_LUT_NUM = 257, 123 124 AV1_MAX_LOOP_FILTER = 63, 125 }; 126 127 128 // The main colour configuration information uses the same ISO/IEC 23001-8 129 // (H.273) enums as FFmpeg does, so separate definitions are not required. 130 131 // Chroma sample position. 132 enum { 133 AV1_CSP_UNKNOWN = 0, 134 AV1_CSP_VERTICAL = 1, // -> AVCHROMA_LOC_LEFT. 135 AV1_CSP_COLOCATED = 2, // -> AVCHROMA_LOC_TOPLEFT. 136 }; 137 138 // Scalability modes (section 6.7.5) 139 enum { 140 AV1_SCALABILITY_L1T2 = 0, 141 AV1_SCALABILITY_L1T3 = 1, 142 AV1_SCALABILITY_L2T1 = 2, 143 AV1_SCALABILITY_L2T2 = 3, 144 AV1_SCALABILITY_L2T3 = 4, 145 AV1_SCALABILITY_S2T1 = 5, 146 AV1_SCALABILITY_S2T2 = 6, 147 AV1_SCALABILITY_S2T3 = 7, 148 AV1_SCALABILITY_L2T1h = 8, 149 AV1_SCALABILITY_L2T2h = 9, 150 AV1_SCALABILITY_L2T3h = 10, 151 AV1_SCALABILITY_S2T1h = 11, 152 AV1_SCALABILITY_S2T2h = 12, 153 AV1_SCALABILITY_S2T3h = 13, 154 AV1_SCALABILITY_SS = 14, 155 AV1_SCALABILITY_L3T1 = 15, 156 AV1_SCALABILITY_L3T2 = 16, 157 AV1_SCALABILITY_L3T3 = 17, 158 AV1_SCALABILITY_S3T1 = 18, 159 AV1_SCALABILITY_S3T2 = 19, 160 AV1_SCALABILITY_S3T3 = 20, 161 AV1_SCALABILITY_L3T2_KEY = 21, 162 AV1_SCALABILITY_L3T3_KEY = 22, 163 AV1_SCALABILITY_L4T5_KEY = 23, 164 AV1_SCALABILITY_L4T7_KEY = 24, 165 AV1_SCALABILITY_L3T2_KEY_SHIFT = 25, 166 AV1_SCALABILITY_L3T3_KEY_SHIFT = 26, 167 AV1_SCALABILITY_L4T5_KEY_SHIFT = 27, 168 AV1_SCALABILITY_L4T7_KEY_SHIFT = 28, 169 }; 170 171 // Frame Restoration types (section 6.10.15) 172 enum { 173 AV1_RESTORE_NONE = 0, 174 AV1_RESTORE_WIENER = 1, 175 AV1_RESTORE_SGRPROJ = 2, 176 AV1_RESTORE_SWITCHABLE = 3, 177 }; 178 179 // TX mode (section 6.8.21) 180 enum { 181 AV1_ONLY_4X4 = 0, 182 AV1_TX_MODE_LARGEST = 1, 183 AV1_TX_MODE_SELECT = 2, 184 }; 185 186 // Sequence Headers are actually unbounded because one can use 187 // an arbitrary number of leading zeroes when encoding via uvlc. 188 // The following estimate is based around using the lowest number 189 // of bits for uvlc encoding. 190 #define AV1_SANE_SEQUENCE_HEADER_MAX_BITS 3138 191 192 #endif /* AVCODEC_AV1_H */