Struct re_sdk::Boxes2D

pub struct Boxes2D {
    pub half_sizes: Vec<HalfSizes2D>,
    pub centers: Option<Vec<Position2D>>,
    pub colors: Option<Vec<Color>>,
    pub radii: Option<Vec<Radius>>,
    pub labels: Option<Vec<Text>>,
    pub draw_order: Option<DrawOrder>,
    pub class_ids: Option<Vec<ClassId>>,
    pub instance_keys: Option<Vec<InstanceKey>>,
}

Archetype: 2D boxes with half-extents and optional center, rotations, rotations, colors etc.

Example

Simple 2D boxes

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let rec = rerun::RecordingStreamBuilder::new("rerun_example_box2d").spawn()?;

    rec.log(
        "simple",
        &rerun::Boxes2D::from_mins_and_sizes([(-1., -1.)], [(2., 2.)]),
    )?;

    // Log an extra rect to set the view bounds
    rec.log("bounds", &rerun::Boxes2D::from_sizes([(4., 3.)]))?;

    Ok(())
}

Fields

half_sizes: Vec<HalfSizes2D>

All half-extents that make up the batch of boxes.

centers: Option<Vec<Position2D>>

Optional center positions of the boxes.

colors: Option<Vec<Color>>

Optional colors for the boxes.

radii: Option<Vec<Radius>>

Optional radii for the lines that make up the boxes.

labels: Option<Vec<Text>>

Optional text labels for the boxes.

draw_order: Option<DrawOrder>

An optional floating point value that specifies the 2D drawing order.

Objects with higher values are drawn on top of those with lower values.

The default for 2D boxes is 10.0.

class_ids: Option<Vec<ClassId>>

Optional ClassIds for the boxes.

The class ID provides colors and labels if not specified explicitly.

instance_keys: Option<Vec<InstanceKey>>

Unique identifiers for each individual boxes in the batch.

Implementations

impl Boxes2D

pub const NUM_COMPONENTS: usize = 9usize

impl Boxes2D

pub fn with_centers( self, centers: impl IntoIterator<Item = impl Into<Position2D>> ) -> Boxes2D

pub fn with_colors( self, colors: impl IntoIterator<Item = impl Into<Color>> ) -> Boxes2D

pub fn with_radii( self, radii: impl IntoIterator<Item = impl Into<Radius>> ) -> Boxes2D

pub fn with_labels( self, labels: impl IntoIterator<Item = impl Into<Text>> ) -> Boxes2D

pub fn with_draw_order(self, draw_order: impl Into<DrawOrder>) -> Boxes2D

pub fn with_class_ids( self, class_ids: impl IntoIterator<Item = impl Into<ClassId>> ) -> Boxes2D

pub fn with_instance_keys( self, instance_keys: impl IntoIterator<Item = impl Into<InstanceKey>> ) -> Boxes2D

impl Boxes2D

pub fn from_half_sizes( half_sizes: impl IntoIterator<Item = impl Into<HalfSizes2D>> ) -> Boxes2D

Creates new Boxes2D with Self::half_sizes centered around the local origin.

pub fn from_centers_and_half_sizes( centers: impl IntoIterator<Item = impl Into<Position2D>>, half_sizes: impl IntoIterator<Item = impl Into<HalfSizes2D>> ) -> Boxes2D

Creates new Boxes2D with Self::centers and Self::half_sizes.

pub fn from_sizes(sizes: impl IntoIterator<Item = impl Into<Vec2D>>) -> Boxes2D

Creates new Boxes2D with Self::half_sizes created from (full) sizes.

TODO(#3285): Does not preserve data as-is and instead creates half-sizes from the input data.

pub fn from_centers_and_sizes( centers: impl IntoIterator<Item = impl Into<Position2D>>, sizes: impl IntoIterator<Item = impl Into<Vec2D>> ) -> Boxes2D

Creates new Boxes2D with Self::centers and Self::half_sizes created from centers and (full) sizes.

TODO(#3285): Does not preserve data as-is and instead creates half-sizes from the input data.

pub fn from_mins_and_sizes( mins: impl IntoIterator<Item = impl Into<Vec2D>>, sizes: impl IntoIterator<Item = impl Into<Vec2D>> ) -> Boxes2D

Creates new Boxes2D with Self::centers and Self::half_sizes created from minimums and (full) sizes.

TODO(#3285): Does not preserve data as-is and instead creates centers and half-sizes from the input data.

Trait Implementations

impl Archetype for Boxes2D

type Indicator = GenericIndicatorComponent<Boxes2D>

The associated indicator component, whose presence indicates that the high-level archetype-based APIs were used to log the data.

fn name() -> ArchetypeName

The fully-qualified name of this archetype, e.g. rerun.archetypes.Points2D.

fn indicator() -> MaybeOwnedComponentBatch<'static>

Creates a ComponentBatch out of the associated Self::Indicator component.

fn required_components() -> Cow<'static, [ComponentName]>

Returns the names of all components that must be provided by the user when constructing this archetype.

fn recommended_components() -> Cow<'static, [ComponentName]>

Returns the names of all components that should be provided by the user when constructing this archetype.

fn optional_components() -> Cow<'static, [ComponentName]>

Returns the names of all components that may be provided by the user when constructing this archetype.

fn all_components() -> Cow<'static, [ComponentName]>

Returns the names of all components that must, should and may be provided by the user when constructing this archetype.

fn from_arrow( arrow_data: impl IntoIterator<Item = (Field, Box<dyn Array>)> ) -> Result<Boxes2D, DeserializationError>

Given an iterator of Arrow arrays and their respective field metadata, deserializes them into this archetype.

impl AsComponents for Boxes2D

fn as_component_batches(&self) -> Vec<MaybeOwnedComponentBatch<'_>>

Exposes the object’s contents as a set of ComponentBatchs.

fn num_instances(&self) -> usize

The number of instances in each batch.

fn to_arrow(&self) -> Result<Vec<(Field, Box<dyn Array>)>, SerializationError>

Serializes all non-null Components of this bundle into Arrow arrays.

impl Clone for Boxes2D

fn clone(&self) -> Boxes2D

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Boxes2D

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for Boxes2D

fn eq(&self, other: &Boxes2D) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Boxes2D