Debian Codegraph @

media_common/agnostic/common/vp/hal/vp_common_defs.h

raw
1 /*
2 * Copyright (c) 2022, Intel Corporation
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included
12 * in all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
21 */
22 //!
23 //! \file vp_common_defs.h
24 //! \brief clarify common utilities for vphal
25 //! \details clarify common utilities for vphal including:
26 //! some marcro, enum, union, structure, function
27 //!
28 #ifndef __VP_COMMON_DEFS_H__
29 #define __VP_COMMON_DEFS_H__
30
31 #include <cstdint>
32 #include "mos_defs.h"
33 #include "media_common_defs.h"
34
35 #define ADDRESS_PAGE_ALIGNMENT_MASK_X64 0xFFFFFFFFFFFFF000ULL
36 #define ADDRESS_PAGE_ALIGNMENT_MASK_X86 0xFFFFF000
37
38 //!
39 //! \def OUT_OF_BOUNDS(a, min, max)
40 //! Calcualte if \a a out the range of [\a min, \a max].
41 //!
42 #define OUT_OF_BOUNDS(a, min, max) (((a) < (min)) || ((a) > (max)))
43
44 //!
45 //! \def RECT1_CONTAINS_RECT2(rect1, rect2)
46 //! Compare if rectangle \a rect1 contains rectangle \a rect2 in coordinate
47 //!
48 #define RECT1_CONTAINS_RECT2(rect1, rect2) \
49 (((rect1).left <= (rect2).left) && ((rect1).top <= (rect2).top) && \
50 ((rect1).right >= (rect2).right) && ((rect1).bottom >= (rect2).bottom))
51
52 //!
53 //! \def RECT1_CONTAINS_RECT2_ONEPIXELBIAS(rect1, rect2)
54 //! Compare if rectangle \a rect1 contains rectangle \a rect2 in coordinate, One pixel bias is allowed
55 //!
56 #define RECT1_CONTAINS_RECT2_ONEPIXELBIAS(rect1, rect2) \
57 (((rect1).left <= ((rect2).left + 1)) && ((rect1).top <= ((rect2).top + 1)) && \
58 (((rect1).right + 1) >= (rect2).right) && (((rect1).bottom + 1) >= (rect2).bottom))
59
60 #define VPHAL_MEMORY_OBJECT_CONTROL uint32_t
61
62 // YUV input ranges
63 #define YUV_RANGE_16_235 1
64 #define YUV_RANGE_0_255 2
65
66 // ProcAmp Default Values
67 #define PROCAMP_BRIGHTNESS_MIN -100.0F
68 #define PROCAMP_BRIGHTNESS_MAX 100.0F
69 #define PROCAMP_BRIGHTNESS_DEFAULT 0.0F
70 #define PROCAMP_BRIGHTNESS_STEP 0.1F
71 #define PROCAMP_CONTRAST_MIN 0.0F
72 #define PROCAMP_CONTRAST_MAX 10.0F
73 #define PROCAMP_CONTRAST_DEFAULT 1.0F
74 #define PROCAMP_CONTRAST_STEP 0.01F
75 #define PROCAMP_HUE_MIN -180.0F
76 #define PROCAMP_HUE_MAX 180.0F
77 #define PROCAMP_HUE_DEFAULT 0.0F
78 #define PROCAMP_HUE_STEP 0.1F
79 #define PROCAMP_SATURATION_MIN 0.0F
80 #define PROCAMP_SATURATION_MAX 10.0F
81 #define PROCAMP_SATURATION_DEFAULT 1.0F
82 #define PROCAMP_SATURATION_STEP 0.01F
83
84 // Denoise Default Values
85 #define NOISEREDUCTION_MIN 0.0F
86 #define NOISEREDUCTION_MAX 64.0F
87 #define NOISEREDUCTION_DEFAULT 0.0F
88 #define NOISEREDUCTION_STEP 1.0F
89
90 // Skin Tone Detection/Enhancement values
91 #define STE_MIN 0.0F
92 #define STE_MAX 9.0F
93 #define STE_DEFAULT 3.0F
94 #define STE_STEP 1.0F
95
96 // Total Color Correction values
97 #define TCC_MIN 0.0F
98 #define TCC_MAX 255.0F
99 #define TCC_DEFAULT 160.0F
100 #define TCC_STEP 1.0F
101
102 // Adaptive Contrast Enhancement values
103 #define ACE_LEVEL_DEFAULT 5
104 #define ACE_STRENGTH_DEFAULT 1
105
106 // Sharpness Values
107 #define EDGEENHANCEMENT_MIN 0.0F
108 #define EDGEENHANCEMENT_MAX 64.0F
109 #define EDGEENHANCEMENT_DEFAULT 44.0F
110 #define EDGEENHANCEMENT_STEP 1.0F
111 #define IEF_STRONG_EDGE_WEIGHT 7
112 #define IEF_REGULAR_WEIGHT 2
113 #define IEF_STRONG_EDGE_THRESHOLD 8
114
115 #define VPHAL_MAX_SOURCES 65 //!< worst case: 64 sub-streams + 1 pri video
116 #define VPHAL_MAX_TARGETS 8 //!< multi output support
117
118 #define VPHAL_TOP_FIELD 0
119 #define VPHAL_BOTTOM_FIELD 1
120 #define VPHAL_TOP_FIELD_FIRST 0
121 #define VPHAL_BOTTOM_FIELD_FIRST 1
122
123 //*-----------------------------------------------------------------------------
124 //| DEFINITIONS
125 //*-----------------------------------------------------------------------------
126 // Incremental size for allocating/reallocating resource
127 #define VPHAL_BUFFER_SIZE_INCREMENT 128
128
129 // VPP internal resource NotLockable flag macro
130 #define VPP_INTER_RESOURCE_NOTLOCKABLE true
131 #define VPP_INTER_RESOURCE_LOCKABLE false
132
133 // Media Features width
134 #define VPHAL_RNDR_8K_WIDTH (7680)
135 #define VPHAL_RNDR_16K_HEIGHT_LIMIT (16352)
136
137 // Media Features height
138 #define VPHAL_RNDR_2K_HEIGHT 1080
139 // The reason that the definition is not (VPHAL_RNDR_2K_HEIGHT*2) is because some 4K clips have 1200 height.
140 #define VPHAL_RNDR_4K_HEIGHT 1200
141 #define VPHAL_RNDR_4K_MAX_HEIGHT 3112
142 #define VPHAL_RNDR_4K_MAX_WIDTH 4096
143 #define VPHAL_RNDR_6K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 3)
144 #define VPHAL_RNDR_8K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 4)
145 #define VPHAL_RNDR_10K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 5)
146 #define VPHAL_RNDR_12K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 6)
147 #define VPHAL_RNDR_14K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 7)
148 #define VPHAL_RNDR_16K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 8)
149 #define VPHAL_RNDR_18K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 9)
150 #define VPHAL_RNDR_20K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 10)
151 #define VPHAL_RNDR_22K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 11)
152 #define VPHAL_RNDR_24K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 12)
153 #define VPHAL_RNDR_26K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 13)
154 #define VPHAL_RNDR_28K_HEIGHT (VPHAL_RNDR_2K_HEIGHT * 14)
155
156 //!
157 //! \def MEDIA_IS_HDCONTENT(dwWidth, dwHeight)
158 //! Determine if the size of content is HD
159 //!
160 #define MEDIA_SDCONTENT_MAX_WIDTH 720
161 #define MEDIA_SDCONTENT_MAX_PAL_HEIGHT 576
162 #define MEDIA_SDCONTENT_MAX_SW_WIDTH 768
163 #define MEDIA_IS_HDCONTENT(dwWidth, dwHeight) ((dwWidth > MEDIA_SDCONTENT_MAX_SW_WIDTH) || (dwHeight > MEDIA_SDCONTENT_MAX_PAL_HEIGHT))
164
165 //!
166 //! \brief Base VP kernel list
167 //!
168 enum VpKernelID
169 {
170 // FC
171 kernelCombinedFc = 0,
172
173 // 2 VEBOX KERNELS
174 kernelVeboxSecureBlockCopy,
175 kernelVeboxUpdateDnState,
176
177 // User Ptr
178 kernelUserPtr,
179 // Fast 1toN
180 kernelFast1toN,
181
182 // HDR
183 kernelHdrMandatory,
184 kernelHdrPreprocess,
185
186 // mediacopy-render copy
187 kernelRenderCopy,
188
189 kernelOclFcCommon,
190 kernelOclFcFP,
191 kernelOclFc444PL3Input,
192 kernelOclFc444PL3Output,
193 kernelOclFc420PL3Input,
194 kernelOclFc420PL3Output,
195 kernelOclFc422HVInput,
196
197 baseKernelMaxNumID
198 };
199
200 enum VpKernelIDNext
201 {
202 vpKernelIDNextBase = 0x200,
203 kernelHdr3DLutCalc = vpKernelIDNextBase,
204 kernelHdr3DLutCalcOcl,
205 kernelHVSCalc,
206 kernelHdrMandatoryLite,
207
208 //Add New Kernel ID Here
209
210 // AI Common
211 kernelAiCommon,
212 kernelAiCommonEnd = kernelAiCommon + 0x1000,
213
214 vpKernelIDNextMax
215 };
216 C_ASSERT(kernelAiCommonEnd == vpKernelIDNextMax - 1);
217
218 //!
219 //! \brief Base VP graph list
220 //!
221 enum VP_GRAPH_ID
222 {
223 VP_GRAPH_ID_INVALID = 0,
224
225 VP_GRAPH_ID_BASE_MAX
226 };
227
228 typedef struct _VPHAL_COMPOSITE_CACHE_CNTL
229 {
230 bool bL3CachingEnabled;
231 VPHAL_MEMORY_OBJECT_CONTROL PrimaryInputSurfMemObjCtl;
232 VPHAL_MEMORY_OBJECT_CONTROL InputSurfMemObjCtl;
233 VPHAL_MEMORY_OBJECT_CONTROL TargetSurfMemObjCtl;
234 } VPHAL_COMPOSITE_CACHE_CNTL, *PVPHAL_COMPOSITE_CACHE_CNTL;
235
236 //!
237 //! \brief Vphal Output chroma configuration enum
238 //!
239 typedef enum _VPHAL_CHROMA_SUBSAMPLING
240 {
241 CHROMA_SUBSAMPLING_TOP_CENTER = 0,
242 CHROMA_SUBSAMPLING_CENTER_CENTER,
243 CHROMA_SUBSAMPLING_BOTTOM_CENTER,
244 CHROMA_SUBSAMPLING_TOP_LEFT,
245 CHROMA_SUBSAMPLING_CENTER_LEFT,
246 CHROMA_SUBSAMPLING_BOTTOM_LEFT
247 } VPHAL_CHROMA_SUBSAMPLING;
248
249 //!
250 //! \brief Vphal Gamma Values configuration enum
251 //!
252 typedef enum _VPHAL_GAMMA_VALUE
253 {
254 GAMMA_1P0 = 0,
255 GAMMA_2P2,
256 GAMMA_2P6
257 } VPHAL_GAMMA_VALUE;
258
259 typedef struct _VPHAL_DNDI_CACHE_CNTL
260 {
261 bool bL3CachingEnabled;
262 VPHAL_MEMORY_OBJECT_CONTROL CurrentInputSurfMemObjCtl;
263 VPHAL_MEMORY_OBJECT_CONTROL PreviousInputSurfMemObjCtl;
264 VPHAL_MEMORY_OBJECT_CONTROL STMMInputSurfMemObjCtl;
265 VPHAL_MEMORY_OBJECT_CONTROL STMMOutputSurfMemObjCtl;
266 VPHAL_MEMORY_OBJECT_CONTROL DnOutSurfMemObjCtl;
267 VPHAL_MEMORY_OBJECT_CONTROL CurrentOutputSurfMemObjCtl;
268 VPHAL_MEMORY_OBJECT_CONTROL StatisticsOutputSurfMemObjCtl;
269 VPHAL_MEMORY_OBJECT_CONTROL LaceOrAceOrRgbHistogramSurfCtrl;
270 VPHAL_MEMORY_OBJECT_CONTROL AlphaOrVignetteSurfMemObjCtl;
271 VPHAL_MEMORY_OBJECT_CONTROL SkinScoreSurfMemObjCtl;
272 VPHAL_MEMORY_OBJECT_CONTROL LaceLookUpTablesSurfMemObjCtl;
273 VPHAL_MEMORY_OBJECT_CONTROL Vebox3DLookUpTablesSurfMemObjCtl;
274 } VPHAL_DNDI_CACHE_CNTL, *PVPHAL_DNDI_CACHE_CNTL;
275
276 typedef struct _VPHAL_LACE_CACHE_CNTL
277 {
278 // LACE would reuse the bL3CachingEnabled of VEBOX's cache control
279 VPHAL_MEMORY_OBJECT_CONTROL FrameHistogramSurfaceMemObjCtl;
280 VPHAL_MEMORY_OBJECT_CONTROL AggregatedHistogramSurfaceMemObjCtl;
281 VPHAL_MEMORY_OBJECT_CONTROL StdStatisticsSurfaceMemObjCtl;
282 VPHAL_MEMORY_OBJECT_CONTROL PwlfInSurfaceMemObjCtl;
283 VPHAL_MEMORY_OBJECT_CONTROL PwlfOutSurfaceMemObjCtl;
284 VPHAL_MEMORY_OBJECT_CONTROL WeitCoefSurfaceMemObjCtl;
285 VPHAL_MEMORY_OBJECT_CONTROL GlobalToneMappingCurveLUTSurfaceMemObjCtl;
286 } VPHAL_LACE_CACHE_CNTL, *PVPHAL_LACE_CACHE_CNTL;
287
288 typedef struct _VPHAL_16_ALIGN_CACHE_CNTL
289 {
290 bool bL3CachingEnabled;
291 VPHAL_MEMORY_OBJECT_CONTROL SourceSurfMemObjCtl;
292 VPHAL_MEMORY_OBJECT_CONTROL TargetSurfMemObjCtl;
293 VPHAL_MEMORY_OBJECT_CONTROL SamplerParamsSurfMemObjCtl;
294 VPHAL_MEMORY_OBJECT_CONTROL SamplerParamsStatsSurfMemObjCtl;
295 } VPHAL_16_ALIGN_CACHE_CNTL, *PVPHAL_16_ALIGN_CACHE_CNTL;
296
297 typedef struct _VPHAL_FAST1TON_CACHE_CNTL
298 {
299 bool bL3CachingEnabled;
300 VPHAL_MEMORY_OBJECT_CONTROL SourceSurfMemObjCtl;
301 VPHAL_MEMORY_OBJECT_CONTROL TargetSurfMemObjCtl;
302 VPHAL_MEMORY_OBJECT_CONTROL SamplerParamsSurfMemObjCtl;
303 VPHAL_MEMORY_OBJECT_CONTROL SamplerParamsStatsSurfMemObjCtl;
304 } VPHAL_FAST1TON_CACHE_CNTL, *PVPHAL_FAST1TON_CACHE_CNTL;
305
306 typedef struct _VPHAL_HDR_CACHE_CNTL
307 {
308 bool bL3CachingEnabled;
309 VPHAL_MEMORY_OBJECT_CONTROL SourceSurfMemObjCtl;
310 VPHAL_MEMORY_OBJECT_CONTROL TargetSurfMemObjCtl;
311 VPHAL_MEMORY_OBJECT_CONTROL Lut2DSurfMemObjCtl;
312 VPHAL_MEMORY_OBJECT_CONTROL Lut3DSurfMemObjCtl;
313 VPHAL_MEMORY_OBJECT_CONTROL CoeffSurfMemObjCtl;
314 } VPHAL_HDR_CACHE_CNTL, *PVPHAL_HDR_CACHE_CNTL;
315
316 //!
317 //! \brief Feature specific cache control settings
318 //!
319 typedef struct _VPHAL_RENDER_CACHE_CNTL
320 {
321 // Input
322 bool bDnDi;
323 bool bCompositing;
324 bool bLace;
325
326 // Output
327 VPHAL_DNDI_CACHE_CNTL DnDi;
328 VPHAL_COMPOSITE_CACHE_CNTL Composite;
329 VPHAL_LACE_CACHE_CNTL Lace;
330 } VPHAL_RENDER_CACHE_CNTL, *PVPHAL_RENDER_CACHE_CNTL;
331
332 //!
333 //! \brief Vphal Palette Type Mode enum
334 //!
335 typedef enum _VPHAL_PALETTE_TYPE
336 {
337 VPHAL_PALETTE_NONE = 0,
338 VPHAL_PALETTE_YCbCr_8, //!< 8-bit depth - AYUV palette
339 VPHAL_PALETTE_ARGB_8, //!< 8-bit depth - ARGB palette
340 VPHAL_PALETTE_AVYU_8 //!< 8-bit depth - YUY2 palette
341 } VPHAL_PALETTE_TYPE;
342
343 //!
344 //! \brief Vphal Chroma Siting enum
345 //!
346 typedef enum _VPHAL_CHROMA_SITING
347 {
348 CHROMA_SITING_NONE = 0,
349 CHROMA_SITING_HORZ_LEFT = 1 << 0,
350 CHROMA_SITING_HORZ_CENTER = 1 << 1,
351 CHROMA_SITING_HORZ_RIGHT = 1 << 2,
352 CHROMA_SITING_VERT_TOP = 1 << 4,
353 CHROMA_SITING_VERT_CENTER = 1 << 5,
354 CHROMA_SITING_VERT_BOTTOM = 1 << 6,
355 } VPHAL_CHROMA_SITING;
356
357 //!
358 //! \brief Vphal Rotation Mode enum
359 //!
360 typedef enum _VPHAL_ROTATION
361 {
362 VPHAL_ROTATION_IDENTITY = ROTATION_IDENTITY, //!< Rotation 0 degrees
363 VPHAL_ROTATION_90 = ROTATION_90, //!< Rotation 90 degrees
364 VPHAL_ROTATION_180 = ROTATION_180, //!< Rotation 180 degrees
365 VPHAL_ROTATION_270 = ROTATION_270, //!< Rotation 270 degrees
366 VPHAL_MIRROR_HORIZONTAL = ROTATION_MIRROR_HORIZONTAL, //!< Horizontal Mirror
367 VPHAL_MIRROR_VERTICAL = ROTATION_MIRROR_VERTICAL, //!< Vertical Mirror
368 VPHAL_ROTATE_90_MIRROR_VERTICAL = ROTATION_90_MIRROR_VERTICAL, //!< 90 + V Mirror
369 VPHAL_ROTATE_90_MIRROR_HORIZONTAL = ROTATION_90_MIRROR_HORIZONTAL //!< 90 + H Mirror
370 } VPHAL_ROTATION;
371
372 //!
373 //! \brief Color Spaces enum
374 //!
375 typedef MEDIA_CSPACE VPHAL_CSPACE;
376
377 //!
378 //! \brief Surface types enum
379 //! IMPORTANT : SurfaceType_Layer[] must be updated to match this enum type
380 //!
381 typedef enum _VPHAL_SURFACE_TYPE
382 {
383 SURF_NONE = 0,
384 SURF_IN_BACKGROUND,
385 SURF_IN_PRIMARY,
386 SURF_IN_SUBSTREAM,
387 SURF_IN_REFERENCE,
388 SURF_OUT_RENDERTARGET,
389 SURF_TYPE_COUNT //!< Keep this line at the end
390 } VPHAL_SURFACE_TYPE;
391 C_ASSERT(SURF_TYPE_COUNT == 6); //!< When adding, update assert & vphal_solo_scenario.cpp
392
393 //!
394 //! Structure VPHAL_GAMMA_TYPE
395 //! \brief GAMMA Function type
396 //!
397 typedef enum _VPHAL_GAMMA_TYPE
398 {
399 VPHAL_GAMMA_NONE = 0,
400 VPHAL_GAMMA_TRADITIONAL_GAMMA,
401 VPHAL_GAMMA_SMPTE_ST2084,
402 VPHAL_GAMMA_BT1886,
403 VPHAL_GAMMA_SRGB,
404 VPHAL_GAMMA_Count
405 } VPHAL_GAMMA_TYPE;
406 C_ASSERT(VPHAL_GAMMA_Count == 5); //!< When adding, update assert
407
408 //!
409 //! \def IS_COLOR_SPACE_BT2020_YUV(_a)
410 //! Check if the color space is BT2020 YUV
411 //!
412 #define IS_COLOR_SPACE_BT2020_YUV(_a) (_a == CSpace_BT2020 || \
413 _a == CSpace_BT2020_FullRange)
414
415 //!
416 //! \def IS_COLOR_SPACE_BT2020_RGB(_a)
417 //! Check if the color space is BT2020 RGB
418 //!
419 #define IS_COLOR_SPACE_BT2020_RGB(_a) (_a == CSpace_BT2020_RGB || \
420 _a == CSpace_BT2020_stRGB)
421
422 #define IS_COLOR_SPACE_BT709_RGB(_a) (_a == CSpace_sRGB || \
423 _a == CSpace_stRGB)
424
425 //!
426 //! \def IS_COLOR_SPACE_BT2020(_a)
427 //! Check if the color space is BT2020
428 //!
429 #define IS_COLOR_SPACE_BT2020(_a) (IS_COLOR_SPACE_BT2020_YUV(_a) || \
430 IS_COLOR_SPACE_BT2020_RGB(_a))
431
432 //!
433 //! \def IS_COLOR_SPACE_RGB(_a)
434 //! Check if the color space is RGB
435 //!
436 #define IS_COLOR_SPACE_RGB(_a) (IS_COLOR_SPACE_BT2020_RGB(_a) || \
437 IS_COLOR_SPACE_BT709_RGB(_a))
438 //!
439 //! \brief Sample Type enum
440 //!
441 typedef enum _VPHAL_SAMPLE_TYPE
442 {
443 SAMPLE_PROGRESSIVE,
444 SAMPLE_SINGLE_TOP_FIELD,
445 SAMPLE_SINGLE_BOTTOM_FIELD,
446 SAMPLE_INTERLEAVED_EVEN_FIRST_TOP_FIELD,
447 SAMPLE_INTERLEAVED_EVEN_FIRST_BOTTOM_FIELD,
448 SAMPLE_INTERLEAVED_ODD_FIRST_TOP_FIELD,
449 SAMPLE_INTERLEAVED_ODD_FIRST_BOTTOM_FIELD,
450 SAMPLE_INVALID
451 } VPHAL_SAMPLE_TYPE;
452 C_ASSERT(SAMPLE_INVALID == 7); //!< When adding, update assert & vphal_solo_scenario.cpp
453
454 //!
455 //! \brief Frame Format enum
456 //!
457 typedef enum _VPHAL_FRAME_FORMAT
458 {
459 FRAME_FORMAT_PROGRESSIVE,
460 FRAME_FORMAT_INTERLEAVED,
461 FRAME_FORMAT_FIELD
462 } VPHAL_FRAME_FORMAT;
463
464 //!
465 //! \brief Interlaced Scaling Mode enum
466 //!
467 typedef enum _VPHAL_ISCALING_TYPE
468 {
469 ISCALING_NONE,
470 ISCALING_INTERLEAVED_TO_INTERLEAVED,
471 ISCALING_INTERLEAVED_TO_FIELD,
472 ISCALING_FIELD_TO_INTERLEAVED,
473 ISCALING_FIELD_TO_FIELD
474 } VPHAL_ISCALING_TYPE;
475 C_ASSERT(ISCALING_FIELD_TO_FIELD == 4);
476
477 //!
478 //! \ brief HVS DN Mode enum
479 //!
480 typedef enum _VPHAL_HVSDN_MODE
481 {
482 HVSDENOISE_AUTO_BDRATE = 0,
483 HVSDENOISE_AUTO_SUBJECTIVE,
484 HVSDENOISE_MANUAL
485 } VPHAL_HVSDN_MODE;
486
487 //!
488 //! \brief DI Mode enum
489 //!
490 typedef enum _VPHAL_DI_MODE
491 {
492 DI_MODE_BOB,
493 DI_MODE_ADI
494 } VPHAL_DI_MODE;
495 C_ASSERT(DI_MODE_ADI == 1); //!< When adding, update assert & vphal_solo_scenario.cpp
496
497 //!
498 //! \brief Blend Type enum
499 //!
500 typedef enum _VPHAL_BLEND_TYPE
501 {
502 BLEND_NONE = 0,
503 BLEND_SOURCE,
504 BLEND_PARTIAL,
505 BLEND_CONSTANT,
506 BLEND_CONSTANT_SOURCE,
507 BLEND_CONSTANT_PARTIAL,
508 BLEND_XOR_MONO
509 } VPHAL_BLEND_TYPE;
510 C_ASSERT(BLEND_CONSTANT == 3); //!< When adding, update assert & vphal_solo_scenario.cpp
511
512 //!
513 //! \brief Scaling Mode enum
514 //!
515 typedef enum _VPHAL_SCALING_MODE
516 {
517 VPHAL_SCALING_NEAREST = 0,
518 VPHAL_SCALING_BILINEAR,
519 VPHAL_SCALING_AVS,
520 VPHAL_SCALING_ADV_QUALITY // !< Advance Perf mode
521 } VPHAL_SCALING_MODE;
522 C_ASSERT(VPHAL_SCALING_ADV_QUALITY == 3); //!< When adding, update assert & vphal_solo_scenario.cpp
523
524 //!
525 //! \brief Composition Report Mode enum
526 //!
527 typedef enum _VPHAL_COMPOSITION_REPORT_MODE
528 {
529 VPHAL_NO_COMPOSITION, //!< No composition , Error Reporting cases
530 VPHAL_INPLACE_COMPOSITION, //!< Inplace Composition
531 VPHAL_LEGACY_COMPOSITION //!< Legacy Composition
532 } VPHAL_COMPOSITION_REPORT_MODE;
533
534 typedef enum _VPHAL_DI_REPORT_MODE
535 {
536 VPHAL_DI_REPORT_PROGRESSIVE, //!< Progressive output
537 VPHAL_DI_REPORT_BOB, //!< True BOB output
538 VPHAL_DI_REPORT_ADI_BOB, //!< DNDI BOB output
539 VPHAL_DI_REPORT_ADI, //!< ADI output
540 VPHAL_DI_REPORT_FMD //!< FMD output
541 } VPHAL_DI_REPORT_MODE;
542
543 //!
544 //! \brief Colorpack enum
545 //!
546 typedef enum _VPHAL_COLORPACK
547 {
548 VPHAL_COLORPACK_400 = 0,
549 VPHAL_COLORPACK_420,
550 VPHAL_COLORPACK_411,
551 VPHAL_COLORPACK_422,
552 VPHAL_COLORPACK_444,
553 VPHAL_COLORPACK_UNKNOWN
554 } VPHAL_COLORPACK,
555 *PVPHAL_COLORPACK;
556
557 //!
558 //! \brief VEBOX 3DLut interpolation mode
559 //!
560 typedef enum _VPHAL_3DLUT_INTERPOLATION
561 {
562 VPHAL_3DLUT_INTERPOLATION_DEFAULT = 0, //!< Default 3DLUT interpolation method.
563 VPHAL_3DLUT_INTERPOLATION_TRILINEAR = 1, //!< 3DLUT trilinear interpolation method.
564 VPHAL_3DLUT_INTERPOLATION_TETRAHEDRAL = 2 //!< 3DLUT tetrahedral interpolation method.
565 } VPHAL_3DLUT_INTERPOLATION;
566
567 //!
568 //! \brief Output Pipe Mode enum
569 //! \details The output pipe that writes the RenderTarget surface
570 //!
571 typedef enum _VPHAL_OUTPUT_PIPE_MODE
572 {
573 VPHAL_OUTPUT_PIPE_MODE_INVALID = -1, //!< None output pipe selected. This is an invalid state
574 VPHAL_OUTPUT_PIPE_MODE_COMP = 0, //!< Composition output pipe. RenderTarget will be written by Composition
575 VPHAL_OUTPUT_PIPE_MODE_SFC = 1, //!< SFC output pipe. RenderTarget will be written by SFC
576 VPHAL_OUTPUT_PIPE_MODE_VEBOX = 2, //!< Vebox output pipe. RenderTarget will be written by Vebox
577 VPHAL_OUTPUT_PIPE_MODE_NPU = 3
578 } VPHAL_OUTPUT_PIPE_MODE,
579 *PVPHAL_OUTPUT_PIPE_MODE;
580
581 typedef enum _VPHAL_SCALING_PREFERENCE
582 {
583 VPHAL_SCALING_PREFER_SFC = 0, // SFC is default
584 VPHAL_SCALING_PREFER_COMP, // For Gen9/10, Composition AVS get better quality than SFC AVS
585 VPHAL_SCALING_PREFER_SFC_FOR_VEBOX // if VEBOX is required, use VEBOX + SFC, otherwise use Composistion
586 } VPHAL_SCALING_PREFERENCE;
587 C_ASSERT(VPHAL_SCALING_PREFER_SFC_FOR_VEBOX == 2); //!< When adding, update assert & vphal_solo_scenario.cpp
588
589 //!
590 //! \brief Gamut Mode enum
591 //!
592 typedef enum _VPHAL_GAMUT_MODE
593 {
594 GAMUT_MODE_NONE,
595 GAMUT_MODE_BASIC,
596 GAMUT_MODE_ADVANCED
597 } VPHAL_GAMUT_MODE;
598 C_ASSERT(GAMUT_MODE_ADVANCED == 2); //!< When adding, update assert & vphal_solo_scenario.cpp
599
600 //-----------------------------------------------------------------------------
601 // Forward declaration -
602 // IMPORTANT - DDI interfaces are NOT to access internal VPHAL states
603 //-----------------------------------------------------------------------------
604 typedef struct _RENDERHAL_INTERFACE *PRENDERHAL_INTERFACE;
605 typedef class MhwVeboxInterface *PMHW_VEBOX_INTERFACE;
606 typedef class MhwSfcInterface *PMHW_SFC_INTERFACE;
607 typedef struct VPHAL_SURFACE *PVPHAL_SURFACE;
608
609 class VphalRenderer;
610
611 class MhwCpInterface;
612
613 //!
614 //! Union VPHAL_COLOR_SAMPLE_8
615 //! \brief Vphal Color Sample 8 bit
616 //!
617 typedef union _VPHAL_COLOR_SAMPLE_8
618 {
619 // ARGB
620 struct
621 {
622 uint8_t B;
623 uint8_t G;
624 uint8_t R;
625 uint8_t A;
626 };
627
628 // AVYU (YUY2 samples)
629 struct
630 {
631 uint8_t U;
632 uint8_t Y;
633 uint8_t V;
634 uint8_t a;
635 };
636
637 // AYCbCr (NV12 samples)
638 struct
639 {
640 uint8_t Cr; //!< V
641 uint8_t Cb; //!< U
642 uint8_t YY; //!< Y
643 uint8_t Alpha;
644 };
645
646 uint32_t dwValue;
647 } VPHAL_COLOR_SAMPLE_8, *PVPHAL_COLOR_SAMPLE_8;
648
649 //!
650 //! Union VPHAL_COLOR_SAMPLE_16
651 //! \brief Vphal Color Sample 16 bit
652 //!
653 typedef union _VPHAL_COLOR_SAMPLE_16
654 {
655 // ARGB
656 struct
657 {
658 int16_t B;
659 int16_t G;
660 int16_t R;
661 int16_t A;
662 };
663
664 // AVYU
665 struct
666 {
667 int16_t U;
668 int16_t Y;
669 int16_t V;
670 int16_t a;
671 };
672
673 // AYCbCr
674 struct
675 {
676 int16_t Cr; //!< V
677 int16_t Cb; //!< U
678 int16_t YY; //!< Y
679 int16_t Alpha;
680 };
681
682 uint32_t Value;
683 } VPHAL_COLOR_SAMPLE_16, *PVPHAL_COLOR_SAMPLE_16;
684
685 //!
686 //! Structure VPHAL_PLANE_OFFSET
687 //! \brief Vphal Plane OffSet
688 //!
689 typedef struct _VPHAL_PLANE_OFFSET
690 {
691 int iLockSurfaceOffset; //!< Locked surface offset
692 int iSurfaceOffset; //!< Plane surface offset
693 int iXOffset; //!< X offset - horizontal offset in pixels
694 int iYOffset; //!< Y offset - vertical offset in pixels
695 } VPHAL_PLANE_OFFSET, *PVPHAL_PLANE_OFFSET;
696
697 //!
698 //! Union VPHAL_HALF_PRECISION_FLOAT
699 //! \brief Vphal half precision float type
700 //!
701 typedef union _VPHAL_HALF_PRECISION_FLOAT
702 {
703 struct
704 {
705 uint16_t Mantissa : 10;
706 uint16_t Exponent : 5;
707 uint16_t Sign : 1;
708 };
709
710 uint16_t value;
711 } VPHAL_HALF_PRECISION_FLOAT, PVPHAL_HALF_PRECISION_FLOAT;
712
713 //!
714 //! Structure VPHAL_PALETTE
715 //! \brief Vphal Palette
716 //! \details Palette entries:
717 //! - 0 : empty palette
718 //! - -1 : palette allocated but not loaded
719 //! - >0 : palette in use
720 //!
721 typedef struct _VPHAL_PALETTE
722 {
723 VPHAL_PALETTE_TYPE PaletteType; //!< Type of palette
724 VPHAL_CSPACE ColorSpace; //!< ColorSpace of Palette
725 bool bHasAlpha; //!< Alpha is valid
726 int32_t iTotalEntries; //!< Palette entries allocated
727 int32_t iNumEntries; //!< Palette entries in use
728 union
729 {
730 PVPHAL_COLOR_SAMPLE_8 pPalette8;
731 PVPHAL_COLOR_SAMPLE_16 pPalette16;
732 };
733 } VPHAL_PALETTE, *PVPHAL_PALETTE;
734
735 //!
736 //! Structure VPHAL_BLENDING_PARAMS
737 //! \brief Layer Blending parameters
738 //!
739 typedef struct _VPHAL_BLENDING_PARAMS
740 {
741 VPHAL_BLEND_TYPE BlendType = BLEND_NONE;
742 float fAlpha = 0.0;
743 } VPHAL_BLENDING_PARAMS, *PVPHAL_BLENDING_PARAMS;
744
745 //!
746 //! Structure VPHAL_LUMAKEY_PARAMS
747 //! \brief Luma Keying parameters
748 //!
749 typedef struct _VPHAL_LUMAKEY_PARAMS
750 {
751 int16_t LumaLow = 0;
752 int16_t LumaHigh = 0;
753 } VPHAL_LUMAKEY_PARAMS, *PVPHAL_LUMAKEY_PARAMS;
754
755 //!
756 //! Structure VPHAL_PROCAMP_PARAMS
757 //! \brief Procamp parameters
758 //!
759 typedef struct _VPHAL_PROCAMP_PARAMS
760 {
761 bool bEnabled = false;
762 float fBrightness = 0.0;
763 float fContrast = 0.0;
764 float fHue = 0.0;
765 float fSaturation = 0.0;
766 } VPHAL_PROCAMP_PARAMS, *PVPHAL_PROCAMP_PARAMS;
767
768 //!
769 //! Structure VPHAL_IEF_PARAMS
770 //! \brief IEF parameters - Image Enhancement (Detail) Filter
771 //!
772 typedef struct _VPHAL_IEF_PARAMS
773 {
774 bool bEnabled = false;
775 bool bSmoothMode = false;
776 bool bSkintoneTuned = false;
777 bool bEmphasizeSkinDetail = false;
778 float fIEFFactor = 0.0;
779 uint16_t StrongEdgeWeight = 0;
780 uint16_t RegularWeight = 0;
781 uint16_t StrongEdgeThreshold = 0;
782 void *pExtParam = nullptr;
783 } VPHAL_IEF_PARAMS, *PVPHAL_IEF_PARAMS;
784
785 //!
786 //! Structure VPHAL_DI_PARAMS
787 //! \brief Deinterlacing parameters
788 //!
789 typedef struct _VPHAL_DI_PARAMS
790 {
791 VPHAL_DI_MODE DIMode = DI_MODE_BOB; //!< DeInterlacing mode
792 bool bEnableFMD = false; //!< FMD
793 bool bSingleField = false; //!< Used in frame Recon - if 30fps (one call per sample pair)
794 bool bSCDEnable = false; //!< Scene change detection
795 } VPHAL_DI_PARAMS, *PVPHAL_DI_PARAMS;
796
797 //!
798 //! \brief Noise Level Enumeration
799 //!
800 typedef enum _VPHAL_NOISELEVEL
801 {
802 NOISELEVEL_DEFAULT,
803 NOISELEVEL_VC1_HD
804 } VPHAL_NOISELEVEL;
805 C_ASSERT(NOISELEVEL_VC1_HD == 1); //!< When adding, update assert & vphal_solo_scenario.cpp
806
807 //!
808 //! Structure VPHAL_HVSDENOISE_PARAMS
809 //! \brief HVS Denoise Parameters - Human Vision System Based Denoise
810 //!
811 typedef struct _VPHAL_HVSDENOISE_PARAMS
812 {
813 uint16_t QP = 0;
814 uint16_t Strength = 0;
815 VPHAL_HVSDN_MODE Mode = HVSDENOISE_AUTO_BDRATE;
816 void *pHVSDenoiseParam = nullptr;
817 uint32_t dwDenoiseParamSize = 0;
818 uint32_t dwGlobalNoiseLevel = 0; //!< Global Noise Level for Y
819 uint32_t dwGlobalNoiseLevelU = 0; //!< Global Noise Level for U
820 uint32_t dwGlobalNoiseLevelV = 0; //!< Global Noise Level for V
821 uint16_t TgneEnable = 0;
822 uint16_t FirstFrame = 0;
823 uint16_t TgneFirstFrame = 0;
824 uint16_t Fallback = 0;
825 uint16_t EnableChroma = 0;
826 uint16_t EnableTemporalGNE = 0;
827 uint16_t RCMethod = 0;
828 uint16_t TgtKbps = 0;
829 uint16_t Width = 0;
830 uint16_t Height = 0;
831 uint32_t Sgne_Level = 0;
832 uint32_t Sgne_LevelU = 0;
833 uint32_t Sgne_LevelV = 0;
834 uint32_t Sgne_Count = 0;
835 uint32_t Sgne_CountU = 0;
836 uint32_t Sgne_CountV = 0;
837 uint32_t PrevNslvTemporal = 0;
838 uint32_t PrevNslvTemporalU = 0;
839 uint32_t PrevNslvTemporalV = 0;
840 } VPHAL_HVSDENOISE_PARAMS, *PVPHAL_HVSDENOISE_PARAMS;
841
842 //!
843 //! Structure VPHAL_SLIMIPU_DENOISE_PARAM
844 //! \brief SLIMIPU Denoise Parameters
845 //!
846 typedef struct _VPHAL_SLIMIPU_DENOISE_PARAM
847 {
848 uint32_t MemSizeInBytes;
849 void *pSystemMem;
850 } VPHAL_SLIMIPU_DENOISE_PARAM, *PVPHAL_SLIMIPU_DENOISE_PARAM;
851
852 //!
853 //! Structure VPHAL_DENOISE_PARAMS
854 //! \brief Denoise parameters
855 //!
856 typedef struct _VPHAL_DENOISE_PARAMS
857 {
858 bool bEnableChroma = false;
859 bool bEnableLuma = false;
860 bool bAutoDetect = false;
861 float fDenoiseFactor = 0.0;
862 VPHAL_NOISELEVEL NoiseLevel = NOISELEVEL_DEFAULT;
863 bool bEnableHVSDenoise = false;
864 VPHAL_HVSDENOISE_PARAMS HVSDenoise = {};
865 bool bEnableSlimIPUDenoise = false;
866 VPHAL_SLIMIPU_DENOISE_PARAM SlimIPUDenoise = {};
867 bool operator==(const struct _VPHAL_DENOISE_PARAMS &b)
868 {
869 return bEnableChroma == b.bEnableChroma &&
870 bEnableLuma == b.bEnableLuma &&
871 bAutoDetect == b.bAutoDetect &&
872 bEnableHVSDenoise == false &&
873 b.bEnableHVSDenoise == false &&
874 bEnableSlimIPUDenoise == false &&
875 b.bEnableSlimIPUDenoise == false;
876 }
877 } VPHAL_DENOISE_PARAMS, *PVPHAL_DENOISE_PARAMS;
878
879 //!
880 //! Structure VPHAL_STE_PARAMS
881 //! \brief STE parameters - Skin Tone Enhancement
882 //!
883 typedef struct _VPHAL_STE_PARAMS
884 {
885 uint32_t dwSTEFactor = 0;
886 } VPHAL_STE_PARAMS, *PVPHAL_STE_PARAMS;
887
888 //!
889 //! Structure VPHAL_STE_PARAMS
890 //! \brief STE parameters - Skin Tone Enhancement
891 //!
892 typedef struct _VPHAL_STD_PARAMS
893 {
894 uint32_t paraSizeInBytes = 0;
895 void *param = nullptr;
896 unsigned long long sysMem = 0;
897 bool bOutputSkinScore = false;
898 } VPHAL_STD_PARAMS, *PVPHAL_STD_PARAMS;
899
900 //!
901 //! Structure VPHAL_TCC_PARAMS
902 //! \brief TCC parameters - Total Color Control
903 //!
904 typedef struct _VPHAL_TCC_PARAMS
905 {
906 uint8_t Red = 0;
907 uint8_t Green = 0;
908 uint8_t Blue = 0;
909 uint8_t Cyan = 0;
910 uint8_t Magenta = 0;
911 uint8_t Yellow = 0;
912 } VPHAL_TCC_PARAMS, *PVPHAL_TCC_PARAMS;
913
914 //!
915 //! Structure VPHAL_COLORPIPE_PARAMS
916 //! \brief IECP Parameters - Color Pipe
917 //!
918 typedef struct _VPHAL_COLORPIPE_PARAMS
919 {
920 bool bEnableACE = false;
921 bool bEnableSTE = false;
922 bool bEnableSTD = false; // Is vebox STD alone enabled
923 bool bEnableTCC = false;
924 bool bAceLevelChanged = false;
925 uint32_t dwAceLevel = 0;
926 uint32_t dwAceStrength = 0;
927 VPHAL_STE_PARAMS SteParams = {};
928 VPHAL_STD_PARAMS StdParams = {};
929 VPHAL_TCC_PARAMS TccParams = {};
930 } VPHAL_COLORPIPE_PARAMS, *PVPHAL_COLORPIPE_PARAMS;
931
932 //!
933 //! Structure VPHAL_3DLUT_PARAMS
934 //! \brief 3DLUT parameters - 3DLUT
935 //!
936 typedef struct _VPHAL_3DLUT_PARAMS
937 {
938 PVPHAL_SURFACE pExt3DLutSurface = nullptr; // Pointer to the 3DLUT surface which app passes to driver.
939 uint32_t LutSize = 0; // Size of 3DLUT, i.e, how many entries LUT has.
940 uint32_t ChannelMapping = 0; // Channel Mapping for the 3DLUT input to 3DLUT output.
941 uint16_t BitDepthPerChannel = 0; // Bit Depth Per Channel(4 channels for 3DLUT).
942 uint16_t ByteCountPerEntry = 0; // Byte Count Per Entry including reserved bytes.
943 uint16_t MappingMode = 0; // Mapping Mode
944
945 VPHAL_3DLUT_INTERPOLATION InterpolationMethod = VPHAL_3DLUT_INTERPOLATION_DEFAULT; // VEBox 3DLut interpolation mode
946 } VPHAL_3DLUT_PARAMS, *PVPHAL_3DLUT_PARAMS;
947
948 //!
949 //! Structure VPHAL_GAMUT_PARAMS
950 //! \brief IECP Gamut Mapping Parameters
951 //!
952 typedef struct _VPHAL_GAMUT_PARAMS
953 {
954 VPHAL_GAMUT_MODE GCompMode;
955 VPHAL_GAMUT_MODE GExpMode;
956 VPHAL_GAMMA_VALUE GammaValue;
957 uint32_t dwAttenuation; //!< U2.10 [0, 1024] 0 = No down scaling, 1024 = Full down scaling
958 float displayRGBW_x[4];
959 float displayRGBW_y[4];
960 bool bColorBalance;
961 int32_t colorBalanceMatrix[3][3];
962 } VPHAL_GAMUT_PARAMS, *PVPHAL_GAMUT_PARAMS;
963
964 //!
965 //! Structure VPHAL_NLAS_PARAMS
966 //! \brief NLAS parameters - Non-Anamorphic Scaling
967 //!
968 typedef struct _VPHAL_NLAS_PARAMS
969 {
970 float fVerticalCrop;
971 float fHLinearRegion;
972 float fNonLinearCrop;
973 } VPHAL_NLAS_PARAMS, *PVPHAL_NLAS_PARAMS;
974
975 typedef struct _VPHAL_VIDEO_COLOR_RGBA
976 {
977 float R;
978 float G;
979 float B;
980 float A;
981 } VPHAL_VIDEO_COLOR_RGBA;
982
983 //!
984 //! Structure VPHAL_COLORFILL_PARAMS
985 //! \brief ColorFill parameters
986 //!
987 typedef struct _VPHAL_COLORFILL_PARAMS
988 {
989 bool bYCbCr = false;
990 bool isFloat = false;
991 uint32_t Color = 0;
992 float ColorFloat[4] = {0.0f};
993 VPHAL_VIDEO_COLOR_RGBA Color1 = {};
994 VPHAL_CSPACE CSpace = CSpace_None;
995 bool bDisableColorfillinSFC = false;
996 bool bOnePixelBiasinSFC = false;
997 } VPHAL_COLORFILL_PARAMS, *PVPHAL_COLORFILL_PARAMS;
998
999 //!
1000 //! Structure VPHAL_ALPHA_FILL_MODE
1001 //! \brief Alpha mode
1002 //!
1003 typedef enum _VPHAL_ALPHA_FILL_MODE
1004 {
1005 VPHAL_ALPHA_FILL_MODE_NONE = 0,
1006 VPHAL_ALPHA_FILL_MODE_OPAQUE,
1007 VPHAL_ALPHA_FILL_MODE_BACKGROUND,
1008 VPHAL_ALPHA_FILL_MODE_SOURCE_STREAM,
1009 } VPHAL_ALPHA_FILL_MODE;
1010
1011 //!
1012 //! Structure VPHAL_ALPHA_PARAMS
1013 //! \brief Alpha parameters
1014 //!
1015 typedef struct _VPHAL_ALPHA_PARAMS
1016 {
1017 float fAlpha;
1018 VPHAL_ALPHA_FILL_MODE AlphaMode;
1019 } VPHAL_ALPHA_PARAMS, *PVPHAL_ALPHA_PARAMS;
1020
1021 //!
1022 //! Structure VPHAL_SPLIT_SCREEN_DEMO_POSITION
1023 //! \brief Split-Screen Demo Mode Position
1024 //!
1025 typedef enum _VPHAL_SPLIT_SCREEN_DEMO_POSITION
1026 {
1027 SPLIT_SCREEN_DEMO_DISABLED = 0,
1028 SPLIT_SCREEN_DEMO_LEFT,
1029 SPLIT_SCREEN_DEMO_RIGHT,
1030 SPLIT_SCREEN_DEMO_TOP,
1031 SPLIT_SCREEN_DEMO_BOTTOM,
1032 SPLIT_SCREEN_DEMO_END_POS_LIST
1033 } VPHAL_SPLIT_SCREEN_DEMO_POSITION;
1034
1035 //!
1036 //! Structure VPHAL_RENDER_COMMAND_STREAM_TYPE
1037 //! \brief RCS or CCS
1038 //!
1039 typedef enum _VPHAL_RENDER_COMMAND_STREAM_TYPE
1040 {
1041 VPHAL_RENDER_COMMAND_STREAM_DEFAULT = 0,
1042 VPHAL_RENDER_COMMAND_STREAM_CCS = 1,
1043 VPHAL_RENDER_COMMAND_STREAM_RCS = 2
1044
1045 } VPHAL_RENDER_COMMAND_STREAM_TYPE;
1046
1047 //!
1048 //! Structure VPHAL_SPLIT_SCREEN_DEMO_MODE_PARAMS
1049 //! \brief Split-Screen Demo Mode Parameters
1050 //!
1051 typedef struct _VPHAL_SPLIT_SCREEN_DEMO_MODE_PARAMS
1052 {
1053 VPHAL_SPLIT_SCREEN_DEMO_POSITION Position; //!< Position of split mode area (disable features)
1054 bool bDisableACE : 1; //!< Disable ACE
1055 bool bDisableAVS : 1; //!< Disable AVS
1056 bool bDisableDN : 1; //!< Disable DN
1057 bool bDisableFMD : 1; //!< Disable FMD
1058 bool bDisableIEF : 1; //!< Disable IEF
1059 bool bDisableProcamp : 1; //!< Disable Procamp
1060 bool bDisableSTE : 1; //!< Disable STE
1061 bool bDisableTCC : 1; //!< Disable TCC
1062 bool bDisableIS : 1; //!< Disable IS
1063 bool bDisableDrDb : 1; //!< Disable DRDB
1064 bool bDisableDNUV : 1; //!< Disable DNUV
1065 bool bDisableFRC : 1; //!< Disable FRC
1066 bool bDisableLACE : 1; //!< Disable LACE
1067 } VPHAL_SPLIT_SCREEN_DEMO_MODE_PARAMS, *PVPHAL_SPLIT_SCREEN_DEMO_MODE_PARAMS;
1068
1069 //!
1070 //! Structure VPHAL_RENDER_PARAMS
1071 //! \brief VPHAL Rendering Parameters
1072 //!
1073 struct VPHAL_RENDER_PARAMS
1074 {
1075 // Input/output surfaces
1076 uint32_t uSrcCount = 0; //!< Num sources
1077 VPHAL_SURFACE *pSrc[VPHAL_MAX_SOURCES] = {}; //!< Source Samples
1078 uint32_t uDstCount = 0; //!< Num Targets
1079 VPHAL_SURFACE *pTarget[VPHAL_MAX_TARGETS] = {}; //!< Render Target
1080
1081 // Additional parameters not included in PVPHAL_SURFACE
1082 PRECT pConstriction = nullptr; //!< Constriction rectangle
1083 PVPHAL_COLORFILL_PARAMS pColorFillParams = nullptr; //!< ColorFill - BG only
1084 bool bTurboMode = false; //!< Enable Media Turbo Mode
1085 bool bStereoMode = false; //!< Stereo BLT mode
1086 PVPHAL_ALPHA_PARAMS pCompAlpha = nullptr; //!< Alpha for composited surfaces
1087 bool bDisableDemoMode = false; //!< Enable/Disable demo mode function calls
1088 PVPHAL_SPLIT_SCREEN_DEMO_MODE_PARAMS pSplitScreenDemoModeParams = nullptr; //!< Split-screen demo mode for VP features
1089 bool bIsDefaultStream = false; //!< Identifier to differentiate default stream
1090
1091 // Debugging parameters
1092 MOS_COMPONENT Component = COMPONENT_UNKNOWN; //!< DDI component (for DEBUGGING only)
1093
1094 // Status Report
1095 bool bReportStatus = false; //!< Report current media BB status (Pre-Processing)
1096 uint32_t StatusFeedBackID = 0; //!< Unique Staus ID;
1097 #if (_DEBUG || _RELEASE_INTERNAL)
1098 bool bTriggerGPUHang = false; //!< Trigger GPU HANG
1099 #endif
1100
1101 bool bCalculatingAlpha = false; //!< Alpha calculation parameters
1102
1103 // extension parameters
1104 void *pExtensionData = nullptr; //!< Extension data
1105
1106 bool bPathKernel = false; // HDR path config if use kernel
1107 bool bAPGWorkloadEnable = false; //!< Identify Whether APG workload Enabled or not
1108
1109 bool bDisableVeboxFor8K = false;
1110 bool bUseVEHdrSfc = false; // use SFC for to perform CSC/Scaling/RGBSwap of HDR streaming; if false, use composite render.
1111 bool bNonFirstFrame = false; // first frame or not: first frame false, otherwise true considering zeromemory parameters.
1112 bool bOptimizeCpuTiming = false; //!< Optimize Cpu Timing
1113
1114 bool bForceToRender = false; // Force to render to perform scaling.
1115 VPHAL_RENDER_COMMAND_STREAM_TYPE renderCommandStreamType = VPHAL_RENDER_COMMAND_STREAM_DEFAULT; // CCS or RCS to Use
1116
1117 HANDLE gpuAppTaskEvent; //!< GPU App task event
1118
1119 VPHAL_RENDER_PARAMS() : uSrcCount(0),
1120 pSrc(),
1121 uDstCount(0),
1122 pTarget(),
1123 pConstriction(nullptr),
1124 pColorFillParams(nullptr),
1125 bTurboMode(false),
1126 bStereoMode(false),
1127 pCompAlpha(nullptr),
1128 bDisableDemoMode(false),
1129 pSplitScreenDemoModeParams(nullptr),
1130 bIsDefaultStream(false),
1131 Component(),
1132 bReportStatus(false),
1133 StatusFeedBackID(0),
1134 #if (_DEBUG || _RELEASE_INTERNAL)
1135 bTriggerGPUHang(false),
1136 #endif
1137 bCalculatingAlpha(false),
1138 pExtensionData(nullptr),
1139 bPathKernel(false),
1140 bUseVEHdrSfc(false),
1141 bNonFirstFrame(false),
1142 gpuAppTaskEvent(nullptr)
1143 {
1144 }
1145 };
1146
1147 typedef VPHAL_RENDER_PARAMS *PVPHAL_RENDER_PARAMS;
1148 typedef const VPHAL_RENDER_PARAMS *PCVPHAL_RENDER_PARAMS;
1149
1150 //!
1151 //! Structure VPHAL_GET_SURFACE_INFO
1152 //! \brief VPHAL Get Surface Infomation Parameters
1153 //!
1154
1155 typedef struct VPHAL_GET_SURFACE_INFO *PVPHAL_GET_SURFACE_INFO;
1156 struct VPHAL_GET_SURFACE_INFO
1157 {
1158 uint32_t ArraySlice;
1159 uint32_t MipSlice;
1160 MOS_S3D_CHANNEL S3dChannel;
1161 };
1162
1163 #endif // __VP_COMMON_DEFS_H__