ProjectedImageCapture Method |
Capture a single 2D frame without stopping the ongoing image projection
Namespace:
Zivid.NET.Projection
Assembly:
ZividCoreNET (in ZividCoreNET.dll) Version: 2.16.0.0
Syntaxpublic Frame2D Capture(
Settings2D settings2D
)
Public Function Capture (
settings2D As Settings2D
) As Frame2D
public:
Frame2D^ Capture(
Settings2D^ settings2D
)
Parameters
- settings2D
- Type: Zivid.NETSettings2D
Settings2D to use for the capture
Return Value
Type:
Frame2DA frame containing a 2D image and metadata
Remarks
This method is deprecated and will be removed in the next SDK major release (3.0). It is replaced by
Capture2D(Settings2D).
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.
See Also