VPI - Vision Programming Interface

0.4.4 Release

PixelFormat.h
Go to the documentation of this file.
1 /*
2  * Copyright 2020 NVIDIA Corporation. All rights reserved.
3  *
4  * NOTICE TO LICENSEE:
5  *
6  * This source code and/or documentation ("Licensed Deliverables") are
7  * subject to NVIDIA intellectual property rights under U.S. and
8  * international Copyright laws.
9  *
10  * These Licensed Deliverables contained herein is PROPRIETARY and
11  * CONFIDENTIAL to NVIDIA and is being provided under the terms and
12  * conditions of a form of NVIDIA software license agreement by and
13  * between NVIDIA and Licensee ("License Agreement") or electronically
14  * accepted by Licensee. Notwithstanding any terms or conditions to
15  * the contrary in the License Agreement, reproduction or disclosure
16  * of the Licensed Deliverables to any third party without the express
17  * written consent of NVIDIA is prohibited.
18  *
19  * NOTWITHSTANDING ANY TERMS OR CONDITIONS TO THE CONTRARY IN THE
20  * LICENSE AGREEMENT, NVIDIA MAKES NO REPRESENTATION ABOUT THE
21  * SUITABILITY OF THESE LICENSED DELIVERABLES FOR ANY PURPOSE. IT IS
22  * PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY OF ANY KIND.
23  * NVIDIA DISCLAIMS ALL WARRANTIES WITH REGARD TO THESE LICENSED
24  * DELIVERABLES, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY,
25  * NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.
26  * NOTWITHSTANDING ANY TERMS OR CONDITIONS TO THE CONTRARY IN THE
27  * LICENSE AGREEMENT, IN NO EVENT SHALL NVIDIA BE LIABLE FOR ANY
28  * SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, OR ANY
29  * DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
30  * WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
31  * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
32  * OF THESE LICENSED DELIVERABLES.
33  *
34  * U.S. Government End Users. These Licensed Deliverables are a
35  * "commercial item" as that term is defined at 48 C.F.R. 2.101 (OCT
36  * 1995), consisting of "commercial computer software" and "commercial
37  * computer software documentation" as such terms are used in 48
38  * C.F.R. 12.212 (SEPT 1995) and is provided to the U.S. Government
39  * only as a commercial end item. Consistent with 48 C.F.R.12.212 and
40  * 48 C.F.R. 227.7202-1 through 227.7202-4 (JUNE 1995), all
41  * U.S. Government End Users acquire the Licensed Deliverables with
42  * only those rights set forth herein.
43  *
44  * Any use of the Licensed Deliverables in individual and commercial
45  * software must include, in the user documentation and internal
46  * comments to the code, the above Disclaimer and U.S. Government End
47  * Users Notice.
48  */
49 
56 #ifndef NV_VPI_PIXEL_FORMAT_H
57 #define NV_VPI_PIXEL_FORMAT_H
58 
59 #include "Format.h"
60 #include "detail/FormatUtils.h"
61 
62 #ifdef __cplusplus
63 extern "C" {
64 #endif
65 
79 typedef enum
80 {
83  VPI_PIXEL_FORMAT_U8 = VPI_DETAIL_MAKE_PIXEL_FORMAT(PL, UNSIGNED, X8),
84  VPI_PIXEL_FORMAT_S8 = VPI_DETAIL_MAKE_PIXEL_FORMAT(PL, SIGNED, X8),
86  VPI_DETAIL_MAKE_PIXEL_FORMAT(PL, UNSIGNED, X16),
87  VPI_PIXEL_FORMAT_S16 = VPI_DETAIL_MAKE_PIXEL_FORMAT(PL, SIGNED, X16),
89  VPI_DETAIL_MAKE_PIXEL_FORMAT(PL, UNSIGNED, X8_Y8),
90  VPI_PIXEL_FORMAT_3U8 = VPI_DETAIL_MAKE_PIXEL_FORMAT(
91  PL, UNSIGNED, X8_Y8_Z8),
92  VPI_PIXEL_FORMAT_4U8 = VPI_DETAIL_MAKE_PIXEL_FORMAT(
93  PL, UNSIGNED, X8_Y8_Z8_W8),
94  VPI_PIXEL_FORMAT_F32 = VPI_DETAIL_MAKE_PIXEL_FORMAT(PL, FLOAT, X32),
96  VPI_DETAIL_MAKE_PIXEL_FORMAT(PL, FLOAT, X32_Y32),
97  VPI_PIXEL_FORMAT_F64 = VPI_DETAIL_MAKE_PIXEL_FORMAT(PL, FLOAT, X64),
100  VPI_PIXEL_FORMAT_FORCE64 = INT64_MAX
101  /* \endcond */
103 
117 #ifdef VPI_DOXYGEN
118 # define VPI_MAKE_PIXEL_FORMAT(memLayout, dataType, packing)
119 #else
120 # define VPI_MAKE_PIXEL_FORMAT (VPIPixelFormat) VPI_DETAIL_MAKE_PIXEL_FORMAT
121 #endif
122 
124 #define vpiMakePixelFormat VPI_APINAME(vpiMakePixelFormat, 004)
125 #define vpiPixelFormatGetPacking VPI_APINAME(vpiPixelFormatGetPacking, 004)
126 #define vpiPixelFormatGetBitsPerPixel VPI_APINAME(vpiPixelFormatGetBitsPerPixel, 004)
127 #define vpiPixelFormatGetDataType VPI_APINAME(vpiPixelFormatGetDataType, 004)
128 #define vpiPixelFormatGetMemLayout VPI_APINAME(vpiPixelFormatGetMemLayout, 004)
129 #define vpiPixelFormatGetChannelCount VPI_APINAME(vpiPixelFormatGetChannelCount, 004)
130 
142  VPIFormatPacking packing);
143 
151 
159 
167 
175 
183 
186 #ifdef __cplusplus
187 }
188 #endif
189 
190 #endif // NV_VPI_PIXEL_FORMAT_H
vpiPixelFormatGetMemLayout
VPIMemLayout vpiPixelFormatGetMemLayout(VPIPixelFormat fmt)
Get the memory layout of a pixel format.
VPI_PIXEL_FORMAT_2F32
@ VPI_PIXEL_FORMAT_2F32
Two interleaved channels of 32-bit float values.
Definition: PixelFormat.h:95
vpiPixelFormatGetChannelCount
int vpiPixelFormatGetChannelCount(VPIPixelFormat fmt)
Get the number of channels of a pixel format.
VPI_PIXEL_FORMAT_4U8
@ VPI_PIXEL_FORMAT_4U8
Four interleaved channels of unsigned 8-bit values.
Definition: PixelFormat.h:92
VPI_PIXEL_FORMAT_S8
@ VPI_PIXEL_FORMAT_S8
One channel of signed 8-bit values.
Definition: PixelFormat.h:84
Format.h
Defines types and functions to handle memory formats.
VPI_PIXEL_FORMAT_U16
@ VPI_PIXEL_FORMAT_U16
One channel of unsigned 16-bit values.
Definition: PixelFormat.h:85
VPIFormatDataType
VPIFormatDataType
Defines the channel data type.
Definition: Format.h:211
VPI_PIXEL_FORMAT_F32
@ VPI_PIXEL_FORMAT_F32
One channel of 32-bit float values.
Definition: PixelFormat.h:94
vpiMakePixelFormat
VPIPixelFormat vpiMakePixelFormat(VPIMemLayout memLayout, VPIFormatDataType dataType, VPIFormatPacking packing)
Creates an user-defined pixel format.
vpiPixelFormatGetPacking
VPIFormatPacking vpiPixelFormatGetPacking(VPIPixelFormat fmt)
Get the packing of a pixel format.
VPIFormatPacking
VPIFormatPacking
Defines how channels are packed into an image plane element.
Definition: Format.h:132
VPI_PIXEL_FORMAT_INVALID
@ VPI_PIXEL_FORMAT_INVALID
Signal format conversion errors.
Definition: PixelFormat.h:82
vpiPixelFormatGetDataType
VPIFormatDataType vpiPixelFormatGetDataType(VPIPixelFormat fmt)
Get the data type of a pixel format.
VPI_PIXEL_FORMAT_U8
@ VPI_PIXEL_FORMAT_U8
One channel of unsigned 8-bit values.
Definition: PixelFormat.h:83
VPIPixelFormat
VPIPixelFormat
Pre-defined pixel formats.
Definition: PixelFormat.h:80
VPI_PIXEL_FORMAT_DEFAULT
@ VPI_PIXEL_FORMAT_DEFAULT
Used to signal that the pixel format must be inferred from image format.
Definition: PixelFormat.h:81
VPI_PIXEL_FORMAT_2U8
@ VPI_PIXEL_FORMAT_2U8
Two interleaved channels of unsigned 8-bit values.
Definition: PixelFormat.h:88
VPIMemLayout
VPIMemLayout
Defines how the 2D plane pixels are laid out in memory.
Definition: Format.h:224
vpiPixelFormatGetBitsPerPixel
int vpiPixelFormatGetBitsPerPixel(VPIPixelFormat fmt)
Get the number of bits per pixel of a pixel format.
VPI_PIXEL_FORMAT_3U8
@ VPI_PIXEL_FORMAT_3U8
Three interleaved channels of unsigned 8-bit values.
Definition: PixelFormat.h:90
VPI_PIXEL_FORMAT_F64
@ VPI_PIXEL_FORMAT_F64
One channel of 64-bit float values.
Definition: PixelFormat.h:97
VPI_PIXEL_FORMAT_S16
@ VPI_PIXEL_FORMAT_S16
One channel of signed 16-bit values.
Definition: PixelFormat.h:87