Hvordan bygge et 3D-mesh programmatisk i TypeScript

Trinn 1: Installer @aspose/3d

npm install @aspose/3d

Ingen native‑tillegg eller systembiblioteker er påkrevd. Pakken inkluderer TypeScript‑type‑definisjoner.

Minimum tsconfig.json:

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

Trinn 2: Opprett en scene og node

A Scene er den øverste beholderen. All geometrien må festes til en Node i scenetreet:

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

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

createChildNode(name) oppretter en navngitt node og kobler den som et barn av den nåværende noden. Det returnerte Node‑objektet er hvor du vil feste mesh i trinn 7.

Trinn 3: Opprett et Mesh-objekt

Mesh inneholder vertex‑posisjoner og polygon‑definisjoner. Konstruer en med et valgfritt navn:

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

const mesh = new Mesh('triangle');

Meshen starter tom: ingen vertices og ingen faces. Du legger dem til i de neste trinnene.

Steg 4: Legg til kontrollpunkter (hjørner)

Kontrollpunkter er vertex‑posisjonene i lokalt rom. Skyv Vector4‑verdier inn i mesh.controlPoints. Den fjerde komponenten (w) er 1 for posisjoner:

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 refererer til disse posisjonene ved deres nullbaserte indeks når du definerer polygonflater.

Trinn 5: Opprett polygonflater

createPolygon() definerer en flate ved å liste opp vertex‑indeksene i rekkefølge. Tre indekser lager en trekant:

mesh.createPolygon(0, 1, 2);

Du kan også definere quads (fire indekser) eller vilkårlige polygoner for formater som støtter dem. For glTF vil biblioteket automatisk triangulere quads og n-gons ved eksport.

Trinn 6: Legg til Vertex Normals

Normale forbedrer gjengivelseskvaliteten. Bruk mesh.createElement() for å opprette en VertexElementNormal, samle normalvektorer i en matrise, og kall deretter setData() for å lagre dem. data-getteren returnerer en defensiv kopi — å pushe til den har ingen effekt. Bruk FVector3 (flyttall med enkel presisjon) for normaldata, ikke 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 betyr én normal per vertex. ReferenceMode.DIRECT betyr at dataarrayet er indeksert direkte av polygon‑vertex‑indeksen.

Trinn 7: Fest Mesh og lagre til glTF

Tildel mesh til noden via node.entity, så lagre 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');

For å produsere en enkelt selvstendig .glb‑fil i stedet, sett saveOpts.binaryMode = true og endre utdatafilens filtype til .glb.