Sådan bygger du et 3D‑mesh programmatisk i TypeScript

Trin 1: Installer @aspose/3d

npm install @aspose/3d

Ingen native‑tilføjelser eller systembiblioteker er påkrævet. Pakken inkluderer TypeScript‑typedefinitioner.

Minimum tsconfig.json:

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

Trin 2: Opret en Scene og Node

En Scene er den øverste container. Al geometri skal vedhæftes en Node inde i scenetræet:

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

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

createChildNode(name) opretter en navngivet node og tilslutter den som et barn af den aktuelle node. Det returnerede Node‑objekt er, hvor du vil vedhæfte mesh’en i trin 7.

Trin 3: Opret et Mesh-objekt

Mesh indeholder vertex‑positioner og polygondefinitioner. Opret en med et valgfrit navn:

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

const mesh = new Mesh('triangle');

Mesh’en starter tom: ingen vertexer og ingen flader. Du tilføjer dem i de næste trin.

Trin 4: Tilføj kontrolpunkter (hjørner)

Kontrolpunkter er vertexpositionerne i lokalt rum. Skub Vector4 værdier ind i mesh.controlPoints. Den fjerde komponent (w) er 1 for 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 refererer til disse positioner ved deres nulbaserede indeks, når du definerer polygonflader.

Trin 5: Opret polygonflader

createPolygon() definerer en flade ved at liste vertex‑indekserne i rækkefølge. Tre indekser udgør en trekant:

mesh.createPolygon(0, 1, 2);

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

Trin 6: Tilføj Vertex Normals

Normale forbedrer gengivelseskvaliteten. Brug mesh.createElement() til at oprette en VertexElementNormal, indsamle normalvektorer i et array, og derefter kalde setData() for at gemme dem. data-getteren returnerer en defensiv kopi — at skubbe til den har ingen effekt. Brug FVector3 (single-precision float) til 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 betyder én normal pr. vertex. ReferenceMode.DIRECT betyder, at dataarrayet er indekseret direkte efter polygon‑vertex‑indekset.

Trin 7: Tilføj mesh’en og gem som glTF

Tildel mesh’en til noden via node.entity, og gem derefter 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 at producere en enkelt selvstændig .glb fil i stedet, skal du indstille saveOpts.binaryMode = true og ændre outputfilens filendelse til .glb.