常见的提问

许可与开源

什么是Aspose.3D FOSS的许可模型?

Aspose.3D FOSS for Java 是 MIT 许可证下发布的,您可以在个人、商业和开源项目中使用它,无限制。.

我可以在商业产品中使用 Aspose.3D FOSS for Java 吗?

是的,MIT许可证允许无限使用商业产品. 在工作时间内不需要任何权利支付、许证服务器或互联网连接。.

安装与要求

如何安装 Aspose.3D FOSS for Java?

加入Maven依赖性到你的 pom.xml:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.5.0</version>
</dependency>

然后将包装输入到您的源文件中:

import com.aspose.threed.*;

需要什么样的Java版本?

Aspose.3D FOSS for Java 需要 JDK 21 或更晚的版本,它完全自含,没有原生依赖和没有平台特定的二进制。.

支持格式

哪些 3D 文件格式可以为 Java 阅读和写作?

目前的发布支持以下格式:

如何自动检测文件格式?

使用 FileFormat.getFormatByExtension(filePath) 通过文件扩展查看格式:

FileFormat fmt = FileFormat.getFormatByExtension("model.gltf");
System.out.println(fmt.getCanImport()); // true
System.out.println(fmt.getCanExport()); // true

我如何使用特定格式的加载或存储选项?

通过一个格式特定的选项对象到 Scene.open() 或 Scene.save().例如, 允许在加载 glTF 时协调系统飞行:

GltfLoadOptions opts = new GltfLoadOptions();
opts.setFlipCoordinateSystem(true);

Scene scene = new Scene();
scene.open("input.gltf", opts);

对于GlTF出口与精致印刷JSON:

GltfSaveOptions saveOpts = new GltfSaveOptions();
saveOpts.setPrettyPrint(true);
scene.save("output.gltf", saveOpts);

同样, FbxLoadOptions 可用于 FBX 进口配置。.

火灾使用

我如何从文件中加载3D模型?

使用静态工厂 Scene.fromFile(filePath) 要做一步负载,或者建造一个 Scene 和呼叫 scene.open(filePath):

// Option 1 — static factory (recommended)
Scene scene = Scene.fromFile("model.obj");

// Option 2 — instance method
Scene scene2 = new Scene();
scene2.open("model.fbx");

我如何创建一个新的空白场景,并保存它?

建造A Scene,按需要添加节点,然后打电话 scene.save(filePath):

Scene scene = new Scene();
Node child = scene.getRootNode().createChildNode("Box");
scene.save("output.glb");

我如何通过场景图表?

通过 root node 访问 scene.getRootNode() 以其子女为主:

Scene scene = Scene.fromFile("model.gltf");
Node root = scene.getRootNode();

for (Node child : root.getChildNodes()) {
    System.out.println(child.getName());
}

如何将一个场景保存到特定的格式?

通过目标扩展输出路径 - Aspose.3D 检测到从目标中获取的格式。 自动扩展. 要明确控制,通过一个 FileFormat 或保存选项对象:

// Auto-detect output format from extension
scene.save("output.stl");

// Explicit format (using options object)
GltfSaveOptions opts = new GltfSaveOptions();
opts.setBufferFilePrefix("buffer_");
scene.save("output.gltf", opts);

已知限制

3D 播放在此版本中可用吗?

是的,The Scene.render() 方法投射 UnsupportedOperationException 在当前的 福斯发布. 转让尚未实施. 为进口、处理、, 仅出口3D场景数据。.

所有 FBX 功能都支持吗?

FBX 进口支持地质和场景图表数据。 实施 - 通过 FBX 格式投射的呼叫保存 ExportException.综合FbX 进口功能如嵌入式动画、限制和属性FBX 延伸可能无法完全保存。.