Aspose.3D FOSS
Python
Developer Guide
Loading Models

Load Files with Aspose.3D

Overview

Aspose.3D FOSS for Python enables loading 3D files into memory for inspection and manipulation. It provides core classes like Scene, Node, Mesh, and Entity to represent 3D content.

The Scene class serves as the root container for 3D objects, while Node instances form the scene graph hierarchy. Mesh and Geometry define shape data, and Entity-derived objects support visibility and shadow properties. These classes integrate with FileFormat to support formats like WAVEFRONT_OBJ, GLTF2, and FBX7400ASCII.

Key Features

Aspose.3D FOSS for Python enables loading and manipulation of 3D assets through a focused API surface. Developers can work with core entities like Scene, Node, Mesh, and Entity, and inspect metadata via AssetInfo and A3DObject.

  • Supports loading common 3D formats including OBJ, glTF 2.0, 3MF, and FBX via FileFormat static methods.
  • Enables programmatic access to scene hierarchy and object properties through Scene, Node, and A3DObject classes.
  • Provides metadata inspection capabilities via AssetInfo to retrieve title, author, and subject from loaded 3D files without requiring external tools.
  • Allows direct manipulation of mesh geometry and entity properties using Mesh, Geometry, and Entity classes.
  • Exposes global transformation data via GlobalTransform to calculate translation, rotation, and scale for scene alignment.

Prerequisites

To use Aspose.3D FOSS for Python for loading 3D files, ensure you have Python 3.7 or later installed. Install the package via pip.

pip install aspose-3d-foss
import aspose.threed
print('Installation successful')
  • Python 3.7 or later
  • aspose-3d-foss package installed via pip
  • Basic familiarity with 3D concepts (scenes, nodes, meshes)

Code Examples

Use Scene.from_file() to load supported formats like OBJ, GLTF2, and 3MF directly from file paths.

from aspose.threed import Scene

scene = Scene.from_file("model.obj")
print(f"Loaded scene with {len(scene.root_node.child_nodes)} child nodes")

Notes and Best Practices

When loading 3D files with Aspose.3D FOSS for Python, ensure your environment uses the correct import path and that files are accessible. The Scene class is the primary entry point for loading files via Scene.from_file(), and FileFormat helps detect or specify formats.

  • Use Scene.from_file() to load files; this is the supported static factory method for opening 3D files from disk.
  • Verify file format compatibility using FileFormat before loading to prevent unsupported format errors.
  • Handle exceptions for file I/O and format detection, especially when processing user-provided files.
  • Prefer loading from local paths or streams with known formats to avoid ambiguity.

See Also

 English