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 = rerun::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.

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.

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.

Examples

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));
}

Log points with radii given in UI points

#include <rerun.hpp>
 
int main() {
    const auto rec = rerun::RecordingStream("rerun_example_points3d_ui_radius");
    rec.spawn().exit_on_failure();
 
    // Two blue points with scene unit radii of 0.1 and 0.3.
    rec.log(
        "scene_units",
        rerun::Points3D({{0.0f, 1.0f, 0.0f}, {1.0f, 1.0f, 1.0f}})
            // By default, radii are interpreted as world-space units.
            .with_radii({0.1f, 0.3f})
            .with_colors(rerun::Color(0, 0, 255))
    );
 
    // Two red points with ui point radii of 40 and 60.
    // UI points are independent of zooming in Views, but are sensitive to the application UI scaling.
    // For 100% ui scaling, UI points are equal to pixels.
    rec.log(
        "ui_points",
        rerun::Points3D({{0.0f, 0.0f, 0.0f}, {1.0f, 0.0f, 1.0f}})
            // rerun::Radius::ui_points produces radii that the viewer interprets as given in ui points.
            .with_radii({
                rerun::Radius::ui_points(40.0f),
                rerun::Radius::ui_points(60.0f),
            })
            .with_colors(rerun::Color(255, 0, 0))
    );
}

Member Function Documentation

with_labels()

Points3D rerun::archetypes::Points3D::with_labels ( Collection< rerun::components::Text >  _labels ) &&

inline

Optional text labels for the points.

If there's a single label present, it will be placed at the center of the entity. Otherwise, each instance will have its own label.

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

labels

std::optional<Collection<rerun::components::Text> > rerun::archetypes::Points3D::labels

Optional text labels for the points.

If there's a single label present, it will be placed at the center of the entity. Otherwise, each instance will have its own label.

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