Mercurial > libavutil.hg
annotate common.h @ 915:a1a27468a9c5 libavutil
Make av_strerror() print an error message mentioning the error code
number if strerror_r() did not succeed for whatever reason.
This avoids the need for the application to fill the string in case
strerror_r() fails, for example because the error code is not known.
author | stefano |
---|---|
date | Mon, 03 May 2010 21:56:21 +0000 |
parents | 6dcab870b03b |
children | be4cc14c16c2 |
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 /** |
633 | 101 * Clips 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 /** |
633 | 115 * Clips 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 /** |
764 | 126 * Clips a signed integer value into the 0-65535 range. |
127 * @param a value to clip | |
128 * @return clipped value | |
129 */ | |
130 static inline av_const uint16_t av_clip_uint16(int a) | |
131 { | |
909
73a9ad2a11bd
Write clip-related decimal numbers into hex, where they make more sense.
rbultje
parents:
908
diff
changeset
|
132 if (a&(~0xFFFF)) return (-a)>>31; |
910 | 133 else return a; |
764 | 134 } |
135 | |
136 /** | |
633 | 137 * Clips a signed integer value into the -32768,32767 range. |
373 | 138 * @param a value to clip |
139 * @return clipped value | |
140 */ | |
481
f4187c1c15a6
Reapply r12489: Add pure, const and malloc attributes to proper functions
zuxy
parents:
478
diff
changeset
|
141 static inline av_const int16_t av_clip_int16(int a) |
373 | 142 { |
909
73a9ad2a11bd
Write clip-related decimal numbers into hex, where they make more sense.
rbultje
parents:
908
diff
changeset
|
143 if ((a+0x8000) & ~0xFFFF) return (a>>31) ^ 0x7FFF; |
910 | 144 else return a; |
373 | 145 } |
146 | |
519
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
147 /** |
900
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
148 * Clips a signed 64-bit integer value into the -2147483648,2147483647 range. |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
149 * @param a value to clip |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
150 * @return clipped value |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
151 */ |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
152 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
|
153 { |
908
de9d2bfb3ceb
Fix broken 32-bit clipping, and write numbers in hex instead of decimal so
rbultje
parents:
900
diff
changeset
|
154 if ((a+0x80000000u) & ~UINT64_C(0xFFFFFFFF)) return (a>>63) ^ 0x7FFFFFFF; |
910 | 155 else return a; |
900
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
156 } |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
157 |
5dcfac995af3
Move clipping of audio samples (for those codecs outputting float) from decoder
rbultje
parents:
899
diff
changeset
|
158 /** |
633 | 159 * Clips 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
|
160 * @param a value to clip |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
161 * @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
|
162 * @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
|
163 * @return clipped value |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
164 */ |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
165 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
|
166 { |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
167 if (a < amin) return amin; |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
168 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
|
169 else return a; |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
170 } |
5cdb952bd09a
Add av_clipf() function to common.h and use it in ra288.c
vitor
parents:
516
diff
changeset
|
171 |
773 | 172 /** Computes ceil(log2(x)). |
173 * @param x value used to compute ceil(log2(x)) | |
174 * @return computed ceiling of log2(x) | |
175 */ | |
176 static inline av_const int av_ceil_log2(int x) | |
177 { | |
178 return av_log2((x - 1) << 1); | |
179 } | |
180 | |
0
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
181 #define MKTAG(a,b,c,d) (a | (b << 8) | (c << 16) | (d << 24)) |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
182 #define MKBETAG(a,b,c,d) (d | (c << 8) | (b << 16) | (a << 24)) |
ee8f44bb7c4d
libavutil: Utility code from libavcodec moved to a separate library.
al
parents:
diff
changeset
|
183 |
132 | 184 /*! |
185 * \def GET_UTF8(val, GET_BYTE, ERROR) | |
633 | 186 * Converts a UTF-8 character (up to 4 bytes long) to its 32-bit UCS-4 encoded form |
132 | 187 * \param val is the output and should be of type uint32_t. It holds the converted |
341 | 188 * UCS-4 character and should be a left value. |
189 * \param GET_BYTE gets UTF-8 encoded bytes from any proper source. It can be | |
132 | 190 * a function or a statement whose return value or evaluated value is of type |
341 | 191 * 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
|
192 * and up to 7 times in the general case. |
341 | 193 * \param ERROR action that should be taken when an invalid UTF-8 byte is returned |
132 | 194 * from GET_BYTE. It should be a statement that jumps out of the macro, |
195 * like exit(), goto, return, break, or continue. | |
196 */ | |
130 | 197 #define GET_UTF8(val, GET_BYTE, ERROR)\ |
198 val= GET_BYTE;\ | |
199 {\ | |
200 int ones= 7 - av_log2(val ^ 255);\ | |
201 if(ones==1)\ | |
202 ERROR\ | |
203 val&= 127>>ones;\ | |
204 while(--ones > 0){\ | |
205 int tmp= GET_BYTE - 128;\ | |
206 if(tmp>>6)\ | |
207 ERROR\ | |
208 val= (val<<6) + tmp;\ | |
209 }\ | |
210 } | |
211 | |
129
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
212 /*! |
780 | 213 * \def GET_UTF16(val, GET_16BIT, ERROR) |
214 * Converts a UTF-16 character (2 or 4 bytes) to its 32-bit UCS-4 encoded form | |
215 * \param val is the output and should be of type uint32_t. It holds the converted | |
216 * UCS-4 character and should be a left value. | |
217 * \param GET_16BIT gets two bytes of UTF-16 encoded data converted to native endianness. | |
218 * It can be a function or a statement whose return value or evaluated value is of type | |
219 * uint16_t. It will be executed up to 2 times. | |
220 * \param ERROR action that should be taken when an invalid UTF-16 surrogate is | |
221 * returned from GET_BYTE. It should be a statement that jumps out of the macro, | |
222 * like exit(), goto, return, break, or continue. | |
223 */ | |
224 #define GET_UTF16(val, GET_16BIT, ERROR)\ | |
225 val = GET_16BIT;\ | |
226 {\ | |
227 unsigned int hi = val - 0xD800;\ | |
228 if (hi < 0x800) {\ | |
229 val = GET_16BIT - 0xDC00;\ | |
230 if (val > 0x3FFU || hi > 0x3FFU)\ | |
231 ERROR\ | |
232 val += (hi<<10) + 0x10000;\ | |
233 }\ | |
234 }\ | |
235 | |
236 /*! | |
131 | 237 * \def PUT_UTF8(val, tmp, PUT_BYTE) |
633 | 238 * Converts a 32-bit Unicode character to its UTF-8 encoded form (up to 4 bytes long). |
239 * \param val is an input-only argument and should be of type uint32_t. It holds | |
240 * a UCS-4 encoded Unicode character that is to be converted to UTF-8. If | |
241 * 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
|
242 * \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
|
243 * represents an intermediate value during conversion that is to be |
633 | 244 * output by PUT_BYTE. |
341 | 245 * \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
|
246 * 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
|
247 * For example, PUT_BYTE could be "*output++ = tmp;" PUT_BYTE will be |
341 | 248 * 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
|
249 * 7 times in the general case, depending on the length of the converted |
633 | 250 * Unicode character. |
129
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
251 */ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
252 #define PUT_UTF8(val, tmp, PUT_BYTE)\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
253 {\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
254 int bytes, shift;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
255 uint32_t in = val;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
256 if (in < 0x80) {\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
257 tmp = in;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
258 PUT_BYTE\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
259 } else {\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
260 bytes = (av_log2(in) + 4) / 5;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
261 shift = (bytes - 1) * 6;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
262 tmp = (256 - (256 >> bytes)) | (in >> shift);\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
263 PUT_BYTE\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
264 while (shift >= 6) {\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
265 shift -= 6;\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
266 tmp = 0x80 | ((in >> shift) & 0x3f);\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
267 PUT_BYTE\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
268 }\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
269 }\ |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
270 } |
ccae53673692
Fix ASF format parser's broken UTF-16 string handling
gpoirier
parents:
127
diff
changeset
|
271 |
848 | 272 /*! |
273 * \def PUT_UTF16(val, tmp, PUT_16BIT) | |
274 * Converts a 32-bit Unicode character to its UTF-16 encoded form (2 or 4 bytes). | |
275 * \param val is an input-only argument and should be of type uint32_t. It holds | |
276 * a UCS-4 encoded Unicode character that is to be converted to UTF-16. If | |
277 * val is given as a function it is executed only once. | |
278 * \param tmp is a temporary variable and should be of type uint16_t. It | |
279 * represents an intermediate value during conversion that is to be | |
280 * output by PUT_16BIT. | |
281 * \param PUT_16BIT writes the converted UTF-16 data to any proper destination | |
282 * in desired endianness. It could be a function or a statement, and uses tmp | |
283 * as the input byte. For example, PUT_BYTE could be "*output++ = tmp;" | |
284 * PUT_BYTE will be executed 1 or 2 times depending on input character. | |
285 */ | |
286 #define PUT_UTF16(val, tmp, PUT_16BIT)\ | |
287 {\ | |
288 uint32_t in = val;\ | |
289 if (in < 0x10000) {\ | |
290 tmp = in;\ | |
291 PUT_16BIT\ | |
292 } else {\ | |
293 tmp = 0xD800 | ((in - 0x10000) >> 10);\ | |
294 PUT_16BIT\ | |
295 tmp = 0xDC00 | ((in - 0x10000) & 0x3FF);\ | |
296 PUT_16BIT\ | |
297 }\ | |
298 }\ | |
299 | |
300 | |
301 | |
630
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
302 #include "mem.h" |
fb04e2fc189c
Reorganize header #includes: Unconditionally #include standard C headers,
diego
parents:
619
diff
changeset
|
303 |
619
c309f86c05a2
Move internal.h #include to the end of the file so that it is after
diego
parents:
610
diff
changeset
|
304 #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
|
305 # include "internal.h" |
c309f86c05a2
Move internal.h #include to the end of the file so that it is after
diego
parents:
610
diff
changeset
|
306 #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
|
307 |
567 | 308 #endif /* AVUTIL_COMMON_H */ |