Zivid C++ API 2.6.1+6cec8609-3
Defining the Future of 3D Machine Vision
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | Friends | List of all members
Zivid::Settings::Acquisition::Brightness Class Reference

Brightness controls the light output from the projector. More...

#include <Zivid/Settings.h>

Public Types

using ValueType = double
 The type of the underlying value More...
 

Public Member Functions

 Brightness ()=default
 Default constructor More...
 
constexpr Brightness (double value)
 Constructor More...
 
double value () const
 Get the value More...
 
bool hasValue () const
 Check if the value is set More...
 
void reset ()
 Reset the node to unset state More...
 
std::string toString () const
 Get the value as string More...
 
bool operator== (const Brightness &other) const
 Comparison operator More...
 
bool operator!= (const Brightness &other) const
 Comparison operator More...
 
bool operator< (const Brightness &other) const
 Comparison operator More...
 
bool operator> (const Brightness &other) const
 Comparison operator More...
 

Static Public Member Functions

static constexpr Range< double > validRange ()
 The range of valid values for Brightness More...
 

Static Public Attributes

static constexpr DataModel::NodeType nodeType = DataModel::NodeType::leafValue
 The type of this node More...
 
static constexpr const char * path { "Acquisition/Brightness" }
 The full path for this value More...
 
static constexpr const char * name { "Brightness" }
 The name of this value More...
 
static constexpr const char * description
 The description for this value More...
 

Friends

struct DataModel::Detail::Befriend< Brightness >
 
std::ostream & operator<< (std::ostream &stream, const Brightness &value)
 Operator to serialize the value to a stream More...
 

Detailed Description

Brightness controls the light output from the projector.

Brightness above 1.0 may be needed when the distance between the camera and the scene is large, or in case of high levels of ambient lighting. Brightness above 1.0 is supported on Zivid One Plus and Zivid Two.

When brightness is above 1.0 the duty cycle of the camera (the percentage of time the camera can capture) will be reduced. For Zivid One Plus the duty cycle in boost mode is 50%. For Zivid Two the duty cycle is reduced linearly from 100% at brightness 1.0, to 50% at brightness 1.8. The duty cycle is calculated over a 10 second period. This limitation is enforced automatically by the camera. Calling capture when the duty cycle limit has been reached will cause the camera to first wait (sleep) for a duration of time to cool down, before capture will start.

Member Typedef Documentation

◆ ValueType

The type of the underlying value

Constructor & Destructor Documentation

◆ Brightness() [1/2]

Zivid::Settings::Acquisition::Brightness::Brightness ( )
default

Default constructor

◆ Brightness() [2/2]

constexpr Zivid::Settings::Acquisition::Brightness::Brightness ( double  value)
inlineexplicitconstexpr

Constructor

Member Function Documentation

◆ hasValue()

bool Zivid::Settings::Acquisition::Brightness::hasValue ( ) const

Check if the value is set

◆ operator!=()

bool Zivid::Settings::Acquisition::Brightness::operator!= ( const Brightness other) const
inline

Comparison operator

◆ operator<()

bool Zivid::Settings::Acquisition::Brightness::operator< ( const Brightness other) const
inline

Comparison operator

◆ operator==()

bool Zivid::Settings::Acquisition::Brightness::operator== ( const Brightness other) const
inline

Comparison operator

◆ operator>()

bool Zivid::Settings::Acquisition::Brightness::operator> ( const Brightness other) const
inline

Comparison operator

◆ reset()

void Zivid::Settings::Acquisition::Brightness::reset ( )

Reset the node to unset state

◆ toString()

std::string Zivid::Settings::Acquisition::Brightness::toString ( ) const

Get the value as string

◆ validRange()

static constexpr Range< double > Zivid::Settings::Acquisition::Brightness::validRange ( )
inlinestaticconstexpr

The range of valid values for Brightness

◆ value()

double Zivid::Settings::Acquisition::Brightness::value ( ) const

Get the value

If this object does not contain a value (see hasValue) then this method throws an exception.

Friends And Related Function Documentation

◆ DataModel::Detail::Befriend< Brightness >

friend struct DataModel::Detail::Befriend< Brightness >
friend

◆ operator<<

std::ostream & operator<< ( std::ostream &  stream,
const Brightness value 
)
friend

Operator to serialize the value to a stream

Member Data Documentation

◆ description

constexpr const char* Zivid::Settings::Acquisition::Brightness::description
staticconstexpr
Initial value:
{
R"description(Brightness controls the light output from the projector.
Brightness above 1.0 may be needed when the distance between the camera and the scene is large,
or in case of high levels of ambient lighting. Brightness above 1.0 is supported on Zivid One
Plus and Zivid Two.
When brightness is above 1.0 the duty cycle of the camera (the percentage of time the camera
can capture) will be reduced. For Zivid One Plus the duty cycle in boost mode is 50%. For Zivid
Two the duty cycle is reduced linearly from 100% at brightness 1.0, to 50% at brightness 1.8.
The duty cycle is calculated over a 10 second period. This limitation is enforced automatically
by the camera. Calling capture when the duty cycle limit has been reached will cause the camera
to first wait (sleep) for a duration of time to cool down, before capture will start.
)description"
}

The description for this value

◆ name

constexpr const char* Zivid::Settings::Acquisition::Brightness::name { "Brightness" }
staticconstexpr

The name of this value

◆ nodeType

constexpr DataModel::NodeType Zivid::Settings::Acquisition::Brightness::nodeType = DataModel::NodeType::leafValue
staticconstexpr

The type of this node

◆ path

constexpr const char* Zivid::Settings::Acquisition::Brightness::path { "Acquisition/Brightness" }
staticconstexpr

The full path for this value


The documentation for this class was generated from the following file: