Làm thế nào để bắt đầu với Aspose.3D FOSS cho TypeScript

@aspose/3d cho TypeScript là một gói miễn phí, được MIT cấp phép để tải lên, thao tác và lưu các tập tin 3D trong Node.js — không có binary bản địa cần thiết, có thể cài đặt từ npm.

Hướng dẫn từng bước

Bước 1: Cài Đặt Gói

Cài đặt từ npm (Node.js 18 hoặc sau đó yêu cầu):

npm install @aspose/3d@24.12.0

Kiểm tra cài đặt đã tải chính xác:

import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");

Bước 2: Nhập các lớp học cần thiết

Import các lớp học bạn cần từ gói:

import { Scene, Node } from "@aspose/3d";

Bước 3: Tải về file 3D

Sử dụng scene.open() tải bất kỳ định dạng được hỗ trợ. Thư viện phát hiện định hình Tự động từ file extension:

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

const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);

Hoặc sử dụng phương pháp nhà máy tĩnh:

const scene = Scene.fromFile("model.glb");

Bước 4: Đi qua kịch bản

Một cảnh tải là một cây của Node Các vật thể được làm gốc trong scene.rootNode:

import { Scene, Node } from "@aspose/3d";

function walk(node: Node, depth: number = 0): void {
    const indent = " ".repeat(depth * 2);
    console.log(`${indent}Node: ${node.name}`);
    for (const child of node.childNodes) {
        walk(child, depth + 1);
    }
}

const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);

Bước 5: Lưu vào định dạng khác nhau

Sử dụng scene.save() để xuất vào bất kỳ định dạng phát hành được hỗ trợ. Thư viện phát hiện các định dạng xuất từ file extension:

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

const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");

Các vấn đề chung và Fixes

Error: ENOENT Khi gọi scene.open() Con đường bạn đi qua không tồn tại. sử dụng con đường tuyệt đối hoặc path.resolve() Để đảm bảo Đường file là đúng.

lỗi định dạng không rõ Bảo đảm rằng phần mở rộng tệp phù hợp với định dạng thực tế. thư viện phát hiện định hình bằng cách: mở rộng cho open() và fromFile().Thông qua một định dạng thông số rõ ràng để vượt quá.

Màn cảnh trống rỗng sau khi tải Một số định dạng nhị phân có thể yêu cầu tùy chọn tải cụ thể.Cố gắng sử dụng quá tải rõ ràng với các tùy chọn định dạng nếu tải mặc định tạo ra một cảnh trống.

Nhập khẩu lỗi TypeScript Định nghĩa kiểu được gắn kết với gói. đảm bảo "moduleResolution": "bundler" hoặc "node16" được đặt trong của bạn tsconfig.json.

Thường xuyên hỏi câu hỏi

@aspose/3d có cần bất kỳ binary bản địa nào không?

Không. gói là JavaScript / TypeScript tinh khiết không có phụ thuộc bản địa. nó chạy trên bất kỳ nền tảng nào hỗ trợ Node.js 18 hoặc sau đó.

Các phiên bản Node.js nào được hỗ trợ?

Node.js 18 or later. The package runs on Windows, macOS, and Linux.

Thư viện có miễn phí để sử dụng thương mại không?

Có. Nó được phát hành theo Giấy phép MIT. Bạn có thể sử dụng, sửa đổi và phân phối lại nó cho bất kỳ mục đích nào, bao gồm các ứng dụng thương mại.

3D định dạng nào tôi có thể đọc và viết?

Bộ gói hỗ trợ OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA và 3MF cho cả hai đọc sách. Sử dụng: sử dụng phần mở rộng dựa trên scene.save() xuất khẩu sang bất kỳ định dạng nào được hỗ trợ.

Tôi có thể tạo ra một cảnh 3D từ scratch không?

Tạo a Scene Không có lý do, thêm nút trẻ em vào scene.rootNode, và - Lưu trữ theo định dạng mong muốn.