re_types/archetypes/

cylinders3d.rs

// DO NOT EDIT! This file was auto-generated by crates/build/re_types_builder/src/codegen/rust/api.rs
// Based on "crates/store/re_types/definitions/rerun/archetypes/cylinders3d.fbs".

#![allow(unused_braces)]
#![allow(unused_imports)]
#![allow(unused_parens)]
#![allow(clippy::clone_on_copy)]
#![allow(clippy::cloned_instead_of_copied)]
#![allow(clippy::map_flatten)]
#![allow(clippy::needless_question_mark)]
#![allow(clippy::new_without_default)]
#![allow(clippy::redundant_closure)]
#![allow(clippy::too_many_arguments)]
#![allow(clippy::too_many_lines)]

use ::re_types_core::try_serialize_field;
use ::re_types_core::SerializationResult;
use ::re_types_core::{ComponentBatch as _, SerializedComponentBatch};
use ::re_types_core::{ComponentDescriptor, ComponentType};
use ::re_types_core::{DeserializationError, DeserializationResult};

/// **Archetype**: 3D cylinders with flat caps.
///
/// This archetype is for cylinder primitives defined by their axial length and radius.
/// For points whose radii are for visualization purposes, use [`archetypes::Points3D`][crate::archetypes::Points3D] instead.
///
/// Orienting and placing cylinders forms a separate transform that is applied prior to [`archetypes::InstancePoses3D`][crate::archetypes::InstancePoses3D] and [`archetypes::Transform3D`][crate::archetypes::Transform3D].
///
/// ## Example
///
/// ### Batch of cylinders
/// ```ignore
/// use rerun::external::glam::vec3;
///
/// fn main() -> Result<(), Box<dyn std::error::Error>> {
///     let rec = rerun::RecordingStreamBuilder::new("rerun_example_cylinders3d_batch").spawn()?;
///
///     rec.log(
///         "cylinders",
///         &rerun::Cylinders3D::from_lengths_and_radii(
///             [0.0, 2.0, 4.0, 6.0, 8.0],
///             [1.0, 0.5, 0.5, 0.5, 1.0],
///         )
///         .with_colors([
///             rerun::Color::from_rgb(255, 0, 0),
///             rerun::Color::from_rgb(188, 188, 0),
///             rerun::Color::from_rgb(0, 255, 0),
///             rerun::Color::from_rgb(0, 188, 188),
///             rerun::Color::from_rgb(0, 0, 255),
///         ])
///         .with_centers([
///             vec3(0., 0., 0.),
///             vec3(2., 0., 0.),
///             vec3(4., 0., 0.),
///             vec3(6., 0., 0.),
///             vec3(8., 0., 0.),
///         ])
///         .with_rotation_axis_angles((0..5).map(|i| {
///             rerun::RotationAxisAngle::new(
///                 [1.0, 0.0, 0.0],
///                 rerun::Angle::from_degrees(i as f32 * -22.5),
///             )
///         })),
///     )?;
///
///     Ok(())
/// }
/// ```
/// <center>
/// <picture>
///   <source media="(max-width: 480px)" srcset="https://static.rerun.io/cylinders3d_batch/ef642dede2bef23704eaff0f22aa48284d482b23/480w.png">
///   <source media="(max-width: 768px)" srcset="https://static.rerun.io/cylinders3d_batch/ef642dede2bef23704eaff0f22aa48284d482b23/768w.png">
///   <source media="(max-width: 1024px)" srcset="https://static.rerun.io/cylinders3d_batch/ef642dede2bef23704eaff0f22aa48284d482b23/1024w.png">
///   <source media="(max-width: 1200px)" srcset="https://static.rerun.io/cylinders3d_batch/ef642dede2bef23704eaff0f22aa48284d482b23/1200w.png">
///   <img src="https://static.rerun.io/cylinders3d_batch/ef642dede2bef23704eaff0f22aa48284d482b23/full.png" width="640">
/// </picture>
/// </center>
#[derive(Clone, Debug, PartialEq, Default)]
pub struct Cylinders3D {
    /// The total axial length of the cylinder, measured as the straight-line distance between the centers of its two endcaps.
    pub lengths: Option<SerializedComponentBatch>,

