File IO

There is a flexible interface for loading and saving point clouds and meshes from different formats.

The main usage is via the pytorch3d.io.IO object, and its methods load_mesh, save_mesh, load_pointcloud and save_pointcloud.

For example, to load a mesh you might do

from pytorch3d.io import IO

device=torch.device("cuda:0")
mesh = IO().load_mesh("mymesh.obj", device=device)

and to save a pointcloud you might do

pcl = Pointclouds(...)
IO().save_pointcloud(pcl, "output_pointcloud.ply")

For meshes, this supports OBJ, PLY and OFF files.

For pointclouds, this supports PLY files.

In addition, there is experimental support for loading meshes from glTF 2 assets stored either in a GLB container file or a glTF JSON file with embedded binary data. This must be enabled explicitly, as described in pytorch3d/io/experimental_gltf_io.py.