Face3

Triangular face used in Geometry. These are created automatically for all standard geometry types, however if you are building a custom geometry you will have to create them manually.

Code Example


    const material = new v3d.MeshStandardMaterial({ color : 0x00cc00 });

    //create a triangular geometry
    const geometry = new v3d.Geometry();
    geometry.vertices.push(new v3d.Vector3(-50, -50, 0));
    geometry.vertices.push(new v3d.Vector3( 50, -50, 0));
    geometry.vertices.push(new v3d.Vector3( 50,  50, 0));

    //create a new face using vertices 0, 1, 2
    const normal = new v3d.Vector3(0, 0, 1); //optional
    const color = new v3d.Color(0xffaa00); //optional
    const materialIndex = 0; //optional
    const face = new v3d.Face3(0, 1, 2, normal, color, materialIndex);

    //add the face to the geometry's faces array
    geometry.faces.push(face);

    //the face normals and vertex normals can be calculated automatically if not supplied above
    geometry.computeFaceNormals();
    geometry.computeVertexNormals();

    scene.add(new v3d.Mesh(geometry, material));

Examples

svg / sandbox
exporter / obj
WebGL / shaders / vector

Constructor

Face3(a : Integer, b : Integer, c : Integer, normal : Vector3, color : Color, materialIndex : Integer)

a — Vertex A index.
b — Vertex B index.
c — Vertex C index.

normal — (optional) Face normal (Vector3) or array of vertex normals. If a single vector is passed in, this sets .normal, otherwise if an array of three vectors is passed in this sets .vertexNormals

color — (optional) Face color or array of vertex colors. If a single vector is passed in, this sets .color, otherwise if an array of three vectors is passed in this sets .vertexColors

materialIndex — (optional) which index of an array of materials to associate with the face.

Properties

# .a : Integer

Vertex A index.

# .b : Integer

Vertex B index.

# .c : Integer

Vertex C index.

# .normal : Vector3

Face normal - vector showing the direction of the Face3. If calculated automatically (using Geometry.computeFaceNormals), this is the normalized cross product of two edges of the triangle. Default is (0, 0, 0).

# .color : Color

Face color - for this to be used a material's vertexColors property must be set to true.

# .vertexNormals : Array

Array of 3 vertex normals.

# .vertexColors : Array

Array of 3 vertex colors - for these to be used a material's vertexColors property must be set to true.

# .materialIndex : Integer

Material index (points to an index in the associated array of materials). Default is 0.

Methods

# .clone () : Face3

Creates a new clone of the Face3 object.

# .copy (face3 : Face3) : Face3

Copy the parameters of another Face3 into this.

Source

For more info on how to obtain the source code of this module see this page.

Last updated on Wed Feb 17 2021