VPI - Vision Programming Interface

0.1.0 Release

Pyramid.h
Go to the documentation of this file.
1 /*
2  * Copyright 2019 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_PYRAMID_H
57 #define NV_VPI_PYRAMID_H
58 
91 #include <stdint.h>
92 
93 #include "Export.h"
94 #include "Image.h"
95 #include "Status.h"
96 #include "Types.h"
97 
98 #ifdef __cplusplus
99 extern "C" {
100 #endif
101 
104 #define VPI_PYRAMID_NO_PVA 0x01
105 #define VPI_PYRAMID_NO_CPU 0x02
106 #define VPI_PYRAMID_NO_CUDA 0x04
111 #define VPI_PYRAMID_ONLY_CUDA (VPI_PYRAMID_NO_PVA | VPI_PYRAMID_NO_CPU)
112 #define VPI_PYRAMID_ONLY_CPU (VPI_PYRAMID_NO_PVA | VPI_PYRAMID_NO_CUDA)
113 #define VPI_PYRAMID_ONLY_PVA (VPI_PYRAMID_NO_CUDA | VPI_PYRAMID_NO_CPU)
117 #define VPI_MAX_PYRAMID_LEVEL_COUNT (10)
118 
123 typedef struct VPIPyramidDataRec
124 {
125  int32_t numLevels;
131 
145 VPI_PUBLIC VPIStatus vpiPyramidCreate(uint32_t width, uint32_t height, VPIImageType fmt, uint32_t numLevels,
146  float scale, uint32_t flags, VPIPyramid *pyr);
147 
153 VPI_PUBLIC void vpiPyramidDestroy(VPIPyramid pyr);
154 
163 VPI_PUBLIC VPIStatus vpiPyramidGetFlags(VPIPyramid pyr, uint32_t *flags);
164 
173 VPI_PUBLIC VPIStatus vpiPyramidGetType(VPIPyramid pyr, VPIImageType *type);
174 
184 VPI_PUBLIC VPIStatus vpiPyramidGetNumLevels(VPIPyramid pyr, uint32_t *numLevels);
185 
195 VPI_PUBLIC VPIStatus vpiPyramidGetWidth(VPIPyramid pyr, uint32_t outSize, uint32_t *out);
196 
206 VPI_PUBLIC VPIStatus vpiPyramidGetHeight(VPIPyramid pyr, uint32_t outSize, uint32_t *out);
207 
220 VPI_PUBLIC VPIStatus vpiPyramidLock(VPIPyramid pyr, VPILockMode lock, VPIPyramidData *out);
221 
235 VPI_PUBLIC VPIStatus vpiImageWrapPyramidLevel(VPIPyramid pyr, uint32_t level, VPIImage *img);
236 
246 VPI_PUBLIC VPIStatus vpiPyramidUnlock(VPIPyramid pyr);
247 
248 #ifdef __cplusplus
249 }
250 #endif
251  // end of VPI_Pyramid
253 
254 #endif // NV_VPI_PYRAMID_H
vpiImageWrapPyramidLevel
VPIStatus vpiImageWrapPyramidLevel(VPIPyramid pyr, uint32_t level, VPIImage *img)
Creates an image that wraps one pyramid level.
VPIPyramidDataRec::numLevels
int32_t numLevels
Number of levels (i.e.
Definition: Pyramid.h:125
Export.h
vpiPyramidCreate
VPIStatus vpiPyramidCreate(uint32_t width, uint32_t height, VPIImageType fmt, uint32_t numLevels, float scale, uint32_t flags, VPIPyramid *pyr)
Create an empty image pyramid instance with the specified flags.
VPIImageType
VPIImageType
Image formats.
Definition: Types.h:172
Types.h
VPI_MAX_PYRAMID_LEVEL_COUNT
#define VPI_MAX_PYRAMID_LEVEL_COUNT
Maximum number of pyramid levels.
Definition: Pyramid.h:117
vpiPyramidGetHeight
VPIStatus vpiPyramidGetHeight(VPIPyramid pyr, uint32_t outSize, uint32_t *out)
Get the height of all image levels.
vpiPyramidGetNumLevels
VPIStatus vpiPyramidGetNumLevels(VPIPyramid pyr, uint32_t *numLevels)
Get the image pyramid level count.
vpiPyramidUnlock
VPIStatus vpiPyramidUnlock(VPIPyramid pyr)
Releases the lock on a image pyramid object.
vpiPyramidGetType
VPIStatus vpiPyramidGetType(VPIPyramid pyr, VPIImageType *type)
Returns the image type of the pyramid levels.
VPIImageDataRec
Stores information about image characteristics and content.
Definition: Image.h:143
VPIPyramidData
struct VPIPyramidDataRec VPIPyramidData
Stores the pyramid contents.
VPIPyramidDataRec
Stores the pyramid contents.
Definition: Pyramid.h:123
Image.h
VPIImage
struct VPIImageImpl * VPIImage
Definition: Types.h:153
VPIStatus
VPIStatus
Error codes.
Definition: Types.h:407
VPIPyramidDataRec::levels
VPIImageData levels[VPI_MAX_PYRAMID_LEVEL_COUNT]
Contents of every pyramid level.
Definition: Pyramid.h:129
VPILockMode
VPILockMode
Defines the lock modes used by memory lock functions.
Definition: Types.h:382
vpiPyramidGetFlags
VPIStatus vpiPyramidGetFlags(VPIPyramid pyr, uint32_t *flags)
Returns the flags associated with the pyramid.
Status.h
vpiPyramidGetWidth
VPIStatus vpiPyramidGetWidth(VPIPyramid pyr, uint32_t outSize, uint32_t *out)
Get the image width in pixels (for all levels at once).
vpiPyramidDestroy
void vpiPyramidDestroy(VPIPyramid pyr)
Destroy an image pyramid instance as well as all resources it owns.
VPIPyramid
struct VPIPyramidImpl * VPIPyramid
Definition: Types.h:159
vpiPyramidLock
VPIStatus vpiPyramidLock(VPIPyramid pyr, VPILockMode lock, VPIPyramidData *out)
Acquires the lock on a pyramid object and returns pointers to each level of the pyramid.