PLYLoader.js 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466
  1. /**
  2. * @author Wei Meng / http://about.me/menway
  3. *
  4. * Description: A THREE loader for PLY ASCII files (known as the Polygon File Format or the Stanford Triangle Format).
  5. *
  6. *
  7. * Limitations: ASCII decoding assumes file is UTF-8.
  8. *
  9. * Usage:
  10. * var loader = new THREE.PLYLoader();
  11. * loader.load('./models/ply/ascii/dolphins.ply', function (geometry) {
  12. *
  13. * scene.add( new THREE.Mesh( geometry ) );
  14. *
  15. * } );
  16. *
  17. * If the PLY file uses non standard property names, they can be mapped while
  18. * loading. For example, the following maps the properties
  19. * “diffuse_(red|green|blue)” in the file to standard color names.
  20. *
  21. * loader.setPropertyNameMapping( {
  22. * diffuse_red: 'red',
  23. * diffuse_green: 'green',
  24. * diffuse_blue: 'blue'
  25. * } );
  26. *
  27. */
  28. THREE.PLYLoader = function () {
  29. this.propertyNameMapping = {};
  30. };
  31. THREE.PLYLoader.prototype = {
  32. constructor: THREE.PLYLoader,
  33. setPropertyNameMapping: function ( mapping ) {
  34. this.propertyNameMapping = mapping;
  35. },
  36. load: function ( url, callback ) {
  37. var scope = this;
  38. var request = new XMLHttpRequest();
  39. request.addEventListener( 'load', function ( event ) {
  40. var geometry = scope.parse( event.target.response );
  41. scope.dispatchEvent( { type: 'load', content: geometry } );
  42. if ( callback ) callback( geometry );
  43. }, false );
  44. request.addEventListener( 'progress', function ( event ) {
  45. scope.dispatchEvent( { type: 'progress', loaded: event.loaded, total: event.total } );
  46. }, false );
  47. request.addEventListener( 'error', function () {
  48. scope.dispatchEvent( { type: 'error', message: 'Couldn\'t load URL [' + url + ']' } );
  49. }, false );
  50. request.open( 'GET', url, true );
  51. request.responseType = "arraybuffer";
  52. request.send( null );
  53. },
  54. bin2str: function (buf) {
  55. var array_buffer = new Uint8Array(buf);
  56. var str = '';
  57. for(var i = 0; i < buf.byteLength; i++) {
  58. str += String.fromCharCode(array_buffer[i]); // implicitly assumes little-endian
  59. }
  60. return str;
  61. },
  62. isASCII: function( data ){
  63. var header = this.parseHeader( this.bin2str( data ) );
  64. return header.format === "ascii";
  65. },
  66. parse: function ( data ) {
  67. if ( data instanceof ArrayBuffer ) {
  68. return this.isASCII( data )
  69. ? this.parseASCII( this.bin2str( data ) )
  70. : this.parseBinary( data );
  71. } else {
  72. return this.parseASCII( data );
  73. }
  74. },
  75. parseHeader: function ( data ) {
  76. var patternHeader = /ply([\s\S]*)end_header\s/;
  77. var headerText = "";
  78. if ( ( result = patternHeader.exec( data ) ) !== null ) {
  79. headerText = result [ 1 ];
  80. }
  81. var header = {
  82. comments: [],
  83. elements: [],
  84. headerLength: result[ 0 ].length
  85. };
  86. var lines = headerText.split( '\n' );
  87. var currentElement = undefined;
  88. var lineType, lineValues;
  89. function make_ply_element_property( propertValues, propertyNameMapping ) {
  90. var property = {
  91. type: propertValues[ 0 ]
  92. };
  93. if ( property.type === 'list' ) {
  94. property.name = propertValues[ 3 ];
  95. property.countType = propertValues[ 1 ];
  96. property.itemType = propertValues[ 2 ];
  97. } else {
  98. property.name = propertValues[ 1 ];
  99. }
  100. if ( property.name in propertyNameMapping ) {
  101. property.name = propertyNameMapping[ property.name ];
  102. }
  103. return property;
  104. }
  105. for ( var i = 0; i < lines.length; i ++ ) {
  106. var line = lines[ i ];
  107. line = line.trim()
  108. if ( line === "" ) { continue; }
  109. lineValues = line.split( /\s+/ );
  110. lineType = lineValues.shift()
  111. line = lineValues.join(" ")
  112. switch( lineType ) {
  113. case "format":
  114. header.format = lineValues[0];
  115. header.version = lineValues[1];
  116. break;
  117. case "comment":
  118. header.comments.push(line);
  119. break;
  120. case "element":
  121. if ( !(currentElement === undefined) ) {
  122. header.elements.push(currentElement);
  123. }
  124. currentElement = Object();
  125. currentElement.name = lineValues[0];
  126. currentElement.count = parseInt( lineValues[1] );
  127. currentElement.properties = [];
  128. break;
  129. case "property":
  130. currentElement.properties.push( make_ply_element_property( lineValues, this.propertyNameMapping ) );
  131. break;
  132. default:
  133. console.log("unhandled", lineType, lineValues);
  134. }
  135. }
  136. if ( !(currentElement === undefined) ) {
  137. header.elements.push(currentElement);
  138. }
  139. return header;
  140. },
  141. parseASCIINumber: function ( n, type ) {
  142. switch( type ) {
  143. case 'char': case 'uchar': case 'short': case 'ushort': case 'int': case 'uint':
  144. case 'int8': case 'uint8': case 'int16': case 'uint16': case 'int32': case 'uint32':
  145. return parseInt( n );
  146. case 'float': case 'double': case 'float32': case 'float64':
  147. return parseFloat( n );
  148. }
  149. },
  150. parseASCIIElement: function ( properties, line ) {
  151. values = line.split( /\s+/ );
  152. var element = Object();
  153. for ( var i = 0; i < properties.length; i ++ ) {
  154. if ( properties[i].type === "list" ) {
  155. var list = [];
  156. var n = this.parseASCIINumber( values.shift(), properties[i].countType );
  157. for ( j = 0; j < n; j ++ ) {
  158. list.push( this.parseASCIINumber( values.shift(), properties[i].itemType ) );
  159. }
  160. element[ properties[i].name ] = list;
  161. } else {
  162. element[ properties[i].name ] = this.parseASCIINumber( values.shift(), properties[i].type );
  163. }
  164. }
  165. return element;
  166. },
  167. parseASCII: function ( data ) {
  168. // PLY ascii format specification, as per http://en.wikipedia.org/wiki/PLY_(file_format)
  169. var geometry = new THREE.Geometry();
  170. var result;
  171. var header = this.parseHeader( data );
  172. var patternBody = /end_header\s([\s\S]*)$/;
  173. var body = "";
  174. if ( ( result = patternBody.exec( data ) ) !== null ) {
  175. body = result [ 1 ];
  176. }
  177. var lines = body.split( '\n' );
  178. var currentElement = 0;
  179. var currentElementCount = 0;
  180. geometry.useColor = false;
  181. for ( var i = 0; i < lines.length; i ++ ) {
  182. var line = lines[ i ];
  183. line = line.trim()
  184. if ( line === "" ) { continue; }
  185. if ( currentElementCount >= header.elements[currentElement].count ) {
  186. currentElement++;
  187. currentElementCount = 0;
  188. }
  189. var element = this.parseASCIIElement( header.elements[currentElement].properties, line );
  190. this.handleElement( geometry, header.elements[currentElement].name, element );
  191. currentElementCount++;
  192. }
  193. return this.postProcess( geometry );
  194. },
  195. postProcess: function ( geometry ) {
  196. if ( geometry.useColor ) {
  197. for ( var i = 0; i < geometry.faces.length; i ++ ) {
  198. geometry.faces[i].vertexColors = [
  199. geometry.colors[geometry.faces[i].a],
  200. geometry.colors[geometry.faces[i].b],
  201. geometry.colors[geometry.faces[i].c]
  202. ];
  203. }
  204. geometry.elementsNeedUpdate = true;
  205. }
  206. geometry.computeBoundingSphere();
  207. return geometry;
  208. },
  209. handleElement: function ( geometry, elementName, element ) {
  210. if ( elementName === "vertex" ) {
  211. geometry.vertices.push(
  212. new THREE.Vector3( element.x, element.y, element.z )
  213. );
  214. if ( 'red' in element && 'green' in element && 'blue' in element ) {
  215. geometry.useColor = true;
  216. color = new THREE.Color();
  217. color.setRGB( element.red / 255.0, element.green / 255.0, element.blue / 255.0 );
  218. geometry.colors.push( color );
  219. }
  220. } else if ( elementName === "face" ) {
  221. geometry.faces.push(
  222. new THREE.Face3( element.vertex_indices[0], element.vertex_indices[1], element.vertex_indices[2] )
  223. );
  224. }
  225. },
  226. binaryRead: function ( dataview, at, type, little_endian ) {
  227. switch( type ) {
  228. // corespondences for non-specific length types here match rply:
  229. case 'int8': case 'char': return [ dataview.getInt8( at ), 1 ];
  230. case 'uint8': case 'uchar': return [ dataview.getUint8( at ), 1 ];
  231. case 'int16': case 'short': return [ dataview.getInt16( at, little_endian ), 2 ];
  232. case 'uint16': case 'ushort': return [ dataview.getUint16( at, little_endian ), 2 ];
  233. case 'int32': case 'int': return [ dataview.getInt32( at, little_endian ), 4 ];
  234. case 'uint32': case 'uint': return [ dataview.getUint32( at, little_endian ), 4 ];
  235. case 'float32': case 'float': return [ dataview.getFloat32( at, little_endian ), 4 ];
  236. case 'float64': case 'double': return [ dataview.getFloat64( at, little_endian ), 8 ];
  237. }
  238. },
  239. binaryReadElement: function ( dataview, at, properties, little_endian ) {
  240. var element = Object();
  241. var result, read = 0;
  242. for ( var i = 0; i < properties.length; i ++ ) {
  243. if ( properties[i].type === "list" ) {
  244. var list = [];
  245. result = this.binaryRead( dataview, at+read, properties[i].countType, little_endian );
  246. var n = result[0];
  247. read += result[1];
  248. for ( j = 0; j < n; j ++ ) {
  249. result = this.binaryRead( dataview, at+read, properties[i].itemType, little_endian );
  250. list.push( result[0] );
  251. read += result[1];
  252. }
  253. element[ properties[i].name ] = list;
  254. } else {
  255. result = this.binaryRead( dataview, at+read, properties[i].type, little_endian );
  256. element[ properties[i].name ] = result[0];
  257. read += result[1];
  258. }
  259. }
  260. return [ element, read ];
  261. },
  262. parseBinary: function ( data ) {
  263. var geometry = new THREE.Geometry();
  264. var header = this.parseHeader( this.bin2str( data ) );
  265. var little_endian = (header.format === "binary_little_endian");
  266. var body = new DataView( data, header.headerLength );
  267. var result, loc = 0;
  268. for ( var currentElement = 0; currentElement < header.elements.length; currentElement ++ ) {
  269. for ( var currentElementCount = 0; currentElementCount < header.elements[currentElement].count; currentElementCount ++ ) {
  270. result = this.binaryReadElement( body, loc, header.elements[currentElement].properties, little_endian );
  271. loc += result[1];
  272. var element = result[0];
  273. this.handleElement( geometry, header.elements[currentElement].name, element );
  274. }
  275. }
  276. return this.postProcess( geometry );
  277. }
  278. };
  279. THREE.EventDispatcher.prototype.apply( THREE.PLYLoader.prototype );