Bắt đầu

Bắt đầu với Aspose.3D FOSS cho Java

Chào mừng đến aspose-3d-foss, một thư viện Java miễn phí, mã nguồn mở để tải, xây dựng và xuất các cảnh 3D. Hướng dẫn này đưa bạn từ dự án mới bắt đầu đến một cảnh hoạt động trong vài phút.


Yêu cầu

Yêu cầuChi tiết
JavaJDK 21 hoặc mới hơn
Công cụ xây dựngMaven hoặc Gradle
OSWindows, macOS hoặc Linux

Cài đặt

Thêm phụ thuộc Maven vào dự án của bạn pom.xml:

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

Xác minh:

import com.aspose.threed.Scene;

public class Main {
    public static void main(String[] args) {
        Scene scene = new Scene();
        System.out.println("aspose-3d-foss loaded successfully.");
    }
}

Xem Hướng dẫn Cài đặt để thiết lập Gradle và các bước xác minh.


Bạn có thể làm gì

Sau khi cài đặt, bạn có thể ngay lập tức:

  • Tải các tệp OBJ, STL, glTF 2.0 / GLB và FBX qua scene.open()
  • Kiểm tra cây cảnh: duyệt Node cây, đọc Mesh đối tượng hình học, truy cập các pháp tuyến đỉnh và UV
  • Biến đổi các nút: đặt dịch chuyển, quay và tỉ lệ thông qua Transform lớp
  • Áp dụng vật liệu: gán Material hoặc PbrMaterial cho các nút
  • Xuất đến bất kỳ định dạng được hỗ trợ nào với scene.save()
  • Xây dựng hình học: tạo Mesh đối tượng lập trình với các điểm điều khiển và đa giác

Bắt đầu nhanh

Tải một tệp 3D, in ra cấu trúc cây cảnh, và lưu lại dưới định dạng GLB:

import com.aspose.threed.Scene;
import com.aspose.threed.Node;

public class QuickStart {
    public static void main(String[] args) throws Exception {
        Scene scene = new Scene();
        scene.open("input.obj");

        System.out.println("Root children: " + scene.getRootNode().getChildNodes().size());
        for (Node node : scene.getRootNode().getChildNodes()) {
            String entityType = node.getEntity() != null
                ? node.getEntity().getClass().getSimpleName()
                : "no entity";
            System.out.println("  " + node.getName() + " [" + entityType + "]");
        }

        scene.save("output.glb");
        System.out.println("Saved output.glb");
    }
}

Các bước tiếp theo

 Tiếng Việt