Files
rerun-io--rerun/examples/cpp/incremental_logging/main.cpp
T
2026-07-13 13:05:14 +08:00

73 lines
2.5 KiB
C++

// Showcase how to incrementally log data belonging to the same archetype, and re-use some or all
// of it across frames.
#include <rerun.hpp>
#include <algorithm>
#include <random>
static const char* README = R"(
# Incremental Logging
This example showcases how to incrementally log data belonging to the same archetype, and re-use some or all of it across frames.
It was logged with the following code:
```cpp
std::vector<rerun::Color> colors(10, rerun::Color(255, 0, 0));
std::vector<rerun::Radius> radii(10, rerun::Radius(0.1f));
// Only log colors and radii once.
rec.set_time_sequence("frame_nr", 0);
rec.log("points", colors, radii);
std::default_random_engine gen;
std::uniform_real_distribution<float> dist_pos(-5.0f, 5.0f);
// Then log only the points themselves each frame.
//
// They will automatically re-use the colors and radii logged at the beginning.
for (int i = 0; i < 10; ++i) {
rec.set_time_sequence("frame_nr", i);
std::vector<rerun::Position3D> points(10);
std::generate(points.begin(), points.end(), [&] {
return rerun::Position3D(dist_pos(gen), dist_pos(gen), dist_pos(gen));
});
rec.log("points", rerun::Points3D(points));
}
```
Move the time cursor around, and notice how the colors and radii from frame 0 are still picked up by later frames, while the points themselves keep changing every frame.
)";
int main() {
const auto rec = rerun::RecordingStream("rerun_example_incremental_logging");
rec.spawn().exit_on_failure();
rec.log_static(
"readme",
rerun::TextDocument(README).with_media_type(rerun::components::MediaType::markdown())
);
// Only log colors and radii once.
// Logging statically with `RecordingStream::log_static` would also work.
rec.set_time_sequence("frame_nr", 0);
rec.log("points", rerun::Points3D().with_colors(rerun::Color(255, 0, 0)).with_radii(0.1f));
std::default_random_engine gen;
std::uniform_real_distribution<float> dist_pos(-5.0f, 5.0f);
// Then log only the points themselves each frame.
//
// They will automatically re-use the colors and radii logged at the beginning.
for (int i = 0; i < 10; ++i) {
rec.set_time_sequence("frame_nr", i);
std::vector<rerun::Position3D> points(10);
std::generate(points.begin(), points.end(), [&] {
return rerun::Position3D(dist_pos(gen), dist_pos(gen), dist_pos(gen));
});
rec.log("points", rerun::Points3D::update_fields().with_positions(points));
}
}