Cách tạo lưới 3D bằng lập trình trong TypeScript

Bước 1: Cài đặt @aspose/3d

npm install @aspose/3d

Không cần addon gốc hay thư viện hệ thống. Gói bao gồm các định nghĩa kiểu TypeScript.

Tối thiểu tsconfig.json:

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

Bước 2: Tạo một Scene và Node

Một Scene là container cấp cao nhất. Tất cả hình học phải được gắn vào một Node trong cây cảnh:

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

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

createChildNode(name) tạo một nút có tên và nối nó như một nút con của nút hiện tại. Đối tượng Node được trả về là nơi bạn sẽ gắn lưới trong Bước 7.

Bước 3: Tạo một Đối tượng Mesh

Mesh chứa các vị trí đỉnh và định nghĩa đa giác. Tạo một đối tượng với tên tùy chọn:

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

const mesh = new Mesh('triangle');

Lưới bắt đầu trống rỗng: không có đỉnh và không có mặt. Bạn sẽ thêm chúng trong các bước tiếp theo.

Bước 4: Thêm các điểm điều khiển (đỉnh)

Các điểm điều khiển là vị trí đỉnh trong không gian cục bộ. Đẩy các giá trị Vector4 vào mesh.controlPoints. Thành phần thứ tư (w) là 1 cho các vị trí:

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

Bạn tham chiếu các vị trí này bằng chỉ mục bắt đầu từ 0 khi định nghĩa các mặt đa giác.

Bước 5: Tạo các mặt đa giác

createPolygon() định nghĩa một mặt bằng cách liệt kê các chỉ số đỉnh theo thứ tự. Ba chỉ số tạo thành một tam giác:

mesh.createPolygon(0, 1, 2);

Bạn cũng có thể định nghĩa các hình tứ giác (bốn chỉ số) hoặc các đa giác tùy ý cho các định dạng hỗ trợ chúng. Đối với glTF, thư viện sẽ tự động chia tứ giác và n-gons thành tam giác khi xuất.

Bước 6: Thêm pháp tuyến đỉnh

Các vector pháp tuyến cải thiện chất lượng hiển thị. Sử dụng mesh.createElement() để tạo một VertexElementNormal, thu thập các vector pháp tuyến vào một mảng, sau đó gọi setData() để lưu chúng. Phương thức getter data trả về một bản sao bảo vệ — việc đẩy vào nó không có tác dụng. Sử dụng FVector3 (số thực đơn độ chính xác) cho dữ liệu pháp tuyến, không phải 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 có nghĩa là một pháp tuyến cho mỗi đỉnh. ReferenceMode.DIRECT có nghĩa là mảng dữ liệu được đánh chỉ mục trực tiếp theo chỉ số đỉnh đa giác.

Bước 7: Gắn Mesh và Lưu thành glTF

Gán lưới cho nút thông qua node.entity, sau đó lưu cảnh:

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

Để tạo một tệp .glb tự chứa duy nhất thay thế, hãy đặt saveOpts.binaryMode = true và thay đổi phần mở rộng tệp đầu ra thành .glb.