![]() |
Zivid C++ API 2.16.0+46cdaba6-1
|
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. | |
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.
ZIVID_CORE_EXPORT bool Zivid::Projection::ProjectedImage::active | ( | ) | const |
Check if a handle is associated with an ongoing image projection.
ZIVID_CORE_EXPORT Frame2D Zivid::Projection::ProjectedImage::capture | ( | const Settings2D & | settings | ) |
Capture a single 2D frame without stopping the ongoing image projection.
settings | Settings2D to use for the capture |
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.
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. ZIVID_CORE_EXPORT Frame2D Zivid::Projection::ProjectedImage::capture2D | ( | const Settings & | settings | ) |
Capture a single 2D frame without stopping the ongoing image projection.
settings | Settings to use for the capture |
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.
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.
ZIVID_CORE_EXPORT Frame2D Zivid::Projection::ProjectedImage::capture2D | ( | const Settings2D & | settings | ) |
Capture a single 2D frame without stopping the ongoing image projection.
settings | Settings2D to use for the capture |
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.
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. ZIVID_CORE_EXPORT void Zivid::Projection::ProjectedImage::stop | ( | ) |
Stops the ongoing image projection.
ZIVID_CORE_EXPORT std::string Zivid::Projection::ProjectedImage::toString | ( | ) | const |
Get string representation of the projected image.