Mercurial > libavutil.hg
annotate common.h @ 957:e34e8d654ded libavutil
Fix grammar errors in documentation
author | mru |
---|---|
date | Wed, 30 Jun 2010 15:38:06 +0000 |
parents | 7362675c3e0a |
children | 64a8e85b50be |
rev | line source |
---|---|
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
1 /* |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at> |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
3 * |
116
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
113
diff
changeset
|
4 * This file is part of FFmpeg. |
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
113
diff
changeset
|
5 * |
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
113
diff
changeset
|
6 * FFmpeg is free software; you can redistribute it and/or |
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
7 * modify it under the terms of the GNU Lesser General Public |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
8 * License as published by the Free Software Foundation; either |
116
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
113
diff
changeset
|
9 * version 2.1 of the License, or (at your option) any later version. |
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
10 * |
116
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
113
diff
changeset
|
11 * FFmpeg is distributed in the hope that it will be useful, |
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
14 * Lesser General Public License for more details. |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
15 * |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
16 * You should have received a copy of the GNU Lesser General Public |
116
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
113
diff
changeset
|
17 * License along with FFmpeg; if not, write to the Free Software |
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
19 */ |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
104
diff
changeset
|
20 |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
21 /** |
899
0795a743bda1
Remove explicit filename from Doxygen @file commands.
diego
parents:
870
diff
changeset
|
22 * @file |
466 | 23 * common internal and external API header |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
24 */ |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
25 |
567 | 26 #ifndef AVUTIL_COMMON_H |
27 #define AVUTIL_COMMON_H | |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
28 |
630
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
29 #include <ctype.h> |
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
30 #include <errno.h> |
158 | 31 #include <inttypes.h> |
630
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
32 #include <limits.h> |
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
33 #include <math.h> |
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
34 #include <stdio.h> |
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
35 #include <stdlib.h> |
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
36 #include <string.h> |
866
efba70214ef1
Move gcc attribute macros to new header libavutil/attributes.h
mru
parents:
848
diff
changeset
|
37 #include "attributes.h" |
159
039198e96ee2
rename always_inline to av_always_inline and move to common.h
mru
parents:
158
diff
changeset
|
38 |
633 | 39 //rounded division & shift |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
40 #define RSHIFT(a,b) ((a) > 0 ? ((a) + ((1<<(b))>>1))>>(b) : ((a) + ((1<<(b))>>1)-1)>>(b)) |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
41 /* assume b>0 */ |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
42 #define ROUNDED_DIV(a,b) (((a)>0 ? (a) + ((b)>>1) : (a) - ((b)>>1))/(b)) |
120 | 43 #define FFABS(a) ((a) >= 0 ? (a) : (-(a))) |
119
7d5463d9530a
Rename SIGN macro to FFSIGN to avoid clashes with system headers.
diego
parents:
117
diff
changeset
|
44 #define FFSIGN(a) ((a) > 0 ? 1 : -1) |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
45 |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
46 #define FFMAX(a,b) ((a) > (b) ? (a) : (b)) |
498
2ae1cc70b1c4
Implement FFMAX3(a,b,c) - maximum over three arguments.
voroshil
parents:
496
diff
changeset
|
47 #define FFMAX3(a,b,c) FFMAX(FFMAX(a,b),c) |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
48 #define FFMIN(a,b) ((a) > (b) ? (b) : (a)) |
501 | 49 #define FFMIN3(a,b,c) FFMIN(FFMIN(a,b),c) |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
50 |
126 | 51 #define FFSWAP(type,a,b) do{type SWAP_tmp= b; b= a; a= SWAP_tmp;}while(0) |
576
481638df1e8b
Add a macro to get the number of elements in a table.
benoit
parents:
567
diff
changeset
|
52 #define FF_ARRAY_ELEMS(a) (sizeof(a) / sizeof((a)[0])) |
735
92180cbccda6
Move ALIGN macro to libavutil/common.h and use it in various places
conrad
parents:
668
diff
changeset
|
53 #define FFALIGN(x, a) (((x)+(a)-1)&~((a)-1)) |
99 | 54 |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
55 /* misc math functions */ |
157 | 56 extern const uint8_t ff_log2_tab[256]; |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
57 |
784
fd7a78f003e7
Move ff_reverse in libavcodec to av_reverse in libavutil.
cehoyos
parents:
780
diff
changeset
|
58 extern const uint8_t av_reverse[256]; |
fd7a78f003e7
Move ff_reverse in libavcodec to av_reverse in libavutil.
cehoyos
parents:
780
diff
changeset
|
59 |
870 | 60 static inline av_const int av_log2_c(unsigned int v) |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
61 { |
443 | 62 int n = 0; |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
63 if (v & 0xffff0000) { |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
64 v >>= 16; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
65 n += 16; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
66 } |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
67 if (v & 0xff00) { |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
68 v >>= 8; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
69 n += 8; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
70 } |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
71 n += ff_log2_tab[v]; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
72 |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
73 return n; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
74 } |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
75 |
870 | 76 static inline av_const int av_log2_16bit_c(unsigned int v) |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
77 { |
443 | 78 int n = 0; |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
79 if (v & 0xff00) { |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
80 v >>= 8; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
81 n += 8; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
82 } |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
83 n += ff_log2_tab[v]; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
84 |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
85 return n; |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
86 } |
870 | 87 |
88 #ifdef HAVE_AV_CONFIG_H | |
89 # include "config.h" | |
90 # include "intmath.h" | |
91 #endif | |
92 | |
93 #ifndef av_log2 | |
94 # define av_log2 av_log2_c | |
95 #endif | |
96 #ifndef av_log2_16bit | |
97 # define av_log2_16bit av_log2_16bit_c | |
807 | 98 #endif |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
99 |
39 | 100 /** |
957 | 101 * Clip a signed integer value into the amin-amax range. |
39 | 102 * @param a value to clip |
103 * @param amin minimum value of the clip range | |
104 * @param amax maximum value of the clip range | |
151 | 105 * @return clipped value |
39 | 106 */ |
481
f4187c1c15a6
Reapply r12489: Add pure, const and malloc attributes to proper functions
zuxy
parents:
478
diff
changeset
|
107 static inline av_const int av_clip(int a, int amin, int amax) |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
108 { |
452 | 109 if (a < amin) return amin; |
63 | 110 else if (a > amax) return amax; |
111 else return a; | |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
112 } |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
113 |
39 | 114 /** |
957 | 115 * Clip a signed integer value into the 0-255 range. |
39 | 116 * @param a value to clip |
151 | 117 * @return clipped value |
39 | 118 */ |
481
f4187c1c15a6
Reapply r12489: Add pure, const and malloc attributes to proper functions
zuxy
parents:
478
diff
changeset
|
119 static inline av_const uint8_t av_clip_uint8(int a) |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
120 { |
909
73a9ad2a11bd
Write clip-related decimal numbers into hex, where they make more sense.
rbultje
parents:
908
diff
changeset
|
121 if (a&(~0xFF)) return (-a)>>31; |
910 | 122 else return a; |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
123 } |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
124 |
373 | 125 /** |
957 | 126 * Clip a signed integer value into the -128,127 range. |
950
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
127 * @param a value to clip |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
128 * @return clipped value |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
129 */ |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
130 static inline av_const int8_t av_clip_int8(int a) |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
131 { |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
132 if ((a+0x80) & ~0xFF) return (a>>31) ^ 0x7F; |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
133 else return a; |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
134 } |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
135 |
7362675c3e0a
Add av_clip_int8(), used in the upcoming VP8 decoder.
rbultje
parents:
949
diff
changeset
|
136 /** |
957 | 137 * Clip a signed integer value into the 0-65535 range. |
764 | 138 * @param a value to clip |
139 * @return clipped value | |
140 */ | |
141 static inline av_const uint16_t av_clip_uint16(int a) | |
142 { | |
909
73a9ad2a11bd
Write clip-related decimal numbers into hex, where they make more sense.
rbultje
parents:
908
diff
changeset
|
143 if (a&(~0xFFFF)) return (-a)>>31; |
910 | 144 else return a; |
764 | 145 } |
146 | |
147 /** | |
957 | 148 * Clip a signed integer value into the -32768,32767 range. |
373 | 149 * @param a value to clip |
150 * @return clipped value | |
151 */ | |
481
f4187c1c15a6
Reapply r12489: Add pure, const and malloc attributes to proper functions
zuxy
parents:
478
diff
changeset
|
152 static inline av_const int16_t av_clip_int16(int a) |
373 | 153 { |
909
73a9ad2a11bd
Write clip-related decimal numbers into hex, where they make more sense.
rbultje
parents:
908
diff
changeset
|
154 if ((a+0x8000) & ~0xFFFF) return (a>>31) ^ 0x7FFF; |
910 | 155 else return a; |
373 | 156 } |
157 | |
519
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
158 /** |
957 | 159 * Clip a signed 64-bit integer value into the -2147483648,2147483647 range. |
900
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
160 * @param a value to clip |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
161 * @return clipped value |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
162 */ |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
163 static inline av_const int32_t av_clipl_int32(int64_t a) |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
164 { |
908
de9d2bfb3ceb
Fix broken 32-bit clipping, and write numbers in hex instead of decimal so
rbultje
parents:
900
diff
changeset
|
165 if ((a+0x80000000u) & ~UINT64_C(0xFFFFFFFF)) return (a>>63) ^ 0x7FFFFFFF; |
910 | 166 else return a; |
900
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
167 } |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
168 |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
169 /** |
957 | 170 * Clip a float value into the amin-amax range. |
519
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
171 * @param a value to clip |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
172 * @param amin minimum value of the clip range |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
173 * @param amax maximum value of the clip range |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
174 * @return clipped value |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
175 */ |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
176 static inline av_const float av_clipf(float a, float amin, float amax) |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
177 { |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
178 if (a < amin) return amin; |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
179 else if (a > amax) return amax; |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
180 else return a; |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
181 } |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
182 |
957 | 183 /** Compute ceil(log2(x)). |
773 | 184 * @param x value used to compute ceil(log2(x)) |
185 * @return computed ceiling of log2(x) | |
186 */ | |
187 static inline av_const int av_ceil_log2(int x) | |
188 { | |
189 return av_log2((x - 1) << 1); | |
190 } | |
191 | |
949
be4cc14c16c2
Add missing parentheses in MKTAG and MKBETAG macros.
benoit
parents:
910
diff
changeset
|
192 #define MKTAG(a,b,c,d) ((a) | ((b) << 8) | ((c) << 16) | ((d) << 24)) |
be4cc14c16c2
Add missing parentheses in MKTAG and MKBETAG macros.
benoit
parents:
910
diff
changeset
|
193 #define MKBETAG(a,b,c,d) ((d) | ((c) << 8) | ((b) << 16) | ((a) << 24)) |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
194 |
132 | 195 /*! |
196 * \def GET_UTF8(val, GET_BYTE, ERROR) | |
957 | 197 * Convert a UTF-8 character (up to 4 bytes long) to its 32-bit UCS-4 encoded form |
132 | 198 * \param val is the output and should be of type uint32_t. It holds the converted |
341 | 199 * UCS-4 character and should be a left value. |
200 * \param GET_BYTE gets UTF-8 encoded bytes from any proper source. It can be | |
132 | 201 * a function or a statement whose return value or evaluated value is of type |
341 | 202 * uint8_t. It will be executed up to 4 times for values in the valid UTF-8 range, |
147
7e143f348a72
Correct GET/PUT_UTF8 comment: the get/put functions might be called up
reimar
parents:
146
diff
changeset
|
203 * and up to 7 times in the general case. |
341 | 204 * \param ERROR action that should be taken when an invalid UTF-8 byte is returned |
132 | 205 * from GET_BYTE. It should be a statement that jumps out of the macro, |
206 * like exit(), goto, return, break, or continue. | |
207 */ | |
130 | 208 #define GET_UTF8(val, GET_BYTE, ERROR)\ |
209 val= GET_BYTE;\ | |
210 {\ | |
211 int ones= 7 - av_log2(val ^ 255);\ | |
212 if(ones==1)\ | |
213 ERROR\ | |
214 val&= 127>>ones;\ | |
215 while(--ones > 0){\ | |
216 int tmp= GET_BYTE - 128;\ | |
217 if(tmp>>6)\ | |
218 ERROR\ | |
219 val= (val<<6) + tmp;\ | |
220 }\ | |
221 } | |
222 | |
129
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
223 /*! |
780 | 224 * \def GET_UTF16(val, GET_16BIT, ERROR) |
957 | 225 * Convert a UTF-16 character (2 or 4 bytes) to its 32-bit UCS-4 encoded form |
780 | 226 * \param val is the output and should be of type uint32_t. It holds the converted |
227 * UCS-4 character and should be a left value. | |
228 * \param GET_16BIT gets two bytes of UTF-16 encoded data converted to native endianness. | |
229 * It can be a function or a statement whose return value or evaluated value is of type | |
230 * uint16_t. It will be executed up to 2 times. | |
231 * \param ERROR action that should be taken when an invalid UTF-16 surrogate is | |
232 * returned from GET_BYTE. It should be a statement that jumps out of the macro, | |
233 * like exit(), goto, return, break, or continue. | |
234 */ | |
235 #define GET_UTF16(val, GET_16BIT, ERROR)\ | |
236 val = GET_16BIT;\ | |
237 {\ | |
238 unsigned int hi = val - 0xD800;\ | |
239 if (hi < 0x800) {\ | |
240 val = GET_16BIT - 0xDC00;\ | |
241 if (val > 0x3FFU || hi > 0x3FFU)\ | |
242 ERROR\ | |
243 val += (hi<<10) + 0x10000;\ | |
244 }\ | |
245 }\ | |
246 | |
247 /*! | |
131 | 248 * \def PUT_UTF8(val, tmp, PUT_BYTE) |
957 | 249 * Convert a 32-bit Unicode character to its UTF-8 encoded form (up to 4 bytes long). |
633 | 250 * \param val is an input-only argument and should be of type uint32_t. It holds |
251 * a UCS-4 encoded Unicode character that is to be converted to UTF-8. If | |
252 * val is given as a function it is executed only once. | |
129
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
253 * \param tmp is a temporary variable and should be of type uint8_t. It |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
254 * represents an intermediate value during conversion that is to be |
633 | 255 * output by PUT_BYTE. |
341 | 256 * \param PUT_BYTE writes the converted UTF-8 bytes to any proper destination. |
129
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
257 * It could be a function or a statement, and uses tmp as the input byte. |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
258 * For example, PUT_BYTE could be "*output++ = tmp;" PUT_BYTE will be |
341 | 259 * executed up to 4 times for values in the valid UTF-8 range and up to |
147
7e143f348a72
Correct GET/PUT_UTF8 comment: the get/put functions might be called up
reimar
parents:
146
diff
changeset
|
260 * 7 times in the general case, depending on the length of the converted |
633 | 261 * Unicode character. |
129
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
262 */ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
263 #define PUT_UTF8(val, tmp, PUT_BYTE)\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
264 {\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
265 int bytes, shift;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
266 uint32_t in = val;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
267 if (in < 0x80) {\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
268 tmp = in;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
269 PUT_BYTE\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
270 } else {\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
271 bytes = (av_log2(in) + 4) / 5;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
272 shift = (bytes - 1) * 6;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
273 tmp = (256 - (256 >> bytes)) | (in >> shift);\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
274 PUT_BYTE\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
275 while (shift >= 6) {\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
276 shift -= 6;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
277 tmp = 0x80 | ((in >> shift) & 0x3f);\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
278 PUT_BYTE\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
279 }\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
280 }\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
281 } |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
282 |
848 | 283 /*! |
284 * \def PUT_UTF16(val, tmp, PUT_16BIT) | |
957 | 285 * Convert a 32-bit Unicode character to its UTF-16 encoded form (2 or 4 bytes). |
848 | 286 * \param val is an input-only argument and should be of type uint32_t. It holds |
287 * a UCS-4 encoded Unicode character that is to be converted to UTF-16. If | |
288 * val is given as a function it is executed only once. | |
289 * \param tmp is a temporary variable and should be of type uint16_t. It | |
290 * represents an intermediate value during conversion that is to be | |
291 * output by PUT_16BIT. | |
292 * \param PUT_16BIT writes the converted UTF-16 data to any proper destination | |
293 * in desired endianness. It could be a function or a statement, and uses tmp | |
294 * as the input byte. For example, PUT_BYTE could be "*output++ = tmp;" | |
295 * PUT_BYTE will be executed 1 or 2 times depending on input character. | |
296 */ | |
297 #define PUT_UTF16(val, tmp, PUT_16BIT)\ | |
298 {\ | |
299 uint32_t in = val;\ | |
300 if (in < 0x10000) {\ | |
301 tmp = in;\ | |
302 PUT_16BIT\ | |
303 } else {\ | |
304 tmp = 0xD800 | ((in - 0x10000) >> 10);\ | |
305 PUT_16BIT\ | |
306 tmp = 0xDC00 | ((in - 0x10000) & 0x3FF);\ | |
307 PUT_16BIT\ | |
308 }\ | |
309 }\ | |
310 | |
311 | |
312 | |
630
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
313 #include "mem.h" |
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
314 |
619
c309f86c05a2
Move internal.h #include to the end of the file so that it is after
diego
parents:
610
diff
changeset
|
315 #ifdef HAVE_AV_CONFIG_H |
c309f86c05a2
Move internal.h #include to the end of the file so that it is after
diego
parents:
610
diff
changeset
|
316 # include "internal.h" |
c309f86c05a2
Move internal.h #include to the end of the file so that it is after
diego
parents:
610
diff
changeset
|
317 #endif /* HAVE_AV_CONFIG_H */ |
c309f86c05a2
Move internal.h #include to the end of the file so that it is after
diego
parents:
610
diff
changeset
|
318 |
567 | 319 #endif /* AVUTIL_COMMON_H */ |