TypeScript'te Programlı Şekilde 3D Mesh Nasıl Oluşturulur

Adım 1: @aspose/3d’yi kurun

npm install @aspose/3d

Yerel eklentiler veya sistem kütüphaneleri gerekmez. Paket, TypeScript tip tanımlarını içerir.

Minimum tsconfig.json:

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

Adım 2: Bir Sahne ve Düğüm Oluştur

Scene üst düzey bir kapsayıcıdır. Tüm geometri, sahne ağacının içinde bir Node‘ye eklenmelidir:

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

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

createChildNode(name) adlandırılmış bir düğüm oluşturur ve bunu mevcut düğümün çocuğu olarak bağlar. Döndürülen Node nesnesi, 7. adımda ağı ekleyeceğiniz yerdir.

Adım 3: Bir Mesh Nesnesi Oluştur

Mesh köşe konumlarını ve çokgen tanımlarını tutar. İsteğe bağlı bir adla bir tane oluşturun:

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

const mesh = new Mesh('triangle');

Mesh boş başlar: köşe ve yüz yok. Bunları sonraki adımlarda eklersiniz.

Adım 4: Kontrol Noktalarını (Köşe Noktaları) Ekle

Kontrol noktaları, yerel uzaydaki köşe konumlarıdır. Vector4 değerlerini mesh.controlPoints içine it. Dördüncü bileşen (w), konumlar için 1‘dir.

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

Poligon yüzeylerini tanımlarken bu konumlara sıfır tabanlı indeksleriyle başvurursunuz.

Adım 5: Çokgen Yüzeyleri Oluştur

createPolygon() bir yüzeyi, köşe indislerini sırayla listeleyerek tanımlar. Üç indis bir üçgen oluşturur:

mesh.createPolygon(0, 1, 2);

Ayrıca, destekleyen formatlar için dörtgenleri (dört indeks) veya keyfi çokgenleri tanımlayabilirsiniz. glTF için, kütüphane dışa aktarım sırasında dörtgenleri ve n‑gonları otomatik olarak üçgenleştirir.

Adım 6: Vertex Normal’ları Ekle

Normal vektörler, render kalitesini artırır. mesh.createElement() kullanarak bir VertexElementNormal oluşturun, normal vektörleri bir diziye toplayın, ardından onları saklamak için setData() çağırın. data alıcı (getter) savunmacı bir kopya döndürür — ona push yapmak hiçbir etki yaratmaz. Normal veriler için FVector3 (tek duyarlıklı kayan nokta) kullanın, Vector4 değil.

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 bir köşe başına bir normal anlamına gelir. ReferenceMode.DIRECT veri dizisinin çokgen köşe indeksine doğrudan indekslendiği anlamına gelir.

Adım 7: Mesh’i Bağlayın ve glTF’ye Kaydedin

Mesh’i düğüme node.entity aracılığıyla atayın, ardından sahneyi kaydedin:

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

Bunun yerine tek bir kendi içinde barındıran .glb dosyası üretmek için, saveOpts.binaryMode = true ayarlayın ve çıktı dosya uzantısını .glb olarak değiştirin.