#ifndef GLOBAL_H_ #define GLOBAL_H_ /***************************************************************************** * This file is part of Kvazaar HEVC encoder. * * Copyright (C) 2013-2015 Tampere University of Technology and others (see * COPYING file). * * Kvazaar is free software: you can redistribute it and/or modify it under * the terms of the GNU Lesser General Public License as published by the * Free Software Foundation; either version 2.1 of the License, or (at your * option) any later version. * * Kvazaar is distributed in the hope that it will be useful, but WITHOUT ANY * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for * more details. * * You should have received a copy of the GNU General Public License along * with Kvazaar. If not, see . ****************************************************************************/ /** * \file * Header that is included in every other header. * * This file contains global constants that can be referred to from any header * or source file. It also contains some helper macros and includes stdint.h * so that any file can refer to integer types with exact widths. */ #ifdef HAVE_CONFIG_H // Include config.h generated by automake. This needs to be before any other // includes in every file, which is why it's in global. #include "config.h" #endif #include #include #include #include #include #include #include #include "kvazaar.h" /** * \defgroup Bitstream * HEVC bitstream coding * * \defgroup CABAC * Context Adaptive Binary Arithmetic Encoder implementation * * \defgroup Compression * Prediction parameter decisions and ratedistortion optimization * * \defgroup Control * Initialization and control flow of the encoder * * \defgroup DataStructures * Containers for images, predictions parameters and such * * \defgroup Extras * 3rd party modules not considered part of the encoder. * * \defgroup Optimization * Architecture dependant SIMD optimizations and dynamic dispatch mechanism * * \defgroup Reconstruction * Stuff required for creating the resulting image after lossy compression * * \defgroup Threading * Stuff related to multi-threading using pthreads */ #if defined(_MSC_VER) && defined(_M_AMD64) #define X86_64 #endif #if defined(__GNUC__) && defined(__x86_64__) #define X86_64 #endif #define PIXEL_MIN 0 #define PIXEL_MAX ((1 << KVZ_BIT_DEPTH) - 1) typedef int16_t coeff_t; //#define VERBOSE 1 /* CONFIG VARIABLES */ //spec: references to variables defined in Rec. ITU-T H.265 (04/2013) //! Limits for prediction block sizes. 0 = 64x64, 4 = 4x4. #define PU_DEPTH_INTER_MIN 0 #define PU_DEPTH_INTER_MAX 3 #define PU_DEPTH_INTRA_MIN 0 #define PU_DEPTH_INTRA_MAX 4 //! Maximum number of layers in GOP structure (for allocating structures) #define MAX_GOP_LAYERS 6 //! Maximum CU depth when descending form LCU level. //! spec: log2_diff_max_min_luma_coding_block_size #define MAX_DEPTH 3 //! Minimum log2 size of CUs. //! spec: MinCbLog2SizeY #define MIN_SIZE 3 //! Minimum log2 size of PUs. //! Search is started at depth 0 and goes in Z-order to MAX_PU_DEPTH, see search_cu() #define MAX_PU_DEPTH 4 //! Minimum log2 transform sizes. //! spec: max_transform_hierarchy_depth_inter #define TR_DEPTH_INTER 2 //! spec: pcm_enabled_flag, Setting to 1 will enable using PCM blocks (current intra-search does not consider PCM) #define ENABLE_PCM 0 //! Enable usage of temporal Motion Vector Prediction #define ENABLE_TEMPORAL_MVP 0 //! skip residual coding when it's under _some_ threshold #define OPTIMIZATION_SKIP_RESIDUAL_ON_THRESHOLD 0 /* END OF CONFIG VARIABLES */ //! pow(2, MIN_SIZE) #define CU_MIN_SIZE_PIXELS (1 << MIN_SIZE) //! spec: CtbSizeY #define LCU_WIDTH (1 << (MIN_SIZE + MAX_DEPTH)) //! spec: CtbWidthC and CtbHeightC #define LCU_WIDTH_C (LCU_WIDTH / 2) //! spec: Log2MaxTrafoSize <= Min(CtbLog2SizeY, 5) #define TR_MAX_LOG2_SIZE 5 #define TR_MAX_WIDTH (1 << TR_MAX_LOG2_SIZE) //! spec: Log2MinTrafoSize #define TR_MIN_LOG2_SIZE 2 #define TR_MIN_WIDTH (1 << TR_MIN_LOG2_SIZE) #if LCU_WIDTH != 64 #error "Kvazaar only support LCU_WIDTH == 64" #endif #define LCU_LUMA_SIZE (LCU_WIDTH * LCU_WIDTH) #define LCU_CHROMA_SIZE (LCU_WIDTH * LCU_WIDTH >> 2) #define MAX_REF_PIC_COUNT 16 #define DEFAULT_REF_PIC_COUNT 3 #define AMVP_MAX_NUM_CANDS 2 #define AMVP_MAX_NUM_CANDS_MEM 3 #define MRG_MAX_NUM_CANDS 5 /* Some tools */ #define MAX(a,b) (((a)>(b))?(a):(b)) #define MIN(a,b) (((a)<(b))?(a):(b)) #define CLIP(low,high,value) MAX((low),MIN((high),(value))) #define CLIP_TO_PIXEL(value) CLIP(0, PIXEL_MAX, (value)) #define SWAP(a,b,swaptype) { swaptype tempval; tempval = a; a = b; b = tempval; } #define CU_WIDTH_FROM_DEPTH(depth) (LCU_WIDTH >> depth) #define WITHIN(val, min_val, max_val) ((min_val) <= (val) && (val) <= (max_val)) #define PU_INDEX(x_pu, y_pu) (((x_pu) % 2) + 2 * ((y_pu) % 2)) #define CEILDIV(x,y) (((x) + (y) - 1) / (y)) #define LOG2_LCU_WIDTH 6 // CU_TO_PIXEL = y * lcu_width * pic_width + x * lcu_width #define CU_TO_PIXEL(x, y, depth, stride) (((y) << (LOG2_LCU_WIDTH - (depth))) * (stride) \ + ((x) << (LOG2_LCU_WIDTH - (depth)))) //#define SIGN3(x) ((x) > 0) ? +1 : ((x) == 0 ? 0 : -1) #define SIGN3(x) (((x) > 0) - ((x) < 0)) #define QUOTE(x) #x #define QUOTE_EXPAND(x) QUOTE(x) // NOTE: When making a release, check to see if incrementing libversion in // configure.ac is necessary. #define KVZ_VERSION 0.8.2 #define VERSION_STRING QUOTE_EXPAND(KVZ_VERSION) //#define VERBOSE 1 #define SAO_ABS_OFFSET_MAX ((1 << (MIN(KVZ_BIT_DEPTH, 10) - 5)) - 1) #define MAX_TILES_PER_DIM 48 #define MAX_SLICES 16 /* Inlining functions */ #ifdef _MSC_VER /* Visual studio */ #define INLINE __forceinline #pragma inline_recursion(on) #else /* others */ #define INLINE inline #endif // Return the next aligned address for *p. Result is at most alignment larger than p. #define ALIGNED_POINTER(p, alignment) (void*)((intptr_t)(p) + (alignment) - ((intptr_t)(p) % (alignment))) // 32 bytes is enough for AVX2 #define SIMD_ALIGNMENT 32 #ifdef _MSC_VER // Buggy VS2010 throws intellisense warnings if void* is not casted. #define MALLOC(type, num) (type *)malloc(sizeof(type) * (num)) #else #define MALLOC(type, num) malloc(sizeof(type) * (num)) #endif // Use memset through FILL and FILL_ARRAY when appropriate, such as when // initializing whole structures or arrays. It's still ok to use memset // directly when doing something more complicated. // Fill a structure or a static array with val bytes. #define FILL(var, val) memset(&(var), (val), sizeof(var)) // Fill a number of elements in an array with val bytes. #define FILL_ARRAY(ar, val, size) memset((ar), (val), (size) * sizeof(*(ar))) #define FREE_POINTER(pointer) { free((void*)pointer); pointer = NULL; } #define MOVE_POINTER(dst_pointer,src_pointer) { dst_pointer = src_pointer; src_pointer = NULL; } #ifndef MAX_INT #define MAX_INT 0x7FFFFFFF #endif #ifndef MAX_INT64 #define MAX_INT64 0x7FFFFFFFFFFFFFFFLL #endif #ifndef MAX_DOUBLE #define MAX_DOUBLE 1.7e+308 #endif //For transform.h and encoder.h #define SCALING_LIST_4x4 0 #define SCALING_LIST_8x8 1 #define SCALING_LIST_16x16 2 #define SCALING_LIST_32x32 3 #define SCALING_LIST_SIZE_NUM 4 #define SCALING_LIST_NUM 6 #define MAX_MATRIX_COEF_NUM 64 #define SCALING_LIST_REM_NUM 6 #define MAX_TR_DYNAMIC_RANGE 15 #define EXP_GOLOMB_TABLE_SIZE (4096*8) //Constants typedef enum { COLOR_Y = 0, COLOR_U, COLOR_V, NUM_COLORS } color_t; #endif