NVIDIA DriveOS Linux NSR SDK API Reference

7.0.3.0 Release
ImageSipl.h
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: Copyright (c) 2019-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
3  * SPDX-License-Identifier: LicenseRef-NvidiaProprietary
4  *
5  * NVIDIA CORPORATION, its affiliates and licensors retain all intellectual
6  * property and proprietary rights in and to this material, related
7  * documentation and any modifications thereto. Any use, reproduction,
8  * disclosure or distribution of this material and related documentation
9  * without an express license agreement from NVIDIA CORPORATION or
10  * its affiliates is strictly prohibited.
11  */
12 
30 #ifndef DW_IMAGE_IMAGE_SIPL_H_
31 #define DW_IMAGE_IMAGE_SIPL_H_
32 
33 #include <dw/image/Image.h>
34 
35 #include <NvSIPLClient.hpp>
36 #include <NvSIPLISPStat.hpp>
43 
44 #ifdef __cplusplus
45 extern "C" {
46 #endif
47 
49 #define DW_IMAGE_NUM_ISP_UNITS 2
50 #define DW_LUMINANCE_NUM_ISP_UNITS 1
51 #define DW_ISP_MAX_LAC_ROI_WINDOWS (NVSIPL_ISP_MAX_LAC_ROI_WINDOWS)
52 #define DW_ISP_MAX_LAC_ROI (NVSIPL_ISP_MAX_LAC_ROI)
53 
55 typedef struct
56 {
57  // Only the first three params from NvMediaISPLocalAvgClipStatsData are needed for luminance per
58  // https://nvbugs/3808315
59 
60  /* Holds number of windows horizontally in one region of interest.
61  */
62  uint32_t numWindowsH;
66  uint32_t numWindowsV;
72 
74 
75 typedef struct
76 {
79 
80 typedef struct
81 {
83  uint32_t numExposures;
84 
87 
90 
93 
95  bool histValid[DW_IMAGE_NUM_ISP_UNITS];
96 
99 
102 
105 
108 
111 
113  bool localAvgClipStatsValid[DW_LUMINANCE_NUM_ISP_UNITS];
114 
116  // This is primarily being used to store the luminance data as per https://nvbugs/3808315
118 
122 
139 
155 dwStatus dwImage_setNvSIPLMetadata(dwImageNvSIPLMetadata const* const metadata, dwImageHandle_t const image);
156 
157 #ifdef __cplusplus
158 }
159 #endif
160 
162 #endif // DW_IMAGE_IMAGE_SIPL_H_
dwImageNvSIPLMetadata::badPixelStats
NvMediaISPBadPixelStatsData badPixelStats
Holds the ISP bad pixel statistics for the previous ISP output frame.
Definition: ImageSipl.h:107
NvSIPLClient.hpp
NVIDIA SIPL: Client Interface - NvSIPL Client
DW_ISP_MAX_COLOR_COMPONENT
#define DW_ISP_MAX_COLOR_COMPONENT
Definition: Image.h:73
dwImageNvMediaLuminanceStatsData
Definition: ImageSipl.h:75
dwImageNvSIPLMetadata::numExposures
uint32_t numExposures
Holds the number of the exposures.
Definition: ImageSipl.h:83
dwImageNvMediaLuminanceROIData::numWindowsH
uint32_t numWindowsH
Definition: ImageSipl.h:62
nvsipl::NvSiplISPLocalAvgClipStatsData
Holds local average and clip statistics block (LAC Stats).
Definition: NvSIPLISPStat.hpp:505
DW_LUMINANCE_NUM_ISP_UNITS
#define DW_LUMINANCE_NUM_ISP_UNITS
Definition: ImageSipl.h:50
nvsipl::NvSiplISPLocalAvgClipStats
Holds controls for local average and clip statistics (LAC Stats).
Definition: NvSIPLISPStat.hpp:515
DW_IMAGE_NUM_ISP_UNITS
#define DW_IMAGE_NUM_ISP_UNITS
Number of available ISP Units.
Definition: ImageSipl.h:49
dwImageNvMediaLuminanceROIData
SIPL meta information stored with each image.
Definition: ImageSipl.h:55
NvMediaISPHistogramStats
nvsipl::NvSiplISPHistogramStats NvMediaISPHistogramStats
Definition: ImageSipl.h:42
nvsipl::NvSiplISPHistogramStats
Holds controls for histogram statistics (HIST Stats).
Definition: NvSIPLISPStat.hpp:439
NvSIPLISPStat.hpp
NvSipl ISP statistics data structures for Tegra
dwConstImageHandle_t
struct dwImageObject const * dwConstImageHandle_t
Definition: Image.h:89
NvMediaISPBadPixelStatsData
nvsipl::NvSiplISPBadPixelStatsData NvMediaISPBadPixelStatsData
Definition: ImageSipl.h:38
NvMediaISPLocalAvgClipStats
nvsipl::NvSiplISPLocalAvgClipStats NvMediaISPLocalAvgClipStats
Definition: ImageSipl.h:39
float32_t
float float32_t
Specifies POD types.
Definition: BasicTypes.h:41
dwImageNvSIPLMetadata::sensorWBInfo
DevBlkCDIWhiteBalance sensorWBInfo
Holds the sensor white balance info.
Definition: ImageSipl.h:89
DevBlkCDIWhiteBalance
Holds the sensor white balance gain structure.
Definition: NvSIPLCDICommon.h:306
NvMediaISPBadPixelStats
nvsipl::NvSiplISPBadPixelStats NvMediaISPBadPixelStats
Definition: ImageSipl.h:37
DevBlkCDIIllumination
Holds the sensor illumination control structure.
Definition: NvSIPLCDICommon.h:327
DW_ISP_MAX_LAC_ROI
#define DW_ISP_MAX_LAC_ROI
Definition: ImageSipl.h:52
DW_ISP_MAX_LAC_ROI_WINDOWS
#define DW_ISP_MAX_LAC_ROI_WINDOWS
Definition: ImageSipl.h:51
NvMediaISPLocalAvgClipStatsData
nvsipl::NvSiplISPLocalAvgClipStatsData NvMediaISPLocalAvgClipStatsData
Definition: ImageSipl.h:40
nvsipl::NvSiplISPBadPixelStatsData
Holds bad pixel statistics (BP Stats).
Definition: NvSIPLISPStat.hpp:102
dwImageNvSIPLMetadata::illuminationInfo
DevBlkCDIIllumination illuminationInfo
Holds the sensor illumination info.
Definition: ImageSipl.h:92
nvsipl::NvSiplISPHistogramStatsData
Holds histogram statistics (HIST Stats).
Definition: NvSIPLISPStat.hpp:235
dwImageNvSIPLMetadata::sensorExpInfo
DevBlkCDIExposure sensorExpInfo
Holds sensor exposure info including exposure times and gains.
Definition: ImageSipl.h:86
dwImageNvSIPLMetadata
Definition: ImageSipl.h:80
dwImageHandle_t
struct dwImageObject * dwImageHandle_t
Definition: Image.h:88
dwImage_getNvSIPLMetadata
DW_API_PUBLIC dwStatus dwImage_getNvSIPLMetadata(dwImageNvSIPLMetadata *metadata, dwConstImageHandle_t image)
Retrieves the SIPL metadata of a dwImageHandle_t.
dwImageNvMediaLuminanceROIData::numWindowsV
uint32_t numWindowsV
Holds number of windows vertically in one region of interest.
Definition: ImageSipl.h:66
dwStatus
dwStatus
Status definition.
Definition: ErrorDefs.h:27
DevBlkCDIExposure
Holds sensor exposure information.
Definition: NvSIPLCDICommon.h:256
nvsipl::NvSiplISPBadPixelStats
Holds controls for bad pixel statistics (BP Stats).
Definition: NvSIPLISPStat.hpp:556
DW_API_PUBLIC
#define DW_API_PUBLIC
Definition: Exports.h:38
dwImage_setNvSIPLMetadata
DW_API_PUBLIC dwStatus dwImage_setNvSIPLMetadata(dwImageNvSIPLMetadata const *const metadata, dwImageHandle_t const image)
Sets the SIPL metadata of a dwImageHandle_t.
dwImageNvSIPLMetadata::badPixelSettings
NvMediaISPBadPixelStats badPixelSettings
Holds the ISP bad pixel settings for the previous ISP output frame.
Definition: ImageSipl.h:110
dwImageNvSIPLMetadata::badPixelStatsValid
bool badPixelStatsValid
Holds a flag indicating if the ISP bad pixel statistics are valid.
Definition: ImageSipl.h:104
NvMediaISPHistogramStatsData
nvsipl::NvSiplISPHistogramStatsData NvMediaISPHistogramStatsData
Definition: ImageSipl.h:41