NVIDIA DRIVE OS Linux SDK API Reference

5.2.0 Release
For Test and Development only
NvSIPLClient.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2018-2020, NVIDIA CORPORATION. All rights reserved.
3  *
4  * NVIDIA CORPORATION and its licensors retain all intellectual property
5  * and proprietary rights in and to this software, related documentation
6  * and any modifications thereto. Any use, reproduction, disclosure or
7  * distribution of this software and related documentation without an express
8  * license agreement from NVIDIA CORPORATION is strictly prohibited.
9  */
10 
11 #ifndef NVSIPLCLIENT_HPP
12 #define NVSIPLCLIENT_HPP
13 
14 #include "NvSIPLCommon.hpp"
15 
16 #include "nvmedia_image.h"
17 #include "devblk_cdi.h"
18 #include "nvmedia_isp_stat.h"
19 
20 #ifdef NVMEDIA_NVSCI_ENABLE
21 #include "nvscisync.h"
22 #include "nvscistream.h"
23 #endif // NVMEDIA_NVSCI_ENABLE
24 
25 #include <cstdint>
26 #include <string>
27 #include <memory>
28 
43 namespace nvsipl
44 {
45 
57 {
58  public:
61  {
63  std::uint64_t frameCaptureTSC;
65  std::uint32_t numExposures;
67  DevBlkCDIExposure sensorExpInfo;
69  DevBlkCDIWhiteBalance sensorWBInfo;
71  DevBlkCDIPWL sensorPWLInfo;
73  DevBlkCDICRC sensorCRCInfo;
75  DevBlkCDIFrameReport sensorReportInfo;
77  DevBlkCDITemperature sensorTempInfo;
79  DevBlkCDIFrameSeqNum frameSeqNumInfo;
84  };
85 
92  {
93  public:
98  virtual void AddRef(void) = 0;
99 
106  virtual SIPLStatus Release(void) = 0;
107 
108 #ifdef NVMEDIA_NVSCI_ENABLE
109 
118  virtual SIPLStatus AddNvSciSyncPrefence(NvSciSyncFence &prefence) = 0;
119 
131  virtual SIPLStatus GetEOFNvSciSyncFence(NvSciSyncFence *postfence) = 0;
132 #endif // NVMEDIA_NVSCI_ENABLE
133  };
134 
141  {
142  public:
146  virtual NvMediaImage* GetImage() = 0;
147 
153  virtual NvMediaImageGroup* GetImageGroup() = 0;
154 
159  virtual ImageMetaData GetImageData() = 0;
160  };
161 
169  {
170  public:
182  virtual SIPLStatus OnFrameAvailable(INvSIPLBuffer* pBuffer) = 0;
183  };
184 
187  {
189  enum class OutputType
190  {
191  ICP,
192  ISP0,
193  ISP1,
194  };
195 
200  };
201 };
202 
205 } // namespace nvsipl
206 
207 
208 
209 #endif // NVSIPLCLIENT_HPP
nvsipl::INvSIPLClient::ConsumerDesc::callback
INvMCallback * callback
Holds a pointer to a user-implemented class object inheriting from INvMCallback.
Definition: NvSIPLClient.hpp:199
nvsipl::INvSIPLClient::ConsumerDesc::eOutputType
OutputType eOutputType
Holds an OutputType.
Definition: NvSIPLClient.hpp:197
nvsipl::INvSIPLClient::ImageMetaData::frameCaptureTSC
std::uint64_t frameCaptureTSC
Holds the TSC timestamp of the frame capture.
Definition: NvSIPLClient.hpp:63
nvsipl::INvSIPLClient::ImageMetaData::sensorTempInfo
DevBlkCDITemperature sensorTempInfo
Holds the parsed embedded data sensor temperature info for the captured frame.
Definition: NvSIPLClient.hpp:77
nvsipl::INvSIPLClient::ConsumerDesc::OutputType::ICP
@ ICP
Indicates the unprocessed output of the image sensor.
nvsipl::INvSIPLClient
Defines the public data structures and describes the interfaces for NvSIPL Client.
Definition: NvSIPLClient.hpp:56
NvSIPLCommon.hpp
NVIDIA SIPL: Common Data Structures - SIPL
nvsipl::INvSIPLClient::ConsumerDesc::OutputType::ISP0
@ ISP0
Indicates the first output of NvMediaISP.
nvsipl::INvSIPLClient::INvSIPLBuffer::Release
virtual SIPLStatus Release(void)=0
Release a reference.
nvsipl::INvSIPLClient::ImageMetaData
Defines the metadata associated with the image.
Definition: NvSIPLClient.hpp:60
nvscisync.h
NVIDIA Software Communications Interface (SCI) : NvSciSync
nvsipl::INvSIPLClient::INvSIPLNvMBuffer::GetImage
virtual NvMediaImage * GetImage()=0
Gets a handle to NvMediaImage.
nvsipl::INvSIPLClient::INvSIPLBuffer
Describes the interfaces of SIPL buffer.
Definition: NvSIPLClient.hpp:91
nvsipl::INvSIPLClient::ImageMetaData::badPixelStatsValid
bool badPixelStatsValid
Holds a flag indicating if the ISP bad pixel statistics are valid.
Definition: NvSIPLClient.hpp:81
NvMediaISPBadPixelStatsData
Holds bad pixel statistics (BP Stats).
Definition: nvmedia_isp_stat.h:562
nvsipl::INvSIPLClient::ConsumerDesc::OutputType
OutputType
Defines the types of the SIPL pipeline output.
Definition: NvSIPLClient.hpp:189
nvsipl::INvSIPLClient::ConsumerDesc
Describes a client of the pipeline.
Definition: NvSIPLClient.hpp:186
NvMediaImageRec
Holds a handle representing image objects.
Definition: nvmedia_image.h:71
nvsipl::INvSIPLClient::ImageMetaData::numExposures
std::uint32_t numExposures
Holds the parsed embedded data frame number of exposures info for the captured frame.
Definition: NvSIPLClient.hpp:65
nvsipl::INvSIPLClient::ImageMetaData::sensorExpInfo
DevBlkCDIExposure sensorExpInfo
Holds the parsed embedded data sensor exposure info for the captured frame.
Definition: NvSIPLClient.hpp:67
nvsipl::INvSIPLClient::ImageMetaData::badPixelStats
NvMediaISPBadPixelStatsData badPixelStats
Holds the ISP bad pixel statistics for the previous ISP output frame.
Definition: NvSIPLClient.hpp:83
nvsipl::INvSIPLClient::INvMCallback::OnFrameAvailable
virtual SIPLStatus OnFrameAvailable(INvSIPLBuffer *pBuffer)=0
A new output frame is available.
nvsipl::INvSIPLClient::INvSIPLBuffer::AddRef
virtual void AddRef(void)=0
Adds a reference.
nvmedia_isp_stat.h
NvMedia ISP stat struct
nvsipl::SIPLStatus
SIPLStatus
Defines the status codes returned by functions in SIPL modules.
Definition: NvSIPLCommon.hpp:38
nvsipl::INvSIPLClient::ImageMetaData::sensorReportInfo
DevBlkCDIFrameReport sensorReportInfo
Holds the parsed embedded data frame report info for the captured frame.
Definition: NvSIPLClient.hpp:75
nvsipl::INvSIPLClient::ImageMetaData::frameSeqNumInfo
DevBlkCDIFrameSeqNum frameSeqNumInfo
Holds the parsed embedded data frame sequence number info for the captured frame.
Definition: NvSIPLClient.hpp:79
nvsipl::INvSIPLClient::INvSIPLNvMBuffer::GetImageGroup
virtual NvMediaImageGroup * GetImageGroup()=0
Gets a handle to NvMediaImageGroup.
NvSciSyncFence
Defines the opaque NvSciSyncFence.
Definition: nvscisync.h:234
nvsipl::INvSIPLClient::ImageMetaData::sensorCRCInfo
DevBlkCDICRC sensorCRCInfo
Holds the parsed embedded data sensor crc info for the captured frame.
Definition: NvSIPLClient.hpp:73
nvscistream.h
NVIDIA Software Communications Interface (SCI) : NvSciStream
nvsipl::INvSIPLClient::ConsumerDesc::OutputType::ISP1
@ ISP1
Indicates the second output of NvMediaISP.
NvMediaImageGroup
Holds a handle representing an image group.
Definition: nvmedia_image.h:115
nvsipl::INvSIPLClient::ImageMetaData::sensorPWLInfo
DevBlkCDIPWL sensorPWLInfo
Holds the parsed embedded data sensor PWL info for the captured frame.
Definition: NvSIPLClient.hpp:71
nvsipl::INvSIPLClient::INvSIPLBuffer::AddNvSciSyncPrefence
virtual SIPLStatus AddNvSciSyncPrefence(NvSciSyncFence &prefence)=0
Add an NvSciSync prefence.
nvsipl::INvSIPLClient::INvSIPLNvMBuffer
Describes a SIPL buffer containing an NvMediaImage or NvMediaImageGroup.
Definition: NvSIPLClient.hpp:140
nvsipl
Contains the classes and variables for implementation of SIPL.
Definition: INvSiplControlAuto.hpp:33
nvmedia_image.h
NVIDIA Media Interface: Image Processing
nvsipl::INvSIPLClient::ImageMetaData::sensorWBInfo
DevBlkCDIWhiteBalance sensorWBInfo
Holds the parsed embedded data sensor white balance info for the captured frame.
Definition: NvSIPLClient.hpp:69
nvsipl::INvSIPLClient::INvSIPLNvMBuffer::GetImageData
virtual ImageMetaData GetImageData()=0
Gets an nvsipl::INvSIPLClient::ImageMetaData associated with NvMediaImage or NvMediaImageGroup.
nvsipl::INvSIPLClient::INvSIPLBuffer::GetEOFNvSciSyncFence
virtual SIPLStatus GetEOFNvSciSyncFence(NvSciSyncFence *postfence)=0
Retrieve the latest NvSciSync EOF fence.
nvsipl::INvSIPLClient::INvMCallback
Describes a class with callback functions that must be implemented by the consumer of the SIPL image ...
Definition: NvSIPLClient.hpp:168