捕获教程

介绍 

要使用 Zivid 相机捕获点云或 2D 图像：初始化 Zivid 应用程序、连接相机、配置捕获设置，然后捕获并保存结果。

有关相应的 API，请参阅 Camera Basic。

先决条件

安装 Zivid 软件。
对于 Python：安装 zivid-python

初始化 

调用 Zivid SDK 中的任何 API 都需要初始化 Zivid application 并在程序运行时使其保持活动状态。

备注

Application 必须在操作 Zivid 相机时保持活动状态。这本质上是 Zivid 的驱动程序。

C++

Zivid::Application zivid;

C＃

var zivid = new Zivid.NET.Application();

Python

app = zivid.Application()

文件相机 

借助文件相机，您可以在没有物理相机的情况下体验 SDK。文件相机可以在 Sample Data（示例数据）中找到，其中有多个文件相机可供选择。

C++

const auto fileCamera =
    userInput ? fileCameraPath : std::string(ZIVID_SAMPLE_DATA_DIR) + "/FileCameraZivid2PlusMR60.zfc";

C＃

fileCamera = Environment.GetFolderPath(Environment.SpecialFolder.CommonApplicationData) + "/Zivid/FileCameraZivid2PlusMR60.zfc";

Python

default=get_sample_data_path() / "FileCameraZivid2PlusMR60.zfc",

C++

std::cout << "Creating virtual camera using file: " << fileCamera << std::endl;
auto camera = zivid.createFileCamera(fileCamera);

C＃

Console.WriteLine("Creating virtual camera using file: " + fileCamera);
var camera = zivid.CreateFileCamera(fileCamera);

Python

print(f"Creating virtual camera using file: {file_camera}")
camera = app.create_file_camera(file_camera)

采集设置必须按照后续示例中所示进行初始化，但您可以自由更改处理设置。

C++

std::cout << "Configuring settings" << std::endl;
Zivid::Settings settings{
    Zivid::Settings::Acquisitions{ Zivid::Settings::Acquisition{} },
    Zivid::Settings::Processing::Filters::Smoothing::Gaussian::Enabled::yes,
    Zivid::Settings::Processing::Filters::Smoothing::Gaussian::Sigma{ 1.5 },
    Zivid::Settings::Processing::Filters::Reflection::Removal::Enabled::yes,
    Zivid::Settings::Processing::Filters::Reflection::Removal::Mode::global,
};
settings.set(
    Zivid::Settings::RegionOfInterest::Box{
        Zivid::Settings::RegionOfInterest::Box::Enabled::yes,
        Zivid::Settings::RegionOfInterest::Box::PointO{ { -266, 190, 771 } },
        Zivid::Settings::RegionOfInterest::Box::PointA{ { 203, 207, 771 } },
        Zivid::Settings::RegionOfInterest::Box::PointB{ { -255, -131, 771 } },
        Zivid::Settings::RegionOfInterest::Box::Extents{ 0, 298 } });

Zivid::Settings2D settings2D{ Zivid::Settings2D::Acquisitions{ Zivid::Settings2D::Acquisition{} } };
settings.color() = Zivid::Settings::Color{ settings2D };

C＃

Console.WriteLine("Configuring settings");
var settings2D = new Zivid.NET.Settings2D
{
    Acquisitions = { new Zivid.NET.Settings2D.Acquisition { } }
};
var settings = new Zivid.NET.Settings
{
    Acquisitions = { new Zivid.NET.Settings.Acquisition { } },
    Processing =
    {
        Filters =
        {
            Smoothing =
            {
                Gaussian = { Enabled = true, Sigma = 1.5 }
            },
            Reflection =
            {
                Removal = { Enabled = true, Mode = ReflectionFilterModeOption.Global}
            }
        }
    }
};
var roiBox = new Zivid.NET.Settings.RegionOfInterestGroup.BoxGroup
{
    Enabled = true,
    PointO = new Zivid.NET.PointXYZ { x = -266, y = 190, z = 771 },
    PointA = new Zivid.NET.PointXYZ { x = 203, y = 207, z = 771 },
    PointB = new Zivid.NET.PointXYZ { x = -255, y = -131, z = 771 }
};
roiBox.Extents = new Zivid.NET.Range<double>(0, 298);
settings.RegionOfInterest.Box = roiBox;
settings.Color = settings2D;

Python

print("Configuring settings")
settings = zivid.Settings()
settings.acquisitions.append(zivid.Settings.Acquisition())
settings.processing.filters.smoothing.gaussian.enabled = True
settings.processing.filters.smoothing.gaussian.sigma = 1.5
settings.processing.filters.reflection.removal.enabled = True
settings.processing.filters.reflection.removal.mode = (
    zivid.Settings.Processing.Filters.Reflection.Removal.Mode.global_
)
settings.region_of_interest.box = zivid.Settings.RegionOfInterest.Box(
    enabled=True,
    point_o=(-266, 190, 771),
    point_a=(203, 207, 771),
    point_b=(-255, -131, 771),
    extents=(0, 298),
)
settings_2d = zivid.Settings2D()
settings_2d.acquisitions.append(zivid.Settings2D.Acquisition())
settings.color = settings_2d

您可以在 File Camera（文件相机）中阅读有关文件相机选项的更多信息。

多线程 

相机对象上的操作是线程安全的，但列出相机和连接相机等其他操作必须按顺序执行。您可以在多线程中了解更多信息。

结论 

本教程展示了如何使用 Zivid SDK 进行相机的连接、配置、捕获和保存文件。

Version History

SDK	变更
2.18.0	新增通过 IP 地址或主机名连接相机的功能。

捕获教程

介绍 

初始化 

连接 

选定相机 

配置 

Presets（预设值）

加载 

保存 

手动配置 

单次 2D 和 3D 采集 - 默认设置

多次采集 HDR

完整配置的设置

捕获 2D3D 

捕获 3D 

捕获 2D 图像 

保存 

导出 

加载 

保存 2D 图像 

Get image (Linear RGB)

Get image (sRGB)

Save image (Linear RGB)

Save image (sRGB)

文件相机 

多线程 

结论 

Version History