1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! Showcase how to incrementally log data belonging to the same archetype, and re-use some or all
//! of it across frames.
//!
//! Usage:
//! ```
//! cargo run -p incremental -- --help
//! ```

use rand::{distributions::Uniform, Rng as _};
use rerun::external::re_log;

#[derive(Debug, clap::Parser)]
#[clap(author, version, about)]
struct Args {
    #[command(flatten)]
    rerun: rerun::clap::RerunArgs,
}

fn main() -> anyhow::Result<()> {
    re_log::setup_logging();

    use clap::Parser as _;
    let args = Args::parse();

    let (rec, _serve_guard) = args.rerun.init("rerun_example_incremental_logging")?;
    run(&rec)
}

const README: &str = 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:
```rust
// Only log colors and radii once.
// Logging statically would also work (i.e. `log_static`).
rec.set_time_sequence("frame_nr", 0);
rec.log(
    "points",
    &rerun::Points3D::update_fields()
        .with_colors([(255, 0, 0)])
        .with_radii([0.1]),
)?;

let mut rng = rand::thread_rng();
let dist = Uniform::new(-5., 5.);

// Then log only the points themselves each frame.
//
// They will automatically re-use the colors and radii logged at the beginning.
for i in 0..10 {
    rec.set_time_sequence("frame_nr", i);

    rec.log(
        "points",
        &rerun::Points3D::update_fields().with_positions(
            (0..10).map(|_| (rng.sample(dist), rng.sample(dist), rng.sample(dist))),
        ),
    )?;
}
```

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.
"#;

fn run(rec: &rerun::RecordingStream) -> anyhow::Result<()> {
    rec.log_static("readme", &rerun::TextDocument::from_markdown(README))?;

    // Only log colors and radii once.
    // Logging statically would also work (i.e. `log_static`).
    rec.set_time_sequence("frame_nr", 0);
    rec.log(
        "points",
        &rerun::Points3D::update_fields()
            .with_colors([(255, 0, 0)])
            .with_radii([0.1]),
    )?;

    let mut rng = rand::thread_rng();
    let dist = Uniform::new(-5., 5.);

    // Then log only the points themselves each frame.
    //
    // They will automatically re-use the colors and radii logged at the beginning.
    for i in 0..10 {
        rec.set_time_sequence("frame_nr", i);

        rec.log(
            "points",
            &rerun::Points3D::update_fields().with_positions(
                (0..10).map(|_| (rng.sample(dist), rng.sample(dist), rng.sample(dist))),
            ),
        )?;
    }

    Ok(())
}