Ocean
Loading...
Searching...
No Matches
FrameConverterY_U_V12.h
Go to the documentation of this file.
1/*
2 * Copyright (c) Meta Platforms, Inc. and affiliates.
3 *
4 * This source code is licensed under the MIT license found in the
5 * LICENSE file in the root directory of this source tree.
6 */
7
8#ifndef META_OCEAN_CV_FRAME_CONVERTER_Y_U_V_12_H
9#define META_OCEAN_CV_FRAME_CONVERTER_Y_U_V_12_H
10
11#include "ocean/cv/CV.h"
12#include "ocean/cv/FrameChannels.h"
13#include "ocean/cv/FrameConverter.h"
14
15#include "ocean/base/Worker.h"
16
17namespace Ocean
18{
19
20namespace CV
21{
22
23/**
24 * This class provides functions to convert frames with Y_U_V12 pixel format.
25 * The Y_U_V12 format holds the three blocks of color channels.<br>
26 * The first block covers the Y channel and holds 8 bit per pixel.<br>
27 * The second block covers the U channel and holds 8 bit for four pixels in a 2x2 neighborhood.<br>
28 * The third block covers the V channel and also holds 8 bit for four pixels in a 2x2 neighborhood.
29 * @ingroup cv
30 */
31class OCEAN_CV_EXPORT FrameConverterY_U_V12 : public FrameConverter
32{
33 public:
34
35 /**
36 * Converts a Y_U_V12 frame to a Y_U_V12 frame into a second image buffer.
37 * @param ySource The y source plane, with (width + yPaddingElements) * height elements, must be valid
38 * @param uSource The u source plane, with (width/2 + uPaddingElements) * height/2 elements, must be valid
39 * @param vSource The v source plane, with (width/2 + vPaddingElements) * height/2 elements, must be valid
40 * @param yTarget The y target plane, with (width + yTargetPaddingElements) * height elements, must be valid
41 * @param uTarget The u target plane, with (width/2 + uTargetPaddingElements) * height/2 elements, must be valid
42 * @param vTarget The v target plane, with (width/2 + vTargetPaddingElements) * height/2 elements, must be valid
43 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
44 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
45 * @param flag Determining the type of conversion
46 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
47 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
48 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
49 * @param yTargetPaddingElements The number of padding elements at the end of each y-target row, in (uint8_t) elements, with range [0, infinity)
50 * @param uTargetPaddingElements The number of padding elements at the end of each uv-target row, in (uint8_t) elements, with range [0, infinity)
51 * @param vTargetPaddingElements The number of padding elements at the end of each uv-target row, in (uint8_t) elements, with range [0, infinity)
52 * @param worker Optional worker object to distribute the computational to several CPU cores
53 */
54 static inline void convertY_U_V12ToY_U_V12(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* yTarget, uint8_t* uTarget, uint8_t* vTarget, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int yTargetPaddingElements, const unsigned int uTargetPaddingElements, const unsigned int vTargetPaddingElements, Worker* worker = nullptr);
55
56 /**
57 * Converts a Y_U_V12 frame to an 8 bit gray scale frame into a second image buffer.
58 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
59 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, can be invalid, as this parameter is not used
60 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, can be invalid, as this parameter is not used
61 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
62 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
63 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
64 * @param flag Determining the type of conversion
65 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
66 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity), actually this parameter is not used
67 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity), actually this parameter is not used
68 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
69 * @param worker Optional worker object to distribute the computational to several CPU cores
70 */
71 static inline void convertY_U_V12ToY8(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker = nullptr);
72
73 /**
74 * Converts a Y_U_V12 frame to a 24 bit BGR frame into a second image buffer using BT.601 (digital).
75 * <pre>
76 * YUV input value range: [16, 235]x[16, 240]x[16, 240]
77 * BGR output value range: [ 0, 255]x[ 0, 255]x[ 0, 255]
78 * </pre>
79 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
80 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
81 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
82 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
83 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
84 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
85 * @param flag Determining the type of conversion
86 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
87 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
88 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
89 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
90 * @param worker Optional worker object to distribute the computational to several CPU cores
91 */
92 static inline void convertY_U_V12LimitedRangeToBGR24FullRange(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker = nullptr);
93
94 /**
95 * Converts a Y_U_V12 frame to a 24 bit BGR frame into a second image buffer using BT.601 (analog).
96 * <pre>
97 * YUV input value range: [0, 255]x[0, 255]x[0, 255]
98 * BGR output value range: [0, 255]x[0, 255]x[0, 255]
99 * </pre>
100 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
101 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
102 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
103 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
104 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
105 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
106 * @param flag Determining the type of conversion
107 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
108 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
109 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
110 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
111 * @param worker Optional worker object to distribute the computational to several CPU cores
112 */
113 static inline void convertY_U_V12FullRangeToBGR24FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker = nullptr);
114
115 /**
116 * Converts a Y_U_V12 frame to an 32 bit BGRA frame into a second image buffer (with 6 bit precision).
117 * <pre>
118 * YUV input value range: [16, 235]x[16, 240]x[16, 240]
119 * BGRA output value range: [ 0, 255]x[ 0, 255]x[ 0, 255]x[ 0, 255]
120 * </pre>
121 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
122 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
123 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
124 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
125 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
126 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
127 * @param flag Determining the type of conversion
128 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
129 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
130 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
131 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
132 * @param alphaValue The value of the alpha channel to be set, with range [0, 255]
133 * @param worker Optional worker object to distribute the computational to several CPU cores
134 */
135 static inline void convertY_U_V12LimitedRangeToBGRA32FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, const uint8_t alphaValue = 0xFF, Worker* worker = nullptr);
136
137 /**
138 * Converts a Y_U_V12 frame to a 24 bit RGB frame into a second image buffer.
139 * <pre>
140 * YUV input value range: [16, 235]x[16, 240]x[16, 240]
141 * RGB output value range: [ 0, 255]x[ 0, 255]x[ 0, 255]
142 * </pre>
143 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
144 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
145 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
146 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
147 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
148 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
149 * @param flag Determining the type of conversion
150 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
151 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
152 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
153 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
154 * @param worker Optional worker object to distribute the computational to several CPU cores
155 */
156 static inline void convertY_U_V12LimitedRangeToRGB24FullRange(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker = nullptr);
157
158 /**
159 * Converts a Y_U_V12 frame to a 24 bit RGB frame into a second image buffer (with 6 bit precision).
160 * <pre>
161 * YUV input value range: [16, 235]x[16, 240]x[16, 240]
162 * RGB output value range: [ 0, 255]x[ 0, 255]x[ 0, 255]
163 * </pre>
164 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
165 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
166 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
167 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
168 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
169 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
170 * @param flag Determining the type of conversion
171 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
172 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
173 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
174 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
175 * @param worker Optional worker object to distribute the computational to several CPU cores
176 */
177 static inline void convertY_U_V12LimitedRangeToRGB24FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker = nullptr);
178
179 /**
180 * Converts a Y_U_V12 frame to a 24 bit RGB frame into a second image buffer.
181 * <pre>
182 * YUV input value range: [0, 255]x[0, 255]x[0, 255]
183 * RGB output value range: [0, 255]x[0, 255]x[0, 255]
184 * </pre>
185 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
186 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
187 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
188 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
189 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
190 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
191 * @param flag Determining the type of conversion
192 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
193 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
194 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
195 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
196 * @param worker Optional worker object to distribute the computational to several CPU cores
197 */
198 static inline void convertY_U_V12FullRangeToRGB24FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker = nullptr);
199
200 /**
201 * Converts a Y_U_V12 frame to an 32 bit RGBA frame into a second image buffer.
202 * <pre>
203 * YUV input value range: [16, 235]x[16, 240]x[16, 240]
204 * RGBA output value range: [ 0, 255]x[ 0, 255]x[ 0, 255]x[ 0, 255]
205 * </pre>
206 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
207 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
208 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
209 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
210 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
211 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
212 * @param flag Determining the type of conversion
213 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
214 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
215 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
216 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
217 * @param alphaValue The value of the alpha channel to be set, with range [0, 255]
218 * @param worker Optional worker object to distribute the computational to several CPU cores
219 */
220 static inline void convertY_U_V12LimitedRangeToRGBA32FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, const uint8_t alphaValue = 0xFF, Worker* worker = nullptr);
221
222 /**
223 * Converts a Y_U_V12 frame to a 24 bit YUV frame into a second image buffer.
224 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
225 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
226 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
227 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
228 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
229 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
230 * @param flag Determining the type of conversion
231 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
232 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
233 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
234 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
235 * @param worker Optional worker object to distribute the computational to several CPU cores
236 */
237 static inline void convertY_U_V12ToYUV24(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker = nullptr);
238
239 /**
240 * Converts a Y_U_V12 frame to a 24 bit YVU frame into a second image buffer.
241 * @param ySource The y source frame buffer, with (width + yPaddingElements) * height elements, must be valid
242 * @param uSource The u source frame buffer, with (width/2 + uPaddingElements) * height/2 elements, must be valid
243 * @param vSource The v source frame buffer, with (width/2 + vPaddingElements) * height/2 elements, must be valid
244 * @param target The target frame buffer, with (width + targetPaddingElements) * height elements, must be valid
245 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
246 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
247 * @param flag Determining the type of conversion
248 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
249 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
250 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
251 * @param targetPaddingElements The number of padding elements at the end of each target row, in (uint8_t) elements, with range [0, infinity)
252 * @param worker Optional worker object to distribute the computational to several CPU cores
253 */
254 static inline void convertY_U_V12ToYVU24(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker = nullptr);
255
256 /**
257 * Converts a Y_U_V12 frame to a Y_UV12 frame into a second image buffer.
258 * @param ySource The y source plane, with (width + yPaddingElements) * height elements, must be valid
259 * @param uSource The u source plane, with (width/2 + uPaddingElements) * height/2 elements, must be valid
260 * @param vSource The v source plane, with (width/2 + vPaddingElements) * height/2 elements, must be valid
261 * @param yTarget The y target plane, with (width + yTargetPaddingElements) * height elements, must be valid
262 * @param uvTarget The uv target plane, with (width + uvTargetPaddingElements) * height/2 elements, must be valid
263 * @param width The width of the frame in pixel, with range [2, infinity), must be a multiple of 2
264 * @param height The height of the frame in pixel, with range [2, infinity), must be a multiple of 2
265 * @param ySourcePaddingElements The number of padding elements at the end of each y-source row, in (uint8_t) elements, with range [0, infinity)
266 * @param uSourcePaddingElements The number of padding elements at the end of each u-source row, in (uint8_t) elements, with range [0, infinity)
267 * @param vSourcePaddingElements The number of padding elements at the end of each v-source row, in (uint8_t) elements, with range [0, infinity)
268 * @param yTargetPaddingElements The number of padding elements at the end of each y-target row, in (uint8_t) elements, with range [0, infinity)
269 * @param uvTargetPaddingElements The number of padding elements at the end of each uv-target row, in (uint8_t) elements, with range [0, infinity)
270 * @param ySourcePixelStride The stride between consecutive pixels in the y source plane, in elements, with range [1, infinity)
271 * @param uSourcePixelStride The stride between consecutive pixels in the u source plane, in elements, with range [1, infinity)
272 * @param vSourcePixelStride The stride between consecutive pixels in the v source plane, in elements, with range [1, infinity)
273 * @param worker Optional worker object to distribute the computational to several CPU cores
274 */
275 static inline void convertY_U_V12ToY_UV12(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* yTarget, uint8_t* uvTarget, const unsigned int width, const unsigned int height, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int yTargetPaddingElements, const unsigned int uvTargetPaddingElements, const unsigned int ySourcePixelStride = 1u, const unsigned int uSourcePixelStride = 1u, const unsigned int vSourcePixelStride = 1u, Worker* worker = nullptr);
276
277 protected:
278
279 /**
280 * Converts one row of an image with Y_U_V12 pixel format to one row of an image with RGBA32 pixel format.
281 * This function applies hard-coded conversion parameters.<br>
282 * The layout of the options parameters is as follows:
283 * <pre>
284 * options[0] uint32_t: sourcePlane0PaddingElements
285 * options[1] uint32_t: sourcePlane1PaddingElements
286 * options[2] uint32_t: sourcePlane2PaddingElements
287 * options[3] uint32_t: targetZippedPaddingElements
288 * options[4] uint32_t: channelValue3
289 * </pre>
290 * @param sources The pointer to the first, second, and third memory block of the source image, must be valid
291 * @param targets The one pointer to the target image, must be valid
292 * @param multipleRowIndex The index of the multiple-row to be handled, with range [0, height - 1]
293 * @param width The width of the frame in pixel, with range [1, infinity)
294 * @param height The height of the frame in pixel, with range [1, infinity)
295 * @param conversionFlag The conversion to be applied
296 * @param options The 5 options parameters: 4 padding parameters, one constant channel value, must be valid
297 */
298 static void convertOneRowY_U_V12ToRGBA32Precision6Bit(const void** sources, void** targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void* options);
299
300 /**
301 * Converts two rows of an image with Y_U_V12 pixel format to two rows of an image with a Y_UV12 pixel format.
302 * The layout of the options parameters is as follows:
303 * <pre>
304 * options[0] uint32_t: ySourcePaddingElements
305 * options[1] uint32_t: uSourcePaddingElements
306 * options[2] uint32_t: vSourcePaddingElements
307 * options[3] uint32_t: yTargetPaddingElements
308 * options[4] uint32_t: uvTargetPaddingElements
309 * options[5] uint32_t: ySourcePixelStride
310 * options[6] uint32_t: uSourcePixelStride
311 * options[7] uint32_t: vSourcePixelStride
312 * </pre>
313 * @param sources The pointer to the first, second, and third plane of the source image, must be valid
314 * @param targets The one pointer to the first and second target plane, must be valid
315 * @param multipleRowIndex The index of the multiple-row to be handled, with range [0, height / 2 - 1]
316 * @param width The width of the frame in pixel, with range [2, infinity), must be even
317 * @param height The height of the frame in pixel, with range [2, infinity), must be even
318 * @param conversionFlag The conversion to be applied, must be CONVERT_NORMAL
319 * @param options The 8 options parameters: 5 padding parameters, 3 pixel stride parameters, must be valid
320 */
321 static void mapY_U_V12ToY_UV12(const void** sources, void** targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void* options);
322};
323
324inline void FrameConverterY_U_V12::convertY_U_V12ToY_U_V12(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* yTarget, uint8_t* uTarget, uint8_t* vTarget, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int yTargetPaddingElements, const unsigned int uTargetPaddingElements, const unsigned int vTargetPaddingElements, Worker* worker)
325{
326 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr);
327 ocean_assert(yTarget != nullptr && uTarget != nullptr && vTarget != nullptr);
328 ocean_assert(width >= 2u && height >= 2u);
329 ocean_assert(width % 2u == 0u && height % 2u == 0u);
330
331 const unsigned int width_2 = width / 2u;
332 const unsigned int height_2 = height / 2u;
333
334 FrameChannels::transformGeneric<uint8_t, 1u>(ySource, yTarget, width, height, flag, ySourcePaddingElements, yTargetPaddingElements, worker);
335 FrameChannels::transformGeneric<uint8_t, 1u>(uSource, uTarget, width_2, height_2, flag, uSourcePaddingElements, uTargetPaddingElements, worker);
336 FrameChannels::transformGeneric<uint8_t, 1u>(vSource, vTarget, width_2, height_2, flag, vSourcePaddingElements, vTargetPaddingElements, worker);
337}
338
339inline void FrameConverterY_U_V12::convertY_U_V12ToY8(const uint8_t* ySource, const uint8_t* /* uSource */, const uint8_t* /* vSource */, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int /* uSourcePaddingElements */, const unsigned int /* vSourcePaddingElements */, const unsigned int targetPaddingElements, Worker* worker)
340{
341 ocean_assert(ySource != nullptr && target != nullptr);
342 ocean_assert(width >= 1u && height >= 1u);
343
344 FrameChannels::transformGeneric<uint8_t, 1u>(ySource, target, width, height, flag, ySourcePaddingElements, targetPaddingElements, worker);
345}
346
347inline void FrameConverterY_U_V12::convertY_U_V12LimitedRangeToBGR24FullRange(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker)
348{
349 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
350
351 ocean_assert(width >= 2u && width % 2u == 0u);
352 ocean_assert(height >= 2u && height % 2u == 0u);
353
354 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
355 {
356 return;
357 }
358
359 // precise color space conversion:
360 // | B | | 1.1639404296875 2.0179443359375 0.0 -276.919921875 | | Y |
361 // | G | = | 1.1639404296875 -0.3909912109375 -0.81298828125 135.486328125 | * | U |
362 // | R | | 1.1639404296875 0.0 1.595947265625 -222.904296875 | | V |
363 // | 1 |
364
365 // approximation:
366 // | B | | 1192 2066 0 -277 | | Y |
367 // | G | = | 1192 -400 -833 135 | * | U |
368 // | R | | 1192 0 1634 -223 | | V |
369 // | 1 |
370
371 const int options[4 + 12] =
372 {
373 // padding parameters
374 int(ySourcePaddingElements), int(uSourcePaddingElements), int(vSourcePaddingElements), int(targetPaddingElements),
375
376 // multiplication parameters (with denominator 1024)
377 1192, 1192, 1192, 2066, -400, 0, 0, -833, 1634,
378
379 // bias/translation parameters (with denominator 1)
380 -277, 135, -223
381 };
382
383 const void* sources[3] =
384 {
385 ySource,
386 uSource,
387 vSource
388 };
389
390 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 2u, FrameConverter::convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision10Bit, options, worker);
391}
392
393inline void FrameConverterY_U_V12::convertY_U_V12FullRangeToBGR24FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker)
394{
395 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
396
397 ocean_assert(width >= 2u && width % 2u == 0u);
398 ocean_assert(height >= 2u && height % 2u == 0u);
399
400 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
401 {
402 return;
403 }
404
405 /*
406 * | B | | 1.0 1.772 0.0 -226.816 | | Y |
407 * | G | = | 1.0 -0.34414 -0.71414 135.45984 | * | U |
408 * | R | | 1.0 0.0 1.402 -179.456 | | V |
409 * | 1 |
410 *
411 * Approximation with 6 bit precision:
412 * | B | | 64 113 0 | | Y |
413 * 64 * | G | = | 64 -22 -46 | * | U - 128 |
414 * | R | | 64 0 90 | | V - 128 |
415 */
416
417 const int options[4 + 12] =
418 {
419 // padding parameters
420 int(ySourcePaddingElements), int(uSourcePaddingElements), int(vSourcePaddingElements), int(targetPaddingElements),
421
422 // multiplication parameters (with denominator 1024)
423 64, 64, 64, 113, -22, 0, 0, -46, 90,
424
425 // bias/translation parameters (with denominator 1)
426 0, 128, 128
427 };
428
429 const void* sources[3] =
430 {
431 ySource,
432 uSource,
433 vSource
434 };
435
436 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 2u, FrameConverter::convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision6Bit, options, worker);
437}
438
439inline void FrameConverterY_U_V12::convertY_U_V12LimitedRangeToBGRA32FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, const uint8_t alphaValue, Worker* worker)
440{
441 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
442
443 ocean_assert(width >= 2u && width % 2u == 0u);
444 ocean_assert(height >= 2u && height % 2u == 0u);
445
446 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
447 {
448 return;
449 }
450
451 // Approximation with 6 bit precision:
452 // | B | | 75 128 0 | | Y - 16 |
453 // 64 * | G | = | 75 -25 -52 | * | U - 128 |
454 // | R | | 75 0 102 | | V - 128 |
455
456 const int options[4 + 12 + 1] =
457 {
458 // padding parameters
459 int(ySourcePaddingElements), int(uSourcePaddingElements), int(vSourcePaddingElements), int(targetPaddingElements),
460
461 // multiplication parameters (with denominator 64)
462 75, 75, 75, 128, -25, 0, 0, -52, 102,
463
464 // bias/translation parameters (with denominator 1)
465 16, 128, 128,
466
467 // alpha value
468 int(alphaValue)
469 };
470
471 const void* sources[3] =
472 {
473 ySource,
474 uSource,
475 vSource
476 };
477
478 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 1u, FrameConverter::convertOneRow_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane4Channels_8BitPerChannel_Precision6Bit, options, worker);
479}
480
481inline void FrameConverterY_U_V12::convertY_U_V12LimitedRangeToRGB24FullRange(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker)
482{
483 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
484
485 ocean_assert(width >= 2u && width % 2u == 0u);
486 ocean_assert(height >= 2u && height % 2u == 0u);
487
488 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
489 {
490 return;
491 }
492
493 // precise color space conversion:
494 // | R | | 1.1639404296875 0.0 1.595947265625 -222.904296875 | | Y |
495 // | G | = | 1.1639404296875 -0.3909912109375 -0.81298828125 135.486328125 | * | U |
496 // | B | | 1.1639404296875 2.0179443359375 0.0 -276.919921875 | | V |
497 // | 1 |
498
499 // approximation:
500 // | R | | 1192 0 1634 -223 | | Y |
501 // | G | = | 1192 -400 -833 135 | * | U |
502 // | B | | 1192 2066 0 -277 | | V |
503 // | 1 |
504
505 const int options[4 + 12] =
506 {
507 // padding parameters
508 int(ySourcePaddingElements), int(uSourcePaddingElements), int(vSourcePaddingElements), int(targetPaddingElements),
509
510 // multiplication parameters (with denominator 1024)
511 1192, 1192, 1192, 0, -400, 2066, 1634, -833, 0,
512
513 // bias/translation parameters (with denominator 1)
514 -223, 135, -277
515 };
516
517 const void* sources[3] =
518 {
519 ySource,
520 uSource,
521 vSource
522 };
523
524 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 2u, FrameConverter::convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision10Bit, options, worker);
525}
526
527inline void FrameConverterY_U_V12::convertY_U_V12LimitedRangeToRGB24FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker)
528{
529 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
530
531 ocean_assert(width >= 2u && width % 2u == 0u);
532 ocean_assert(height >= 2u && height % 2u == 0u);
533
534 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
535 {
536 return;
537 }
538
539 /*
540 * | R | | 1.1639404296875 0.0 1.595947265625 -222.904296875 | | Y |
541 * | G | = | 1.1639404296875 -0.3909912109375 -0.81298828125 135.486328125 | * | U |
542 * | B | | 1.1639404296875 2.0179443359375 0.0 -276.919921875 | | V |
543 * | 1 |
544 *
545 * Approximation with 6 bit precision:
546 * | R | | 75 0 102 | | Y - 16 |
547 * 64 * | G | = | 75 -25 -52 | * | U - 128 |
548 * | B | | 75 128 0 | | V - 128 |
549 */
550
551 const int options[4 + 12] =
552 {
553 // padding parameters
554 int(ySourcePaddingElements), int(uSourcePaddingElements), int(vSourcePaddingElements), int(targetPaddingElements),
555
556 // multiplication parameters (with denominator 1024)
557 75, 75, 75, 0, -25, 128, 102, -52, 0,
558
559 // bias/translation parameters (with denominator 1)
560 16, 128, 128
561 };
562
563 const void* sources[3] =
564 {
565 ySource,
566 uSource,
567 vSource
568 };
569
570 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 2u, FrameConverter::convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision6Bit, options, worker);
571}
572
573inline void FrameConverterY_U_V12::convertY_U_V12FullRangeToRGB24FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker)
574{
575 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
576
577 ocean_assert(width >= 2u && width % 2u == 0u);
578 ocean_assert(height >= 2u && height % 2u == 0u);
579
580 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
581 {
582 return;
583 }
584
585 /*
586 * | R | | 1.0 0.0 1.402 -179.456 | | Y |
587 * | G | = | 1.0 -0.34414 -0.71414 135.45984 | * | U |
588 * | B | | 1.0 1.772 0.0 -226.816 | | V |
589 * | 1 |
590 *
591 * Approximation with 6 bit precision:
592 * | R | | 64 0 90 | | Y |
593 * 64 * | G | = | 64 -22 -46 | * | U - 128 |
594 * | B | | 64 113 0 | | V - 128 |
595 */
596
597 const int options[4 + 12] =
598 {
599 // padding parameters
600 int(ySourcePaddingElements), int(uSourcePaddingElements), int(vSourcePaddingElements), int(targetPaddingElements),
601
602 // multiplication parameters (with denominator 1024)
603 64, 64, 64, 0, -22, 113, 90, -46, 0,
604
605 // bias/translation parameters (with denominator 1)
606 0, 128, 128
607 };
608
609 const void* sources[3] =
610 {
611 ySource,
612 uSource,
613 vSource
614 };
615
616 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 2u, FrameConverter::convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision6Bit, options, worker);
617}
618
619inline void FrameConverterY_U_V12::convertY_U_V12LimitedRangeToRGBA32FullRangePrecision6Bit(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, const uint8_t alphaValue, Worker* worker)
620{
621 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
622
623 ocean_assert(width >= 2u && width % 2u == 0u);
624 ocean_assert(height >= 2u && height % 2u == 0u);
625
626 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
627 {
628 return;
629 }
630
631#if 1
632
633 // Approximation with 6 bit precision:
634 // | R | | 75 0 102 | | Y - 16 |
635 // 64 * | G | = | 75 -25 -52 | * | U - 128 |
636 // | B | | 75 128 0 | | V - 128 |
637
638 const int options[4 + 12 + 1] =
639 {
640 // padding parameters
641 int(ySourcePaddingElements), int(uSourcePaddingElements), int(vSourcePaddingElements), int(targetPaddingElements),
642
643 // multiplication parameters (with denominator 64)
644 75, 75, 75, 0, -25, 128, 102, -52, 0,
645
646 // bias/translation parameters (with denominator 1)
647 16, 128, 128,
648
649 // alpha value
650 int(alphaValue)
651 };
652
653 const void* sources[3] =
654 {
655 ySource,
656 uSource,
657 vSource
658 };
659
660 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 1u, FrameConverter::convertOneRow_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane4Channels_8BitPerChannel_Precision6Bit, options, worker);
661
662#else
663
664 const int options[4 + 1] =
665 {
666 // padding parameters
667 int(ySourcePaddingElements), int(uSourcePaddingElements), int(vSourcePaddingElements), int(targetPaddingElements),
668
669 // alpha value
670 int(alphaValue)
671 };
672
673 const void* sources[3] =
674 {
675 ySource,
676 uSource,
677 vSource
678 };
679
680 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 1u, convertOneRowY_U_V12ToRGBA32Precision6Bit, options, worker);
681
682#endif
683}
684
685inline void FrameConverterY_U_V12::convertY_U_V12ToYUV24(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker)
686{
687 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
688
689 ocean_assert(width >= 2u && width % 2u == 0u);
690 ocean_assert(height >= 2u && height % 2u == 0u);
691
692 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
693 {
694 return;
695 }
696
697 const unsigned int options[4] = {ySourcePaddingElements, uSourcePaddingElements, vSourcePaddingElements, targetPaddingElements};
698
699 const void* sources[3] =
700 {
701 ySource,
702 uSource,
703 vSource
704 };
705
706 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 2u, FrameConverter::mapTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel<0u, 1u, 2u>, options, worker);
707}
708
709inline void FrameConverterY_U_V12::convertY_U_V12ToYVU24(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker* worker)
710{
711 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr && target != nullptr);
712
713 ocean_assert(width >= 2u && width % 2u == 0u);
714 ocean_assert(height >= 2u && height % 2u == 0u);
715
716 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
717 {
718 return;
719 }
720
721 const unsigned int options[4] = {ySourcePaddingElements, uSourcePaddingElements, vSourcePaddingElements, targetPaddingElements};
722
723 const void* sources[3] =
724 {
725 ySource,
726 uSource,
727 vSource
728 };
729
730 FrameConverter::convertArbitraryPixelFormat(sources, (void**)(&target), width, height, flag, 2u, FrameConverter::mapTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel<0u, 2u, 1u>, options, worker);
731}
732
733inline void FrameConverterY_U_V12::convertY_U_V12ToY_UV12(const uint8_t* ySource, const uint8_t* uSource, const uint8_t* vSource, uint8_t* yTarget, uint8_t* uvTarget, const unsigned int width, const unsigned int height, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int yTargetPaddingElements, const unsigned int uvTargetPaddingElements, const unsigned int ySourcePixelStride, const unsigned int uSourcePixelStride, const unsigned int vSourcePixelStride, Worker* worker)
734{
735 ocean_assert(ySource != nullptr && uSource != nullptr && vSource != nullptr);
736 ocean_assert(yTarget != nullptr && uvTarget != nullptr);
737
738 if (width < 2u || height < 2u || width % 2u != 0u || height % 2u != 0u)
739 {
740 ocean_assert(false && "Invalid parameters!");
741 return;
742 }
743
744 const uint32_t options[8] = {ySourcePaddingElements, uSourcePaddingElements, vSourcePaddingElements, yTargetPaddingElements, uvTargetPaddingElements, ySourcePixelStride, uSourcePixelStride, vSourcePixelStride};
745
746 const void* sources[3] =
747 {
748 ySource,
749 uSource,
750 vSource
751 };
752
753 void* targets[2] =
754 {
755 yTarget,
756 uvTarget
757 };
758
759 FrameConverter::convertArbitraryPixelFormat(sources, targets, width, height, CONVERT_NORMAL, 2u, mapY_U_V12ToY_UV12, options, worker);
760}
761
762}
763
764}
765
766#endif // META_OCEAN_CV_FRAME_CONVERTER_Y_U_V_12_H
Ocean::CV::FrameConverter
This is the base class for all frame converter classes.
Definition FrameConverter.h:32
Ocean::CV::FrameConverter::ConversionFlag
ConversionFlag
Definition of individual conversion flags.
Definition FrameConverter.h:39
Ocean::CV::FrameConverter::CONVERT_NORMAL
@ CONVERT_NORMAL
Normal conversion, neither flips nor mirrors the image.
Definition FrameConverter.h:49
Ocean::CV::FrameConverter::convertOneRow_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane4Channels_8BitPerChannel_Precision6Bit
static void convertOneRow_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane4Channels_8BitPerChannel_Precision6Bit(const void **sources, void **targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
Converts one row of an image with e.g., a Y_U_V12 pixel format to one row of an image with e....
Ocean::CV::FrameConverter::convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision10Bit
static void convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision10Bit(const void **sources, void **targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
Converts two rows of an image with e.g., a Y_U_V12 pixel format to two rows of an image with e....
Ocean::CV::FrameConverter::convertArbitraryPixelFormat
static void convertArbitraryPixelFormat(const void **sources, void **targets, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int multipleRowsPerIteration, const MultipleRowsConversionFunction multipleRowsConversionFunction, const void *options, Worker *worker)
Converts a frame with arbitrary pixel format (e.g., Y_UV12, Y_VU12, YUYV16, ...) to a frame with arbi...
Definition FrameConverter.h:3234
Ocean::CV::FrameConverter::convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision6Bit
static void convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision6Bit(const void **sources, void **targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
Converts two rows of an image with e.g., a Y_U_V12 pixel format to two rows of an image with e....
Ocean::CV::FrameConverterY_U_V12
This class provides functions to convert frames with Y_U_V12 pixel format.
Definition FrameConverterY_U_V12.h:32
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12LimitedRangeToRGB24FullRangePrecision6Bit
static void convertY_U_V12LimitedRangeToRGB24FullRangePrecision6Bit(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a 24 bit RGB frame into a second image buffer (with 6 bit precision).
Definition FrameConverterY_U_V12.h:527
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12LimitedRangeToBGR24FullRange
static void convertY_U_V12LimitedRangeToBGR24FullRange(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a 24 bit BGR frame into a second image buffer using BT....
Definition FrameConverterY_U_V12.h:347
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12ToYUV24
static void convertY_U_V12ToYUV24(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a 24 bit YUV frame into a second image buffer.
Definition FrameConverterY_U_V12.h:685
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12FullRangeToRGB24FullRangePrecision6Bit
static void convertY_U_V12FullRangeToRGB24FullRangePrecision6Bit(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a 24 bit RGB frame into a second image buffer.
Definition FrameConverterY_U_V12.h:573
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12LimitedRangeToRGBA32FullRangePrecision6Bit
static void convertY_U_V12LimitedRangeToRGBA32FullRangePrecision6Bit(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, const uint8_t alphaValue=0xFF, Worker *worker=nullptr)
Converts a Y_U_V12 frame to an 32 bit RGBA frame into a second image buffer.
Definition FrameConverterY_U_V12.h:619
Ocean::CV::FrameConverterY_U_V12::convertOneRowY_U_V12ToRGBA32Precision6Bit
static void convertOneRowY_U_V12ToRGBA32Precision6Bit(const void **sources, void **targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
Converts one row of an image with Y_U_V12 pixel format to one row of an image with RGBA32 pixel forma...
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12ToYVU24
static void convertY_U_V12ToYVU24(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a 24 bit YVU frame into a second image buffer.
Definition FrameConverterY_U_V12.h:709
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12FullRangeToBGR24FullRangePrecision6Bit
static void convertY_U_V12FullRangeToBGR24FullRangePrecision6Bit(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a 24 bit BGR frame into a second image buffer using BT....
Definition FrameConverterY_U_V12.h:393
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12LimitedRangeToRGB24FullRange
static void convertY_U_V12LimitedRangeToRGB24FullRange(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a 24 bit RGB frame into a second image buffer.
Definition FrameConverterY_U_V12.h:481
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12ToY_U_V12
static void convertY_U_V12ToY_U_V12(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *yTarget, uint8_t *uTarget, uint8_t *vTarget, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int yTargetPaddingElements, const unsigned int uTargetPaddingElements, const unsigned int vTargetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a Y_U_V12 frame into a second image buffer.
Definition FrameConverterY_U_V12.h:324
Ocean::CV::FrameConverterY_U_V12::mapY_U_V12ToY_UV12
static void mapY_U_V12ToY_UV12(const void **sources, void **targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
Converts two rows of an image with Y_U_V12 pixel format to two rows of an image with a Y_UV12 pixel f...
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12ToY_UV12
static void convertY_U_V12ToY_UV12(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *yTarget, uint8_t *uvTarget, const unsigned int width, const unsigned int height, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int yTargetPaddingElements, const unsigned int uvTargetPaddingElements, const unsigned int ySourcePixelStride=1u, const unsigned int uSourcePixelStride=1u, const unsigned int vSourcePixelStride=1u, Worker *worker=nullptr)
Converts a Y_U_V12 frame to a Y_UV12 frame into a second image buffer.
Definition FrameConverterY_U_V12.h:733
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12ToY8
static void convertY_U_V12ToY8(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
Converts a Y_U_V12 frame to an 8 bit gray scale frame into a second image buffer.
Definition FrameConverterY_U_V12.h:339
Ocean::CV::FrameConverterY_U_V12::convertY_U_V12LimitedRangeToBGRA32FullRangePrecision6Bit
static void convertY_U_V12LimitedRangeToBGRA32FullRangePrecision6Bit(const uint8_t *ySource, const uint8_t *uSource, const uint8_t *vSource, uint8_t *target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int ySourcePaddingElements, const unsigned int uSourcePaddingElements, const unsigned int vSourcePaddingElements, const unsigned int targetPaddingElements, const uint8_t alphaValue=0xFF, Worker *worker=nullptr)
Converts a Y_U_V12 frame to an 32 bit BGRA frame into a second image buffer (with 6 bit precision).
Definition FrameConverterY_U_V12.h:439
Ocean::Worker
This class implements a worker able to distribute function calls over different threads.
Definition Worker.h:33
Ocean
The namespace covering the entire Ocean framework.
Definition Accessor.h:15