CaptureMetadata.h

前往此文件的文档。

/*
 * 版权所有 (c) 2016-2021，NVIDIA CORPORATION。保留所有权利。
 *
 * 允许以源代码和二进制形式再分发和使用，无论是否
 * 修改，前提是满足以下条件：
 *
 * * 源代码的再分发必须保留上述版权声明、
 * 此条件列表以及以下免责声明。
 *
 * * 二进制形式的再分发必须在上述版权声明、
 * 此条件列表以及以下免责声明中复制
 * 文档和/或随分发提供的其他材料。
 *
 * * 未经事先书面许可，不得使用 NVIDIA CORPORATION 的名称或其
 * 贡献者的姓名来认可或推广由此软件衍生的产品。
 *
 * 本软件由版权持有者“按原样”提供，并且不作任何明示或暗示的
 * 保证，包括但不限于
 * 对适销性和特定用途适用性的默示保证。在任何情况下，版权所有者或
 * 贡献者均不对任何直接、间接、附带、特殊、
 * 惩戒性或后果性损害（包括但不限于
 * 替代商品或服务的采购；使用、数据或
 * 利润损失；或业务中断）承担责任，无论其是如何造成的，以及基于任何责任理论
 * 的责任，无论是合同、严格责任还是侵权
 * （包括疏忽或其他），均不以任何方式因使用本软件而引起，
 * 即使已被告知可能发生此类损害。
 */

#ifndef _ARGUS_CAPTURE_METADATA_H
#define _ARGUS_CAPTURE_METADATA_H

namespace Argus
{

class CaptureMetadata : public InterfaceProvider
{
protected
 ~CaptureMetadata() {}
};

class CaptureMetadataContainer : public InterfaceProvider, public Destructable
{
protected
 ~CaptureMetadataContainer() {}
};

DEFINE_UUID(InterfaceID, IID_BAYER_HISTOGRAM, 50bc4f1c,6424,beb7,baae,b0,90,c9,c3,25,9e);
class IBayerHistogram : public Interface
{
public

 static const InterfaceID& id() { return IID_BAYER_HISTOGRAM; }

 virtual uint32_t getBinCount() const = 0;

 virtual Status getHistogram(std::vector< BayerTuple<uint32_t> >* histogram) const = 0;

protected

 ~IBayerHistogram() {}
};

DEFINE_UUID(InterfaceID, IID_RGB_HISTOGRAM, 50bc4f1d,6424,beb7,baae,b0,90,c9,c3,25,9e);
class IRGBHistogram : public Interface
{
public

 static const InterfaceID& id() { return IID_RGB_HISTOGRAM; }

 virtual uint32_t getBinCount() const = 0;

 virtual Status getHistogram(std::vector< RGBTuple<uint32_t> >* histogram) const = 0;

protected

 ~IRGBHistogram() {}
};

DEFINE_UUID(InterfaceID, IID_STREAM_CAPTURE_METADATA, 61cbe0a8,0ee1,4c67,baae,02,02,1a,b8,d9,47);
class IStreamCaptureMetadata : public Interface
{
public

 static const InterfaceID& id() { return IID_STREAM_CAPTURE_METADATA; }

 virtual Rectangle<float> getSourceClipRect() const = 0;

protected

 ~IStreamCaptureMetadata() {}
};

DEFINE_UUID(InterfaceID, IID_CAPTURE_METADATA, 5f6ac5d4,59e8,45d0,8bac,38,09,1f,f8,74,a9);
class ICaptureMetadata : public Interface
{
public

 static const InterfaceID& id() { return IID_CAPTURE_METADATA; }

 static const uint32_t NUM_COLOR_CORRECTION_ELEMENTS = 9;
 static const uint32_t NUM_AWB_WB_ESTIMATE_ELEMENTS = 4;

 virtual uint32_t getCaptureId() const = 0;

 virtual uint32_t getClientData() const = 0;

 virtual InterfaceProvider* getStreamMetadata(const OutputStream* stream) const = 0;

 virtual const InterfaceProvider* getBayerHistogram() const = 0;

 virtual const InterfaceProvider* getRGBHistogram() const = 0;

 virtual bool getAeLocked() const = 0;

 virtual Status getAeRegions(std::vector<AcRegion>* regions) const = 0;

 virtual Rectangle<uint32_t> getBayerHistogramRegion() const = 0;

 virtual AeState getAeState() const = 0;

 virtual AeFlickerState getFlickerState() const = 0;

 virtual int32_t getAperturePosition() const = 0;

 virtual int32_t getFocuserPosition() const = 0;

 virtual uint32_t getAwbCct() const = 0;

 virtual BayerTuple<float> getAwbGains() const = 0;

 virtual AwbMode getAwbMode() const = 0;

 virtual Status getAwbRegions(std::vector<AcRegion>* regions) const = 0;

 virtual Status getAfRegions(std::vector<AcRegion>* regions) const = 0;

 virtual Status getSharpnessScore(std::vector<float>* values) const = 0;

 virtual AwbState getAwbState() const = 0;

 virtual Status getAwbWbEstimate(std::vector<float>* estimate) const = 0;

 virtual bool getColorCorrectionMatrixEnable() const = 0;

 virtual Status getColorCorrectionMatrix(std::vector<float>* ccMatrix) const = 0;

 virtual float getColorSaturation() const = 0;

 virtual uint64_t getFrameDuration() const = 0;

 virtual float getIspDigitalGain() const = 0;

 virtual uint64_t getFrameReadoutTime() const = 0;

 virtual float getSceneLux() const = 0;

 virtual float getSensorAnalogGain() const = 0;

 virtual uint64_t getSensorExposureTime() const = 0;

 virtual uint32_t getSensorSensitivity() const = 0;

 virtual uint64_t getSensorTimestamp() const = 0;

 virtual bool getToneMapCurveEnabled() const = 0;

 virtual Status getToneMapCurve(RGBChannel channel, std::vector<float>* curve) const = 0;

protected
 ~ICaptureMetadata() {}
};

DEFINE_UUID(InterfaceID, IID_DENOISE_METADATA, 7A461D23,6AE1,11E6,BDF4,08,00,20,0C,9A,66);
class IDenoiseMetadata : public Interface
{
public
 static const InterfaceID& id() { return IID_DENOISE_METADATA; }

 virtual DenoiseMode getDenoiseMode() const = 0;

 virtual float getDenoiseStrength() const = 0;

protected
 ~IDenoiseMetadata() {}
};

DEFINE_UUID(InterfaceID, IID_EDGE_ENHANCE_METADATA, 7A461D24,6AE1,11E6,BDF4,08,00,20,0C,9A,66);
class IEdgeEnhanceMetadata : public Interface
{
public
 static const InterfaceID& id() { return IID_EDGE_ENHANCE_METADATA; }

 virtual EdgeEnhanceMode getEdgeEnhanceMode() const = 0;

 virtual float getEdgeEnhanceStrength() const = 0;

protected
 ~IEdgeEnhanceMetadata() {}
};

} // namespace Argus

#endif // _ARGUS_CAPTURE_METADATA_H