Add doxy to av_log_missing_feature() etc. stating that the function is
[ffmpeg-lucabe.git] / libavutil / internal.h
blob0ca2b4d9837624da50d5af2dad01d9b9559f747b
1 /*
2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at>
4 * This file is part of FFmpeg.
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.
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.
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
21 /**
22 * @file libavutil/internal.h
23 * common internal API header
26 #ifndef AVUTIL_INTERNAL_H
27 #define AVUTIL_INTERNAL_H
29 #if !defined(DEBUG) && !defined(NDEBUG)
30 # define NDEBUG
31 #endif
33 #include <limits.h>
34 #include <stdint.h>
35 #include <stddef.h>
36 #include <assert.h>
37 #include "config.h"
38 #include "common.h"
39 #include "mem.h"
40 #include "timer.h"
42 #ifndef attribute_align_arg
43 #if (!defined(__ICC) || __ICC > 1110) && AV_GCC_VERSION_AT_LEAST(4,2)
44 # define attribute_align_arg __attribute__((force_align_arg_pointer))
45 #else
46 # define attribute_align_arg
47 #endif
48 #endif
50 #ifndef attribute_used
51 #if AV_GCC_VERSION_AT_LEAST(3,1)
52 # define attribute_used __attribute__((used))
53 #else
54 # define attribute_used
55 #endif
56 #endif
58 #ifndef INT16_MIN
59 #define INT16_MIN (-0x7fff-1)
60 #endif
62 #ifndef INT16_MAX
63 #define INT16_MAX 0x7fff
64 #endif
66 #ifndef INT32_MIN
67 #define INT32_MIN (-0x7fffffff-1)
68 #endif
70 #ifndef INT32_MAX
71 #define INT32_MAX 0x7fffffff
72 #endif
74 #ifndef UINT32_MAX
75 #define UINT32_MAX 0xffffffff
76 #endif
78 #ifndef INT64_MIN
79 #define INT64_MIN (-0x7fffffffffffffffLL-1)
80 #endif
82 #ifndef INT64_MAX
83 #define INT64_MAX INT64_C(9223372036854775807)
84 #endif
86 #ifndef UINT64_MAX
87 #define UINT64_MAX UINT64_C(0xFFFFFFFFFFFFFFFF)
88 #endif
90 #ifndef INT_BIT
91 # define INT_BIT (CHAR_BIT * sizeof(int))
92 #endif
94 #if ( defined(__PIC__) || defined(__pic__) ) && ! defined(PIC)
95 # define PIC
96 #endif
98 #ifndef offsetof
99 # define offsetof(T,F) ((unsigned int)((char *)&((T *)0)->F))
100 #endif
102 /* Use to export labels from asm. */
103 #define LABEL_MANGLE(a) EXTERN_PREFIX #a
105 // Use rip-relative addressing if compiling PIC code on x86-64.
106 #if ARCH_X86_64 && defined(PIC)
107 # define LOCAL_MANGLE(a) #a "(%%rip)"
108 #else
109 # define LOCAL_MANGLE(a) #a
110 #endif
112 #define MANGLE(a) EXTERN_PREFIX LOCAL_MANGLE(a)
114 /* debug stuff */
116 /* dprintf macros */
117 #ifdef DEBUG
118 # define dprintf(pctx, ...) av_log(pctx, AV_LOG_DEBUG, __VA_ARGS__)
119 #else
120 # define dprintf(pctx, ...)
121 #endif
123 #define av_abort() do { av_log(NULL, AV_LOG_ERROR, "Abort at %s:%d\n", __FILE__, __LINE__); abort(); } while (0)
125 /* math */
127 extern const uint32_t ff_inverse[256];
129 #if ARCH_X86
130 # define FASTDIV(a,b) \
132 int ret,dmy;\
133 __asm__ volatile(\
134 "mull %3"\
135 :"=d"(ret),"=a"(dmy)\
136 :"1"(a),"g"(ff_inverse[b])\
138 ret;\
140 #elif HAVE_ARMV6 && HAVE_INLINE_ASM
141 static inline av_const int FASTDIV(int a, int b)
143 int r, t;
144 __asm__ volatile("cmp %3, #2 \n\t"
145 "ldr %1, [%4, %3, lsl #2] \n\t"
146 "lsrle %0, %2, #1 \n\t"
147 "smmulgt %0, %1, %2 \n\t"
148 : "=&r"(r), "=&r"(t) : "r"(a), "r"(b), "r"(ff_inverse));
149 return r;
151 #elif ARCH_ARM && HAVE_INLINE_ASM
152 static inline av_const int FASTDIV(int a, int b)
154 int r, t;
155 __asm__ volatile ("umull %1, %0, %2, %3"
156 : "=&r"(r), "=&r"(t) : "r"(a), "r"(ff_inverse[b]));
157 return r;
159 #elif CONFIG_FASTDIV
160 # define FASTDIV(a,b) ((uint32_t)((((uint64_t)a)*ff_inverse[b])>>32))
161 #else
162 # define FASTDIV(a,b) ((a)/(b))
163 #endif
165 extern const uint8_t ff_sqrt_tab[256];
167 static inline av_const unsigned int ff_sqrt(unsigned int a)
169 unsigned int b;
171 if(a<255) return (ff_sqrt_tab[a+1]-1)>>4;
172 else if(a<(1<<12)) b= ff_sqrt_tab[a>>4 ]>>2;
173 #if !CONFIG_SMALL
174 else if(a<(1<<14)) b= ff_sqrt_tab[a>>6 ]>>1;
175 else if(a<(1<<16)) b= ff_sqrt_tab[a>>8 ] ;
176 #endif
177 else{
178 int s= av_log2_16bit(a>>16)>>1;
179 unsigned int c= a>>(s+2);
180 b= ff_sqrt_tab[c>>(s+8)];
181 b= FASTDIV(c,b) + (b<<s);
184 return b - (a<b*b);
187 #if ARCH_X86
188 #define MASK_ABS(mask, level)\
189 __asm__ volatile(\
190 "cltd \n\t"\
191 "xorl %1, %0 \n\t"\
192 "subl %1, %0 \n\t"\
193 : "+a" (level), "=&d" (mask)\
195 #else
196 #define MASK_ABS(mask, level)\
197 mask= level>>31;\
198 level= (level^mask)-mask;
199 #endif
201 #if HAVE_CMOV
202 #define COPY3_IF_LT(x,y,a,b,c,d)\
203 __asm__ volatile (\
204 "cmpl %0, %3 \n\t"\
205 "cmovl %3, %0 \n\t"\
206 "cmovl %4, %1 \n\t"\
207 "cmovl %5, %2 \n\t"\
208 : "+&r" (x), "+&r" (a), "+r" (c)\
209 : "r" (y), "r" (b), "r" (d)\
211 #else
212 #define COPY3_IF_LT(x,y,a,b,c,d)\
213 if((y)<(x)){\
214 (x)=(y);\
215 (a)=(b);\
216 (c)=(d);\
218 #endif
220 /* avoid usage of dangerous/inappropriate system functions */
221 #undef malloc
222 #define malloc please_use_av_malloc
223 #undef free
224 #define free please_use_av_free
225 #undef realloc
226 #define realloc please_use_av_realloc
227 #undef time
228 #define time time_is_forbidden_due_to_security_issues
229 #undef rand
230 #define rand rand_is_forbidden_due_to_state_trashing_use_av_lfg_get
231 #undef srand
232 #define srand srand_is_forbidden_due_to_state_trashing_use_av_lfg_init
233 #undef random
234 #define random random_is_forbidden_due_to_state_trashing_use_av_lfg_get
235 #undef sprintf
236 #define sprintf sprintf_is_forbidden_due_to_security_issues_use_snprintf
237 #undef strcat
238 #define strcat strcat_is_forbidden_due_to_security_issues_use_av_strlcat
239 #undef exit
240 #define exit exit_is_forbidden
241 #ifndef LIBAVFORMAT_BUILD
242 #undef printf
243 #define printf please_use_av_log_instead_of_printf
244 #undef fprintf
245 #define fprintf please_use_av_log_instead_of_fprintf
246 #undef puts
247 #define puts please_use_av_log_instead_of_puts
248 #undef perror
249 #define perror please_use_av_log_instead_of_perror
250 #endif
252 #define CHECKED_ALLOCZ(p, size)\
254 p= av_mallocz(size);\
255 if(p==NULL && (size)!=0){\
256 av_log(NULL, AV_LOG_ERROR, "Cannot allocate memory.");\
257 goto fail;\
261 #if defined(__ICC) || defined(__SUNPRO_C)
262 #define DECLARE_ALIGNED(n,t,v) t v __attribute__ ((aligned (n)))
263 #define DECLARE_ASM_CONST(n,t,v) const t __attribute__ ((aligned (n))) v
264 #elif defined(__GNUC__)
265 #define DECLARE_ALIGNED(n,t,v) t v __attribute__ ((aligned (n)))
266 #define DECLARE_ASM_CONST(n,t,v) static const t v attribute_used __attribute__ ((aligned (n)))
267 #elif defined(_MSC_VER)
268 #define DECLARE_ALIGNED(n,t,v) __declspec(align(n)) t v
269 #define DECLARE_ASM_CONST(n,t,v) __declspec(align(n)) static const t v
270 #elif HAVE_INLINE_ASM
271 #error The asm code needs alignment, but we do not know how to do it for this compiler.
272 #else
273 #define DECLARE_ALIGNED(n,t,v) t v
274 #define DECLARE_ASM_CONST(n,t,v) static const t v
275 #endif
278 #if !HAVE_LLRINT
279 static av_always_inline av_const long long llrint(double x)
281 return rint(x);
283 #endif /* HAVE_LLRINT */
285 #if !HAVE_LRINT
286 static av_always_inline av_const long int lrint(double x)
288 return rint(x);
290 #endif /* HAVE_LRINT */
292 #if !HAVE_LRINTF
293 static av_always_inline av_const long int lrintf(float x)
295 return (int)(rint(x));
297 #endif /* HAVE_LRINTF */
299 #if !HAVE_ROUND
300 static av_always_inline av_const double round(double x)
302 return (x > 0) ? floor(x + 0.5) : ceil(x - 0.5);
304 #endif /* HAVE_ROUND */
306 #if !HAVE_ROUNDF
307 static av_always_inline av_const float roundf(float x)
309 return (x > 0) ? floor(x + 0.5) : ceil(x - 0.5);
311 #endif /* HAVE_ROUNDF */
313 #if !HAVE_TRUNCF
314 static av_always_inline av_const float truncf(float x)
316 return (x > 0) ? floor(x) : ceil(x);
318 #endif /* HAVE_TRUNCF */
321 * Returns NULL if CONFIG_SMALL is true, otherwise the argument
322 * without modification. Used to disable the definition of strings
323 * (for example AVCodec long_names).
325 #if CONFIG_SMALL
326 # define NULL_IF_CONFIG_SMALL(x) NULL
327 #else
328 # define NULL_IF_CONFIG_SMALL(x) x
329 #endif
331 #endif /* AVUTIL_INTERNAL_H */