Struct hexx::mesh::MeshInfo

pub struct MeshInfo {
    pub vertices: Vec<Vec3>,
    pub normals: Vec<Vec3>,
    pub uvs: Vec<Vec2>,
    pub indices: Vec<u16>,
}

Hexagonal mesh information.

Usage

Use:

• ColumnMeshBuilder for 3d hexagonal column meshes
• PlaneMeshBuilder for hexagonal plane meshes

The mesh info has some customization options:

let layout = HexLayout::default();
// Build the mesh info
let info: MeshInfo = ColumnMeshBuilder::new(&layout, 2.0).build();
// Customize the generated mesh
let info = info
    .rotated(Quat::IDENTITY)
    .with_offset(Vec3::new(12.0, 34.2, -43.54));

Merging

MeshInfo can be merged with other meshes using Self::merge_with. Don’t forget to offset the meshes in the mesh builder using:

• ColumnMeshBuilder::at
• PlaneMeshBuilder::at
• Self::with_offset for a custom offset

Otherwise you might end up with meshes at the same coordinates

Fields

vertices: Vec<Vec3>

All vertices positions information (Vertex_Position attribute)

normals: Vec<Vec3>

Normals for each vertex (You might need to swap y and z) (Vertex_Normal attribute)

uvs: Vec<Vec2>

UV coordinates of each vertex (Vertex_Uv attribute)

indices: Vec<u16>

Vertex indices for triangles

Implementations

impl MeshInfo

pub fn rotated(self, rotation: Quat) -> Self

Returns a new MeshInfo but with vertex positions and normals rotated

pub fn with_offset(self, offset: Vec3) -> Self

Returns a new MeshInfo but with offset applied to vertex positions

pub fn merge_with(&mut self, rhs: Self)

Merges rhs into self. All vertices, normals and uvs are appended to self and indices are offsetted to maintain triangle data.

Note

This method doesn’t merge vertices or tries to remove invisible faces.

Panics

Will panic if there are more vertices than u16::MAX

pub fn hexagonal_plane(layout: &HexLayout, hex: Hex) -> Self

👎Deprecated since 0.13.0: Use PlaneMeshBuilder instead

Computes mesh data for an hexagonal plane facing Vec3::Y with 6 vertices and 4 triangles

Note

Prefer using PlaneMeshBuilder for additional customization like:

• UV options
• Offsets
• rotation
• etc

pub fn cheap_hexagonal_column( layout: &HexLayout, hex: Hex, column_height: f32 ) -> Self

Computes cheap mesh data for an hexagonal column facing Vec3::Y without the bottom face.

This mesh has only 12 vertices, as no vertex is duplicated. As a consequence the normals will behave strangely and the UV mapping will be extremely simplistic and stretched on the sides.

Use this mesh if you don’t care about lighting and texturing, like for convex hull collision shapes.

Prefer using ColumnMeshBuilder in most cases

Trait Implementations

impl Clone for MeshInfo

fn clone(&self) -> MeshInfo

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MeshInfo

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

Formats the value using the given formatter.

impl Default for MeshInfo

fn default() -> MeshInfo

Returns the “default value” for a type.