/** * @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 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 = THREE.LoaderUtils.decodeText( new Uint8Array( data ) ); var header = parseHeader( text ); geometry = header.format === 'ascii' ? parseASCII( text, header ) : parseBinary( data, header ); } else { geometry = parseASCII( data, parseHeader( data ) ); } return geometry; } };