Cum să construiești o rețea 3D programatic în TypeScript

Pasul 1: Instalați @aspose/3d

npm install @aspose/3d

Nu sunt necesare addon-uri native sau biblioteci de sistem. Pachetul include definiții de tip TypeScript.

Minim tsconfig.json:

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

Pasul 2: Crearea unei scene și a unui nod

Un Scene este containerul de nivel superior. Toată geometria trebuie să fie atașată unui Node în interiorul arborelui de scenă:

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

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

createChildNode(name) creează un nod denumit și îl conectează ca un copil al nodului curent. Obiectul Node returnat este locul în care veţi ataşa mesh‑ul în Pasul 7.

Pasul 3: Crează un obiect Mesh

Mesh conține pozițiile vârfurilor și definițiile poligoanelor. Construiți unul cu un nume opțional:

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

const mesh = new Mesh('triangle');

Mesh-ul începe gol: fără vertices și fără faces. Le adaugi în pașii următori.

Pasul 4: Adăugați puncte de control (vârfuri)

Punctele de control sunt pozițiile vârfurilor în spațiul local. Împinge valorile Vector4 în mesh.controlPoints. A patra componentă (w) este 1 pentru poziții:

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

Faceţi referire la aceste poziţii prin indicele lor bazat pe zero atunci când definiţi feţele poligonului.

Pasul 5: Crearea fețelor poligonale

createPolygon() definește o față prin listarea indicilor vârfurilor în ordine. Trei indici formează un triunghi:

mesh.createPolygon(0, 1, 2);

De asemenea, puteți defini cvadrilaturi (patru indici) sau poligoane arbitrare pentru formatele care le acceptă. Pentru glTF, biblioteca va triangula automat cvadrilaturile și n-gonii la export.

Pasul 6: Adăugați normalele de vârf

Normalele îmbunătățesc calitatea redării. Folosește mesh.createElement() pentru a crea un VertexElementNormal, colectează vectorii normali într-un tablou, apoi apelează setData() pentru a-i stoca. Getter-ul data returnează o copie defensivă — adăugarea de elemente în ea nu are niciun efect. Folosește FVector3 (float cu precizie simplă) pentru datele de normale, nu 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 înseamnă un normal pe fiecare vârf. ReferenceMode.DIRECT înseamnă că matricea de date este indexată direct prin indicele vârfului poligonului.

Pasul 7: Atașează Mesh-ul și Salvează în glTF

Atribuiți mesh-ul nodului prin node.entity, apoi salvați scena:

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

Pentru a produce un singur fișier .glb autocontinut în schimb, setați saveOpts.binaryMode = true și schimbați extensia fișierului de ieșire la .glb.