Enum Shape3d 

pub enum Shape3d {
    Point(Vec3),
    Line {
        start: Vec3,
        end: Vec3,
        pixel_count: usize,
    },
    Grid {
        start: Vec3,
        horizontal_end: Vec3,
        vertical_end: Vec3,
        horizontal_pixel_count: usize,
        vertical_pixel_count: usize,
        serpentine: bool,
    },
    Arc {
        center: Vec3,
        axis_u: Vec3,
        axis_v: Vec3,
        start_angle_in_radians: f32,
        end_angle_in_radians: f32,
        pixel_count: usize,
    },
}

Enumeration of three-dimensional shape primitives.

Each variant represents a different type of 3D arrangement of LEDs.

Variants

Point(Vec3)

A single point at the specified location.

Line

A line of LEDs from start to end with pixel_count LEDs.

Fields

start: Vec3

Starting point of the line

end: Vec3

Ending point of the line

pixel_count: usize

Number of LEDs along the line

Grid

A grid of LEDs defined by three corners and dimensions.

Fields

start: Vec3

Starting point (origin) of the grid

horizontal_end: Vec3

Ending point for first horizontal row (defines the horizontal axis)

vertical_end: Vec3

Ending point for first vertical column (defines the vertical axis)

horizontal_pixel_count: usize

Number of LEDs along each horizontal row

vertical_pixel_count: usize

Number of LEDs along each vertical column

serpentine: bool

Whether horizontal rows of LEDs are wired in a zigzag pattern

Arc

An circular or elliptical arc in 3D.

Parametric form:

point(theta) = center + cos(theta) * axis_u + sin(theta) * axis_v

Plane and orientation:

• The arc lies in the plane spanned by axis_u and axis_v.
• axis_u and axis_v must be non-colinear (not scalar multiples).
• Theta = 0 lies along axis_u (i.e. center + axis_u)
  • As theta increases, the point moves towards axis_v.
• Looking along axis_u x axis_v, rotation is counter-clockwise. Swap the two axes to flip direction.
• To make a full circle/ellipse, set end = start + core::f32::consts::TAU.

How to choose axis_u / axis_v:

• Circle of radius r in the XY plane:
  • axis_u = (r, 0, 0)
  • axis_v = (0, r, 0)
• Circle of radius r in an arbitrary plane with unit basis u, v:
  • axis_u = r * u
  • axis_v = r * v
• Ellipse with radii rx, ry in a plane with unit basis u, v:
  • axis_u = rx * u
  • axis_v = ry * v

Notes:

• Axes don’t need to be unit length or perpendicular; their lengths set the ellipse radii along their directions.
• The points returned by shape::points() of a Shape3d::Arc:
  • Will have uniform density if a circular arc
  • Will not have uniform density if an elliptical arc, as the points correspond to theta.

Fields

center: Vec3

Center of the ellipse

axis_u: Vec3

Cosine-axis vector

axis_v: Vec3

Sine-axis vector

start_angle_in_radians: f32

Start angle in radians

end_angle_in_radians: f32

End angle in radians

pixel_count: usize

Number of LEDs

Implementations

impl Shape3d

pub const fn pixel_count(&self) -> usize

Returns the total number of pixels (LEDs) in this shape.

pub fn points(&self) -> Shape3dPointsIterator

Returns an iterator over all points (LED positions) in this shape.

Trait Implementations

impl Clone for Shape3d

fn clone(&self) -> Shape3d

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Shape3d

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

Formats the value using the given formatter.