Struct Lines3d 

pub struct Lines3d {
    pub vertices: Vec<Vert3dInstanced>,
    pub indices: Vec<u32>,
}

Raw data defining a wireframe mesh

Fields

vertices: Vec<Vert3dInstanced>

indices: Vec<u32>

Implementations

impl Lines3d

pub fn capsule( index_offset: u32, hemisphere_latitude_divisions: u16, longitude_divisions: u16, ) -> Self

Two hemispherical “caps” connected at their equators.

Intended to be scaled first and then each cap translated along the Z axis to achieve the correct capsule height.

Can also be used to render a hemisphere or a sphere by slicing the corresponding number of indices. Note that the sphere is slightly degenerate since there are duplicate vertices on the equator, and so the last 2 * longitude_divisions indices will differ but the total index count will be the same.

Panics

Panics of hemisphere_latitude_divisions is zero or if longitude_divisions is less than two.

impl Lines3d

pub fn cube(index_offset: u32) -> Self

impl Lines3d

pub fn cylinder(index_offset: u32, divisions: u16) -> Self

Unit cylinder– total height is 2.0 centered at 0.0 in the vertical (Z) axis, radius 1.0 in the X/Y plane.

Panics

Divisions must be 2 or greater.

impl Lines3d

pub fn grid(index_offset: u32, dims: u16) -> Self

Produces vertices and indices for a 3D lines list arranged in a square grid in the X/Y plane of dims by dims dimensions.

The number of vertices will be (dims + 1)^2.

The number of indices will be 4*(dims^2 + dims).

Panics

Panics if dims is zero.

impl Lines3d

pub fn hemisphere( index_offset: u32, latitude_divisions: u16, longitude_divisions: u16, ) -> Self

Generates a hemisphere with unit radius in the positive Z half-space with a number of parallels equal to latitude_divisions and a number of half-meridians equal to longitude_divisions

impl Lines3d

Produces vertices and indices for a 3D lines list unit sphere (radius $1.0$) with the given number of latitudinal divisions rounded down to the nearest even number (ensuring the sphere always has an ‘equator’), and with the given number of longitudinal divisions.

The number of parallels will be equal to latitude_divisions - (latitude_divisions % 2) - 1 and the number of meridians will be equal to longitude_divisions.

There will be 2 + (latitude_divisions-1) * longitude_divisions vertices and 4 * longitude_divisions * latitude_divisions - 2 * longitude_divisions indices.

The first 4 * (latitude_divisions / 2) * longitude_divisions indices can be used to render only the top hemisphere (the sphere itself is computed progressively by adding more vertices and indices onto a base hemisphere to form the southern hemisphere).

Panics

Panics if latitude_divisions or longitude_divisions are less than two (i.e. there must be at least an equator latitude dividing the north and south hemispheres and a prime meridian dividing the east and west hemispheres.

pub fn sphere( index_offset: u32, latitude_divisions: u16, longitude_divisions: u16, ) -> Self

impl Lines3d

pub const fn empty() -> Self

Trait Implementations

impl Clone for Lines3d

fn clone(&self) -> Lines3d

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Lines3d

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

Formats the value using the given formatter.

impl From<(Vec<Vert3dInstanced>, Vec<u32>)> for Lines3d

fn from(value: (Vec<Vert3dInstanced>, Vec<u32>)) -> Self

Converts to this type from the input type.

impl From<Aabb3<f32>> for Lines3d

fn from(aabb: Aabb3<f32>) -> Self

Converts to this type from the input type.

impl From<Lines3d> for Mesh

fn from(value: Lines3d) -> Self

Converts to this type from the input type.

impl PartialEq for Lines3d

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl TryFrom<Mesh> for Lines3d

type Error = TryIntoError<Mesh>

The type returned in the event of a conversion error.

fn try_from(value: Mesh) -> Result<Self, TryIntoError<Mesh>>

Performs the conversion.

impl StructuralPartialEq for Lines3d