scimesh::ply_io Namespace Reference

Functions for reading PLY files. More...

Functions
Mesh	read_ply (const std::string &path)
	Load a mesh from a Stanford PLY file.

Detailed Description

Functions for reading PLY files.

Function Documentation

read_ply()

Mesh scimesh::ply_io::read_ply

(

const std::string &

path

)

Load a mesh from a Stanford PLY file.

Reads vertex positions, face indices, and optionally per-vertex colors and normals. Both ASCII and binary (little-endian) PLY files are supported.

Parameters

path	Filesystem path to the .ply file.

Returns

A Mesh populated with the file's geometry.

Exceptions

std::runtime_error

if the file cannot be opened or parsed.

Example

Mesh scan = scimesh::ply_io::read_ply("bunny.ply");
std::cout << "Loaded " << scan.vertices.size() << " vertices\n";

Color support

If the PLY file contains per-vertex RGB colors, they are automatically loaded into Mesh::colors. Use mesh.has_colors() to check.

Unsupported

• Texture coordinates — PLY files with texture coordinates lose them; assign Mesh::uvs yourself if you need textured rendering.

See also

read_obj(), read_stl(), Mesh::has_colors()

Definition at line 48 of file ply_io.cpp.