Struct Vertex

#[repr(C)]
pub struct Vertex {
    pub pos: Vec3,
    pub norm: Vec3,
    pub uv: Vec2,
    pub col: Color32,
}

This represents a single vertex in a Mesh, all StereoKit Meshes currently use this exact layout! It’s good to fill out all values of a Vertex explicitly, as default values for the normal (0,0,0) and color (0,0,0,0) will cause your mesh to appear completely black, or even transparent in most shaders! https://stereokit.net/Pages/StereoKit/Vertex.html

Examples

use stereokit_rust::{maths::{Vec3, Vec2, Matrix}, util::Color32, mesh::{Mesh,Vertex}, material::Material};

// Creating vertices with all fields specified
let vertices = [
    Vertex::new(Vec3::ZERO,Vec3::UP,None,         Some(Color32::rgb(0, 0, 255))),
    Vertex::new(Vec3::X,   Vec3::UP,Some(Vec2::X),Some(Color32::rgb(255, 0, 0))),
    Vertex::new(Vec3::Y,   Vec3::UP,Some(Vec2::Y),Some(Color32::rgb(0,255, 0))),
];
let indices = [0, 1, 2, 2, 1, 0];
let mut mesh = Mesh::new();
mesh.id("most_basic_mesh").keep_data(true).set_data(&vertices, &indices, true);
let material = Material::pbr();

filename_scr = "screenshots/basic_mesh.jpeg";
test_screenshot!( // !!!! Get a proper main loop !!!!
    mesh.draw(token, &material, Matrix::IDENTITY, None, None);
);

Fields

pos: Vec3

Position of the vertex, in model space coordinates.

norm: Vec3

The normal of this vertex, or the direction the vertex is facing. Preferably normalized.

uv: Vec2

The texture coordinates at this vertex.

col: Color32

The color of the vertex. If you aren’t using it, set it to white.

Implementations

impl Vertex

pub fn new<V: Into<Vec3>>( position: V, normal: V, texture_coordinate: Option<Vec2>, color: Option<Color32>, ) -> Self

Create a new Vertex. https://stereokit.net/Pages/StereoKit/Vertex/Vertex.html

• position - Location of the vertex, this is typically meters in model space.
• normal - The direction the Vertex is facing. Never leave this as zero, or your lighting may turn out black! A good default value if you don’t know what to put here is (0,1,0), but a Mesh composed entirely of this value will have flat lighting.
• texture_coordinate - If None, set the value to Vec2::ZERO
• color - If None, set the value to Color32::WHITE

Examples

use stereokit_rust::{maths::{Vec3, Vec2}, mesh::Vertex, util::Color32};

let vertex = Vertex::new([0.0, 0.0, 0.0], [0.0, 1.0, 0.0], None, None);
let vertex_bis = Vertex{
        pos: Vec3::new(0.0, 0.0, 0.0),
        norm: Vec3::new(0.0, 1.0, 0.0),
        uv: Vec2::ZERO,
        col: Color32::WHITE};
assert_eq!(vertex, vertex_bis);

let vertex = Vertex::new([0.0, 0.0, 0.0], [0.0, 0.0, 0.0],
                         Some(Vec2::ZERO), Some(Color32::BLACK_TRANSPARENT) );
let vertex_default = Vertex::default();
assert_eq!(vertex, vertex_default);

Trait Implementations

impl Clone for Vertex

fn clone(&self) -> Vertex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vertex

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

Formats the value using the given formatter.

impl Default for Vertex

fn default() -> Vertex

Returns the “default value” for a type.

impl PartialEq for Vertex

fn eq(&self, other: &Vertex) -> 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 Copy for Vertex

impl StructuralPartialEq for Vertex