入门

开始使用 Aspose.3D FOSS for Java

欢迎来到 aspose-3d-foss,，一个免费、开源的 Java 库，用于加载、构建和导出 3D 场景。本指南可帮助您在几分钟内从全新项目创建出可运行的场景。.

先决条件

要求详情
JavaJDK 21 或更高版本
构建工具Maven 或 Gradle
OSWindows、macOS 或 Linux

安装

将 Maven 依赖添加到您的 pom.xml:

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

验证：:

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.");
    }
}

请参阅 安装指南 以获取 Gradle 设置和验证步骤。.

您可以做什么

安装完成后，您可以立即：:

  • 加载 OBJ、STL、glTF 2.0 / GLB 和 FBX 文件 via scene.open()
  • 检查 场景层次结构：遍历 Node 树，读取 Mesh 几何体，访问顶点法线和 UV
  • 变换 节点：通过…设置平移、旋转和缩放 Transform 类
  • 应用材质: 分配 Material 或 PbrMaterial 到节点
  • 导出 到任何受支持的格式，使用 scene.save()
  • 构建几何体: 创建 Mesh 以编程方式使用控制点和多边形创建对象

快速入门

加载 3D 文件，打印场景层次结构，并重新保存为 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");
    }
}

后续步骤

 中文