Point Cloud

Point clouds have all the basic properties described in Object Instructions.

Data

The point cloud object has a data property that can be updated via instructions. The provided data overrides the previous data of the point cloud.

Example:

Python

    visu = Visu(voraus_3d_visu, clear_all=True)

    points_material = visu.add_points_material(size=0.1, color=[0.882, 0.2, 1])
    point_cloud = visu.add_point_cloud(data_format="ply", material=points_material)

    with visu.connection():
        byte_data = point_cloud_path.read_bytes()
        visu.update(
            point_cloud.data(byte_data),
        )

Rust

let mut visu = Visu::new(url, false, false, true, None)?;

let points_material = visu.add_points_material(
    [0.882, 0.2, 1.0],
    PointsMaterialOptions {
        size: 0.1,
        ..Default::default()
    },
)?;
let point_cloud = visu.add_point_cloud(
    PointCloudFormat::Ply,
    PointCloudOptions {
        material: Some(points_material.identifier.clone()),
        ..Default::default()
    },
)?;

let mut connection = visu.connection()?;
let byte_data = std::fs::read(&point_cloud_0_ply)?;
connection.update(vec![point_cloud.data(&byte_data)])?;

Fig. 6 Result of the data instruction

Note

The maximum payload size for the point cloud update is 12 MB. For performance reasons, binary point cloud data is preferred over ASCII and should not exceed 1 MB. Benchmark your server and client hardware to find the optimal payload size for your use case.

Points Material

The Point Cloud object specifies the material as PointsMaterial which has the same properties as MeshStandardMaterial which are described in Geometric Primitives and in Model.