PLYLoader class

Description: A THREE loader for PLY ASCII files (known as the Polygon File Format or the Stanford Triangle Format).

Limitations: ASCII decoding assumes file is UTF-8.

Usage: const loader = PLYLoader(); loader.load('./models/ply/ascii/dolphins.ply', function (geometry) {

	scene.add( THREE.Mesh( geometry ) );

} );

If the PLY file uses non standard property names, they can be mapped while loading. For example, the following maps the properties “diffuse_(red|green|blue)” in the file to standard color names.

loader.setPropertyNameMapping( { diffuse_red: 'red', diffuse_green: 'green', diffuse_blue: 'blue' } );

Custom properties outside of the defaults for position, uv, normal and color attributes can be added using the setCustomPropertyNameMapping method. For example, the following maps the element properties “custom_property_a” and “custom_property_b” to an attribute “customAttribute” with an item size of 2. Attribute item sizes are set from the number of element properties in the property array.

loader.setCustomPropertyNameMapping( { customAttribute: 'custom_property_a', 'custom_property_b', } );