    /// Radii of the cylinders.
    pub radii: Option<SerializedComponentBatch>,

    /// Optional centers of the cylinders.
    ///
    /// If not specified, each cylinder will be centered at (0, 0, 0).
    pub centers: Option<SerializedComponentBatch>,

    /// Rotations via axis + angle.
    ///
    /// If no rotation is specified, the cylinders align with the +Z axis of the local coordinate system.
    pub rotation_axis_angles: Option<SerializedComponentBatch>,

    /// Rotations via quaternion.
    ///
    /// If no rotation is specified, the cylinders align with the +Z axis of the local coordinate system.
    pub quaternions: Option<SerializedComponentBatch>,

    /// Optional colors for the cylinders.
    pub colors: Option<SerializedComponentBatch>,

    /// Optional radii for the lines used when the cylinder is rendered as a wireframe.
    pub line_radii: Option<SerializedComponentBatch>,

    /// Optionally choose whether the cylinders are drawn with lines or solid.
    pub fill_mode: Option<SerializedComponentBatch>,

    /// Optional text labels for the cylinders, which will be located at their centers.
    pub labels: Option<SerializedComponentBatch>,

    /// Whether the text labels should be shown.
    ///
    /// If not set, labels will automatically appear when there is exactly one label for this entity
    /// or the number of instances on this entity is under a certain threshold.
    pub show_labels: Option<SerializedComponentBatch>,

    /// Optional class ID for the ellipsoids.
    ///
    /// The class ID provides colors and labels if not specified explicitly.
    pub class_ids: Option<SerializedComponentBatch>,
}

