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

Aspose.3D FOSS cho Java

Tải, tạo, biến đổi và xuất các cảnh 3D từ Java — miễn phí và mã nguồn mở.

Aspose.3D FOSS for Java Aspose.3D FOSS
for Java

Tài Liệu GitHub

Thư viện Java mã nguồn mở cho Xử lý Tệp 3D

Aspose.3D FOSS cho Java là một thư viện thuần Java, được cấp phép MIT, dùng để làm việc với các định dạng tệp 3D. Thêm một phụ thuộc Maven duy nhất và ngay lập tức bắt đầu đọc, tạo và ghi các cảnh 3D mà không cần cài đặt bất kỳ runtime gốc nào, SDK bên ngoài, hay trình render của bên thứ ba.

Thư viện cung cấp một API đồ thị cảnh sạch sẽ, được xây dựng quanh Scene, Node, Mesh, Camera 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ợ các định dạng bao gồm OBJ (với việc tải vật liệu .mtl), STL (nhị phân và ASCII, đã được xác minh vòng quay), glTF 2.0 (vật liệu PBR), GLB (glTF nhị phân), và FBX (chỉ nhập). Các tùy chọn tải và lưu cho từng định dạng cho phép bạn kiểm soát việc lật tọa độ, tỉ lệ, chuẩn hoá pháp tuyến và tải vật liệu mà không cần viết mã phân tích cú pháp riêng cho định dạng.

Aspose.3D FOSS yêu cầu Java 21 trở lên và chạy giống hệt trên các môi trường CI Windows, macOS và Linux, các container Docker, và môi trường không máy chủ. Không có phần mở rộng gốc nào cần biên dịch và không có gói hệ thống nào cần cài đặt.

Hỗ trợ định dạng 3D và API Đồ thị Cảnh

  • OBJ / MTL: Tải các tệp Wavefront OBJ kèm theo định nghĩa vật liệu.
  • STL: Đọc và ghi cả STL nhị phân và ASCII với việc xác minh vòng quay đầy đủ.
  • glTF 2.0 / GLB: Tải vật liệu PBR và xuất qua GltfSaveOptions. Sử dụng setContentType(FileContentType.BINARY) cho đầu ra GLB.
  • FBX: Hỗ trợ nhập để tải các tệp FBX (không có khả năng xuất).
  • API đồ thị cảnh: Scene, Node, Mesh, Camera, Transform.

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

  • Đường ống xác thực tài sản: Kiểm tra, định hướng lại và xuất lại tài sản 3D trong CI.
  • Công cụ phát triển game: Xử lý hàng loạt lưới OBJ và STL mà không cần engine gốc.
  • Quy trình in 3D: Đọc, xác thực và xuất lại các tệp STL.
  • Web backends: Cung cấp các endpoint chuyển đổi 3D trong Docker hoặc các hàm serverless.
  • Content migration: Chuyển đổi giữa các họ định dạng ở quy mô lớn.

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 mà không cần mã tùy chỉnh.
  • 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.
  • Kiểm soát tải vật liệu: Bật hoặc tắt việc tải MTL/texture để phân tích nhanh hơn.
  • Đầu ra in đẹp: Chọn JSON glTF dạng gọn hoặc dễ đọc cho con người qua các tùy chọn.
  • Độ trung thực vòng lặp: 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 Java cài đặt với một phụ thuộc Maven duy nhất (com.aspose:aspose-3d-foss:26.1.0). Thư viện hoàn toàn Java, không có phần mở rộng native để biên dịch và không có gói hệ thống nào cần cài đặt.

API đồ thị cảnh phản ánh mô hình khái niệm của các công cụ 3D chuyên nghiệp, vì vậy đường cong học tập ngắn đối với bất kỳ ai quen thuộc với mô hình dữ liệu của Three.js hoặc Blender. Thư viện được cấp phép MIT, mã nguồn mở, và chào đón các báo cáo lỗi cũng như đóng góp trên GitHub.

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

Thêm phụ thuộc Maven, sau đó gọi Scene.fromFile("model.obj") để tải tệp OBJ cùng với các định nghĩa vật liệu MTL của nó. Một lệnh scene.save() duy nhất với phần mở rộng .gltf sẽ ghi một tệp JSON glTF 2.0, mà không cần đăng ký định dạng hay đối tượng chuyển đổi nào.

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>

import com.aspose.threed.*;

// Tải tệp OBJ (với vật liệu .mtl)
Scene scene = Scene.fromFile("model.obj");

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

Chuyển đổi STL sang glTF bằng GltfSaveOptions

Để tạo một tệp glTF với các điều chỉnh hệ tọa độ, hãy truyền một thể hiện GltfSaveOptions với setFlipCoordinateSystem(true). Mẫu tương tự áp dụng cho tất cả các tùy chọn theo định dạng — thay lớp tùy chọn bằng lớp phù hợp với định dạng bạn đang nhắm tới.

import com.aspose.threed.*;

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

// Lưu dưới dạng glTF với các tùy chọn
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

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

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

Đây là một thư viện pure-Java 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ỳ môi trường chạy 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), STL (nhị phân và ASCII), glTF 2.0, GLB (glTF nhị phân), và FBX (chỉ nhập). Mỗi định dạng có một lớp tùy chọn tải/lưu riêng.

Nó có yêu cầu bất kỳ phụ thuộc gốc nào không?

Không. Aspose.3D FOSS cho Java là pure Java không có bất kỳ phần mở rộng gốc nào. Nó chạy trên Windows, macOS và Linux mà không cần bước biên dịch nào.

Làm thế nào để cài đặt nó?

Thêm phụ thuộc Maven com.aspose:aspose-3d-foss:26.1.0 vào dự án của bạn. Không cần gói hệ thống bổ sung hay phần mở rộng gốc nào.

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 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 viết mã phân tích cú pháp riêng cho từng định dạng.

Phiên bản Java nào được hỗ trợ?

Java 21 và các phiên bản sau được hỗ trợ. Thư viện chạy giống hệt trên tất cả các hệ điều hành chính.

Mã nguồn có sẵn không?

Có. 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 requests được chào đón.

  

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

 Tiếng Việt