1. Sản Phẩm
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS cho TypeScript

Tải, xây dựng, biến đổi và xuất các cảnh 3D từ Node.js — đầy đủ kiểu dữ liệu, mã nguồn mở và sẵn sàng cho sản xuất chỉ với một lệnh cài đặt npm.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Tài Liệu GitHub

Thư viện TypeScript mã nguồn mở cho xử lý tệp 3D

Aspose.3D FOSS cho TypeScript là một thư viện được cấp phép MIT để làm việc với các định dạng tệp 3D trong các ứng dụng Node.js. Cài đặt nó bằng một lệnh npm install @aspose/3d duy nhất và bắt đầu đọc, tạo và ghi các cảnh 3D bằng TypeScript ngay lập tức, mà không cần addon gốc để biên dịch, không cần SDK bên ngoài để cài đặt, và không yêu cầu trình render.

Thư viện cung cấp một API đồ thị cảnh được gõ đầy đủ, được xây dựng quanh các lớp Scene, Node, Entity, Mesh, Camera, Light và Transform, cùng mô hình khái niệm được các công cụ 3D chuyên nghiệp sử dụng. Hỗ trợ định dạng bao gồm OBJ (Wavefront, với việc tải vật liệu .mtl), glTF 2.0 và GLB nhị phân (vật liệu PBR), STL (nhị phân và ASCII, vòng quay đầy đủ), COLLADA (DAE), 3MF và FBX. Các lớp tùy chọn theo định dạng như ObjLoadOptions và GltfSaveOptions cho phép bạn kiểm soát chính xác hướng hệ tọa độ, tỉ lệ, chuẩn hoá pháp tuyến, đầu ra nhị phân so với JSON, và việc tải vật liệu.

Aspose.3D FOSS nhắm tới Node.js 18, 20 và 22+ với TypeScript 5.0+ và biên dịch sang CommonJS. Thư viện đi kèm với các cài đặt biên dịch TypeScript nghiêm ngặt (noImplicitAny, strictNullChecks) để IDE của bạn cung cấp tính năng tự động hoàn thành đầy đủ và an toàn khi biên dịch. Phụ thuộc runtime duy nhất của nó, xmldom, được cài đặt tự động.

Hỗ trợ Định dạng 3D và API Đồ thị Cảnh có Kiểu

  • OBJ / MTL: Tải các tệp Wavefront OBJ kèm theo định nghĩa vật liệu.
  • glTF 2.0 / GLB: Tải vật liệu PBR và xuất GLB nhị phân thông qua GltfSaveOptions.
  • STL: Đọc và ghi cả STL nhị phân và ASCII với việc xác minh vòng quay đầy đủ.
  • COLLADA, 3MF, FBX: Hỗ trợ định dạng bổ sung với các lớp tùy chọn theo định dạng.
  • Full TypeScript types: Mỗi lớp, phương thức và tùy chọn đều được gõ mạnh mẽ với noImplicitAny và strictNullChecks.

Nơi Aspose.3D FOSS có thể được sử dụng

  • Pipeline tài sản Node.js: Nhập tệp OBJ, xác thực và định hướng lại hình học, và xuất ra GLB trong CI.
  • Công cụ game: Xử lý hàng loạt lưới 3D mà không cần engine hoặc renderer gốc.
  • Quy trình in 3D: Đọc, xác thực và xuất lại tệp STL và 3MF.
  • Serverless backends: Chạy các endpoint chuyển đổi 3D trong Lambda hoặc Cloud Functions.
  • Content migration: Chuyển đổi giữa các họ định dạng ở quy mô lớn từ một script duy nhất.

Tùy chọn theo Định dạng và Kiểm soát Tọa độ

  • Định hướng hệ tọa độ: Đảo trục và điều chỉnh tỉ lệ theo định dạng với các lớp tùy chọn.
  • Chuẩn hoá pháp tuyến: Tự động chuẩn hoá các pháp tuyến đỉnh khi tải hoặc lưu.
  • Đầu ra nhị phân vs. JSON: Chọn GLB gọn nhẹ hoặc glTF có thể đọc được qua GltfSaveOptions.
  • Kiểm soát tải vật liệu: Bật hoặc tắt việc tải MTL/texture để tăng tốc phân tích.
  • Độ trung thực vòng quay: Các nút đồ thị cảnh không xác định được giữ nguyên nguyên văn khi lưu lại.

