2D Image Capture Process

획득이 완료되면 2D 캡처 API가 반환됩니다.

C++

const auto frame2D = camera.capture2D(settings);

C#

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

Python

frame_2d = camera.capture_2d(settings)

Frame2D 객체에서 이미지를 가져오는 메서드는 CPU 메모리에서 2D 이미지를 사용할 수 있게 된 후에 반환됩니다. 이 함수 호출은 처리 및 복사가 완료될 때까지 차단됩니다. 이미지 개체는 CPU 메모리의 이미지 데이터에 대한 핸들을 보유합니다.

팁

recommended hardware 를 사용해서 2D 이미지 처리 시간을 최소화하십시오.

C++

const auto imageSRGB = frame2D.imageRGBA_SRGB();

C#

var imageSRGB = frame2D.ImageRGBA_SRGB();

Python

image_srgb = frame_2d.image_rgba_srgb()

Linear RGB( BGRA 및 RGBA ) 및 sRGB( SRGB )와 같이 다양한 색상 공간에서 이미지를 얻을 수 있습니다. 자세한 내용은 2D Color Spaces and Output Formats 을 참조하세요.

참고

C++ 및 C#에서 클래스 Zivid::Image 아아 Zivid::Array2D 에서 상속받고, 추가로 PNG 파일 형식으로 이미지를 저장하는 메서드를 제공합니다.

CPU 메모리에서 이미지를 사용할 수 있으면 머신 비전 애플리케이션에서 활용하거나 디스크에 저장할 수 있습니다.

C++

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

C#

var imageFile = "ImageRGBA_sRGB.png";
Console.WriteLine($"Saving 2D color image (sRGB color space) to file: {imageFile}");
imageSRGB.Save(imageFile);

Python

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

팁

타이밍을 최적화하려면 2D 캡처 API가 반환된 후 장면에서 로봇을 이동하거나 개체를 이동하십시오. 이는 Frame2D 개체에서 이미지를 가져오기 위해 API를 호출하기 전 또는 동시에 발생해야 합니다.

Version History

SDK	Changes
2.12.0	Zivid 2+에서는 2D 수집 시간이 최대 50%까지 단축됩니다.
2.11.0	SRGB 색 공간에 대한 지원이 추가되었습니다.
2.9.0	수집이 완료되면 캡처 기능이 반환되고 캡처 속도가 향상됩니다.
2.8.0	Zivid 2의 캡처 속도가 향상되었습니다.