Rerun C++ SDK
Loading...
Searching...
No Matches
plot_legend.hpp
1// DO NOT EDIT! This file was auto-generated by crates/build/re_types_builder/src/codegen/cpp/mod.rs
2// Based on "crates/store/re_types/definitions/rerun/blueprint/archetypes/plot_legend.fbs".
3
4#pragma once
5
6#include "../../blueprint/components/corner2d.hpp"
7#include "../../collection.hpp"
8#include "../../component_batch.hpp"
9#include "../../component_column.hpp"
10#include "../../components/visible.hpp"
11#include "../../indicator_component.hpp"
12#include "../../result.hpp"
13
14#include <cstdint>
15#include <optional>
16#include <utility>
17#include <vector>
18
19namespace rerun::blueprint::archetypes {
20 /// **Archetype**: Configuration for the legend of a plot.
21 ///
22 /// ⚠ **This type is _unstable_ and may change significantly in a way that the data won't be backwards compatible.**
23 ///
24 struct PlotLegend {
25 /// To what corner the legend is aligned.
26 ///
27 /// Defaults to the right bottom corner.
28 std::optional<ComponentBatch> corner;
29
30 /// Whether the legend is shown at all.
31 ///
32 /// True by default.
33 std::optional<ComponentBatch> visible;
34
35 public:
36 static constexpr const char IndicatorComponentName[] =
37 "rerun.blueprint.components.PlotLegendIndicator";
38
39 /// Indicator component, used to identify the archetype when converting to a list of components.
41 /// The name of the archetype as used in `ComponentDescriptor`s.
42 static constexpr const char ArchetypeName[] = "rerun.blueprint.archetypes.PlotLegend";
43
44 /// `ComponentDescriptor` for the `corner` field.
45 static constexpr auto Descriptor_corner = ComponentDescriptor(
46 ArchetypeName, "corner",
48 );
49 /// `ComponentDescriptor` for the `visible` field.
50 static constexpr auto Descriptor_visible = ComponentDescriptor(
51 ArchetypeName, "visible",
53 );
54
55 public:
56 PlotLegend() = default;
57 PlotLegend(PlotLegend&& other) = default;
58 PlotLegend(const PlotLegend& other) = default;
59 PlotLegend& operator=(const PlotLegend& other) = default;
60 PlotLegend& operator=(PlotLegend&& other) = default;
61
62 /// Update only some specific fields of a `PlotLegend`.
64 return PlotLegend();
65 }
66
67 /// Clear all the fields of a `PlotLegend`.
69
70 /// To what corner the legend is aligned.
71 ///
72 /// Defaults to the right bottom corner.
73 PlotLegend with_corner(const rerun::blueprint::components::Corner2D& _corner) && {
74 corner = ComponentBatch::from_loggable(_corner, Descriptor_corner).value_or_throw();
75 return std::move(*this);
76 }
77
78 /// Whether the legend is shown at all.
79 ///
80 /// True by default.
82 visible = ComponentBatch::from_loggable(_visible, Descriptor_visible).value_or_throw();
83 return std::move(*this);
84 }
85
86 /// Partitions the component data into multiple sub-batches.
87 ///
88 /// Specifically, this transforms the existing `ComponentBatch` data into `ComponentColumn`s
89 /// instead, via `ComponentBatch::partitioned`.
90 ///
91 /// This makes it possible to use `RecordingStream::send_columns` to send columnar data directly into Rerun.
92 ///
93 /// The specified `lengths` must sum to the total length of the component batch.
95
96 /// Partitions the component data into unit-length sub-batches.
97 ///
98 /// This is semantically similar to calling `columns` with `std::vector<uint32_t>(n, 1)`,
99 /// where `n` is automatically guessed.
101 };
102
103} // namespace rerun::blueprint::archetypes
104
105namespace rerun {
106 /// \private
107 template <typename T>
108 struct AsComponents;
109
110 /// \private
111 template <>
112 struct AsComponents<blueprint::archetypes::PlotLegend> {
113 /// Serialize all set component batches.
114 static Result<Collection<ComponentBatch>> as_batches(
115 const blueprint::archetypes::PlotLegend& archetype
116 );
117 };
118} // namespace rerun
Generic collection of elements that are roughly contiguous in memory.
Definition collection.hpp:49
A class for representing either a usable value, or an error.
Definition result.hpp:14
All Rerun C++ types and functions are in the rerun namespace or one of its nested namespaces.
Definition rerun.hpp:23
static Result< ComponentBatch > from_loggable(const rerun::Collection< T > &components, const ComponentDescriptor &descriptor=rerun::Loggable< T >::Descriptor)
Creates a new component batch from a collection of component instances.
Definition component_batch.hpp:46
A ComponentDescriptor fully describes the semantics of a column of data.
Definition component_descriptor.hpp:14
The Loggable trait is used by all built-in implementation of rerun::AsComponents to serialize a colle...
Definition loggable.hpp:11
Archetype: Configuration for the legend of a plot.
Definition plot_legend.hpp:24
static constexpr const char ArchetypeName[]
The name of the archetype as used in ComponentDescriptors.
Definition plot_legend.hpp:42
static PlotLegend update_fields()
Update only some specific fields of a PlotLegend.
Definition plot_legend.hpp:63
PlotLegend with_visible(const rerun::components::Visible &_visible) &&
Whether the legend is shown at all.
Definition plot_legend.hpp:81
static constexpr auto Descriptor_visible
ComponentDescriptor for the visible field.
Definition plot_legend.hpp:50
std::optional< ComponentBatch > corner
To what corner the legend is aligned.
Definition plot_legend.hpp:28
std::optional< ComponentBatch > visible
Whether the legend is shown at all.
Definition plot_legend.hpp:33
Collection< ComponentColumn > columns(const Collection< uint32_t > &lengths_)
Partitions the component data into multiple sub-batches.
Collection< ComponentColumn > columns()
Partitions the component data into unit-length sub-batches.
static constexpr auto Descriptor_corner
ComponentDescriptor for the corner field.
Definition plot_legend.hpp:45
static PlotLegend clear_fields()
Clear all the fields of a PlotLegend.
PlotLegend with_corner(const rerun::blueprint::components::Corner2D &_corner) &&
To what corner the legend is aligned.
Definition plot_legend.hpp:73
Indicator component used by archetypes when converting them to component lists.
Definition indicator_component.hpp:32
Component: Whether the container, view, entity or instance is currently visible.
Definition visible.hpp:15