2D图像捕获流程

当2D图像在CPU内存中可用时， 2D捕获API会返回数据。所有的采集、处理和复制都发生在这个函数调用中。

小技巧

使用推荐的硬件来最小化2D捕获时间。

C++

const auto frame2D = camera.capture(settings2D);

C＃

using(var frame2D = camera.Capture(settings2D))

Python

with camera.capture(settings_2d) as frame_2d:

从Frame2D对象获取图像的方法会立即返回图像。图像对象持有 CPU 内存中图像数据的句柄。

C++

const auto image = frame2D.imageRGBA();

C＃

var image = frame2D.ImageRGBA();

Python

image = frame_2d.image_rgba()

备注

在C++中，类 Zivid::Image 继承自 Zivid::Array2D ，同时还提供一种将图像保存为PNG文件格式的方法。

当图像在CPU内存中可用时，我们可以在机器视觉应用程序中使用它或将其保存到磁盘。

C++

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

C＃

var imageFile = "Image.png";
Console.WriteLine("Saving 2D color image to file: {0}", imageFile);
image.Save(imageFile);

Python

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

小心

如果2D捕获的设置中亮度>0，则Zivid One+相机在更改捕获模式（2D 和 3D）时会有时间损失。您可以阅读更多相关的信息 2D和3D切换限制.

版本历史

SDK	变更
2.8.0	提升了Zivid Two的捕获速度