| OLD | NEW |
| (Empty) |
| 1 /* | |
| 2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at> | |
| 3 * | |
| 4 * This file is part of FFmpeg. | |
| 5 * | |
| 6 * FFmpeg is free software; you can redistribute it and/or | |
| 7 * modify it under the terms of the GNU Lesser General Public | |
| 8 * License as published by the Free Software Foundation; either | |
| 9 * version 2.1 of the License, or (at your option) any later version. | |
| 10 * | |
| 11 * FFmpeg is distributed in the hope that it will be useful, | |
| 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
| 14 * Lesser General Public License for more details. | |
| 15 * | |
| 16 * You should have received a copy of the GNU Lesser General Public | |
| 17 * License along with FFmpeg; if not, write to the Free Software | |
| 18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | |
| 19 */ | |
| 20 | |
| 21 /** | |
| 22 * @file libavutil/common.h | |
| 23 * common internal and external API header | |
| 24 */ | |
| 25 | |
| 26 #ifndef AVUTIL_COMMON_H | |
| 27 #define AVUTIL_COMMON_H | |
| 28 | |
| 29 #include <ctype.h> | |
| 30 #include <errno.h> | |
| 31 #include <inttypes.h> | |
| 32 #include <limits.h> | |
| 33 #include <math.h> | |
| 34 #include <stdio.h> | |
| 35 #include <stdlib.h> | |
| 36 #include <string.h> | |
| 37 | |
| 38 #ifdef __GNUC__ | |
| 39 # define AV_GCC_VERSION_AT_LEAST(x,y) (__GNUC__ > x || __GNUC__ == x && __GNU
C_MINOR__ >= y) | |
| 40 #else | |
| 41 # define AV_GCC_VERSION_AT_LEAST(x,y) 0 | |
| 42 #endif | |
| 43 | |
| 44 #ifndef av_always_inline | |
| 45 #if AV_GCC_VERSION_AT_LEAST(3,1) | |
| 46 # define av_always_inline __attribute__((always_inline)) inline | |
| 47 #else | |
| 48 # define av_always_inline inline | |
| 49 #endif | |
| 50 #endif | |
| 51 | |
| 52 #ifndef av_noinline | |
| 53 #if AV_GCC_VERSION_AT_LEAST(3,1) | |
| 54 # define av_noinline __attribute__((noinline)) | |
| 55 #else | |
| 56 # define av_noinline | |
| 57 #endif | |
| 58 #endif | |
| 59 | |
| 60 #ifndef av_pure | |
| 61 #if AV_GCC_VERSION_AT_LEAST(3,1) | |
| 62 # define av_pure __attribute__((pure)) | |
| 63 #else | |
| 64 # define av_pure | |
| 65 #endif | |
| 66 #endif | |
| 67 | |
| 68 #ifndef av_const | |
| 69 #if AV_GCC_VERSION_AT_LEAST(2,6) | |
| 70 # define av_const __attribute__((const)) | |
| 71 #else | |
| 72 # define av_const | |
| 73 #endif | |
| 74 #endif | |
| 75 | |
| 76 #ifndef av_cold | |
| 77 #if (!defined(__ICC) || __ICC > 1100) && AV_GCC_VERSION_AT_LEAST(4,3) | |
| 78 # define av_cold __attribute__((cold)) | |
| 79 #else | |
| 80 # define av_cold | |
| 81 #endif | |
| 82 #endif | |
| 83 | |
| 84 #ifndef av_flatten | |
| 85 #if AV_GCC_VERSION_AT_LEAST(4,1) | |
| 86 # define av_flatten __attribute__((flatten)) | |
| 87 #else | |
| 88 # define av_flatten | |
| 89 #endif | |
| 90 #endif | |
| 91 | |
| 92 #ifndef attribute_deprecated | |
| 93 #if AV_GCC_VERSION_AT_LEAST(3,1) | |
| 94 # define attribute_deprecated __attribute__((deprecated)) | |
| 95 #else | |
| 96 # define attribute_deprecated | |
| 97 #endif | |
| 98 #endif | |
| 99 | |
| 100 #ifndef av_unused | |
| 101 #if defined(__GNUC__) | |
| 102 # define av_unused __attribute__((unused)) | |
| 103 #else | |
| 104 # define av_unused | |
| 105 #endif | |
| 106 #endif | |
| 107 | |
| 108 #ifndef av_uninit | |
| 109 #if defined(__GNUC__) && !defined(__ICC) | |
| 110 # define av_uninit(x) x=x | |
| 111 #else | |
| 112 # define av_uninit(x) x | |
| 113 #endif | |
| 114 #endif | |
| 115 | |
| 116 //rounded division & shift | |
| 117 #define RSHIFT(a,b) ((a) > 0 ? ((a) + ((1<<(b))>>1))>>(b) : ((a) + ((1<<(b))>>1)
-1)>>(b)) | |
| 118 /* assume b>0 */ | |
| 119 #define ROUNDED_DIV(a,b) (((a)>0 ? (a) + ((b)>>1) : (a) - ((b)>>1))/(b)) | |
| 120 #define FFABS(a) ((a) >= 0 ? (a) : (-(a))) | |
| 121 #define FFSIGN(a) ((a) > 0 ? 1 : -1) | |
| 122 | |
| 123 #define FFMAX(a,b) ((a) > (b) ? (a) : (b)) | |
| 124 #define FFMAX3(a,b,c) FFMAX(FFMAX(a,b),c) | |
| 125 #define FFMIN(a,b) ((a) > (b) ? (b) : (a)) | |
| 126 #define FFMIN3(a,b,c) FFMIN(FFMIN(a,b),c) | |
| 127 | |
| 128 #define FFSWAP(type,a,b) do{type SWAP_tmp= b; b= a; a= SWAP_tmp;}while(0) | |
| 129 #define FF_ARRAY_ELEMS(a) (sizeof(a) / sizeof((a)[0])) | |
| 130 | |
| 131 /* misc math functions */ | |
| 132 extern const uint8_t ff_log2_tab[256]; | |
| 133 | |
| 134 static inline av_const int av_log2(unsigned int v) | |
| 135 { | |
| 136 int n = 0; | |
| 137 if (v & 0xffff0000) { | |
| 138 v >>= 16; | |
| 139 n += 16; | |
| 140 } | |
| 141 if (v & 0xff00) { | |
| 142 v >>= 8; | |
| 143 n += 8; | |
| 144 } | |
| 145 n += ff_log2_tab[v]; | |
| 146 | |
| 147 return n; | |
| 148 } | |
| 149 | |
| 150 static inline av_const int av_log2_16bit(unsigned int v) | |
| 151 { | |
| 152 int n = 0; | |
| 153 if (v & 0xff00) { | |
| 154 v >>= 8; | |
| 155 n += 8; | |
| 156 } | |
| 157 n += ff_log2_tab[v]; | |
| 158 | |
| 159 return n; | |
| 160 } | |
| 161 | |
| 162 /** | |
| 163 * Clips a signed integer value into the amin-amax range. | |
| 164 * @param a value to clip | |
| 165 * @param amin minimum value of the clip range | |
| 166 * @param amax maximum value of the clip range | |
| 167 * @return clipped value | |
| 168 */ | |
| 169 static inline av_const int av_clip(int a, int amin, int amax) | |
| 170 { | |
| 171 if (a < amin) return amin; | |
| 172 else if (a > amax) return amax; | |
| 173 else return a; | |
| 174 } | |
| 175 | |
| 176 /** | |
| 177 * Clips a signed integer value into the 0-255 range. | |
| 178 * @param a value to clip | |
| 179 * @return clipped value | |
| 180 */ | |
| 181 static inline av_const uint8_t av_clip_uint8(int a) | |
| 182 { | |
| 183 if (a&(~255)) return (-a)>>31; | |
| 184 else return a; | |
| 185 } | |
| 186 | |
| 187 /** | |
| 188 * Clips a signed integer value into the -32768,32767 range. | |
| 189 * @param a value to clip | |
| 190 * @return clipped value | |
| 191 */ | |
| 192 static inline av_const int16_t av_clip_int16(int a) | |
| 193 { | |
| 194 if ((a+32768) & ~65535) return (a>>31) ^ 32767; | |
| 195 else return a; | |
| 196 } | |
| 197 | |
| 198 /** | |
| 199 * Clips a float value into the amin-amax range. | |
| 200 * @param a value to clip | |
| 201 * @param amin minimum value of the clip range | |
| 202 * @param amax maximum value of the clip range | |
| 203 * @return clipped value | |
| 204 */ | |
| 205 static inline av_const float av_clipf(float a, float amin, float amax) | |
| 206 { | |
| 207 if (a < amin) return amin; | |
| 208 else if (a > amax) return amax; | |
| 209 else return a; | |
| 210 } | |
| 211 | |
| 212 #define MKTAG(a,b,c,d) (a | (b << 8) | (c << 16) | (d << 24)) | |
| 213 #define MKBETAG(a,b,c,d) (d | (c << 8) | (b << 16) | (a << 24)) | |
| 214 | |
| 215 /*! | |
| 216 * \def GET_UTF8(val, GET_BYTE, ERROR) | |
| 217 * Converts a UTF-8 character (up to 4 bytes long) to its 32-bit UCS-4 encoded f
orm | |
| 218 * \param val is the output and should be of type uint32_t. It holds the convert
ed | |
| 219 * UCS-4 character and should be a left value. | |
| 220 * \param GET_BYTE gets UTF-8 encoded bytes from any proper source. It can be | |
| 221 * a function or a statement whose return value or evaluated value is of type | |
| 222 * uint8_t. It will be executed up to 4 times for values in the valid UTF-8 rang
e, | |
| 223 * and up to 7 times in the general case. | |
| 224 * \param ERROR action that should be taken when an invalid UTF-8 byte is return
ed | |
| 225 * from GET_BYTE. It should be a statement that jumps out of the macro, | |
| 226 * like exit(), goto, return, break, or continue. | |
| 227 */ | |
| 228 #define GET_UTF8(val, GET_BYTE, ERROR)\ | |
| 229 val= GET_BYTE;\ | |
| 230 {\ | |
| 231 int ones= 7 - av_log2(val ^ 255);\ | |
| 232 if(ones==1)\ | |
| 233 ERROR\ | |
| 234 val&= 127>>ones;\ | |
| 235 while(--ones > 0){\ | |
| 236 int tmp= GET_BYTE - 128;\ | |
| 237 if(tmp>>6)\ | |
| 238 ERROR\ | |
| 239 val= (val<<6) + tmp;\ | |
| 240 }\ | |
| 241 } | |
| 242 | |
| 243 /*! | |
| 244 * \def PUT_UTF8(val, tmp, PUT_BYTE) | |
| 245 * Converts a 32-bit Unicode character to its UTF-8 encoded form (up to 4 bytes
long). | |
| 246 * \param val is an input-only argument and should be of type uint32_t. It holds | |
| 247 * a UCS-4 encoded Unicode character that is to be converted to UTF-8. If | |
| 248 * val is given as a function it is executed only once. | |
| 249 * \param tmp is a temporary variable and should be of type uint8_t. It | |
| 250 * represents an intermediate value during conversion that is to be | |
| 251 * output by PUT_BYTE. | |
| 252 * \param PUT_BYTE writes the converted UTF-8 bytes to any proper destination. | |
| 253 * It could be a function or a statement, and uses tmp as the input byte. | |
| 254 * For example, PUT_BYTE could be "*output++ = tmp;" PUT_BYTE will be | |
| 255 * executed up to 4 times for values in the valid UTF-8 range and up to | |
| 256 * 7 times in the general case, depending on the length of the converted | |
| 257 * Unicode character. | |
| 258 */ | |
| 259 #define PUT_UTF8(val, tmp, PUT_BYTE)\ | |
| 260 {\ | |
| 261 int bytes, shift;\ | |
| 262 uint32_t in = val;\ | |
| 263 if (in < 0x80) {\ | |
| 264 tmp = in;\ | |
| 265 PUT_BYTE\ | |
| 266 } else {\ | |
| 267 bytes = (av_log2(in) + 4) / 5;\ | |
| 268 shift = (bytes - 1) * 6;\ | |
| 269 tmp = (256 - (256 >> bytes)) | (in >> shift);\ | |
| 270 PUT_BYTE\ | |
| 271 while (shift >= 6) {\ | |
| 272 shift -= 6;\ | |
| 273 tmp = 0x80 | ((in >> shift) & 0x3f);\ | |
| 274 PUT_BYTE\ | |
| 275 }\ | |
| 276 }\ | |
| 277 } | |
| 278 | |
| 279 #include "mem.h" | |
| 280 | |
| 281 #ifdef HAVE_AV_CONFIG_H | |
| 282 # include "config.h" | |
| 283 # include "internal.h" | |
| 284 #endif /* HAVE_AV_CONFIG_H */ | |
| 285 | |
| 286 #endif /* AVUTIL_COMMON_H */ | |
| OLD | NEW |