PLY (file format)

Short description: File format designed to store three-dimensional data from 3D scanners

Polygon File Format

Filename extension	.ply
Internet media type	text/plain
Type code	ASCII/Binary file
Magic number	ply
Developed by	Greg Turk, Stanford University
Initial release	1994
Type of format	3D model format

PLY is a computer file format known as the Polygon File Format or the Stanford Triangle Format. It was principally designed to store three-dimensional data from 3D scanners. The data storage format supports a relatively simple description of a single object as a list of nominally flat polygons. A variety of properties can be stored, including color and transparency, surface normals, texture coordinates and data confidence values. The format permits one to have different properties for the front and back of a polygon.

There are two versions of the file format, one in ASCII, the other in binary.

The file format

A Ply file starts with the "header" attribute, which specifies the elements of a mesh and their types, followed by the list of elements itself. The elements are usually vertices and faces, but may include other entities such as edges, samples of range maps, and triangle strips.

The header of both ASCII and binary files is ASCII text. Only the numerical data that follows the header is different between the two versions. The header always starts with a "magic number", a line containing:

ply

which identifies the file as a PLY file. The second line indicates which variation of the PLY format this is. It should be one of the following:

format ascii 1.0
format binary_little_endian 1.0
format binary_big_endian 1.0

Future versions of the standard will change the revision number at the end - but 1.0 is the only version currently in use.

Comments may be placed in the header by using the word comment at the start of the line. Everything from there until the end of the line should then be ignored. e.g.:

comment This is a comment!

The element keyword introduces a description of how some particular data elements are stored and how many of them there are. Hence, in a file where there are 12 vertices, each represented as a floating point (X,Y,Z) triple, one would expect to see:

element vertex 12
property float x
property float y
property float z

Other property lines might indicate that colours or other data items are stored at each vertex and indicate the data type of that information. Regarding the data type, there are two variants depending on the source of the ply file. The type can be specified with one of char uchar short ushort int uint float double, or one of int8 uint8 int16 uint16 int32 uint32 float32 float64. For an object with ten polygonal faces, one might see:

element face 10
property list uchar int vertex_index

PLY implementations vary wildly in the property names. vertex_indices is more often used than vertex_index, for example in Blender and VTK. The extended specification lists a "Core List (required)", "Second List (often used)" and "Third List (suggested extensions)" of property names.

The word list indicates that the data is a list of values, the first of which is the number of entries in the list (represented as a 'uchar' in this case). In this example each list entry is represented as an 'int'. At the end of the header, there must always be the line:

end_header

ASCII or binary format

In the ASCII version of the format, the vertices and faces are each described one to a line with the numbers separated by white space. In the binary version, the data is simply packed closely together at the endianness specified in the header and with the data types given in the property records. For the common property list... representation for polygons, the first number for that element is the number of vertices that the polygon has and the remaining numbers are the indices of those vertices in the preceding vertex list.

History

The PLY format was developed in the mid-90s by Greg Turk and others in the Stanford graphics lab under the direction of Marc Levoy. Its design was inspired by the Wavefront .obj format. However, the Obj format lacked extensibility for arbitrary properties and groupings, so the property and element keywords were devised to generalize the notions of vertices, faces, associated data, and other groups.

See also

• STL (file format), another common file format for 3D printing
• Additive Manufacturing File Format
• Wavefront .obj file, a 3D geometry definition file format with .obj file extension
• glTF - a Khronos Group file format for 3D Scenes and models.
• Universal Scene Description (USD).

Open source software

• CloudCompare having a focus on point clouds with some additional functions for meshes.
• GigaMesh Software Framework: numerical computations on meshes in PLY (or OBJ).
• MeshLab: generic application for visualizing, processing and converting three-dimensional meshes to or from the PLY file format.

External links

• Library of Congress Format Description
• PLY - Polygon File Format
• Some tools for working with PLY files (C source code)
• rply - An Ansi C software library for reading and writing PLY files (MIT license)
• libply - A C++ software library for reading and writing PLY files (GNU license)
• Another C++ software library for reading and writing PLY files (GPL 3.0 license)
• A repository of 3D models stored in the PLY format