rerun::archetypes::Points3D Struct Reference

Archetype: A 3D point cloud with positions and optional colors, radii, labels, etc. More...

#include <rerun/archetypes/points3d.hpp>

Public Types
using	IndicatorComponent = components::IndicatorComponent< IndicatorComponentName >
	Indicator component, used to identify the archetype when converting to a list of components.

Public Member Functions
	Points3D (Points3D &&other)=default
	Points3D (Collection< rerun::components::Position3D > _positions)
Points3D	with_radii (Collection< rerun::components::Radius > _radii) &&
	Optional radii for the points, effectively turning them into circles.
Points3D	with_colors (Collection< rerun::components::Color > _colors) &&
	Optional colors for the points.
Points3D	with_labels (Collection< rerun::components::Text > _labels) &&
	Optional text labels for the points.
Points3D	with_class_ids (Collection< rerun::components::ClassId > _class_ids) &&
	Optional class Ids for the points.
Points3D	with_keypoint_ids (Collection< rerun::components::KeypointId > _keypoint_ids) &&
	Optional keypoint IDs for the points, identifying them within a class.
Points3D	with_instance_keys (Collection< rerun::components::InstanceKey > _instance_keys) &&
	Unique identifiers for each individual point in the batch.
size_t	num_instances () const
	Returns the number of primary instances of this archetype.

Public Attributes
Collection< rerun::components::Position3D >	positions
	All the 3D positions at which the point cloud shows points.
std::optional< Collection< rerun::components::Radius > >	radii
	Optional radii for the points, effectively turning them into circles.
std::optional< Collection< rerun::components::Color > >	colors
	Optional colors for the points.
std::optional< Collection< rerun::components::Text > >	labels
	Optional text labels for the points.
std::optional< Collection< rerun::components::ClassId > >	class_ids
	Optional class Ids for the points.
std::optional< Collection< rerun::components::KeypointId > >	keypoint_ids
	Optional keypoint IDs for the points, identifying them within a class.
std::optional< Collection< rerun::components::InstanceKey > >	instance_keys
	Unique identifiers for each individual point in the batch.

Static Public Attributes
static constexpr const char	IndicatorComponentName [] = "rerun.components.Points3DIndicator"

Detailed Description

Archetype: A 3D point cloud with positions and optional colors, radii, labels, etc.

Example

Randomly distributed 3D points with varying color and radius

#include <rerun.hpp>
 
#include <algorithm>
#include <random>
#include <vector>
 
int main() {
    const auto rec = rerun::RecordingStream("rerun_example_points3d_random");
    rec.spawn().exit_on_failure();
 
    std::default_random_engine gen;
    std::uniform_real_distribution<float> dist_pos(-5.0f, 5.0f);
    std::uniform_real_distribution<float> dist_radius(0.1f, 1.0f);
    // On MSVC uint8_t distributions are not supported.
    std::uniform_int_distribution<int> dist_color(0, 255);
 
    std::vector<rerun::Position3D> points3d(10);
    std::generate(points3d.begin(), points3d.end(), [&] {
        return rerun::Position3D(dist_pos(gen), dist_pos(gen), dist_pos(gen));
    });
    std::vector<rerun::Color> colors(10);
    std::generate(colors.begin(), colors.end(), [&] {
        return rerun::Color(
            static_cast<uint8_t>(dist_color(gen)),
            static_cast<uint8_t>(dist_color(gen)),
            static_cast<uint8_t>(dist_color(gen))
        );
    });
    std::vector<rerun::Radius> radii(10);
    std::generate(radii.begin(), radii.end(), [&] { return dist_radius(gen); });
 
    rec.log("random", rerun::Points3D(points3d).with_colors(colors).with_radii(radii));
}

Member Function Documentation

with_class_ids()

Points3D rerun::archetypes::Points3D::with_class_ids ( Collection< rerun::components::ClassId >  _class_ids ) &&

inline

Optional class Ids for the points.

The class ID provides colors and labels if not specified explicitly.

with_keypoint_ids()

Points3D rerun::archetypes::Points3D::with_keypoint_ids ( Collection< rerun::components::KeypointId >  _keypoint_ids ) &&

inline

Optional keypoint IDs for the points, identifying them within a class.

If keypoint IDs are passed in but no class IDs were specified, the class ID will default to 0. This is useful to identify points within a single classification (which is identified with class_id). E.g. the classification might be 'Person' and the keypoints refer to joints on a detected skeleton.

Member Data Documentation

class_ids

std::optional<Collection<rerun::components::ClassId> > rerun::archetypes::Points3D::class_ids

Optional class Ids for the points.

The class ID provides colors and labels if not specified explicitly.

keypoint_ids

std::optional<Collection<rerun::components::KeypointId> > rerun::archetypes::Points3D::keypoint_ids

Optional keypoint IDs for the points, identifying them within a class.

If keypoint IDs are passed in but no class IDs were specified, the class ID will default to 0. This is useful to identify points within a single classification (which is identified with class_id). E.g. the classification might be 'Person' and the keypoints refer to joints on a detected skeleton.

---

The documentation for this struct was generated from the following file:

• rerun/archetypes/points3d.hpp