点云结构和输出格式

有序点云 

Zivid输出的是结构点云，这意味着点云被放置为类似于图像结构的2D点阵列。无结构点云通常被存储在一个一维数组中的点列表中。以上两种情况下每个点均包含了XYZ数据以及RGB值。

这种结构有几个优点。

为无结构点云设计的算法也可以用于结构点云，因为2D数组可以看做1D数组。而相反情况并不总是正确的。

有序点云在2D图像（颜色和深度）中的像素与点云中的3D点之间具有1：1的相关性。这意味着图像中的相邻像素是点云中的相邻点。这使得2D操作和算法能够应用于2D图像，而结果可以直接应用于点云。例如，对物体的检测和分割，可以分割2D图像并直接从所需像素中提取3D点。

点的有序性加快了计算并降低了某些算法的消耗，尤其是使用相邻点的操作。

Zivid点云 

Zivid相机使用2.3MP (Zivid One+：1920 x 1200，Zivid Two：1944 x 1200) 来捕获场景的点云。

有多种方法可以从SDK获取分辨率。

C++

const auto cameraInfo = camera.info();

auto defaultSettings = Zivid::Experimental::SettingsInfo::defaultValue<Zivid::Settings>(cameraInfo);
defaultSettings.acquisitions().emplaceBack(
    Zivid::Experimental::SettingsInfo::defaultValue<Zivid::Settings::Acquisition>(cameraInfo));

std::cout << "Camera resolution for default settings:" << std::endl;
const auto resolution = Zivid::Experimental::SettingsInfo::resolution(cameraInfo, defaultSettings);
std::cout << "Height: " << resolution.height() << std::endl;
std::cout << "Width: " << resolution.width() << std::endl;

std::cout << "Point cloud (GPU memory) resolution:" << std::endl;
const auto pointCloud = camera.capture(defaultSettings).pointCloud();
std::cout << "Height: " << pointCloud.height() << std::endl;
std::cout << "Width: " << pointCloud.width() << std::endl;

std::cout << "Point cloud (CPU memory) resolution:" << std::endl;
const auto data = pointCloud.copyPointsXYZColorsRGBA();
std::cout << "Height: " << data.height() << std::endl;
std::cout << "Width: " << data.width() << std::endl;

生成的点云由230万个点组成。由于像素和点之间存在1:1的相关性，因此可以获得每个像素的XYZ（mm）、RGB（8 位）和SNR，其中SNR是信噪比。在GPU内部，3D坐标、颜色值和SNR值分别存储在单独的2D数组中，存储Zivid One+数据的数组大小为 1920 x 1200，Zivid Two为 1944 x 1200。在用户端（CPU内存），数据可以以不同的格式存储，具体取决于请求的方式。查看点云教程了解详细解释。

颜色和深度图像可以直接从Zivid点云中提取。您可以从 GitHub repository 中找到相关示例。

Zivid输出格式 

在ZividStudio中，您可以将点云保存在Zivid数据文件（*.zdf）中。此外，您也可以将点云导出（File → Export）为以下格式：

PLY file - Unordered points (*.ply)

PLY file - Ordered points (*.ply)

ASCII points (*.xyz)

Point Cloud Data File - Unordered points (*.pcd)。也可配置为导出有序的点数据，有关如何将PCD导出为有序点的教程，请参阅结构PCD格式。

Zivid数据文件 (*.zdf) 是原生的Zivid文件格式。如果您使用API，您可以遍历点云并以您喜欢的任何格式保存X、Y、Z、R、G、B和SNR数据。查看我们的示例来了解如何使用 C++ 、 C# 、 Python 和 MATLAB 读取或转换Zivid数据。

小技巧

查看Zivid点云的最简单方法是将ZDF文件复制到您的PC上，并使用 Zivid Studio 来查看点云。或者您也可以使用API将ZDF转换为PLY（或使用我们的 Python script ），然后使用3D查看器来勘察，例如 MeshLab 或者 CloudCompare。

配置文件包含以下信息：

__version__:
    serializer: 1
    data: 12
Configuration:
    APIBreakingBugFixes:
        FileFormats:
            PCD:
                UseOrganizedFormat: yes

将配置文件放在以下目录中：

Windows

mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Config.yml %LOCALAPPDATA%\Zivid\API\

Ubuntu

mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Config.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/

提示

此解决方法也适用于从Zivid Studio导出PCD。

小心

Zivid配置文件必须使用.yml文件扩展名（而不是.yaml）。

点云结构和输出格式

有序点云 

Zivid点云 

Zivid输出格式 

ASCII points (*.xyz)

PLY file (*.ply)

Point Cloud Data file (*.pcd)

结构PCD格式 

点云结构和输出格式

有序点云

Zivid点云

Zivid输出格式

ASCII points (*.xyz)

PLY file (*.ply)

Point Cloud Data file (*.pcd)

结构PCD格式

有序点云 

Zivid点云 

Zivid输出格式 

结构PCD格式 