Cách xuất cảnh 3D sang glTF/GLB trong TypeScript

Aspose.3D FOSS hỗ trợ glTF 2.0 như một định dạng nhập và xuất. Cùng một đối tượng Scene có thể được tạo từ tệp OBJ, FBX, STL hoặc các tệp nguồn khác và sau đó được ghi vào .gltf (JSON + nhị phân bên ngoài) hoặc .glb (bộ chứa nhị phân duy nhất) bằng cách đặt một cờ trên GltfSaveOptions.

Hướng Dẫn Từng Bước

npm install @aspose/3d

node --version   # must be >= 16.0.0

import { Scene } from '@aspose/3d';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';

import { ObjLoadOptions } from '@aspose/3d/formats/obj';

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

import { Scene, Node, Mesh } from '@aspose/3d';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';

const scene = new Scene();
const childNode = new Node('cube');
scene.rootNode.addChildNode(childNode);
// Attach geometry to childNode as needed

const saveOpts = new GltfSaveOptions();

// Set to true for a single binary .glb file
// Set to false (default) for JSON .gltf + separate .bin
saveOpts.binaryMode = true;

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

const saveOpts = new GltfSaveOptions();
saveOpts.binaryMode = true;   // produce .glb

scene.save('output.glb', GltfFormat.getInstance(), saveOpts);
console.log('Converted to GLB successfully');

saveOpts.binaryMode = false;
scene.save('output.gltf', GltfFormat.getInstance(), saveOpts);
console.log('Exported to glTF JSON successfully');

import * as fs from 'fs';

const outputPath = 'output.glb';
const stats = fs.statSync(outputPath);
console.log(`Output file size: ${stats.size} bytes`);

if (stats.size === 0) {
    throw new Error('Export produced an empty file: check scene content');
}

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

const verify = new Scene();
verify.open('output.glb', new GltfLoadOptions());

let nodeCount = 0;
function countNodes(node: any): void {
    nodeCount++;
    for (const child of node.childNodes) countNodes(child);
}
countNodes(verify.rootNode);

console.log(`Round-trip verification: ${nodeCount} node(s) in output`);

Các vấn đề thường gặp và cách khắc phục

Không tìm thấy tệp vật liệu OBJ sau khi xuất
Khi lưu dưới dạng OBJ qua scene.save('output.obj'), tệp vật liệu .mtl sẽ được ghi cùng với tệp .obj một cách tự động. Đảm bảo thư mục đầu ra có quyền ghi và cả hai tệp được giữ cùng nhau.

Output .glb is smaller than expected / meshes are missing
Nếu cảnh đã tải có các nút không có thực thể (ví dụ: các nhóm trống từ một OBJ), GLB sẽ không chứa hình học của các nút đó. Xác nhận tệp đầu vào của bạn có dữ liệu đa giác thực tế bằng cách sử dụng mesh.controlPoints.length > 0 trước khi lưu.

Không thể tìm thấy mô-đun ‘@aspose/3d/formats/gltf’
Đảm bảo bạn đang sử dụng Node.js 18+ và @aspose/3d được cài đặt trong cùng node_modules với điểm vào của bạn. Chạy npm ls @aspose/3d để xác nhận phiên bản là 24.12.0 trở lên.

GltfFormat.getInstance() trả về undefined
Điều này cho thấy có sự không khớp phiên bản giữa gói @aspose/3d chính và một phiên bản cũ đã được lưu trong bộ nhớ đệm. Xóa node_modules và package-lock.json, sau đó chạy lại npm install.

Textures are missing in the output GLB
Đảm bảo binaryMode = true được đặt để tạo ra một GLB tự chứa. Đối với đầu ra glTF JSON, các tệp hình ảnh kết cấu phải có mặt bên cạnh tệp đầu ra vì chúng được tham chiếu bằng đường dẫn tương đối.

Lỗi kiểu: Đối số có kiểu ‘GltfSaveOptions’ không thể gán
Đảm bảo cả Scene và GltfSaveOptions đều được nhập khẩu từ cùng một phiên bản gói đã cài đặt. Việc cài đặt hỗn hợp (toàn cầu + cục bộ) có thể gây ra sự không khớp giao diện.

Câu hỏi thường gặp (FAQ)

Sự khác nhau giữa glTF và GLB là gì? glTF 2.0 JSON (.gltf) lưu trữ đồ thị cảnh dưới dạng tệp JSON có thể đọc được bởi con người với các bộ đệm .bin riêng biệt và các tệp hình ảnh. GLB (.glb) đóng gói mọi thứ vào một container nhị phân duy nhất. Đặt binaryMode = true cho GLB, false cho JSON glTF.

Có thể xuất một cảnh được xây dựng hoàn toàn bằng mã (không có tệp nguồn) không?
Có. Tạo một Scene, thêm các đối tượng Node, gắn Mesh hoặc các thực thể khác, sau đó gọi scene.save(). Cảnh không cần phải xuất phát từ một tệp đã tải.

Xuất glTF có mất dữ liệu không?
Đối với hình học và biến đổi, có. Vật liệu được ánh xạ sang các thuộc tính vật liệu PBR của glTF khi có thể. Các phần mở rộng vật liệu FBX độc quyền có thể không được chuyển đổi qua lại một cách hoàn hảo.

Tôi có thể xuất sang STL hoặc 3MF thay thế không? Có. Mẫu tương tự; nhập các định dạng tương ứng *SaveOptions và *Format.getInstance():

import { StlSaveOptions, StlFormat } from '@aspose/3d/formats/stl';
const opts = new StlSaveOptions();
scene.save('output.stl', StlFormat.getInstance(), opts);

scene.save() có chạy bất đồng bộ không? Không. scene.save() là đồng bộ. Bao bọc nó trong một luồng worker nếu bạn cần tránh việc chặn vòng lặp sự kiện trong quá trình xuất khẩu lớn.

Phiên bản Node.js nào được hỗ trợ?
Node.js 18, 20 và 22+. Node.js 16 và các phiên bản trước đó không được hỗ trợ.

Xem thêm

• Cách tải mô hình 3D trong TypeScript
• Tham chiếu API: GltfSaveOptions
• Tham chiếu API: GltfFormat
• Tham chiếu API: Scene
• npm: @aspose/3d