2D Image Capture Process

The 2D capture API returns when the acquisition is done.

C++

source

const auto frame2D = camera.capture2D(settings);

C#

source

using (var frame2D = camera.Capture2D(settings))

Python

source

with camera.capture_2d(settings) as frame_2d:

The method to get the image from the Frame2D object returns after the 2D image is available in CPU memory. This function call blocks until processing and copying are finished. The image object holds a handle to the image data in CPU memory.

Tip

Use recommended hardware to minimize 2D image processing time.

C++

source

const auto imageSRGB = frame2D.imageSRGB();

C#

source

var imageSRGB = frame2D.ImageSRGB();

Python

source

image_srgb = frame_2d.image_srgb()

It is possible to get the image in different color spaces, as linear RGB (BGRA and RGBA) and sRGB (SRGB). For more information, see 2D Color Spaces and Output Formats.

Note

In C++ and C#, class Zivid::Image inherits from Zivid::Array2D and provides, in addition, a method to save the image in PNG file format.

When the image is available on the CPU memory, we can utilize it in our machine vision application or save it to disk.

C++

source

const auto imageFile = "ImageSRGB.png";
std::cout << "Saving 2D color image (sRGB color space) to file: " << imageFile << std::endl;
imageSRGB.save(imageFile);

C#

source

var imageFile = "ImageSRGB.png";
Console.WriteLine("Saving 2D color image (sRGB color space) to file: " + imageFile);
imageSRGB.Save(imageFile);

Python

source

image_file = "ImageSRGB.png"
print(f"Saving 2D color image (sRGB color space) to file: {image_file}")
image_srgb.save(image_file)

Tip

For optimized timing, move the robot or move the objects in the scene after the 2D capture API returns. This has to happen before or at the same time when calling the API to get the image from the Frame2D object.

Version History

SDK	Changes
2.12.0	2D acquisition time on Zivid 2+ is reduced by up to 50%.
2.11.0	Added support for SRGB color space.
2.9.0	Capture function returns when the acquisition is done and improved capture speed.
2.8.0	Improved capture speed of Zivid 2.