pyvista_js.PLYReader#

class pyvista_js.PLYReader(path: str | Path)#

Bases: object

Reader for PLY (Polygon File Format) files (.ply).

Reads a PLY ASCII file and produces a Mesh that delegates parsing to vtk.js’s vtkPLYReader at render time. Python extracts only the vertex coordinates so that camera framing and bounding-sphere queries work before rendering.

Parameters:

path (str or Path) – Path to the .ply file.

Examples

>>> import pyvista_js as pv
>>> reader = pv.PLYReader("model.ply")
>>> mesh = reader.read()
__init__(path: str | Path) None#

Initialize the reader with a file path.

Methods

__init__(path)

Initialize the reader with a file path.

read()

Read the PLY file and return a Mesh.

Attributes

path

Return the file path.

property path: Path#

Return the file path.

Returns:

The path to the PLY file.

Return type:

Path

read() _PLYMesh#

Read the PLY file and return a Mesh.

The full file content is base64-encoded and stored so that vtk.js can parse it at render time. Vertex coordinates are extracted on the Python side for bounding-sphere and camera-framing calculations.

Returns:

A mesh backed by the PLY file content.

Return type:

Mesh

Raises:

ValueError – If the file format is invalid or unsupported.