Ako programovo vytvoriť 3D sieť v TypeScripte

Krok 1: Nainštalujte @aspose/3d

npm install @aspose/3d

Nie sú potrebné žiadne natívne doplnky ani systémové knižnice. Balík obsahuje definície typov TypeScript.

Minimum tsconfig.json:

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

Krok 2: Vytvoriť scénu a uzol

Scene je kontajner najvyššej úrovne. Všetka geometria musí byť pripojená k Node v rámci stromu scény:

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

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

createChildNode(name) vytvorí pomenovaný uzol a pripojí ho ako dieťa aktuálneho uzla. Vrátený objekt Node je miesto, kde v kroku 7 pripojíte mesh.

Krok 3: Vytvoriť Mesh Object

Mesh obsahuje pozície vrcholov a definície polygonov. Vytvorte jeden s voliteľným názvom:

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

const mesh = new Mesh('triangle');

Mriežka začína prázdna: žiadne vrcholy a žiadne plochy. Pridáte ich v nasledujúcich krokoch.

Krok 4: Pridať kontrolné body (vrcholy)

Kontrolné body sú pozície vrcholov v lokálnom priestore. Vložte hodnoty Vector4 do mesh.controlPoints. Štvrtá zložka (w) je 1 pre pozície:

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

Pri definovaní polygonových plôch odkazujete na tieto pozície pomocou ich nulového indexu.

Krok 5: Vytvoriť polygonové plochy

createPolygon() definuje plochu výpisom indexov vrcholov v poradí. Tri indexy tvoria trojuholník:

mesh.createPolygon(0, 1, 2);

Môžete tiež definovať štvoruholníky (štyri indexy) alebo ľubovoľné polygóny pre formáty, ktoré ich podporujú. Pre glTF knižnica automaticky trianguluje štvoruholníky a n-góny pri exporte.

Krok 6: Pridať normály vrcholov

Normály zlepšujú kvalitu renderovania. Použite mesh.createElement() na vytvorenie VertexElementNormal, zozbierajte normálové vektory do poľa a potom zavolajte setData() na ich uloženie. Getter data vracia obrannú kópiu — pridávanie do nej nemá žiadny účinok. Použite FVector3 (jednoprecízny float) pre normálové dáta, nie 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 znamená jeden normál na vrchol. ReferenceMode.DIRECT znamená, že dátové pole je indexované priamo podľa indexu vrcholu polygonu.

Krok 7: Pripojte sieť a uložte do glTF

Priraďte sieť k uzlu prostredníctvom node.entity, potom uložte scénu:

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

Ak chcete namiesto toho vytvoriť jeden samostatný .glb súbor, nastavte saveOpts.binaryMode = true a zmeňte príponu výstupného súboru na .glb.