threers 0.0.2

Drop-in three.js replacement for Rust and WebAssembly (wgpu) — THREE.* API, scene graph, PBR, post-fx, mesh BVH, CSG, headless render, and native media codecs
Documentation
use crate::core::{BufferAttribute, BufferGeometry, LineSegments, Object3D};
use crate::materials::LineBasicMaterial;
use crate::math::Color;

/// Line-segments visualization of each vertex's normal vector.
/// Mirrors three.js's `VertexNormalsHelper`.
pub struct VertexNormalsHelper;

impl VertexNormalsHelper {
    pub fn new(geom: &BufferGeometry, length: f32, color: Color) -> Object3D {
        let pos = match geom.get_attribute("position") {
            Some(p) => &p.array,
            None => return empty_line(color),
        };
        let nrm = match geom.get_attribute("normal") {
            Some(n) => &n.array,
            None => return empty_line(color),
        };
        let count = pos.len() / 3;
        let mut positions = Vec::with_capacity(count * 6);
        for i in 0..count {
            let px = pos[i * 3];
            let py = pos[i * 3 + 1];
            let pz = pos[i * 3 + 2];
            let nx = nrm[i * 3];
            let ny = nrm[i * 3 + 1];
            let nz = nrm[i * 3 + 2];
            positions.extend_from_slice(&[
                px,
                py,
                pz,
                px + nx * length,
                py + ny * length,
                pz + nz * length,
            ]);
        }
        let mut g = BufferGeometry::new();
        g.set_attribute("position", BufferAttribute::new(positions, 3));
        Object3D::line_segments(LineSegments::new(g, LineBasicMaterial::new(color).into()))
    }
}

/// Visualization of each vertex's tangent vector. Requires the geometry to
/// carry a `tangent` (vec4) attribute. Mirrors three.js's `VertexTangentsHelper`.
pub struct VertexTangentsHelper;

impl VertexTangentsHelper {
    pub fn new(geom: &BufferGeometry, length: f32, color: Color) -> Object3D {
        let pos = match geom.get_attribute("position") {
            Some(p) => &p.array,
            None => return empty_line(color),
        };
        let tan = match geom.get_attribute("tangent") {
            Some(t) => &t.array,
            None => return empty_line(color),
        };
        let count = pos.len() / 3;
        let mut positions = Vec::with_capacity(count * 6);
        for i in 0..count {
            let px = pos[i * 3];
            let py = pos[i * 3 + 1];
            let pz = pos[i * 3 + 2];
            let tx = tan[i * 4];
            let ty = tan[i * 4 + 1];
            let tz = tan[i * 4 + 2];
            positions.extend_from_slice(&[
                px,
                py,
                pz,
                px + tx * length,
                py + ty * length,
                pz + tz * length,
            ]);
        }
        let mut g = BufferGeometry::new();
        g.set_attribute("position", BufferAttribute::new(positions, 3));
        Object3D::line_segments(LineSegments::new(g, LineBasicMaterial::new(color).into()))
    }
}

fn empty_line(color: Color) -> Object3D {
    let mut g = BufferGeometry::new();
    g.set_attribute("position", BufferAttribute::new(Vec::new(), 3));
    Object3D::line_segments(LineSegments::new(g, LineBasicMaterial::new(color).into()))
}