trimesh.exchange.ply#

trimesh.exchange.ply.export_draco(mesh, bits=28)#

Export a mesh using Google’s Draco compressed format.

Only works if draco_encoder is in your PATH: https://github.com/google/draco

Parameters:

  • mesh (Trimesh object) – Mesh to export

  • bits (int) – Bits of quantization for position tol.merge=1e-8 is roughly 25 bits

Returns:

data – DRC file bytes

Return type:

str or bytes

trimesh.exchange.ply.export_ply(mesh, encoding='binary', vertex_normal=None, include_attributes=True)#

Export a mesh in the PLY format.

Parameters:

  • mesh (trimesh.Trimesh) – Mesh to export.

  • encoding (str) – PLY encoding: ‘ascii’ or ‘binary_little_endian’

  • vertex_normal (None or include vertex normals) –

Returns:

export

Return type:

bytes of result

trimesh.exchange.ply.load_draco(file_obj, **kwargs)#

Load a mesh from Google’s Draco format.

Parameters:

file_obj (file- like object) – Contains data

Returns:

kwargs – Keyword arguments to construct a Trimesh object

Return type:

dict

trimesh.exchange.ply.load_ply(file_obj, resolver=None, fix_texture=True, prefer_color=None, *args, **kwargs)#

Load a PLY file from an open file object.

Parameters:

  • file_obj (an open file- like object) – Source data, ASCII or binary PLY

  • resolver (trimesh.visual.resolvers.Resolver) – Object which can resolve assets

  • fix_texture (bool) – If True, will re- index vertices and faces so vertices with different UV coordinates are disconnected.

  • prefer_color (None, 'vertex', or 'face') – Which kind of color to prefer if both defined

Returns:

mesh_kwargs – Data which can be passed to Trimesh constructor, eg: a = Trimesh(**mesh_kwargs)

Return type:

dict