How to Load 3D Models in Java

aspose-3d-foss for Java provides a straightforward API for opening 3D files. After loading a file into a Scene object you can walk the node hierarchy and read geometry data.

Step-by-Step Guide

Step 1: Install the Package

Add the Maven dependency:

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

Step 2: Import the Scene Class

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

Step 3: Load a File

Scene scene = new Scene();
scene.open("model.obj");

Or use the static factory:

Scene scene = Scene.fromFile("model.obj");

Supported formats: OBJ, STL, glTF 2.0 / GLB, FBX.

Step 4: Traverse Scene Nodes

void walk(Node node, int depth) {
    String indent = " ".repeat(depth * 2);
    System.out.println(indent + "Node: " + node.getName());
    for (Node child : node.getChildNodes()) {
        walk(child, depth + 1);
    }
}

walk(scene.getRootNode(), 0);

Step 5: Access Mesh Data

for (Node node : scene.getRootNode().getChildNodes()) {
    if (node.getEntity() instanceof Mesh) {
        Mesh mesh = (Mesh) node.getEntity();
        System.out.println("Mesh '" + node.getName() + "': " +
            mesh.getControlPoints().size() + " vertices, " +
            mesh.getPolygonCount() + " polygons");
    }
}

Common Issues and Fixes

Exception on load

Verify the file is not corrupted and the format is supported (OBJ, STL, glTF, FBX).

NullPointerException accessing entity

Not every node carries geometry. Always check node.getEntity() instanceof Mesh before casting.

Coordinate system mismatch

Use ObjLoadOptions.setFlipCoordinateSystem(true) or apply a rotation after loading.

Frequently Asked Questions (FAQ)

Which formats can I load?

OBJ, STL (binary and ASCII), glTF 2.0 / GLB, and FBX.

Can I load from an InputStream?

Yes. scene.open() accepts an InputStream.

Is the library thread-safe?

Each Scene instance is independent. Loading separate files into separate instances from separate threads is safe.