Struct bevy::render::mesh::primitives::Capsule3dMeshBuilder

pub struct Capsule3dMeshBuilder {
    pub capsule: Capsule3d,
    pub rings: usize,
    pub longitudes: usize,
    pub latitudes: usize,
    pub uv_profile: CapsuleUvProfile,
}

A builder used for creating a Mesh with a Capsule3d shape.

Fields

capsule: Capsule3d

The Capsule3d shape.

rings: usize

The number of horizontal lines subdividing the cylindrical part of the capsule. The default is 0.

longitudes: usize

The number of vertical lines subdividing the hemispheres of the capsule. The default is 32.

latitudes: usize

The number of horizontal lines subdividing the hemispheres of the capsule. The default is 16.

uv_profile: CapsuleUvProfile

The manner in which UV coordinates are distributed vertically. The default is CapsuleUvProfile::Aspect.

Implementations

impl Capsule3dMeshBuilder

pub fn new( radius: f32, height: f32, longitudes: usize, latitudes: usize ) -> Capsule3dMeshBuilder

Creates a new Capsule3dMeshBuilder from a given radius, height, longitudes, and latitudes.

Note that height is the distance between the centers of the hemispheres. radius will be added to both ends to get the real height of the mesh.

pub const fn rings(self, rings: usize) -> Capsule3dMeshBuilder

Sets the number of horizontal lines subdividing the cylindrical part of the capsule.

pub const fn longitudes(self, longitudes: usize) -> Capsule3dMeshBuilder

Sets the number of vertical lines subdividing the hemispheres of the capsule.

pub const fn latitudes(self, latitudes: usize) -> Capsule3dMeshBuilder

Sets the number of horizontal lines subdividing the hemispheres of the capsule.

pub const fn uv_profile( self, uv_profile: CapsuleUvProfile ) -> Capsule3dMeshBuilder

Sets the manner in which UV coordinates are distributed vertically.

pub fn build(&self) -> Mesh

Builds a Mesh based on the configuration in self.

Examples found in repository

examples/math/render_primitives.rs (line 520)

fn spawn_primitive_3d(
    mut commands: Commands,
    mut materials: ResMut<Assets<StandardMaterial>>,
    mut meshes: ResMut<Assets<Mesh>>,
) {
    const POSITION: Vec3 = Vec3::new(-LEFT_RIGHT_OFFSET_3D, 0.0, 0.0);
    let material: Handle<StandardMaterial> = materials.add(Color::WHITE);
    let camera_mode = CameraActive::Dim3;
    [
        Some(CUBOID.mesh()),
        Some(SPHERE.mesh().build()),
        None, // ellipse
        None, // triangle
        Some(PLANE_3D.mesh().build()),
        None, // line
        None, // segment
        None, // polyline
        None, // polygon
        None, // regular polygon
        Some(CAPSULE_3D.mesh().build()),
        Some(CYLINDER.mesh().build()),
        None, // cone
        None, // conical frustum
        Some(TORUS.mesh().build()),
    ]
    .into_iter()
    .zip(PrimitiveSelected::ALL)
    .for_each(|(maybe_mesh, state)| {
        if let Some(mesh) = maybe_mesh {
            commands.spawn((
                MeshDim3,
                PrimitiveData {
                    camera_mode,
                    primitive_state: state,
                },
                PbrBundle {
                    mesh: meshes.add(mesh),
                    material: material.clone(),
                    transform: Transform::from_translation(POSITION),
                    ..Default::default()
                },
            ));
        }
    });
}

Trait Implementations

impl Clone for Capsule3dMeshBuilder

fn clone(&self) -> Capsule3dMeshBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Capsule3dMeshBuilder

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

Formats the value using the given formatter.

impl Default for Capsule3dMeshBuilder

fn default() -> Capsule3dMeshBuilder

Returns the “default value” for a type.

impl From<Capsule3dMeshBuilder> for Mesh

fn from(capsule: Capsule3dMeshBuilder) -> Mesh

Converts to this type from the input type.

impl Copy for Capsule3dMeshBuilder