impl Cylinders3D {
    /// Returns the [`ComponentDescriptor`] for [`Self::lengths`].
    ///
    /// The corresponding component is [`crate::components::Length`].
    #[inline]
    pub fn descriptor_lengths() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:lengths".into(),
            component_type: Some("rerun.components.Length".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::radii`].
    ///
    /// The corresponding component is [`crate::components::Radius`].
    #[inline]
    pub fn descriptor_radii() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:radii".into(),
            component_type: Some("rerun.components.Radius".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::centers`].
    ///
    /// The corresponding component is [`crate::components::PoseTranslation3D`].
    #[inline]
    pub fn descriptor_centers() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:centers".into(),
            component_type: Some("rerun.components.PoseTranslation3D".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::rotation_axis_angles`].
    ///
    /// The corresponding component is [`crate::components::PoseRotationAxisAngle`].
    #[inline]
    pub fn descriptor_rotation_axis_angles() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:rotation_axis_angles".into(),
            component_type: Some("rerun.components.PoseRotationAxisAngle".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::quaternions`].
    ///
    /// The corresponding component is [`crate::components::PoseRotationQuat`].
    #[inline]
    pub fn descriptor_quaternions() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:quaternions".into(),
            component_type: Some("rerun.components.PoseRotationQuat".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::colors`].
    ///
    /// The corresponding component is [`crate::components::Color`].
    #[inline]
    pub fn descriptor_colors() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:colors".into(),
            component_type: Some("rerun.components.Color".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::line_radii`].
    ///
    /// The corresponding component is [`crate::components::Radius`].
    #[inline]
    pub fn descriptor_line_radii() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:line_radii".into(),
            component_type: Some("rerun.components.Radius".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::fill_mode`].
    ///
    /// The corresponding component is [`crate::components::FillMode`].
    #[inline]
    pub fn descriptor_fill_mode() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:fill_mode".into(),
            component_type: Some("rerun.components.FillMode".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::labels`].
    ///
    /// The corresponding component is [`crate::components::Text`].
    #[inline]
    pub fn descriptor_labels() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:labels".into(),
            component_type: Some("rerun.components.Text".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::show_labels`].
    ///
    /// The corresponding component is [`crate::components::ShowLabels`].
    #[inline]
    pub fn descriptor_show_labels() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:show_labels".into(),
            component_type: Some("rerun.components.ShowLabels".into()),
        }
    }

    /// Returns the [`ComponentDescriptor`] for [`Self::class_ids`].
    ///
    /// The corresponding component is [`crate::components::ClassId`].
    #[inline]
    pub fn descriptor_class_ids() -> ComponentDescriptor {
        ComponentDescriptor {
            archetype: Some("rerun.archetypes.Cylinders3D".into()),
            component: "Cylinders3D:class_ids".into(),
            component_type: Some("rerun.components.ClassId".into()),
        }
    }
}

static REQUIRED_COMPONENTS: once_cell::sync::Lazy<[ComponentDescriptor; 2usize]> =
    once_cell::sync::Lazy::new(|| {
        [
            Cylinders3D::descriptor_lengths(),
            Cylinders3D::descriptor_radii(),
        ]
    });

static RECOMMENDED_COMPONENTS: once_cell::sync::Lazy<[ComponentDescriptor; 2usize]> =
    once_cell::sync::Lazy::new(|| {
        [
            Cylinders3D::descriptor_centers(),
            Cylinders3D::descriptor_colors(),
        ]
    });

static OPTIONAL_COMPONENTS: once_cell::sync::Lazy<[ComponentDescriptor; 7usize]> =
    once_cell::sync::Lazy::new(|| {
        [
            Cylinders3D::descriptor_rotation_axis_angles(),
            Cylinders3D::descriptor_quaternions(),
            Cylinders3D::descriptor_line_radii(),
            Cylinders3D::descriptor_fill_mode(),
            Cylinders3D::descriptor_labels(),
            Cylinders3D::descriptor_show_labels(),
            Cylinders3D::descriptor_class_ids(),
        ]
    });

static ALL_COMPONENTS: once_cell::sync::Lazy<[ComponentDescriptor; 11usize]> =
    once_cell::sync::Lazy::new(|| {
        [
            Cylinders3D::descriptor_lengths(),
            Cylinders3D::descriptor_radii(),
            Cylinders3D::descriptor_centers(),
            Cylinders3D::descriptor_colors(),
            Cylinders3D::descriptor_rotation_axis_angles(),
            Cylinders3D::descriptor_quaternions(),
            Cylinders3D::descriptor_line_radii(),
            Cylinders3D::descriptor_fill_mode(),
            Cylinders3D::descriptor_labels(),
            Cylinders3D::descriptor_show_labels(),
            Cylinders3D::descriptor_class_ids(),
        ]
    });

impl Cylinders3D {
    /// The total number of components in the archetype: 2 required, 2 recommended, 7 optional
    pub const NUM_COMPONENTS: usize = 11usize;
}

impl ::re_types_core::Archetype for Cylinders3D {
    #[inline]
    fn name() -> ::re_types_core::ArchetypeName {
        "rerun.archetypes.Cylinders3D".into()
    }

    #[inline]
    fn display_name() -> &'static str {
        "Cylinders 3D"
    }

    #[inline]
    fn required_components() -> ::std::borrow::Cow<'static, [ComponentDescriptor]> {
        REQUIRED_COMPONENTS.as_slice().into()
    }

    #[inline]
    fn recommended_components() -> ::std::borrow::Cow<'static, [ComponentDescriptor]> {
        RECOMMENDED_COMPONENTS.as_slice().into()
    }

    #[inline]
    fn optional_components() -> ::std::borrow::Cow<'static, [ComponentDescriptor]> {
        OPTIONAL_COMPONENTS.as_slice().into()
    }

    #[inline]
    fn all_components() -> ::std::borrow::Cow<'static, [ComponentDescriptor]> {
        ALL_COMPONENTS.as_slice().into()
    }

    #[inline]
    fn from_arrow_components(
        arrow_data: impl IntoIterator<Item = (ComponentDescriptor, arrow::array::ArrayRef)>,
    ) -> DeserializationResult<Self> {
        re_tracing::profile_function!();
        use ::re_types_core::{Loggable as _, ResultExt as _};
        let arrays_by_descr: ::nohash_hasher::IntMap<_, _> = arrow_data.into_iter().collect();
        let lengths = arrays_by_descr
            .get(&Self::descriptor_lengths())
            .map(|array| SerializedComponentBatch::new(array.clone(), Self::descriptor_lengths()));
        let radii = arrays_by_descr
            .get(&Self::descriptor_radii())
            .map(|array| SerializedComponentBatch::new(array.clone(), Self::descriptor_radii()));
        let centers = arrays_by_descr
            .get(&Self::descriptor_centers())
            .map(|array| SerializedComponentBatch::new(array.clone(), Self::descriptor_centers()));
        let rotation_axis_angles = arrays_by_descr
            .get(&Self::descriptor_rotation_axis_angles())
            .map(|array| {
                SerializedComponentBatch::new(
                    array.clone(),
                    Self::descriptor_rotation_axis_angles(),
                )
            });
        let quaternions = arrays_by_descr
            .get(&Self::descriptor_quaternions())
            .map(|array| {
                SerializedComponentBatch::new(array.clone(), Self::descriptor_quaternions())
            });
        let colors = arrays_by_descr
            .get(&Self::descriptor_colors())
            .map(|array| SerializedComponentBatch::new(array.clone(), Self::descriptor_colors()));
        let line_radii = arrays_by_descr
            .get(&Self::descriptor_line_radii())
            .map(|array| {
                SerializedComponentBatch::new(array.clone(), Self::descriptor_line_radii())
            });
        let fill_mode = arrays_by_descr
            .get(&Self::descriptor_fill_mode())
            .map(|array| {
                SerializedComponentBatch::new(array.clone(), Self::descriptor_fill_mode())
            });
        let labels = arrays_by_descr
            .get(&Self::descriptor_labels())
            .map(|array| SerializedComponentBatch::new(array.clone(), Self::descriptor_labels()));
        let show_labels = arrays_by_descr
            .get(&Self::descriptor_show_labels())
            .map(|array| {
                SerializedComponentBatch::new(array.clone(), Self::descriptor_show_labels())
            });
        let class_ids = arrays_by_descr
            .get(&Self::descriptor_class_ids())
            .map(|array| {
                SerializedComponentBatch::new(array.clone(), Self::descriptor_class_ids())
            });
        Ok(Self {
            lengths,
            radii,
            centers,
            rotation_axis_angles,
            quaternions,
            colors,
            line_radii,
            fill_mode,
            labels,
            show_labels,
            class_ids,
        })
    }
}

impl ::re_types_core::AsComponents for Cylinders3D {
    #[inline]
    fn as_serialized_batches(&self) -> Vec<SerializedComponentBatch> {
        use ::re_types_core::Archetype as _;
        [
            self.lengths.clone(),
            self.radii.clone(),
            self.centers.clone(),
            self.rotation_axis_angles.clone(),
            self.quaternions.clone(),
            self.colors.clone(),
            self.line_radii.clone(),
            self.fill_mode.clone(),
            self.labels.clone(),
            self.show_labels.clone(),
            self.class_ids.clone(),
        ]
        .into_iter()
        .flatten()
        .collect()
    }
}

impl ::re_types_core::ArchetypeReflectionMarker for Cylinders3D {}

impl Cylinders3D {
    /// Create a new `Cylinders3D`.
    #[inline]
    pub(crate) fn new(
        lengths: impl IntoIterator<Item = impl Into<crate::components::Length>>,
        radii: impl IntoIterator<Item = impl Into<crate::components::Radius>>,
    ) -> Self {
        Self {
            lengths: try_serialize_field(Self::descriptor_lengths(), lengths),
            radii: try_serialize_field(Self::descriptor_radii(), radii),
            centers: None,
            rotation_axis_angles: None,
            quaternions: None,
            colors: None,
            line_radii: None,
            fill_mode: None,
            labels: None,
            show_labels: None,
            class_ids: None,
        }
    }

    /// Update only some specific fields of a `Cylinders3D`.
    #[inline]
    pub fn update_fields() -> Self {
        Self::default()
    }

    /// Clear all the fields of a `Cylinders3D`.
    #[inline]
    pub fn clear_fields() -> Self {
        use ::re_types_core::Loggable as _;
        Self {
            lengths: Some(SerializedComponentBatch::new(
                crate::components::Length::arrow_empty(),
                Self::descriptor_lengths(),
            )),
            radii: Some(SerializedComponentBatch::new(
                crate::components::Radius::arrow_empty(),
                Self::descriptor_radii(),
            )),
            centers: Some(SerializedComponentBatch::new(
                crate::components::PoseTranslation3D::arrow_empty(),
                Self::descriptor_centers(),
            )),
            rotation_axis_angles: Some(SerializedComponentBatch::new(
                crate::components::PoseRotationAxisAngle::arrow_empty(),
                Self::descriptor_rotation_axis_angles(),
            )),
            quaternions: Some(SerializedComponentBatch::new(
                crate::components::PoseRotationQuat::arrow_empty(),
                Self::descriptor_quaternions(),
            )),
            colors: Some(SerializedComponentBatch::new(
                crate::components::Color::arrow_empty(),
                Self::descriptor_colors(),
            )),
            line_radii: Some(SerializedComponentBatch::new(
                crate::components::Radius::arrow_empty(),
                Self::descriptor_line_radii(),
            )),
            fill_mode: Some(SerializedComponentBatch::new(
                crate::components::FillMode::arrow_empty(),
                Self::descriptor_fill_mode(),
            )),
            labels: Some(SerializedComponentBatch::new(
                crate::components::Text::arrow_empty(),
                Self::descriptor_labels(),
            )),
            show_labels: Some(SerializedComponentBatch::new(
                crate::components::ShowLabels::arrow_empty(),
                Self::descriptor_show_labels(),
            )),
            class_ids: Some(SerializedComponentBatch::new(
                crate::components::ClassId::arrow_empty(),
                Self::descriptor_class_ids(),
            )),
        }
    }

    /// Partitions the component data into multiple sub-batches.
    ///
    /// Specifically, this transforms the existing [`SerializedComponentBatch`]es data into [`SerializedComponentColumn`]s
    /// instead, via [`SerializedComponentBatch::partitioned`].
    ///
    /// This makes it possible to use `RecordingStream::send_columns` to send columnar data directly into Rerun.
    ///
    /// The specified `lengths` must sum to the total length of the component batch.
    ///
    /// [`SerializedComponentColumn`]: [::re_types_core::SerializedComponentColumn]
    #[inline]
    pub fn columns<I>(
        self,
        _lengths: I,
    ) -> SerializationResult<impl Iterator<Item = ::re_types_core::SerializedComponentColumn>>
    where
        I: IntoIterator<Item = usize> + Clone,
    {
        let columns = [
            self.lengths
                .map(|lengths| lengths.partitioned(_lengths.clone()))
                .transpose()?,
            self.radii
                .map(|radii| radii.partitioned(_lengths.clone()))
                .transpose()?,
            self.centers
                .map(|centers| centers.partitioned(_lengths.clone()))
                .transpose()?,
            self.rotation_axis_angles
                .map(|rotation_axis_angles| rotation_axis_angles.partitioned(_lengths.clone()))
                .transpose()?,
            self.quaternions
                .map(|quaternions| quaternions.partitioned(_lengths.clone()))
                .transpose()?,
            self.colors
                .map(|colors| colors.partitioned(_lengths.clone()))
                .transpose()?,
            self.line_radii
                .map(|line_radii| line_radii.partitioned(_lengths.clone()))
                .transpose()?,
            self.fill_mode
                .map(|fill_mode| fill_mode.partitioned(_lengths.clone()))
                .transpose()?,
            self.labels
                .map(|labels| labels.partitioned(_lengths.clone()))
                .transpose()?,
            self.show_labels
                .map(|show_labels| show_labels.partitioned(_lengths.clone()))
                .transpose()?,
            self.class_ids
                .map(|class_ids| class_ids.partitioned(_lengths.clone()))
                .transpose()?,
        ];
        Ok(columns.into_iter().flatten())
    }

    /// Helper to partition the component data into unit-length sub-batches.
    ///
    /// This is semantically similar to calling [`Self::columns`] with `std::iter::take(1).repeat(n)`,
    /// where `n` is automatically guessed.
    #[inline]
    pub fn columns_of_unit_batches(
        self,
    ) -> SerializationResult<impl Iterator<Item = ::re_types_core::SerializedComponentColumn>> {
        let len_lengths = self.lengths.as_ref().map(|b| b.array.len());
        let len_radii = self.radii.as_ref().map(|b| b.array.len());
        let len_centers = self.centers.as_ref().map(|b| b.array.len());
        let len_rotation_axis_angles = self.rotation_axis_angles.as_ref().map(|b| b.array.len());
        let len_quaternions = self.quaternions.as_ref().map(|b| b.array.len());
        let len_colors = self.colors.as_ref().map(|b| b.array.len());
        let len_line_radii = self.line_radii.as_ref().map(|b| b.array.len());
        let len_fill_mode = self.fill_mode.as_ref().map(|b| b.array.len());
        let len_labels = self.labels.as_ref().map(|b| b.array.len());
        let len_show_labels = self.show_labels.as_ref().map(|b| b.array.len());
        let len_class_ids = self.class_ids.as_ref().map(|b| b.array.len());
        let len = None
            .or(len_lengths)
            .or(len_radii)
            .or(len_centers)
            .or(len_rotation_axis_angles)
            .or(len_quaternions)
            .or(len_colors)
            .or(len_line_radii)
            .or(len_fill_mode)
            .or(len_labels)
            .or(len_show_labels)
            .or(len_class_ids)
            .unwrap_or(0);
        self.columns(std::iter::repeat(1).take(len))
    }

    /// The total axial length of the cylinder, measured as the straight-line distance between the centers of its two endcaps.
    #[inline]
    pub fn with_lengths(
        mut self,
        lengths: impl IntoIterator<Item = impl Into<crate::components::Length>>,
    ) -> Self {
        self.lengths = try_serialize_field(Self::descriptor_lengths(), lengths);
        self
    }

    /// Radii of the cylinders.
    #[inline]
    pub fn with_radii(
        mut self,
        radii: impl IntoIterator<Item = impl Into<crate::components::Radius>>,
    ) -> Self {
        self.radii = try_serialize_field(Self::descriptor_radii(), radii);
        self
    }

    /// Optional centers of the cylinders.
    ///
    /// If not specified, each cylinder will be centered at (0, 0, 0).
    #[inline]
    pub fn with_centers(
        mut self,
        centers: impl IntoIterator<Item = impl Into<crate::components::PoseTranslation3D>>,
    ) -> Self {
        self.centers = try_serialize_field(Self::descriptor_centers(), centers);
        self
    }

    /// Rotations via axis + angle.
    ///
    /// If no rotation is specified, the cylinders align with the +Z axis of the local coordinate system.
    #[inline]
    pub fn with_rotation_axis_angles(
        mut self,
        rotation_axis_angles: impl IntoIterator<
            Item = impl Into<crate::components::PoseRotationAxisAngle>,
        >,
    ) -> Self {
        self.rotation_axis_angles = try_serialize_field(
            Self::descriptor_rotation_axis_angles(),
            rotation_axis_angles,
        );
        self
    }

    /// Rotations via quaternion.
    ///
    /// If no rotation is specified, the cylinders align with the +Z axis of the local coordinate system.
    #[inline]
    pub fn with_quaternions(
        mut self,
        quaternions: impl IntoIterator<Item = impl Into<crate::components::PoseRotationQuat>>,
    ) -> Self {
        self.quaternions = try_serialize_field(Self::descriptor_quaternions(), quaternions);
        self
    }

    /// Optional colors for the cylinders.
    #[inline]
    pub fn with_colors(
        mut self,
        colors: impl IntoIterator<Item = impl Into<crate::components::Color>>,
    ) -> Self {
        self.colors = try_serialize_field(Self::descriptor_colors(), colors);
        self
    }

    /// Optional radii for the lines used when the cylinder is rendered as a wireframe.
    #[inline]
    pub fn with_line_radii(
        mut self,
        line_radii: impl IntoIterator<Item = impl Into<crate::components::Radius>>,
    ) -> Self {
        self.line_radii = try_serialize_field(Self::descriptor_line_radii(), line_radii);
        self
    }

    /// Optionally choose whether the cylinders are drawn with lines or solid.
    #[inline]
    pub fn with_fill_mode(mut self, fill_mode: impl Into<crate::components::FillMode>) -> Self {
        self.fill_mode = try_serialize_field(Self::descriptor_fill_mode(), [fill_mode]);
        self
    }

    /// This method makes it possible to pack multiple [`crate::components::FillMode`] in a single component batch.
    ///
    /// This only makes sense when used in conjunction with [`Self::columns`]. [`Self::with_fill_mode`] should
    /// be used when logging a single row's worth of data.
    #[inline]
    pub fn with_many_fill_mode(
        mut self,
        fill_mode: impl IntoIterator<Item = impl Into<crate::components::FillMode>>,
    ) -> Self {
        self.fill_mode = try_serialize_field(Self::descriptor_fill_mode(), fill_mode);
        self
    }

    /// Optional text labels for the cylinders, which will be located at their centers.
    #[inline]
    pub fn with_labels(
        mut self,
        labels: impl IntoIterator<Item = impl Into<crate::components::Text>>,
    ) -> Self {
        self.labels = try_serialize_field(Self::descriptor_labels(), labels);
        self
    }

    /// Whether the text labels should be shown.
    ///
    /// If not set, labels will automatically appear when there is exactly one label for this entity
    /// or the number of instances on this entity is under a certain threshold.
    #[inline]
    pub fn with_show_labels(
        mut self,
        show_labels: impl Into<crate::components::ShowLabels>,
    ) -> Self {
        self.show_labels = try_serialize_field(Self::descriptor_show_labels(), [show_labels]);
        self
    }

    /// This method makes it possible to pack multiple [`crate::components::ShowLabels`] in a single component batch.
    ///
    /// This only makes sense when used in conjunction with [`Self::columns`]. [`Self::with_show_labels`] should
    /// be used when logging a single row's worth of data.
    #[inline]
    pub fn with_many_show_labels(
        mut self,
        show_labels: impl IntoIterator<Item = impl Into<crate::components::ShowLabels>>,
    ) -> Self {
        self.show_labels = try_serialize_field(Self::descriptor_show_labels(), show_labels);
        self
    }

    /// Optional class ID for the ellipsoids.
    ///
    /// The class ID provides colors and labels if not specified explicitly.
    #[inline]
    pub fn with_class_ids(
        mut self,
        class_ids: impl IntoIterator<Item = impl Into<crate::components::ClassId>>,
    ) -> Self {
        self.class_ids = try_serialize_field(Self::descriptor_class_ids(), class_ids);
        self
    }
}

impl ::re_byte_size::SizeBytes for Cylinders3D {
    #[inline]
    fn heap_size_bytes(&self) -> u64 {
        self.lengths.heap_size_bytes()
            + self.radii.heap_size_bytes()
            + self.centers.heap_size_bytes()
            + self.rotation_axis_angles.heap_size_bytes()
            + self.quaternions.heap_size_bytes()
            + self.colors.heap_size_bytes()
            + self.line_radii.heap_size_bytes()
            + self.fill_mode.heap_size_bytes()
            + self.labels.heap_size_bytes()
            + self.show_labels.heap_size_bytes()
            + self.class_ids.heap_size_bytes()
    }
}