Rerun C++ SDK
Loading...
Searching...
No Matches
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::Position3Dpositions
 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

image

#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));
}
A RecordingStream handles everything related to logging data into Rerun.
Definition recording_stream.hpp:57
Archetype: A 3D point cloud with positions and optional colors, radii, labels, etc.
Definition points3d.hpp:67
Points3D with_radii(Collection< rerun::components::Radius > _radii) &&
Optional radii for the points, effectively turning them into circles.
Definition points3d.hpp:112
std::optional< Collection< rerun::components::Radius > > radii
Optional radii for the points, effectively turning them into circles.
Definition points3d.hpp:72
Points3D with_colors(Collection< rerun::components::Color > _colors) &&
Optional colors for the points.
Definition points3d.hpp:119
std::optional< Collection< rerun::components::Color > > colors
Optional colors for the points.
Definition points3d.hpp:75

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: