Mercurial > mplayer.hg
annotate libswscale/swscale.h @ 31342:996166ae509d
Remove unnecessary get_path() declaration.
author | diego |
---|---|
date | Mon, 14 Jun 2010 11:39:22 +0000 |
parents | 661755507236 |
children | 8e44769b4b4b |
rev | line source |
---|---|
18861 | 1 /* |
20094
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
2 * Copyright (C) 2001-2003 Michael Niedermayer <michaelni@gmx.at> |
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
3 * |
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
4 * This file is part of FFmpeg. |
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
5 * |
21029
1f2ba24b4e47
Clarify that some of the non-SIMD code is now LGPLed.
lucabe
parents:
20094
diff
changeset
|
6 * FFmpeg is free software; you can redistribute it and/or |
1f2ba24b4e47
Clarify that some of the non-SIMD code is now LGPLed.
lucabe
parents:
20094
diff
changeset
|
7 * modify it under the terms of the GNU Lesser General Public |
1f2ba24b4e47
Clarify that some of the non-SIMD code is now LGPLed.
lucabe
parents:
20094
diff
changeset
|
8 * License as published by the Free Software Foundation; either |
1f2ba24b4e47
Clarify that some of the non-SIMD code is now LGPLed.
lucabe
parents:
20094
diff
changeset
|
9 * version 2.1 of the License, or (at your option) any later version. |
20094
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
10 * |
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
11 * FFmpeg is distributed in the hope that it will be useful, |
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
21029
1f2ba24b4e47
Clarify that some of the non-SIMD code is now LGPLed.
lucabe
parents:
20094
diff
changeset
|
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
1f2ba24b4e47
Clarify that some of the non-SIMD code is now LGPLed.
lucabe
parents:
20094
diff
changeset
|
14 * Lesser General Public License for more details. |
20094
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
15 * |
21029
1f2ba24b4e47
Clarify that some of the non-SIMD code is now LGPLed.
lucabe
parents:
20094
diff
changeset
|
16 * You should have received a copy of the GNU Lesser General Public |
1f2ba24b4e47
Clarify that some of the non-SIMD code is now LGPLed.
lucabe
parents:
20094
diff
changeset
|
17 * License along with FFmpeg; if not, write to the Free Software |
23702 | 18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
20094
aca9e9783f67
Change license headers to say 'FFmpeg' instead of 'this program'.
diego
parents:
19661
diff
changeset
|
19 */ |
18861 | 20 |
27467
239a049163eb
Change header inclusion guard names in line with FFmpeg r15120.
stefano
parents:
27460
diff
changeset
|
21 #ifndef SWSCALE_SWSCALE_H |
239a049163eb
Change header inclusion guard names in line with FFmpeg r15120.
stefano
parents:
27460
diff
changeset
|
22 #define SWSCALE_SWSCALE_H |
18861 | 23 |
24 /** | |
31008
23af929986ec
Remove explicit filename from Doxygen @file commands.
diego
parents:
30477
diff
changeset
|
25 * @file |
23129 | 26 * @brief |
18861 | 27 * external api for the swscale stuff |
28 */ | |
29 | |
26065 | 30 #include "libavutil/avutil.h" |
21870
cad3e015ddde
deprecate sws_scale_ordered(), as it now is a duplicate of sws_scale()
lucabe
parents:
21029
diff
changeset
|
31 |
26073 | 32 #define LIBSWSCALE_VERSION_MAJOR 0 |
31235
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
33 #define LIBSWSCALE_VERSION_MINOR 11 |
30194
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
34 #define LIBSWSCALE_VERSION_MICRO 0 |
26002 | 35 |
26073 | 36 #define LIBSWSCALE_VERSION_INT AV_VERSION_INT(LIBSWSCALE_VERSION_MAJOR, \ |
37 LIBSWSCALE_VERSION_MINOR, \ | |
38 LIBSWSCALE_VERSION_MICRO) | |
39 #define LIBSWSCALE_VERSION AV_VERSION(LIBSWSCALE_VERSION_MAJOR, \ | |
40 LIBSWSCALE_VERSION_MINOR, \ | |
41 LIBSWSCALE_VERSION_MICRO) | |
19143
c4dac777b44c
Use libavutil in libswscale, and allow it to be built out of the mplayer tree
lucabe
parents:
18861
diff
changeset
|
42 #define LIBSWSCALE_BUILD LIBSWSCALE_VERSION_INT |
c4dac777b44c
Use libavutil in libswscale, and allow it to be built out of the mplayer tree
lucabe
parents:
18861
diff
changeset
|
43 |
c4dac777b44c
Use libavutil in libswscale, and allow it to be built out of the mplayer tree
lucabe
parents:
18861
diff
changeset
|
44 #define LIBSWSCALE_IDENT "SwS" AV_STRINGIFY(LIBSWSCALE_VERSION) |
c4dac777b44c
Use libavutil in libswscale, and allow it to be built out of the mplayer tree
lucabe
parents:
18861
diff
changeset
|
45 |
27460 | 46 /** |
47 * Returns the LIBSWSCALE_VERSION_INT constant. | |
48 */ | |
49 unsigned swscale_version(void); | |
50 | |
29890
e8e1f8cc7c5b
Add functions to return library license and library configuration.
diego
parents:
29802
diff
changeset
|
51 /** |
e8e1f8cc7c5b
Add functions to return library license and library configuration.
diego
parents:
29802
diff
changeset
|
52 * Returns the libswscale build-time configuration. |
e8e1f8cc7c5b
Add functions to return library license and library configuration.
diego
parents:
29802
diff
changeset
|
53 */ |
30138 | 54 const char *swscale_configuration(void); |
29890
e8e1f8cc7c5b
Add functions to return library license and library configuration.
diego
parents:
29802
diff
changeset
|
55 |
e8e1f8cc7c5b
Add functions to return library license and library configuration.
diego
parents:
29802
diff
changeset
|
56 /** |
e8e1f8cc7c5b
Add functions to return library license and library configuration.
diego
parents:
29802
diff
changeset
|
57 * Returns the libswscale license. |
e8e1f8cc7c5b
Add functions to return library license and library configuration.
diego
parents:
29802
diff
changeset
|
58 */ |
30138 | 59 const char *swscale_license(void); |
29890
e8e1f8cc7c5b
Add functions to return library license and library configuration.
diego
parents:
29802
diff
changeset
|
60 |
18861 | 61 /* values for the flags, the stuff on the command line is different */ |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
62 #define SWS_FAST_BILINEAR 1 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
63 #define SWS_BILINEAR 2 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
64 #define SWS_BICUBIC 4 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
65 #define SWS_X 8 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
66 #define SWS_POINT 0x10 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
67 #define SWS_AREA 0x20 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
68 #define SWS_BICUBLIN 0x40 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
69 #define SWS_GAUSS 0x80 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
70 #define SWS_SINC 0x100 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
71 #define SWS_LANCZOS 0x200 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
72 #define SWS_SPLINE 0x400 |
18861 | 73 |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
74 #define SWS_SRC_V_CHR_DROP_MASK 0x30000 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
75 #define SWS_SRC_V_CHR_DROP_SHIFT 16 |
18861 | 76 |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
77 #define SWS_PARAM_DEFAULT 123456 |
18861 | 78 |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
79 #define SWS_PRINT_INFO 0x1000 |
18861 | 80 |
23536 | 81 //the following 3 flags are not completely implemented |
82 //internal chrominace subsampling info | |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
83 #define SWS_FULL_CHR_H_INT 0x2000 |
18861 | 84 //input subsampling info |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
85 #define SWS_FULL_CHR_H_INP 0x4000 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
86 #define SWS_DIRECT_BGR 0x8000 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
87 #define SWS_ACCURATE_RND 0x40000 |
27560 | 88 #define SWS_BITEXACT 0x80000 |
18861 | 89 |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
90 #define SWS_CPU_CAPS_MMX 0x80000000 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
91 #define SWS_CPU_CAPS_MMX2 0x20000000 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
92 #define SWS_CPU_CAPS_3DNOW 0x40000000 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
93 #define SWS_CPU_CAPS_ALTIVEC 0x10000000 |
23289
786823779b67
Blackfin optimized YUV420 to RGB CSC Color Space Converters.
gpoirier
parents:
23155
diff
changeset
|
94 #define SWS_CPU_CAPS_BFIN 0x01000000 |
18861 | 95 |
96 #define SWS_MAX_REDUCE_CUTOFF 0.002 | |
97 | |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
98 #define SWS_CS_ITU709 1 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
99 #define SWS_CS_FCC 4 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
100 #define SWS_CS_ITU601 5 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
101 #define SWS_CS_ITU624 5 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
102 #define SWS_CS_SMPTE170M 5 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
103 #define SWS_CS_SMPTE240M 7 |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
104 #define SWS_CS_DEFAULT 5 |
18861 | 105 |
30471
ef00ce26e9b5
Add function to translate SWS_CS_* to coefficient array
conrad
parents:
30339
diff
changeset
|
106 /** |
ef00ce26e9b5
Add function to translate SWS_CS_* to coefficient array
conrad
parents:
30339
diff
changeset
|
107 * Returns a pointer to yuv<->rgb coefficients for the given colorspace |
30477 | 108 * suitable for sws_setColorspaceDetails(). |
109 * | |
110 * @param colorspace One of the SWS_CS_* macros. If invalid, | |
111 * SWS_CS_DEFAULT is used. | |
30471
ef00ce26e9b5
Add function to translate SWS_CS_* to coefficient array
conrad
parents:
30339
diff
changeset
|
112 */ |
30476 | 113 const int *sws_getCoefficients(int colorspace); |
18861 | 114 |
115 | |
116 // when used for filters they must have an odd number of elements | |
117 // coeffs cannot be shared between vectors | |
118 typedef struct { | |
28477 | 119 double *coeff; ///< pointer to the list of coefficients |
120 int length; ///< number of coefficients in the vector | |
18861 | 121 } SwsVector; |
122 | |
123 // vectors can be shared | |
124 typedef struct { | |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
125 SwsVector *lumH; |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
126 SwsVector *lumV; |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
127 SwsVector *chrH; |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
128 SwsVector *chrV; |
18861 | 129 } SwsFilter; |
130 | |
131 struct SwsContext; | |
132 | |
29802 | 133 /** |
30194
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
134 * Returns a positive value if pix_fmt is a supported input format, 0 |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
135 * otherwise. |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
136 */ |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
137 int sws_isSupportedInput(enum PixelFormat pix_fmt); |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
138 |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
139 /** |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
140 * Returns a positive value if pix_fmt is a supported output format, 0 |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
141 * otherwise. |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
142 */ |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
143 int sws_isSupportedOutput(enum PixelFormat pix_fmt); |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
144 |
bd9db1814611
Implement sws_isSupportedInput() and sws_isSupportedOutput().
stefano
parents:
30138
diff
changeset
|
145 /** |
29802 | 146 * Frees the swscaler context swsContext. |
147 * If swsContext is NULL, then does nothing. | |
148 */ | |
18861 | 149 void sws_freeContext(struct SwsContext *swsContext); |
150 | |
28500 | 151 /** |
152 * Allocates and returns a SwsContext. You need it to perform | |
153 * scaling/conversion operations using sws_scale(). | |
154 * | |
155 * @param srcW the width of the source image | |
156 * @param srcH the height of the source image | |
157 * @param srcFormat the source image format | |
158 * @param dstW the width of the destination image | |
159 * @param dstH the height of the destination image | |
160 * @param dstFormat the destination image format | |
161 * @param flags specify which algorithm and options to use for rescaling | |
162 * @return a pointer to an allocated context, or NULL in case of error | |
163 */ | |
29140
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
164 struct SwsContext *sws_getContext(int srcW, int srcH, enum PixelFormat srcFormat, |
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
165 int dstW, int dstH, enum PixelFormat dstFormat, |
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
166 int flags, SwsFilter *srcFilter, |
29246
8861e08033eb
Add const qualifier to param argument of sws_getContext() and
diego
parents:
29145
diff
changeset
|
167 SwsFilter *dstFilter, const double *param); |
28619 | 168 |
169 /** | |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
170 * Scales the image slice in srcSlice and puts the resulting scaled |
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
171 * slice in the image in dst. A slice is a sequence of consecutive |
29762
bb26e1db5c90
Document slice ordering assumption done by sws_scale().
stefano
parents:
29623
diff
changeset
|
172 * rows in an image. |
bb26e1db5c90
Document slice ordering assumption done by sws_scale().
stefano
parents:
29623
diff
changeset
|
173 * |
bb26e1db5c90
Document slice ordering assumption done by sws_scale().
stefano
parents:
29623
diff
changeset
|
174 * Slices have to be provided in sequential order, either in |
bb26e1db5c90
Document slice ordering assumption done by sws_scale().
stefano
parents:
29623
diff
changeset
|
175 * top-bottom or bottom-top order. If slices are provided in |
bb26e1db5c90
Document slice ordering assumption done by sws_scale().
stefano
parents:
29623
diff
changeset
|
176 * non-sequential order the behavior of the function is undefined. |
28619 | 177 * |
178 * @param context the scaling context previously created with | |
179 * sws_getContext() | |
28620
77f2575e2a91
Rename the "src" parameter in the sws_scale() declaration to
stefano
parents:
28619
diff
changeset
|
180 * @param srcSlice the array containing the pointers to the planes of |
28619 | 181 * the source slice |
182 * @param srcStride the array containing the strides for each plane of | |
183 * the source image | |
184 * @param srcSliceY the position in the source image of the slice to | |
185 * process, that is the number (counted starting from | |
186 * zero) in the image of the first row of the slice | |
187 * @param srcSliceH the height of the source slice, that is the number | |
188 * of rows in the slice | |
189 * @param dst the array containing the pointers to the planes of | |
190 * the destination image | |
191 * @param dstStride the array containing the strides for each plane of | |
192 * the destination image | |
193 * @return the height of the output slice | |
194 */ | |
30339 | 195 int sws_scale(struct SwsContext *context, const uint8_t* const srcSlice[], const int srcStride[], |
196 int srcSliceY, int srcSliceH, uint8_t* const dst[], const int dstStride[]); | |
31135
5a55c39743d1
Add empty newline to separate function declarations, for better
stefano
parents:
31008
diff
changeset
|
197 |
28457
7d49f24cc18f
Drop the deprecated sws_scale_ordered() at the next major version
stefano
parents:
28456
diff
changeset
|
198 #if LIBSWSCALE_VERSION_MAJOR < 1 |
28486
423d3751bfd2
Add a @deprecated notice to swscale_get_ordered().
stefano
parents:
28477
diff
changeset
|
199 /** |
423d3751bfd2
Add a @deprecated notice to swscale_get_ordered().
stefano
parents:
28477
diff
changeset
|
200 * @deprecated Use sws_scale() instead. |
423d3751bfd2
Add a @deprecated notice to swscale_get_ordered().
stefano
parents:
28477
diff
changeset
|
201 */ |
30332
b4c3e12c9a08
Make const prototypes for input sources of sws_scale_* stricter.
benoit
parents:
30264
diff
changeset
|
202 int sws_scale_ordered(struct SwsContext *context, const uint8_t* const src[], |
29140
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
203 int srcStride[], int srcSliceY, int srcSliceH, |
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
204 uint8_t* dst[], int dstStride[]) attribute_deprecated; |
28457
7d49f24cc18f
Drop the deprecated sws_scale_ordered() at the next major version
stefano
parents:
28456
diff
changeset
|
205 #endif |
18861 | 206 |
29145
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
207 /** |
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
208 * @param inv_table the yuv2rgb coefficients, normally ff_yuv2rgb_coeffs[x] |
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
209 * @param fullRange if 1 then the luma range is 0..255 if 0 it is 16..235 |
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
210 * @return -1 if not supported |
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
211 */ |
29140
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
212 int sws_setColorspaceDetails(struct SwsContext *c, const int inv_table[4], |
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
213 int srcRange, const int table[4], int dstRange, |
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
214 int brightness, int contrast, int saturation); |
29145
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
215 |
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
216 /** |
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
217 * @return -1 if not supported |
af07ee7cae9c
Move sws_[gs]etColorspaceDetails() documentation from swscale.c to
stefano
parents:
29140
diff
changeset
|
218 */ |
29140
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
219 int sws_getColorspaceDetails(struct SwsContext *c, int **inv_table, |
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
220 int *srcRange, int **table, int *dstRange, |
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
221 int *brightness, int *contrast, int *saturation); |
28493
95cfbbaa4f03
Move sws_getGaussianVec() documentation from swscale.c to swscale.h.
stefano
parents:
28492
diff
changeset
|
222 |
95cfbbaa4f03
Move sws_getGaussianVec() documentation from swscale.c to swscale.h.
stefano
parents:
28492
diff
changeset
|
223 /** |
29494 | 224 * Allocates and returns an uninitialized vector with length coefficients. |
225 */ | |
226 SwsVector *sws_allocVec(int length); | |
227 | |
228 /** | |
28493
95cfbbaa4f03
Move sws_getGaussianVec() documentation from swscale.c to swscale.h.
stefano
parents:
28492
diff
changeset
|
229 * Returns a normalized Gaussian curve used to filter stuff |
95cfbbaa4f03
Move sws_getGaussianVec() documentation from swscale.c to swscale.h.
stefano
parents:
28492
diff
changeset
|
230 * quality=3 is high quality, lower is lower quality. |
95cfbbaa4f03
Move sws_getGaussianVec() documentation from swscale.c to swscale.h.
stefano
parents:
28492
diff
changeset
|
231 */ |
18861 | 232 SwsVector *sws_getGaussianVec(double variance, double quality); |
28489 | 233 |
234 /** | |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
235 * Allocates and returns a vector with length coefficients, all |
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
236 * with the same value c. |
28489 | 237 */ |
18861 | 238 SwsVector *sws_getConstVec(double c, int length); |
28498 | 239 |
240 /** | |
241 * Allocates and returns a vector with just one coefficient, with | |
242 * value 1.0. | |
243 */ | |
18861 | 244 SwsVector *sws_getIdentityVec(void); |
28490 | 245 |
246 /** | |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
247 * Scales all the coefficients of a by the scalar value. |
28490 | 248 */ |
18861 | 249 void sws_scaleVec(SwsVector *a, double scalar); |
28530 | 250 |
251 /** | |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
252 * Scales all the coefficients of a so that their sum equals height. |
28530 | 253 */ |
18861 | 254 void sws_normalizeVec(SwsVector *a, double height); |
255 void sws_convVec(SwsVector *a, SwsVector *b); | |
256 void sws_addVec(SwsVector *a, SwsVector *b); | |
257 void sws_subVec(SwsVector *a, SwsVector *b); | |
258 void sws_shiftVec(SwsVector *a, int shift); | |
28492 | 259 |
260 /** | |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
261 * Allocates and returns a clone of the vector a, that is a vector |
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
262 * with the same coefficients as a. |
28492 | 263 */ |
18861 | 264 SwsVector *sws_cloneVec(SwsVector *a); |
265 | |
28531
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
266 #if LIBSWSCALE_VERSION_MAJOR < 1 |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
267 /** |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
268 * @deprecated Use sws_printVec2() instead. |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
269 */ |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
270 attribute_deprecated void sws_printVec(SwsVector *a); |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
271 #endif |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
272 |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
273 /** |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
274 * Prints with av_log() a textual representation of the vector a |
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
275 * if log_level <= av_log_level. |
28531
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
276 */ |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
277 void sws_printVec2(SwsVector *a, AVClass *log_ctx, int log_level); |
a14b65e14dc9
Implement sws_printVec2() and deprecate sws_printVec().
stefano
parents:
28530
diff
changeset
|
278 |
18861 | 279 void sws_freeVec(SwsVector *a); |
280 | |
23129 | 281 SwsFilter *sws_getDefaultFilter(float lumaGBlur, float chromaGBlur, |
28455 | 282 float lumaSharpen, float chromaSharpen, |
23155
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
283 float chromaHShift, float chromaVShift, |
1befc8d767cd
cosmetics attack, part II: Remove all tabs and prettyprint/reindent the code.
diego
parents:
23129
diff
changeset
|
284 int verbose); |
18861 | 285 void sws_freeFilter(SwsFilter *filter); |
286 | |
28488
01afb64ccf4a
Move documentation of sws_getCachedContext() from swscale.c to
stefano
parents:
28486
diff
changeset
|
287 /** |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
288 * Checks if context can be reused, otherwise reallocates a new |
28502
514300a59359
Apply misc fixes for sws_getCachedContext() documentation.
stefano
parents:
28501
diff
changeset
|
289 * one. |
28488
01afb64ccf4a
Move documentation of sws_getCachedContext() from swscale.c to
stefano
parents:
28486
diff
changeset
|
290 * |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
291 * If context is NULL, just calls sws_getContext() to get a new |
28502
514300a59359
Apply misc fixes for sws_getCachedContext() documentation.
stefano
parents:
28501
diff
changeset
|
292 * context. Otherwise, checks if the parameters are the ones already |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
293 * saved in context. If that is the case, returns the current |
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
294 * context. Otherwise, frees context and gets a new context with |
28502
514300a59359
Apply misc fixes for sws_getCachedContext() documentation.
stefano
parents:
28501
diff
changeset
|
295 * the new parameters. |
514300a59359
Apply misc fixes for sws_getCachedContext() documentation.
stefano
parents:
28501
diff
changeset
|
296 * |
29309
037740689e99
Remove '\p' doxygen markup, as it should improve plain text doxy
stefano
parents:
29246
diff
changeset
|
297 * Be warned that srcFilter and dstFilter are not checked, they |
28502
514300a59359
Apply misc fixes for sws_getCachedContext() documentation.
stefano
parents:
28501
diff
changeset
|
298 * are assumed to remain the same. |
28488
01afb64ccf4a
Move documentation of sws_getCachedContext() from swscale.c to
stefano
parents:
28486
diff
changeset
|
299 */ |
19661
7b24faac56fd
Add sws_getCachedContext(), which checks if context is valid or reallocs a new one instead.
gpoirier
parents:
19594
diff
changeset
|
300 struct SwsContext *sws_getCachedContext(struct SwsContext *context, |
28456
2402abd3a2d5
Replace int type with enum PixelFormat for the dstFormat/srcFormat
stefano
parents:
28455
diff
changeset
|
301 int srcW, int srcH, enum PixelFormat srcFormat, |
29140
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
302 int dstW, int dstH, enum PixelFormat dstFormat, |
b322381cf5e1
whitespace cosmetics: Break some overly long lines.
diego
parents:
28665
diff
changeset
|
303 int flags, SwsFilter *srcFilter, |
29246
8861e08033eb
Add const qualifier to param argument of sws_getContext() and
diego
parents:
29145
diff
changeset
|
304 SwsFilter *dstFilter, const double *param); |
19661
7b24faac56fd
Add sws_getCachedContext(), which checks if context is valid or reallocs a new one instead.
gpoirier
parents:
19594
diff
changeset
|
305 |
31235
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
306 /** |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
307 * Converts an 8bit paletted frame into a frame with a color depth of 32-bits. |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
308 * |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
309 * The output frame will have the same packed format as the palette. |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
310 * |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
311 * @param src source frame buffer |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
312 * @param dst destination frame buffer |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
313 * @param num_pixels number of pixels to convert |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
314 * @param palette array with [256] entries, which must match color arrangement (RGB or BGR) of src |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
315 */ |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
316 void sws_convertPalette8ToPacked32(const uint8_t *src, uint8_t *dst, long num_pixels, const uint8_t *palette); |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
317 |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
318 /** |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
319 * Converts an 8bit paletted frame into a frame with a color depth of 24 bits. |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
320 * |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
321 * With the palette format "ABCD", the destination frame ends up with the format "ABC". |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
322 * |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
323 * @param src source frame buffer |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
324 * @param dst destination frame buffer |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
325 * @param num_pixels number of pixels to convert |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
326 * @param palette array with [256] entries, which must match color arrangement (RGB or BGR) of src |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
327 */ |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
328 void sws_convertPalette8ToPacked24(const uint8_t *src, uint8_t *dst, long num_pixels, const uint8_t *palette); |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
329 |
661755507236
deprecate palette8topacked32 in favor of public API functions sws_convertPalette8ToPacked32 and -24
siretart
parents:
31135
diff
changeset
|
330 |
27467
239a049163eb
Change header inclusion guard names in line with FFmpeg r15120.
stefano
parents:
27460
diff
changeset
|
331 #endif /* SWSCALE_SWSCALE_H */ |