Cara Membina Mesh 3D Secara Program dalam TypeScript

Langkah 1: Pasang @aspose/3d

npm install @aspose/3d

Tiada add‑on asli atau perpustakaan sistem diperlukan. Pakej ini termasuk definisi jenis TypeScript.

Minimum tsconfig.json:

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

Langkah 2: Buat Adegan dan Node

Sebuah Scene ialah kontena peringkat atas. Semua geometri mesti dilampirkan kepada sebuah Node di dalam pokok adegan:

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

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

createChildNode(name) membuat nod bernama dan menyambungkannya sebagai anak nod semasa. Objek Node yang dikembalikan ialah tempat anda akan melekatkan mesh pada Langkah 7.

Langkah 3: Cipta Objek Mesh

Mesh menyimpan kedudukan vertex dan definisi poligon. Bina satu dengan nama pilihan:

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

const mesh = new Mesh('triangle');

Mesh bermula kosong: tiada simpul dan tiada muka. Anda menambahnya dalam langkah seterusnya.

Langkah 4: Tambah Titik Kawalan (Vertices)

Titik kawalan adalah kedudukan verteks dalam ruang tempatan. Tolak nilai Vector4 ke dalam mesh.controlPoints. Komponen keempat (w) ialah 1 untuk kedudukan:

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

Anda merujuk kedudukan ini dengan indeks berasaskan sifar apabila mentakrifkan muka polygon.

Langkah 5: Cipta Muka Poligon

createPolygon() mendefinisikan satu muka dengan menyenaraikan indeks‑vertex dalam susunan. Tiga indeks membentuk satu segitiga:

mesh.createPolygon(0, 1, 2);

Anda juga boleh menentukan quads (empat indeks) atau poligon sewenang‑wenanya untuk format yang menyokongnya. Untuk glTF, perpustakaan akan secara automatik melakukan triangulasi quads dan n‑gon semasa eksport.

Langkah 6: Tambah Normal Vertex

Normal meningkatkan kualiti rendering. Gunakan mesh.createElement() untuk membuat VertexElementNormal, kumpulkan vektor normal ke dalam satu array, kemudian panggil setData() untuk menyimpannya. Getter data mengembalikan salinan defensif — menolak ke dalamnya tidak memberi kesan. Gunakan FVector3 (float tepat tunggal) untuk data normal, bukan 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 bermaksud satu normal per vertex. ReferenceMode.DIRECT bermaksud susunan data diindeks secara langsung oleh indeks vertex poligon.

Langkah 7: Lampirkan Mesh dan Simpan ke glTF

Tetapkan mesh kepada nod melalui node.entity, kemudian simpan adegan:

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

Untuk menghasilkan satu fail .glb yang berdiri sendiri, tetapkan saveOpts.binaryMode = true dan ubah sambungan fail output kepada .glb.