Trải nghiệm nhà phát triển

Aspose.3D FOSS cho TypeScript cài đặt bằng một lệnh npm install @aspose/3d duy nhất. Không có addon gốc nào cần biên dịch. Thư viện thuần TypeScript/JavaScript với một phụ thuộc được tự động cài đặt (xmldom).

API được gõ mạnh mẽ cung cấp tính năng tự động hoàn thành đầy đủ trong IDE cho mọi lớp đồ thị cảnh và tùy chọn định dạng. Thư viện nhắm tới Node.js 18–22+ và TypeScript 5.0+, chạy giống hệt trên các runner CI Linux và máy làm việc của nhà phát triển, và được cấp phép MIT với hệ thống theo dõi issue mở trên GitHub.

Tải một cảnh OBJ và xuất dưới dạng glTF

Cài đặt bằng npm, sau đó sử dụng phương thức đồng bộ scene.open() với ObjLoadOptions để tải mesh cùng với file vật liệu MTL của nó. Gọi scene.save() với phần mở rộng .gltf sẽ ghi ra JSON glTF 2.0 tiêu chuẩn; định dạng được suy ra tự động từ phần mở rộng file.

npm install @aspose/3d

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

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

// Xuất dưới dạng glTF 2.0 JSON
scene.save("model.gltf");

Chuyển đổi STL sang GLB nhị phân

Để tạo một tệp nhị phân GLB gọn gàng thay vì JSON glTF mặc định, hãy truyền GltfSaveOptions với binaryMode = true.

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

const scene = new Scene();
scene.open("mesh.stl");

// Lưu dưới dạng GLB nhị phân gọn
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Câu Hỏi Thường Gặp

Aspose.3D FOSS cho TypeScript là gì?

Đây là một thư viện TypeScript/Node.js miễn phí, có giấy phép MIT, dùng để tải, thao tác và lưu các cảnh 3D mà không cần cài đặt bất kỳ addon gốc nào hoặc SDK bên ngoài.

Các định dạng 3D nào được hỗ trợ?

OBJ (kèm .mtl), glTF 2.0 và GLB, STL (binary và ASCII), COLLADA (DAE), 3MF và FBX. Mỗi định dạng có một lớp tùy chọn kiểu riêng.

Nó có yêu cầu các addon gốc của Node.js không?

Không. Aspose.3D FOSS cho TypeScript là JavaScript/TypeScript thuần. Nó không yêu cầu bước biên dịch và chỉ có một phụ thuộc thời gian chạy duy nhất (xmldom) được npm cài đặt tự động.

Làm sao để cài đặt nó?

Chạy npm install @aspose/3d. Không cần gói hệ thống bổ sung hay addon gốc nào.

Phiên bản Node.js và TypeScript nào được hỗ trợ?

Node.js 18, 20 và 22+. TypeScript 5.0+. Thư viện biên dịch thành CommonJS và hoạt động với các cài đặt TypeScript nghiêm ngặt.

Nó có đi kèm với các định nghĩa kiểu TypeScript không?

Có. Tất cả các lớp, phương thức, enum và kiểu tùy chọn đều được gán kiểu đầy đủ với noImplicitAny và strictNullChecks được bật.

Tôi có thể kiểm soát hướng hệ tọa độ không?

Có. Các lớp tùy chọn theo định dạng như ObjLoadOptions và GltfSaveOptions cho phép bạn đảo trục, điều chỉnh tỉ lệ và chuẩn hoá vector pháp tuyến mà không cần mã phân tích tùy chỉnh.

Tôi có thể tìm mã nguồn ở đâu?

Thư viện được cấp phép MIT và được lưu trữ trên GitHub. Các báo cáo lỗi và pull request đều được chào đón.

  

Tài Nguyên Hỗ Trợ và Học Tập

 Tiếng Việt