Hur man bygger en 3D Mesh Programmatiskt i TypeScript

Steg 1: Installera @aspose/3d

asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.

Inga inhemska addon eller systembibliotek krävs. paketet innehåller TypeScript-typdefinitioner.

Minimum tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true
  }
}

Steg 2: Skapa en scen och noder

A och Scene är den högsta nivån container. all geometri måste anslutas till en Node Inuti trädet:

import { Scene } from '@aspose/3d';

const scene = new Scene();
const node = scene.rootNode.createChildNode('triangle');

createChildNode(name) skapar en namngiven nod och strömmar den som ett barn av den aktuella noden. Node objektet är där du kommer att fästa mesh i steg 7.

Steg 3: Skapa ett Mesh Object

Mesh Håller vertexpositioner och polygon definitioner. Konstruera en med ett valfritt namn:

import { Mesh } from '@aspose/3d/entities';

const mesh = new Mesh('triangle');

Mässa börjar tom: inga vertikaler och inga ansikten. Du lägger till dem i nästa steg.

Steg 4: Lägg till kontrollpunkter (vertikaler)

Kontrollpunkter är de vertikala positionerna i lokal utrymme. Vector4 Värden i mesh.controlPoints.Den fjärde delen (w) är 1 För positioner:

import { Vector4 } from '@aspose/3d/utilities';

mesh.controlPoints.push(new Vector4(0.0, 0.0, 0.0, 1.0)); // index 0
mesh.controlPoints.push(new Vector4(1.0, 0.0, 0.0, 1.0)); // index 1
mesh.controlPoints.push(new Vector4(0.5, 1.0, 0.0, 1.0)); // index 2

Du refererar till dessa positioner genom deras nollbaserade index när du definierar polygon ansikten.

Steg 5: Skapa polygon ansikten

createPolygon() definierar ett ansikte genom att lista vertexindex i ordning.Tre index gör en triangel:

mesh.createPolygon(0, 1, 2);

Du kan också definiera quads (fem index) eller arbitrariska polygoner för format som stöder dem. För glTF kommer biblioteket automatiskt att triangulera quad och n-gons på export.

Steg 6: Lägg till Vertex normaler

Normala förbättrar rendering kvalitet. användning mesh.createElement() För att skapa en VertexElementNormal, samla normala vektorer i en rad, sedan ringa setData() för att hålla dem. den data getter returnerar en försvarskopia – att trycka på det har ingen effekt. FVector3 (enhetlig precision) för normala data, inte Vector4.

import { VertexElementNormal } from '@aspose/3d/entities';
import { VertexElementType, MappingMode, ReferenceMode } from '@aspose/3d/entities';
import { FVector3 } from '@aspose/3d/utilities';

const normals = mesh.createElement(
    VertexElementType.NORMAL,
    MappingMode.CONTROL_POINT,
    ReferenceMode.DIRECT
) as VertexElementNormal;

// Build the normal array, then call setData() — do NOT push to normals.data
normals.setData([
    new FVector3(0, 0, 1), // normal for vertex 0 (pointing +Z)
    new FVector3(0, 0, 1), // normal for vertex 1
    new FVector3(0, 0, 1), // normal for vertex 2
]);

MappingMode.CONTROL_POINT Det är en normal per vertex. ReferenceMode.DIRECT Det betyder att dataråget indexeras direkt av polygonvertexindexet.

Steg 7: Anslut Mesh och Spara till glTF

Tilldela mesh till knuten via node.entity,Så spara scenen:

import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';

node.entity = mesh;

const saveOpts = new GltfSaveOptions();
scene.save('triangle.gltf', GltfFormat.getInstance(), saveOpts);
console.log('Triangle mesh saved to triangle.gltf');

Att producera en enda självinnehållande .glb filer istället, ställ in saveOpts.binaryMode = true och ändra utgångsfil förlängning till .glb.