Cargo Features
[dependencies]
rerun = { version = "0.30.0-alpha.4", default-features = false, features = ["auth", "analytics", "clap", "data_loaders", "dataframe", "demo", "ecolor", "glam", "image", "log", "map_view", "mint", "nasm", "native_viewer", "oss_server", "perf_telemetry", "perf_telemetry_tracy", "run", "sdk", "server", "web_viewer"] }
- default = analytics, data_loaders, dataframe, demo, glam, image, log, map_view, sdk, server
-
These default features are set whenever
rerunis added withoutsomewhere in the dependency tree.default-features = false - auth run?
-
Support the
rerun authcommand - analytics default
-
Enable anonymized telemetry using our analytics SDK.
Enables analytics of optional re_crash_handler, optional re_viewer, and optional re_web_viewer_server and re_analytics
Optional dependencies:
- clap run?
-
Integration with
clap.Enables clap
Affects
rerun::clap… - data_loaders default
-
Support for using Rerun's data-loaders directly from the SDK.
See our
log_fileexample and https://www.rerun.io/docs/reference/data-loaders/overview for more information.Enables re_mcap, data_loaders of optional re_sdk
- dataframe default
-
Access to Rerun's dataframe API and related types.
Enables re_dataframe
Affects
rerun::dataframe… - demo default
-
Demo helpers for examples.
Affects
rerun::demo_util… - ecolor
-
Integration with the
ecolorcrate.Enables ecolor of optional re_sdk_types
- glam default
-
Add support for some math operations using
glam. Only relevant if featuresdkis enabled.Enables glam of re_byte_size and optional re_sdk_types
Affects
demo_util::grid,demo_util::color_spiral… - image default
-
Integration with the
imagecrate, plus JPEG support.Enables image of optional re_sdk_types
- log default
-
Integration with the
logcrate.Enables env_filter ^0.1.3 and log
Affects
rerun::log_integration… - map_view default
-
Support the map view.
This adds a lot of extra dependencies. - mint
-
Add support for math type conversions using
mint. Only relevant if featuresdkis enabled.Enables mint of optional re_sdk_types
- nasm
-
Enable faster native video decoding with assembly. You need to install nasm to compile with this feature.
- native_viewer
-
Support spawning a native viewer and allow to extend the viewer.
This adds a lot of extra dependencies, so only enable this feature if you need it!Enables re_crash_handler and re_viewer
Affects
rerun::native_viewer… - oss_server
-
Enable the in-memory Rerun Server, useful for testing.
Enables re_server
- perf_telemetry perf_telemetry_tracy?
-
Enables integration with
re_perf_telemetry(OpenTelemetry, Jaeger).This only works on native, and only with
TELEMETRY_ENABLEDset.Enables re_perf_telemetry, perf_telemetry of re_redap_client and optional re_viewer
- perf_telemetry_tracy = perf_telemetry
-
Enables Tracy profiler integration on top of
perf_telemetry.This only works on native.
Enables tracy of re_perf_telemetry
- run = auth, clap, sdk, unindent
-
Add support for the [
run()] function, which acts like a main-function for a CLI, acting the same as thererunbinary.Enables re_chunk_store, re_crash_handler, and re_data_source, decoder and encoder of re_log_encoding
- sdk default run?
-
Embed the Rerun SDK & built-in types and re-export all of their public symbols.
Enables re_sdk and re_sdk_types
Affects
rerun::native_viewer… - server default web_viewer?
-
Support for running a gRPC server that listens to incoming log messages from a Rerun SDK.
Enables re_grpc_server, server of re_sdk, signal of tokio
- web_viewer = server
-
Support serving a web viewer over HTTP.
Enabling this inflates the binary size quite a bit, since it embeds the viewer wasm.
For faster & easier builds, a pre-built web-views comes bundled with the crate as a Wasm binary.
Enabling this feature will embed this pre-built web viewer.
However, when building from source in the repository, this feature adds quite a bit to the compile time since it requires compiling and bundling the viewer as wasm.Enables re_web_viewer_server, web_viewer of optional re_sdk
Features from optional dependencies
In crates that don't use the dep: syntax, optional dependencies automatically become Cargo features. These features may have been created by mistake, and this functionality may be removed in the future.