Skip to content

Commit

Permalink
Update repository post 0.10.0 release (#4086)
Browse files Browse the repository at this point in the history
### What
* Part of #3962

### Checklist
* [x] I have read and agree to [Contributor
Guide](https://github.com/rerun-io/rerun/blob/main/CONTRIBUTING.md) and
the [Code of
Conduct](https://github.com/rerun-io/rerun/blob/main/CODE_OF_CONDUCT.md)
* [x] I've included a screenshot or gif (if applicable)
* [x] I have tested [demo.rerun.io](https://demo.rerun.io/pr/4086) (if
applicable)
* [x] The PR title and labels are set such as to maximize their
usefulness for the next release's CHANGELOG

- [PR Build Summary](https://build.rerun.io/pr/4086)
- [Docs
preview](https://rerun.io/preview/a05da824b65bd0dc06746f46b8e4dca78d8d1f7e/docs)
<!--DOCS-PREVIEW-->
- [Examples
preview](https://rerun.io/preview/a05da824b65bd0dc06746f46b8e4dca78d8d1f7e/examples)
<!--EXAMPLES-PREVIEW-->
- [Recent benchmark results](https://ref.rerun.io/dev/bench/)
- [Wasm size tracking](https://ref.rerun.io/dev/sizes/)

---------

Co-authored-by: Emil Ernerfeldt <[email protected]>
  • Loading branch information
nikolausWest and emilk authored Oct 30, 2023
1 parent 39d4bef commit cc58a81
Show file tree
Hide file tree
Showing 14 changed files with 28 additions and 20 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/documentation.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@ jobs:
paths: "**/*.c, **/*.cpp, **/*.fbs, **/*.h, **/*.hpp, **/*.js, **/*.md, **/*.py, **/*.rs, **/*.sh, **/*.toml, **/*.txt, **/*.wgsl, **/*.yml"

# Avoid crates.io rate-limiting, skip changelog PR links (so many), and skip speculative links
# https://rerun-io.github.io/rerun/dev/bench/ often 404:s for unknown reasons
linksToSkip: "https://crates.io/crates/.*, https://github.com/rerun-io/rerun/pull/.*, .*?speculative-link, https://www.rerun.io/docs/getting-started/installing-viewer, https://www.rerun.io/docs/howto/arrow-cpp-install, https://rerun-io.github.io/rerun/dev/bench/"
# TODO(##4085): https://rerun-io.github.io/rerun/dev/bench/ often 404:s for unknown reasons
linksToSkip: "https://crates.io/crates/.*, https://github.com/rerun-io/rerun/pull/.*, .*?speculative-link, https://rerun-io.github.io/rerun/dev/bench/"
retry: true
retryErrors: true
retryErrorsCount: 5
Expand Down
13 changes: 12 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,21 @@

* Python: `pip install rerun-sdk`
* Rust: `cargo add rerun` and `cargo install rerun-cli`
* Online demo: <https://app.rerun.io/version/0.9.1/>
* Online demo: <https://app.rerun.io/version/0.10.0/>

### Overview & Highlights
* The C++ SDK is finally here!
```cpp
#include <rerun.hpp>

int main() {
const auto rec = rerun::RecordingStream("rerun_example_points3d_simple");
rec.spawn().exit_on_failure();

rec.log("points", rerun::Points3D({{0.0f, 0.0f, 0.0f}, {1.0f, 1.0f, 1.0f}}));
}
```
* Add an integrated getting-started guide into the viewer splash screen
* Add a new and improved `spawn` method in the Rust SDK
* Add support for NV12-encoded images [#3541](https://github.com/rerun-io/rerun/pull/3541) (thanks [@zrezke](https://github.com/zrezke)!)
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

# Build time aware visualizations of multimodal data

Use the Rerun SDK (available in Python, Rust, and soon C++) to log data like images, tensors, point clouds, and text. Logs are streamed to the Rerun Viewer for live visualization or to file for later use.
Use the Rerun SDK (available in Python, Rust, and C++) to log data like images, tensors, point clouds, and text. Logs are streamed to the Rerun Viewer for live visualization or to file for later use.

```py
import rerun as rr # pip install rerun-sdk
Expand Down Expand Up @@ -46,7 +46,7 @@ rr.log("path/to/points", rr.Points3D(positions, colors=colors))
## Getting started
* **Python**: `pip install rerun-sdk` or on [`conda`](https://github.com/conda-forge/rerun-sdk-feedstock)
* **Rust**: `cargo add rerun`
* **C / C++**: [Coming soon](https://github.com/rerun-io/rerun/issues/2919)
* **C++**: [Guide](https://www.rerun.io/docs/getting-started/cpp)

### Rerun Viewer binary
Both the Python and Rust library can start the Rerun Viewer, but to stream log data over the network or load our `.rrd` data files you also need the `rerun` binary.
Expand Down
3 changes: 1 addition & 2 deletions crates/re_types/definitions/rerun/datatypes/uint32.fbs
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,7 @@ struct UInt32 (
"attr.arrow.transparent",
"attr.rust.derive": "Copy, PartialEq, Eq, PartialOrd, Ord",
"attr.rust.override_crate": "re_types_core",
"attr.rust.tuple_struct",
"attr.docs.unreleased"
"attr.rust.tuple_struct"
) {
value: uint32 (order: 100);
}
2 changes: 1 addition & 1 deletion docs/code-examples/roundtrips.py
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
# for one or more specific SDKs.
opt_out_run = {
"any_values": ["cpp", "rust"], # Not yet implemented
"custom_data": ["cpp"], # TODO(#2919): Not yet implemented in C++
"custom_data": ["cpp"], # TODO(emilk): Not yet implemented in C++
"extra_values": ["cpp", "rust"], # Missing examples
"image_advanced": ["cpp", "rust"], # Missing examples
"log_line": ["cpp", "rust", "py"], # Not a complete example -- just a single log line
Expand Down
2 changes: 1 addition & 1 deletion docs/content/getting-started/logging-cpp.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ In a few lines of code, we'll go from a blank sheet to something you don't see e
This guide aims to go wide instead of deep.
There are links to other doc pages where you can learn more about specific topics.

At any time, you can checkout the complete code listing for this tutorial [here](https://github.com/rerun-io/rerun/tree/latest/examples/cpp/dna/main.cpp?speculative-link) to better keep track of the overall picture.
At any time, you can checkout the complete code listing for this tutorial [here](https://github.com/rerun-io/rerun/tree/latest/examples/cpp/dna/main.cpp) to better keep track of the overall picture.
To build the example from the repository, run:

```bash
Expand Down
2 changes: 1 addition & 1 deletion docs/content/getting-started/logging-rust.md
Original file line number Diff line number Diff line change
Expand Up @@ -333,7 +333,7 @@ You can also save a recording (or a portion of it) as you're visualizing it, dir

### Spawning the Viewer from your process

If the Rerun Viewer is [installed](installing-viewer.md) and available in your `PATH`, you can use [`RecordingStream::spawn`](https://docs.rs/rerun/latest/rerun/struct.RecordingStream.html#method.spawn?speculative-link) to automatically start a viewer in a new process and connect to it over TCP.
If the Rerun Viewer is [installed](installing-viewer.md) and available in your `PATH`, you can use [`RecordingStream::spawn`](https://docs.rs/rerun/latest/rerun/struct.RecordingStream.html#method.spawn) to automatically start a viewer in a new process and connect to it over TCP.
If an external viewer was already running, `spawn` will connect to that one instead of spawning a new one.

```rust
Expand Down
3 changes: 1 addition & 2 deletions docs/content/howto/cpp-custom-component-batch-adapter.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: C++ Custom Component Batch Adapter
order: 7
# TODO(#3962): update link
redirect: https://github.com/rerun-io/rerun/blob/6b2cf6dbf29124a10f2fc909e02f5fee7cbd0cbe/examples/cpp/custom_component_adapter/README.md
redirect: https://github.com/rerun-io/rerun/blob/latest/examples/cpp/custom_component_adapter/README.md
---
2 changes: 1 addition & 1 deletion docs/content/reference/sdk-operating-modes.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Call [`rr.spawn`](https://ref.rerun.io/docs/python/stable/common/initialization_

#### Rust

[`RecordingStream::spawn`](https://docs.rs/rerun/latest/rerun/struct.RecordingStream.html#method.spawn?speculative-link) spawns a new Rerun Viewer process using an executable available in your PATH, then streams all the data to it via TCP. If an external viewer was already running, `spawn` will connect to that one instead of spawning a new one.
[`RecordingStream::spawn`](https://docs.rs/rerun/latest/rerun/struct.RecordingStream.html#method.spawn) spawns a new Rerun Viewer process using an executable available in your PATH, then streams all the data to it via TCP. If an external viewer was already running, `spawn` will connect to that one instead of spawning a new one.

#### C++

Expand Down
4 changes: 2 additions & 2 deletions docs/content/reference/types/datatypes/uint32.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion examples/cpp/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Rerun C++ Examples
The simplest example is [`minimal`](minimal/main.cpp). You may want to start there
using the accompanying [`C++ Quick Start`](https://www.rerun.io/docs/getting-started/cpp?speculative-link) guide.
using the accompanying [`C++ Quick Start`](https://www.rerun.io/docs/getting-started/cpp) guide.

## Build all examples
The CMake target `examples` is a convenient alias for building all CMake examples in one go.
Expand Down
3 changes: 1 addition & 2 deletions examples/cpp/minimal/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,7 @@ thumbnail: https://static.rerun.io/minimal/0e47ac513ab25d56cf2b493128097d499a07e
</picture>

The simplest example of how to use Rerun, showing how to log a point cloud.
# TODO(#3962): Update Link to C++
This is part of the [Quick Start guide](https://www.rerun.io/docs/getting-started/rust).
This is part of the [Quick Start guide](https://www.rerun.io/docs/getting-started/cpp).

To build it from a checkout of the repository (requires a Rust toolchain):
```bash
Expand Down
2 changes: 1 addition & 1 deletion rerun_cpp/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Rerun C++ SDK

Read our [getting-started guide](https://www.rerun.io/docs/getting-started/cpp?speculative-link) for information on how to use the Rerun C++ SDK.
Read our [getting-started guide](https://www.rerun.io/docs/getting-started/cpp) for information on how to use the Rerun C++ SDK.

## Development
### Requirements
Expand Down
2 changes: 1 addition & 1 deletion rerun_cpp/src/rerun.hpp
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
// The Rerun C++ SDK.
//
// For more information, read our [getting-started guide](https://www.rerun.io/docs/getting-started/cpp?speculative-link)
// For more information, read our [getting-started guide](https://www.rerun.io/docs/getting-started/cpp)
// or visit <https://www.rerun.io/>.

#pragma once
Expand Down

0 comments on commit cc58a81

Please sign in to comment.