--- /dev/null
+/**
+ * @author Wei Meng / http://about.me/menway
+ *
+ * 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:
+ * var loader = new THREE.PLYLoader();
+ * loader.load('./models/ply/ascii/dolphins.ply', function (geometry) {
+ *
+ * scene.add( new 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'
+ * } );
+ *
+ */
+
+
+THREE.PLYLoader = function ( manager ) {
+
+ this.manager = ( manager !== undefined ) ? manager : THREE.DefaultLoadingManager;
+
+ this.propertyNameMapping = {};
+
+};
+
+THREE.PLYLoader.prototype = {
+
+ constructor: THREE.PLYLoader,
+
+ load: function ( url, onLoad, onProgress, onError ) {
+
+ var scope = this;
+
+ var loader = new THREE.FileLoader( this.manager );
+ loader.setResponseType( 'arraybuffer' );
+ loader.load( url, function ( text ) {
+
+ onLoad( scope.parse( text ) );
+
+ }, onProgress, onError );
+
+ },
+
+ setPropertyNameMapping: function ( mapping ) {
+
+ this.propertyNameMapping = mapping;
+
+ },
+
+ parse: function ( data ) {
+
+ function bin2str( buf ) {
+
+ var array_buffer = new Uint8Array( buf );
+
+ if ( window.TextDecoder !== undefined ) {
+
+ return new TextDecoder().decode( array_buffer );
+
+ }
+
+ var str = '';
+
+ for ( var i = 0, il = buf.byteLength; i < il; i ++ ) {
+
+ str += String.fromCharCode( array_buffer[ i ] ); // implicitly assumes little-endian
+
+ }
+
+ return str;
+
+ }
+
+ function parseHeader( data ) {
+
+ var patternHeader = /ply([\s\S]*)end_header\s/;
+ var headerText = '';
+ var headerLength = 0;
+ var result = patternHeader.exec( data );
+
+ if ( result !== null ) {
+
+ headerText = result [ 1 ];
+ headerLength = result[ 0 ].length;
+
+ }
+
+ var header = {
+ comments: [],
+ elements: [],
+ headerLength: headerLength
+ };
+
+ var lines = headerText.split( '\n' );
+ var currentElement;
+ var lineType, lineValues;
+
+ function make_ply_element_property( propertValues, propertyNameMapping ) {
+
+ var property = { type: propertValues[ 0 ] };
+
+ if ( property.type === 'list' ) {
+
+ property.name = propertValues[ 3 ];
+ property.countType = propertValues[ 1 ];
+ property.itemType = propertValues[ 2 ];
+
+ } else {
+
+ property.name = propertValues[ 1 ];
+
+ }
+
+ if ( property.name in propertyNameMapping ) {
+
+ property.name = propertyNameMapping[ property.name ];
+
+ }
+
+ return property;
+
+ }
+
+ for ( var i = 0; i < lines.length; i ++ ) {
+
+ var line = lines[ i ];
+ line = line.trim();
+
+ if ( line === '' ) continue;
+
+ lineValues = line.split( /\s+/ );
+ lineType = lineValues.shift();
+ line = lineValues.join( ' ' );
+
+ switch ( lineType ) {
+
+ case 'format':
+
+ header.format = lineValues[ 0 ];
+ header.version = lineValues[ 1 ];
+
+ break;
+
+ case 'comment':
+
+ header.comments.push( line );
+
+ break;
+
+ case 'element':
+
+ if ( currentElement !== undefined ) {
+
+ header.elements.push( currentElement );
+
+ }
+
+ currentElement = {};
+ currentElement.name = lineValues[ 0 ];
+ currentElement.count = parseInt( lineValues[ 1 ] );
+ currentElement.properties = [];
+
+ break;
+
+ case 'property':
+
+ currentElement.properties.push( make_ply_element_property( lineValues, scope.propertyNameMapping ) );
+
+ break;
+
+
+ default:
+
+ console.log( 'unhandled', lineType, lineValues );
+
+ }
+
+ }
+
+ if ( currentElement !== undefined ) {
+
+ header.elements.push( currentElement );
+
+ }
+
+ return header;
+
+ }
+
+ function parseASCIINumber( n, type ) {
+
+ switch ( type ) {
+
+ case 'char': case 'uchar': case 'short': case 'ushort': case 'int': case 'uint':
+ case 'int8': case 'uint8': case 'int16': case 'uint16': case 'int32': case 'uint32':
+
+ return parseInt( n );
+
+ case 'float': case 'double': case 'float32': case 'float64':
+
+ return parseFloat( n );
+
+ }
+
+ }
+
+ function parseASCIIElement( properties, line ) {
+
+ var values = line.split( /\s+/ );
+
+ var element = {};
+
+ for ( var i = 0; i < properties.length; i ++ ) {
+
+ if ( properties[ i ].type === 'list' ) {
+
+ var list = [];
+ var n = parseASCIINumber( values.shift(), properties[ i ].countType );
+
+ for ( var j = 0; j < n; j ++ ) {
+
+ list.push( parseASCIINumber( values.shift(), properties[ i ].itemType ) );
+
+ }
+
+ element[ properties[ i ].name ] = list;
+
+ } else {
+
+ element[ properties[ i ].name ] = parseASCIINumber( values.shift(), properties[ i ].type );
+
+ }
+
+ }
+
+ return element;
+
+ }
+
+ function parseASCII( data, header ) {
+
+ // PLY ascii format specification, as per http://en.wikipedia.org/wiki/PLY_(file_format)
+
+ var buffer = {
+ indices : [],
+ vertices : [],
+ normals : [],
+ uvs : [],
+ colors : []
+ };
+
+ var result;
+
+ var patternBody = /end_header\s([\s\S]*)$/;
+ var body = '';
+ if ( ( result = patternBody.exec( data ) ) !== null ) {
+
+ body = result [ 1 ];
+
+ }
+
+ var lines = body.split( '\n' );
+ var currentElement = 0;
+ var currentElementCount = 0;
+
+ for ( var i = 0; i < lines.length; i ++ ) {
+
+ var line = lines[ i ];
+ line = line.trim();
+ if ( line === '' ) {
+
+ continue;
+
+ }
+
+ if ( currentElementCount >= header.elements[ currentElement ].count ) {
+
+ currentElement ++;
+ currentElementCount = 0;
+
+ }
+
+ var element = parseASCIIElement( header.elements[ currentElement ].properties, line );
+
+ handleElement( buffer, header.elements[ currentElement ].name, element );
+
+ currentElementCount ++;
+
+ }
+
+ return postProcess( buffer );
+
+ }
+
+ function postProcess( buffer ) {
+
+ var geometry = new THREE.BufferGeometry();
+
+ // mandatory buffer data
+
+ if ( buffer.indices.length > 0 ) {
+
+ geometry.setIndex( buffer.indices );
+
+ }
+
+ geometry.addAttribute( 'position', new THREE.Float32BufferAttribute( buffer.vertices, 3 ) );
+
+ // optional buffer data
+
+ if ( buffer.normals.length > 0 ) {
+
+ geometry.addAttribute( 'normal', new THREE.Float32BufferAttribute( buffer.normals, 3 ) );
+
+ }
+
+ if ( buffer.uvs.length > 0 ) {
+
+ geometry.addAttribute( 'uv', new THREE.Float32BufferAttribute( buffer.uvs, 2 ) );
+
+ }
+
+ if ( buffer.colors.length > 0 ) {
+
+ geometry.addAttribute( 'color', new THREE.Float32BufferAttribute( buffer.colors, 3 ) );
+
+ }
+
+ geometry.computeBoundingSphere();
+
+ return geometry;
+
+ }
+
+ function handleElement( buffer, elementName, element ) {
+
+ if ( elementName === 'vertex' ) {
+
+ buffer.vertices.push( element.x, element.y, element.z );
+
+ if ( 'nx' in element && 'ny' in element && 'nz' in element ) {
+
+ buffer.normals.push( element.nx, element.ny, element.nz );
+
+ }
+
+ if ( 's' in element && 't' in element ) {
+
+ buffer.uvs.push( element.s, element.t );
+
+ }
+
+ if ( 'red' in element && 'green' in element && 'blue' in element ) {
+
+ buffer.colors.push( element.red / 255.0, element.green / 255.0, element.blue / 255.0 );
+
+ }
+
+ } else if ( elementName === 'face' ) {
+
+ var vertex_indices = element.vertex_indices || element.vertex_index; // issue #9338
+
+ if ( vertex_indices.length === 3 ) {
+
+ buffer.indices.push( vertex_indices[ 0 ], vertex_indices[ 1 ], vertex_indices[ 2 ] );
+
+ } else if ( vertex_indices.length === 4 ) {
+
+ buffer.indices.push( vertex_indices[ 0 ], vertex_indices[ 1 ], vertex_indices[ 3 ] );
+ buffer.indices.push( vertex_indices[ 1 ], vertex_indices[ 2 ], vertex_indices[ 3 ] );
+
+ }
+
+ }
+
+ }
+
+ function binaryRead( dataview, at, type, little_endian ) {
+
+ switch ( type ) {
+
+ // corespondences for non-specific length types here match rply:
+ case 'int8': case 'char': return [ dataview.getInt8( at ), 1 ];
+ case 'uint8': case 'uchar': return [ dataview.getUint8( at ), 1 ];
+ case 'int16': case 'short': return [ dataview.getInt16( at, little_endian ), 2 ];
+ case 'uint16': case 'ushort': return [ dataview.getUint16( at, little_endian ), 2 ];
+ case 'int32': case 'int': return [ dataview.getInt32( at, little_endian ), 4 ];
+ case 'uint32': case 'uint': return [ dataview.getUint32( at, little_endian ), 4 ];
+ case 'float32': case 'float': return [ dataview.getFloat32( at, little_endian ), 4 ];
+ case 'float64': case 'double': return [ dataview.getFloat64( at, little_endian ), 8 ];
+
+ }
+
+ }
+
+ function binaryReadElement( dataview, at, properties, little_endian ) {
+
+ var element = {};
+ var result, read = 0;
+
+ for ( var i = 0; i < properties.length; i ++ ) {
+
+ if ( properties[ i ].type === 'list' ) {
+
+ var list = [];
+
+ result = binaryRead( dataview, at + read, properties[ i ].countType, little_endian );
+ var n = result[ 0 ];
+ read += result[ 1 ];
+
+ for ( var j = 0; j < n; j ++ ) {
+
+ result = binaryRead( dataview, at + read, properties[ i ].itemType, little_endian );
+ list.push( result[ 0 ] );
+ read += result[ 1 ];
+
+ }
+
+ element[ properties[ i ].name ] = list;
+
+ } else {
+
+ result = binaryRead( dataview, at + read, properties[ i ].type, little_endian );
+ element[ properties[ i ].name ] = result[ 0 ];
+ read += result[ 1 ];
+
+ }
+
+ }
+
+ return [ element, read ];
+
+ }
+
+ function parseBinary( data, header ) {
+
+ var buffer = {
+ indices : [],
+ vertices : [],
+ normals : [],
+ uvs : [],
+ colors : []
+ };
+
+ var little_endian = ( header.format === 'binary_little_endian' );
+ var body = new DataView( data, header.headerLength );
+ var result, loc = 0;
+
+ for ( var currentElement = 0; currentElement < header.elements.length; currentElement ++ ) {
+
+ for ( var currentElementCount = 0; currentElementCount < header.elements[ currentElement ].count; currentElementCount ++ ) {
+
+ result = binaryReadElement( body, loc, header.elements[ currentElement ].properties, little_endian );
+ loc += result[ 1 ];
+ var element = result[ 0 ];
+
+ handleElement( buffer, header.elements[ currentElement ].name, element );
+
+ }
+
+ }
+
+ return postProcess( buffer );
+
+ }
+
+ //
+
+ var geometry;
+ var scope = this;
+
+ if ( data instanceof ArrayBuffer ) {
+
+ var text = bin2str( data );
+ var header = parseHeader( text );
+
+ geometry = header.format === 'ascii' ? parseASCII( text, header ) : parseBinary( data, header );
+
+ } else {
+
+ geometry = parseASCII( data, parseHeader( data ) );
+
+ }
+
+ return geometry;
+
+ }
+
+};