Zivid C++ API 2.16.0+46cdaba6-1
Zivid::Projection::ProjectedImage Class Reference

A handle to a 2D image being displayed on Zivid camera's projector. More...

#include <Zivid/Projection/ProjectedImage.h>

Public Member Functions

ZIVID_CORE_EXPORT Frame2D capture2D (const Settings &settings)
 Capture a single 2D frame without stopping the ongoing image projection.
 
ZIVID_CORE_EXPORT Frame2D capture2D (const Settings2D &settings)
 Capture a single 2D frame without stopping the ongoing image projection.
 
ZIVID_CORE_EXPORT Frame2D capture (const Settings2D &settings)
 Capture a single 2D frame without stopping the ongoing image projection.
 
ZIVID_CORE_EXPORT void stop ()
 Stops the ongoing image projection.
 
ZIVID_CORE_EXPORT bool active () const
 Check if a handle is associated with an ongoing image projection.
 
ZIVID_CORE_EXPORT std::string toString () const
 Get string representation of the projected image.
 

Detailed Description

A handle to a 2D image being displayed on Zivid camera's projector.

The image projection will stop when this handle goes out of scope, if another operation is started on the camera or if the stop() method on this handle is called.

Member Function Documentation

◆ active()

ZIVID_CORE_EXPORT bool Zivid::Projection::ProjectedImage::active ( ) const

Check if a handle is associated with an ongoing image projection.

Returns
A bool indicating the active status.

◆ capture()

ZIVID_CORE_EXPORT Frame2D Zivid::Projection::ProjectedImage::capture ( const Settings2D & settings)

Capture a single 2D frame without stopping the ongoing image projection.

Parameters
settingsSettings2D to use for the capture
Returns
A frame containing a 2D image and metadata

This method is deprecated and will be removed in the next SDK major release (3.0). It is replaced by capture2D.

This method returns right after the acquisition of the image is complete.

Some settings cannot be used to capture while projecting, depending on the camera model:

  • Not all camera models support capturing rgb colors while projecting. An exception will be thrown if Settings2D/Sampling/Color is set to rgb and the camera does not support capturing rgb colors while projecting. Those cameras must use grayscale instead.

  • When Settings2D/Sampling/Color is set to rgb the brightness must be 0 in all acquisitions, otherwise an exception will be thrown.

  • When Settings2D/Sampling/Color is set to grayscale the brightness may be set to some value > 0. This value will override the brightness of the projection to control the contrast between the scene and the projected image. This will cause the projected image to flicker while the camera is capturing. If the brightness is set to 0 the image projection will be uninterrupted.

◆ capture2D() [1/2]

ZIVID_CORE_EXPORT Frame2D Zivid::Projection::ProjectedImage::capture2D ( const Settings & settings)

Capture a single 2D frame without stopping the ongoing image projection.

Parameters
settingsSettings to use for the capture
Returns
A frame containing a 2D image and metadata

This method returns right after the acquisition of the image is complete.

Some settings cannot be used to capture while projecting, depending on the camera model:

  • Not all camera models support capturing rgb colors while projecting. An exception will be thrown if Settings2D/Sampling/Color is set to rgb and the camera does not support capturing rgb colors while projecting. Those cameras must use grayscale instead.

  • When Settings2D/Sampling/Color is set to rgb the brightness must be 0 in all acquisitions, otherwise an exception will be thrown.

  • When Settings2D/Sampling/Color is set to grayscale the brightness may be set to some value > 0. This value will override the brightness of the projection to control the contrast between the scene and the projected image. This will cause the projected image to flicker while the camera is capturing. If the brightness is set to 0 the image projection will be uninterrupted.

This overload is provided for convenience. Note that only the Settings2D part under Settings::Color will be used for the capture. The other parts of the settings will be ignored.

◆ capture2D() [2/2]

ZIVID_CORE_EXPORT Frame2D Zivid::Projection::ProjectedImage::capture2D ( const Settings2D & settings)

Capture a single 2D frame without stopping the ongoing image projection.

Parameters
settingsSettings2D to use for the capture
Returns
A frame containing a 2D image and metadata

This method returns right after the acquisition of the image is complete.

Some settings cannot be used to capture while projecting, depending on the camera model:

  • Not all camera models support capturing rgb colors while projecting. An exception will be thrown if Settings2D/Sampling/Color is set to rgb and the camera does not support capturing rgb colors while projecting. Those cameras must use grayscale instead.

  • When Settings2D/Sampling/Color is set to rgb the brightness must be 0 in all acquisitions, otherwise an exception will be thrown.

  • When Settings2D/Sampling/Color is set to grayscale the brightness may be set to some value > 0. This value will override the brightness of the projection to control the contrast between the scene and the projected image. This will cause the projected image to flicker while the camera is capturing. If the brightness is set to 0 the image projection will be uninterrupted.

◆ stop()

ZIVID_CORE_EXPORT void Zivid::Projection::ProjectedImage::stop ( )

Stops the ongoing image projection.

◆ toString()

ZIVID_CORE_EXPORT std::string Zivid::Projection::ProjectedImage::toString ( ) const

Get string representation of the projected image.


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