Com crear una malla 3D programàticament amb TypeScript

Pas 1: Instal·la @aspose/3d

npm install @aspose/3d

No es requereixen complements natius ni biblioteques del sistema. El paquet inclou definicions de tipus TypeScript.

Mínim tsconfig.json:

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

Pas 2: Crea una Escena i un Node

Un Scene és el contenidor de nivell superior. Tota la geometria ha d’estar adjunta a un Node dins de l’arbre d’escena:

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

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

createChildNode(name) crea un node anomenat i el connecta com a fill del node actual. L’objecte Node retornat és on adjuntareu la malla al pas 7.

Pas 3: Crea un objecte Mesh

Mesh conté posicions de vèrtex i definicions de polígons. Construeix-ne un amb un nom opcional:

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

const mesh = new Mesh('triangle');

La malla comença buida: sense vèrtexs i sense cares. Els afegeixes en els passos següents.

Pas 4: Afegeix punts de control (Vèrtexs)

Els punts de control són les posicions dels vèrtexs en l’espai local. Empenyeu els valors Vector4 a mesh.controlPoints. El quart component (w) és 1 per a les posicions:

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

Feu referència a aquestes posicions pel seu índex basat en zero en definir les cares del polígon.

Pas 5: Crear cares de polígon

createPolygon() defineix una cara enumerant els índexs dels vèrtexs en ordre. Tres índexs formen un triangle:

mesh.createPolygon(0, 1, 2);

També podeu definir quads (quatre índexs) o polígons arbitràris per a formats que els admeten. Per a glTF, la biblioteca triangul·larà automàticament els quads i els n‑gons en exportar.

Pas 6: Afegir normals de vèrtex

Les normals milloren la qualitat del renderitzat. Utilitzeu mesh.createElement() per crear una VertexElementNormal, recolliu vectors normals en una matriu i, a continuació, crideu setData() per emmagatzemar‑los. El getter data retorna una còpia defensiva — afegir elements a ella no té cap efecte. Utilitzeu FVector3 (float de precisió simple) per a les dades normals, no 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 significa una normal per vèrtex. ReferenceMode.DIRECT significa que la matriu de dades està indexada directament per l’índex del vèrtex del polígon.

Pas 7: Adjunta la malla i desa a glTF

Assigna la malla al node mitjançant node.entity, i després desa l’escena:

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');

Per generar un únic fitxer .glb autocontingut, estableix saveOpts.binaryMode = true i canvia l’extensió del fitxer de sortida a .glb.