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

Aspose.3D FOSS for TypeScript

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

Thư viện Open-Source TypeScript cho xử lý tệp 3D

Aspose.3D FOSS cho TypeScript là một thư viện có giấy 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, xây dựng 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 Scene, Node, Entity, Mesh, Camera, LightTransform, 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 tròn đầy đủ), COLLADA (DAE), 3MF và FBX. Các lớp tùy chọn theo định dạng như ObjLoadOptionsGltfSaveOptions cho phép bạn kiểm soát chính xác việc định hướng hệ tọa độ, tỉ lệ, chuẩn hoá pháp tuyến, đầu ra nhị phân so với JSON, và 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 thời gian biên dịch. Phụ thuộc runtime duy nhất của nó, xmldom, được cài đặt tự động. Đối với dòng sản phẩm doanh nghiệp, xem Aspose.3D — Enterprise Product Family.

Hỗ trợ định dạng 3D và API đồ thị cảnh được gõ

  • ** OBJ / MTL:** Load Wavefront OB J file với các định nghĩa vật liệu đi kèm.
  • glTF 2.0 / GLB: PBR vật liệu tải và nhị phân GDB đầu ra thông qua GltfSaveOptions.
  • STL: Đọc và viết cả hai STL nhị phân và ASCII với xác minh vòng tròn đầy đủ.
  • COLLADA, 3MF, FBX: Hỗ trợ định dạng bổ sung với các lớp tùy chọn cho mỗi định hình.
  • Dạng TypeScript đầy đủ: Mỗi lớp, phương thức và tùy chọn được nhập mạnh với noImplicitAnystrictNullChecks.

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

  • Node.js tài sản đường ống: Nhập tệp OBJ, xác nhận và định hướng lại hình học, và xuất như GLB trong CI.
  • ** Công cụ trò chơi:** Các lưới 3D xử lý hàng loạt mà không có động cơ hoặc trình hiển thị bản địa.
  • ** Luân chuyển in 3D:** Đọc, xác nhận và tái xuất các tệp STL và 3MF.
  • ** Serverless backends:** Chạy các điểm kết thúc chuyển đổi 3D trong Lambda hoặc Cloud Functions.
  • ** Di chuyển nội dung:** Chuyển đổi giữa các gia đình định dạng theo quy mô từ một kịch bản duy nhất.

Tùy chọn định dạng và kiểm soát phối hợp

  • ** Định hướng hệ thống tọa độ:** Chuyển trục và điều chỉnh thang theo định dạng với các lớp tùy chọn.
  • Điều bình thường: Tự động chuẩn hóa các tiêu chuẩn đỉnh khi tải hoặc lưu.
  • ** Tích xuất nhị phân so với JSON:** Chọn GLB nhỏ gọn hoặc glTF có thể đọc được thông qua GltfSaveOptions.
  • ** Kiểm soát tải vật liệu:** Cho phép hoặc vô hiệu hóa MTL / texture loading để phân tích nhanh hơn.
  • Đúng với vòng quay: Các nút đồ thị không rõ được bảo quản theo nghĩa đen khi lưu lại.

Kinh nghiệm của nhà phát triển

Aspose.3D FOSS for TypeScript cài đặt với một lệnh npm install @aspose/3d. Không có bổ sung bản địa để biên dịch. Thư viện là Typecript / JavaScript thuần khiết với 1 phụ thuộc tự động cài (xmldom).

API được gõ mạnh cung cấp hoàn chỉnh tự động IDE đầy đủ cho mọi lớp và tùy chọn định dạng cảnh. Thư viện nhắm mục tiêu Node.js 1822 + và TypeScript 5.0+, chạy giống nhau trên trình điều hành Linux CI và trạm làm việc của nhà phát triển, và có giấy phép MIT với một tracker vấn đề mở trên GitHub .

Tải một OBJ Scene và xuất như glTF

Cài đặt bằng npm, sau đó sử dụng scene.open() với ObjLoadOptions để tải lưới cùng với tệp vật liệu MTL của nó. Cả open()save() đều đồng bộ — không cần await hay chuỗi Promise. Gọi scene.save() với phần mở rộng .gltf sẽ ghi chuẩn glTF 2.0 JSON — định dạng được suy ra tự động từ phần mở rộng tệp.

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());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

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

Để tạo ra một GLB nhị phân gọn thay vì glTF JSON mặc định, hãy truyền GltfSaveOptions với binaryMode = true. Cả open()save() đều đồng bộ — không cần await.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
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ì?

Nó là một thư viện TypeScript / Node.js miễn phí, được cấp phép bởi MIT để tải, thao tác và lưu cảnh 3D mà không cần cài đặt bất kỳ addon bản địa hoặc SDK bên ngoài nào.

Các định dạng 3D được hỗ trợ là gì?

OBJ (với .mtl), glTF 2.0 và GLB, STL (hai tính và ASCII), COLLADA (DAE), 3MF và FBX. Mỗi định dạng có một lớp tùy chọn được đánh máy chuyên dụng.

Nó có yêu cầu Node.js addons bản địa không?

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

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

Chạy npm install @aspose/3d. Không cần thêm gói hệ thống hoặc bổ sung bản địa.

Các phiên bản Node.js và TypeScript được hỗ trợ là gì?

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

Nó có cung cấp với định nghĩa kiểu TypeScript không?

Tất cả các lớp, phương thức, enum và loại tùy chọn được nhập đầy đủ với noImplicitAnystrictNullChecks bật.

Tôi có thể điều khiển định hướng hệ thống tọa độ không?

Vâng. Per-format option classes như ObjLoadOptionsGltfSaveOptions cho phép bạn flip axes, điều chỉnh quy mô, và bình thường hóa thông thường mà không cần mã phân tích tùy chỉnh.

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

Thư viện được cấp phép bởi MIT và lưu trữ trên GitHub. Báo cáo lỗi và yêu cầu kéo là chào đón.

  

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

 Tiếng Việt