MMDLoader.js 47 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985
  1. console.warn( "THREE.MMDLoader: As part of the transition to ES6 Modules, the files in 'examples/js' were deprecated in May 2020 (r117) and will be deleted in December 2020 (r124). You can find more information about developing using ES6 Modules in https://threejs.org/docs/#manual/en/introduction/Installation." );
  2. /**
  3. * Dependencies
  4. * - mmd-parser https://github.com/takahirox/mmd-parser
  5. * - THREE.TGALoader
  6. * - THREE.OutlineEffect
  7. *
  8. * MMDLoader creates Three.js Objects from MMD resources as
  9. * PMD, PMX, VMD, and VPD files.
  10. *
  11. * PMD/PMX is a model data format, VMD is a motion data format
  12. * VPD is a posing data format used in MMD(Miku Miku Dance).
  13. *
  14. * MMD official site
  15. * - https://sites.google.com/view/evpvp/
  16. *
  17. * PMD, VMD format (in Japanese)
  18. * - http://blog.goo.ne.jp/torisu_tetosuki/e/209ad341d3ece2b1b4df24abf619d6e4
  19. *
  20. * PMX format
  21. * - https://gist.github.com/felixjones/f8a06bd48f9da9a4539f
  22. *
  23. * TODO
  24. * - light motion in vmd support.
  25. * - SDEF support.
  26. * - uv/material/bone morphing support.
  27. * - more precise grant skinning support.
  28. * - shadow support.
  29. */
  30. THREE.MMDLoader = ( function () {
  31. /**
  32. * @param {THREE.LoadingManager} manager
  33. */
  34. function MMDLoader( manager ) {
  35. THREE.Loader.call( this, manager );
  36. this.loader = new THREE.FileLoader( this.manager );
  37. this.parser = null; // lazy generation
  38. this.meshBuilder = new MeshBuilder( this.manager );
  39. this.animationBuilder = new AnimationBuilder();
  40. }
  41. MMDLoader.prototype = Object.assign( Object.create( THREE.Loader.prototype ), {
  42. constructor: MMDLoader,
  43. /**
  44. * @param {string} animationPath
  45. * @return {THREE.MMDLoader}
  46. */
  47. setAnimationPath: function ( animationPath ) {
  48. this.animationPath = animationPath;
  49. return this;
  50. },
  51. // Load MMD assets as Three.js Object
  52. /**
  53. * Loads Model file (.pmd or .pmx) as a THREE.SkinnedMesh.
  54. *
  55. * @param {string} url - url to Model(.pmd or .pmx) file
  56. * @param {function} onLoad
  57. * @param {function} onProgress
  58. * @param {function} onError
  59. */
  60. load: function ( url, onLoad, onProgress, onError ) {
  61. var builder = this.meshBuilder.setCrossOrigin( this.crossOrigin );
  62. // resource path
  63. var resourcePath;
  64. if ( this.resourcePath !== '' ) {
  65. resourcePath = this.resourcePath;
  66. } else if ( this.path !== '' ) {
  67. resourcePath = this.path;
  68. } else {
  69. resourcePath = THREE.LoaderUtils.extractUrlBase( url );
  70. }
  71. var modelExtension = this._extractExtension( url ).toLowerCase();
  72. // Should I detect by seeing header?
  73. if ( modelExtension !== 'pmd' && modelExtension !== 'pmx' ) {
  74. if ( onError ) onError( new Error( 'THREE.MMDLoader: Unknown model file extension .' + modelExtension + '.' ) );
  75. return;
  76. }
  77. this[ modelExtension === 'pmd' ? 'loadPMD' : 'loadPMX' ]( url, function ( data ) {
  78. onLoad( builder.build( data, resourcePath, onProgress, onError ) );
  79. }, onProgress, onError );
  80. },
  81. /**
  82. * Loads Motion file(s) (.vmd) as a THREE.AnimationClip.
  83. * If two or more files are specified, they'll be merged.
  84. *
  85. * @param {string|Array<string>} url - url(s) to animation(.vmd) file(s)
  86. * @param {THREE.SkinnedMesh|THREE.Camera} object - tracks will be fitting to this object
  87. * @param {function} onLoad
  88. * @param {function} onProgress
  89. * @param {function} onError
  90. */
  91. loadAnimation: function ( url, object, onLoad, onProgress, onError ) {
  92. var builder = this.animationBuilder;
  93. this.loadVMD( url, function ( vmd ) {
  94. onLoad( object.isCamera
  95. ? builder.buildCameraAnimation( vmd )
  96. : builder.build( vmd, object ) );
  97. }, onProgress, onError );
  98. },
  99. /**
  100. * Loads mode file and motion file(s) as an object containing
  101. * a THREE.SkinnedMesh and a THREE.AnimationClip.
  102. * Tracks of THREE.AnimationClip are fitting to the model.
  103. *
  104. * @param {string} modelUrl - url to Model(.pmd or .pmx) file
  105. * @param {string|Array{string}} vmdUrl - url(s) to animation(.vmd) file
  106. * @param {function} onLoad
  107. * @param {function} onProgress
  108. * @param {function} onError
  109. */
  110. loadWithAnimation: function ( modelUrl, vmdUrl, onLoad, onProgress, onError ) {
  111. var scope = this;
  112. this.load( modelUrl, function ( mesh ) {
  113. scope.loadAnimation( vmdUrl, mesh, function ( animation ) {
  114. onLoad( {
  115. mesh: mesh,
  116. animation: animation
  117. } );
  118. }, onProgress, onError );
  119. }, onProgress, onError );
  120. },
  121. // Load MMD assets as Object data parsed by MMDParser
  122. /**
  123. * Loads .pmd file as an Object.
  124. *
  125. * @param {string} url - url to .pmd file
  126. * @param {function} onLoad
  127. * @param {function} onProgress
  128. * @param {function} onError
  129. */
  130. loadPMD: function ( url, onLoad, onProgress, onError ) {
  131. var parser = this._getParser();
  132. this.loader
  133. .setMimeType( undefined )
  134. .setPath( this.path )
  135. .setResponseType( 'arraybuffer' )
  136. .setRequestHeader( this.requestHeader )
  137. .setWithCredentials( this.withCredentials )
  138. .load( url, function ( buffer ) {
  139. onLoad( parser.parsePmd( buffer, true ) );
  140. }, onProgress, onError );
  141. },
  142. /**
  143. * Loads .pmx file as an Object.
  144. *
  145. * @param {string} url - url to .pmx file
  146. * @param {function} onLoad
  147. * @param {function} onProgress
  148. * @param {function} onError
  149. */
  150. loadPMX: function ( url, onLoad, onProgress, onError ) {
  151. var parser = this._getParser();
  152. this.loader
  153. .setMimeType( undefined )
  154. .setPath( this.path )
  155. .setResponseType( 'arraybuffer' )
  156. .setRequestHeader( this.requestHeader )
  157. .setWithCredentials( this.withCredentials )
  158. .load( url, function ( buffer ) {
  159. onLoad( parser.parsePmx( buffer, true ) );
  160. }, onProgress, onError );
  161. },
  162. /**
  163. * Loads .vmd file as an Object. If two or more files are specified
  164. * they'll be merged.
  165. *
  166. * @param {string|Array<string>} url - url(s) to .vmd file(s)
  167. * @param {function} onLoad
  168. * @param {function} onProgress
  169. * @param {function} onError
  170. */
  171. loadVMD: function ( url, onLoad, onProgress, onError ) {
  172. var urls = Array.isArray( url ) ? url : [ url ];
  173. var vmds = [];
  174. var vmdNum = urls.length;
  175. var parser = this._getParser();
  176. this.loader
  177. .setMimeType( undefined )
  178. .setPath( this.animationPath )
  179. .setResponseType( 'arraybuffer' )
  180. .setRequestHeader( this.requestHeader )
  181. .setWithCredentials( this.withCredentials );
  182. for ( var i = 0, il = urls.length; i < il; i ++ ) {
  183. this.loader.load( urls[ i ], function ( buffer ) {
  184. vmds.push( parser.parseVmd( buffer, true ) );
  185. if ( vmds.length === vmdNum ) onLoad( parser.mergeVmds( vmds ) );
  186. }, onProgress, onError );
  187. }
  188. },
  189. /**
  190. * Loads .vpd file as an Object.
  191. *
  192. * @param {string} url - url to .vpd file
  193. * @param {boolean} isUnicode
  194. * @param {function} onLoad
  195. * @param {function} onProgress
  196. * @param {function} onError
  197. */
  198. loadVPD: function ( url, isUnicode, onLoad, onProgress, onError ) {
  199. var parser = this._getParser();
  200. this.loader
  201. .setMimeType( isUnicode ? undefined : 'text/plain; charset=shift_jis' )
  202. .setPath( this.animationPath )
  203. .setResponseType( 'text' )
  204. .setRequestHeader( this.requestHeader )
  205. .setWithCredentials( this.withCredentials )
  206. .load( url, function ( text ) {
  207. onLoad( parser.parseVpd( text, true ) );
  208. }, onProgress, onError );
  209. },
  210. // private methods
  211. _extractExtension: function ( url ) {
  212. var index = url.lastIndexOf( '.' );
  213. return index < 0 ? '' : url.slice( index + 1 );
  214. },
  215. _getParser: function () {
  216. if ( this.parser === null ) {
  217. if ( typeof MMDParser === 'undefined' ) {
  218. throw new Error( 'THREE.MMDLoader: Import MMDParser https://github.com/takahirox/mmd-parser' );
  219. }
  220. this.parser = new MMDParser.Parser(); // eslint-disable-line no-undef
  221. }
  222. return this.parser;
  223. }
  224. } );
  225. // Utilities
  226. /*
  227. * base64 encoded defalut toon textures toon00.bmp - toon10.bmp.
  228. * We don't need to request external toon image files.
  229. * This idea is from http://www20.atpages.jp/katwat/three.js_r58/examples/mytest37/mmd.three.js
  230. */
  231. var DEFAULT_TOON_TEXTURES = [
  232. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAL0lEQVRYR+3QQREAAAzCsOFfNJPBJ1XQS9r2hsUAAQIECBAgQIAAAQIECBAgsBZ4MUx/ofm2I/kAAAAASUVORK5CYII=',
  233. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAN0lEQVRYR+3WQREAMBACsZ5/bWiiMvgEBTt5cW37hjsBBAgQIECAwFwgyfYPCCBAgAABAgTWAh8aBHZBl14e8wAAAABJRU5ErkJggg==',
  234. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAOUlEQVRYR+3WMREAMAwDsYY/yoDI7MLwIiP40+RJklfcCCBAgAABAgTqArfb/QMCCBAgQIAAgbbAB3z/e0F3js2cAAAAAElFTkSuQmCC',
  235. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAN0lEQVRYR+3WQREAMBACsZ5/B5ilMvgEBTt5cW37hjsBBAgQIECAwFwgyfYPCCBAgAABAgTWAh81dWyx0gFwKAAAAABJRU5ErkJggg==',
  236. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAOklEQVRYR+3WoREAMAwDsWb/UQtCy9wxTOQJ/oQ8SXKKGwEECBAgQIBAXeDt7f4BAQQIECBAgEBb4AOz8Hzx7WLY4wAAAABJRU5ErkJggg==',
  237. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAABPUlEQVRYR+1XwW7CMAy1+f9fZOMysSEOEweEOPRNdm3HbdOyIhAcklPrOs/PLy9RygBALxzcCDQFmgJNgaZAU6Ap0BR4PwX8gsRMVLssMRH5HcpzJEaWL7EVg9F1IHRlyqQohgVr4FGUlUcMJSjcUlDw0zvjeun70cLWmneoyf7NgBTQSniBTQQSuJAZsOnnaczjIMb5hCiuHKxokCrJfVnrctyZL0PkJAJe1HMil4nxeyi3Ypfn1kX51jpPvo/JeCNC4PhVdHdJw2XjBR8brF8PEIhNVn12AgP7uHsTBguBn53MUZCqv7Lp07Pn5k1Ro+uWmUNn7D+M57rtk7aG0Vo73xyF/fbFf0bPJjDXngnGocDTdFhygZjwUQrMNrDcmZlQT50VJ/g/UwNyHpu778+yW+/ksOz/BFo54P4AsUXMfRq7XWsAAAAASUVORK5CYII=',
  238. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAACMElEQVRYR+2Xv4pTQRTGf2dubhLdICiii2KnYKHVolhauKWPoGAnNr6BD6CvIVaihYuI2i1ia0BY0MZGRHQXjZj/mSPnnskfNWiWZUlzJ5k7M2cm833nO5Mziej2DWWJRUoCpQKlAntSQCqgw39/iUWAGmh37jrRnVsKlgpiqmkoGVABA7E57fvY+pJDdgKqF6HzFCSADkDq+F6AHABtQ+UMVE5D7zXod7fFNhTEckTbj5XQgHzNN+5tQvc5NG7C6BNkp6D3EmpXHDR+dQAjFLchW3VS9rlw3JBh+B7ys5Cf9z0GW1C/7P32AyBAOAz1q4jGliIH3YPuBnSfQX4OGreTIgEYQb/pBDtPnEQ4CivXYPAWBk13oHrB54yA9QuSn2H4AcKRpEILDt0BUzj+RLR1V5EqjD66NPRBVpLcQwjHoHYJOhsQv6U4mnzmrIXJCFr4LDwm/xBUoboG9XX4cc9VKdYoSA2yk5NQLJaKDUjTBoveG3Z2TElTxwjNK4M3LEZgUdDdruvcXzKBpStgp2NPiWi3ks9ZXxIoFVi+AvHLdc9TqtjL3/aYjpPlrzOcEnK62Szhimdd7xX232zFDTgtxezOu3WNMRLjiKgjtOhHVMd1loynVHvOgjuIIJMaELEqhJAV/RCSLbWTcfPFakFgFlALTRRvx+ok6Hlp/Q+v3fmx90bMyUzaEAhmM3KvHlXTL5DxnbGf/1M8RNNACLL5MNtPxP/mypJAqcDSFfgFhpYqWUzhTEAAAAAASUVORK5CYII=',
  239. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAL0lEQVRYR+3QQREAAAzCsOFfNJPBJ1XQS9r2hsUAAQIECBAgQIAAAQIECBAgsBZ4MUx/ofm2I/kAAAAASUVORK5CYII=',
  240. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAL0lEQVRYR+3QQREAAAzCsOFfNJPBJ1XQS9r2hsUAAQIECBAgQIAAAQIECBAgsBZ4MUx/ofm2I/kAAAAASUVORK5CYII=',
  241. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAL0lEQVRYR+3QQREAAAzCsOFfNJPBJ1XQS9r2hsUAAQIECBAgQIAAAQIECBAgsBZ4MUx/ofm2I/kAAAAASUVORK5CYII=',
  242. 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAL0lEQVRYR+3QQREAAAzCsOFfNJPBJ1XQS9r2hsUAAQIECBAgQIAAAQIECBAgsBZ4MUx/ofm2I/kAAAAASUVORK5CYII='
  243. ];
  244. // Builders. They build Three.js object from Object data parsed by MMDParser.
  245. /**
  246. * @param {THREE.LoadingManager} manager
  247. */
  248. function MeshBuilder( manager ) {
  249. this.geometryBuilder = new GeometryBuilder();
  250. this.materialBuilder = new MaterialBuilder( manager );
  251. }
  252. MeshBuilder.prototype = {
  253. constructor: MeshBuilder,
  254. crossOrigin: 'anonymous',
  255. /**
  256. * @param {string} crossOrigin
  257. * @return {MeshBuilder}
  258. */
  259. setCrossOrigin: function ( crossOrigin ) {
  260. this.crossOrigin = crossOrigin;
  261. return this;
  262. },
  263. /**
  264. * @param {Object} data - parsed PMD/PMX data
  265. * @param {string} resourcePath
  266. * @param {function} onProgress
  267. * @param {function} onError
  268. * @return {THREE.SkinnedMesh}
  269. */
  270. build: function ( data, resourcePath, onProgress, onError ) {
  271. var geometry = this.geometryBuilder.build( data );
  272. var material = this.materialBuilder
  273. .setCrossOrigin( this.crossOrigin )
  274. .setResourcePath( resourcePath )
  275. .build( data, geometry, onProgress, onError );
  276. var mesh = new THREE.SkinnedMesh( geometry, material );
  277. var skeleton = new THREE.Skeleton( initBones( mesh ) );
  278. mesh.bind( skeleton );
  279. // console.log( mesh ); // for console debug
  280. return mesh;
  281. }
  282. };
  283. // TODO: Try to remove this function
  284. function initBones( mesh ) {
  285. var geometry = mesh.geometry;
  286. var bones = [], bone, gbone;
  287. var i, il;
  288. if ( geometry && geometry.bones !== undefined ) {
  289. // first, create array of 'Bone' objects from geometry data
  290. for ( i = 0, il = geometry.bones.length; i < il; i ++ ) {
  291. gbone = geometry.bones[ i ];
  292. // create new 'Bone' object
  293. bone = new THREE.Bone();
  294. bones.push( bone );
  295. // apply values
  296. bone.name = gbone.name;
  297. bone.position.fromArray( gbone.pos );
  298. bone.quaternion.fromArray( gbone.rotq );
  299. if ( gbone.scl !== undefined ) bone.scale.fromArray( gbone.scl );
  300. }
  301. // second, create bone hierarchy
  302. for ( i = 0, il = geometry.bones.length; i < il; i ++ ) {
  303. gbone = geometry.bones[ i ];
  304. if ( ( gbone.parent !== - 1 ) && ( gbone.parent !== null ) && ( bones[ gbone.parent ] !== undefined ) ) {
  305. // subsequent bones in the hierarchy
  306. bones[ gbone.parent ].add( bones[ i ] );
  307. } else {
  308. // topmost bone, immediate child of the skinned mesh
  309. mesh.add( bones[ i ] );
  310. }
  311. }
  312. }
  313. // now the bones are part of the scene graph and children of the skinned mesh.
  314. // let's update the corresponding matrices
  315. mesh.updateMatrixWorld( true );
  316. return bones;
  317. }
  318. //
  319. function GeometryBuilder() {
  320. }
  321. GeometryBuilder.prototype = {
  322. constructor: GeometryBuilder,
  323. /**
  324. * @param {Object} data - parsed PMD/PMX data
  325. * @return {THREE.BufferGeometry}
  326. */
  327. build: function ( data ) {
  328. // for geometry
  329. var positions = [];
  330. var uvs = [];
  331. var normals = [];
  332. var indices = [];
  333. var groups = [];
  334. var bones = [];
  335. var skinIndices = [];
  336. var skinWeights = [];
  337. var morphTargets = [];
  338. var morphPositions = [];
  339. var iks = [];
  340. var grants = [];
  341. var rigidBodies = [];
  342. var constraints = [];
  343. // for work
  344. var offset = 0;
  345. var boneTypeTable = {};
  346. // positions, normals, uvs, skinIndices, skinWeights
  347. for ( var i = 0; i < data.metadata.vertexCount; i ++ ) {
  348. var v = data.vertices[ i ];
  349. for ( var j = 0, jl = v.position.length; j < jl; j ++ ) {
  350. positions.push( v.position[ j ] );
  351. }
  352. for ( var j = 0, jl = v.normal.length; j < jl; j ++ ) {
  353. normals.push( v.normal[ j ] );
  354. }
  355. for ( var j = 0, jl = v.uv.length; j < jl; j ++ ) {
  356. uvs.push( v.uv[ j ] );
  357. }
  358. for ( var j = 0; j < 4; j ++ ) {
  359. skinIndices.push( v.skinIndices.length - 1 >= j ? v.skinIndices[ j ] : 0.0 );
  360. }
  361. for ( var j = 0; j < 4; j ++ ) {
  362. skinWeights.push( v.skinWeights.length - 1 >= j ? v.skinWeights[ j ] : 0.0 );
  363. }
  364. }
  365. // indices
  366. for ( var i = 0; i < data.metadata.faceCount; i ++ ) {
  367. var face = data.faces[ i ];
  368. for ( var j = 0, jl = face.indices.length; j < jl; j ++ ) {
  369. indices.push( face.indices[ j ] );
  370. }
  371. }
  372. // groups
  373. for ( var i = 0; i < data.metadata.materialCount; i ++ ) {
  374. var material = data.materials[ i ];
  375. groups.push( {
  376. offset: offset * 3,
  377. count: material.faceCount * 3
  378. } );
  379. offset += material.faceCount;
  380. }
  381. // bones
  382. for ( var i = 0; i < data.metadata.rigidBodyCount; i ++ ) {
  383. var body = data.rigidBodies[ i ];
  384. var value = boneTypeTable[ body.boneIndex ];
  385. // keeps greater number if already value is set without any special reasons
  386. value = value === undefined ? body.type : Math.max( body.type, value );
  387. boneTypeTable[ body.boneIndex ] = value;
  388. }
  389. for ( var i = 0; i < data.metadata.boneCount; i ++ ) {
  390. var boneData = data.bones[ i ];
  391. var bone = {
  392. parent: boneData.parentIndex,
  393. name: boneData.name,
  394. pos: boneData.position.slice( 0, 3 ),
  395. rotq: [ 0, 0, 0, 1 ],
  396. scl: [ 1, 1, 1 ],
  397. rigidBodyType: boneTypeTable[ i ] !== undefined ? boneTypeTable[ i ] : - 1
  398. };
  399. if ( bone.parent !== - 1 ) {
  400. bone.pos[ 0 ] -= data.bones[ bone.parent ].position[ 0 ];
  401. bone.pos[ 1 ] -= data.bones[ bone.parent ].position[ 1 ];
  402. bone.pos[ 2 ] -= data.bones[ bone.parent ].position[ 2 ];
  403. }
  404. bones.push( bone );
  405. }
  406. // iks
  407. // TODO: remove duplicated codes between PMD and PMX
  408. if ( data.metadata.format === 'pmd' ) {
  409. for ( var i = 0; i < data.metadata.ikCount; i ++ ) {
  410. var ik = data.iks[ i ];
  411. var param = {
  412. target: ik.target,
  413. effector: ik.effector,
  414. iteration: ik.iteration,
  415. maxAngle: ik.maxAngle * 4,
  416. links: []
  417. };
  418. for ( var j = 0, jl = ik.links.length; j < jl; j ++ ) {
  419. var link = {};
  420. link.index = ik.links[ j ].index;
  421. link.enabled = true;
  422. if ( data.bones[ link.index ].name.indexOf( 'ひざ' ) >= 0 ) {
  423. link.limitation = new THREE.Vector3( 1.0, 0.0, 0.0 );
  424. }
  425. param.links.push( link );
  426. }
  427. iks.push( param );
  428. }
  429. } else {
  430. for ( var i = 0; i < data.metadata.boneCount; i ++ ) {
  431. var ik = data.bones[ i ].ik;
  432. if ( ik === undefined ) continue;
  433. var param = {
  434. target: i,
  435. effector: ik.effector,
  436. iteration: ik.iteration,
  437. maxAngle: ik.maxAngle,
  438. links: []
  439. };
  440. for ( var j = 0, jl = ik.links.length; j < jl; j ++ ) {
  441. var link = {};
  442. link.index = ik.links[ j ].index;
  443. link.enabled = true;
  444. if ( ik.links[ j ].angleLimitation === 1 ) {
  445. // Revert if rotationMin/Max doesn't work well
  446. // link.limitation = new THREE.Vector3( 1.0, 0.0, 0.0 );
  447. var rotationMin = ik.links[ j ].lowerLimitationAngle;
  448. var rotationMax = ik.links[ j ].upperLimitationAngle;
  449. // Convert Left to Right coordinate by myself because
  450. // MMDParser doesn't convert. It's a MMDParser's bug
  451. var tmp1 = - rotationMax[ 0 ];
  452. var tmp2 = - rotationMax[ 1 ];
  453. rotationMax[ 0 ] = - rotationMin[ 0 ];
  454. rotationMax[ 1 ] = - rotationMin[ 1 ];
  455. rotationMin[ 0 ] = tmp1;
  456. rotationMin[ 1 ] = tmp2;
  457. link.rotationMin = new THREE.Vector3().fromArray( rotationMin );
  458. link.rotationMax = new THREE.Vector3().fromArray( rotationMax );
  459. }
  460. param.links.push( link );
  461. }
  462. iks.push( param );
  463. }
  464. }
  465. // grants
  466. if ( data.metadata.format === 'pmx' ) {
  467. for ( var i = 0; i < data.metadata.boneCount; i ++ ) {
  468. var boneData = data.bones[ i ];
  469. var grant = boneData.grant;
  470. if ( grant === undefined ) continue;
  471. var param = {
  472. index: i,
  473. parentIndex: grant.parentIndex,
  474. ratio: grant.ratio,
  475. isLocal: grant.isLocal,
  476. affectRotation: grant.affectRotation,
  477. affectPosition: grant.affectPosition,
  478. transformationClass: boneData.transformationClass
  479. };
  480. grants.push( param );
  481. }
  482. grants.sort( function ( a, b ) {
  483. return a.transformationClass - b.transformationClass;
  484. } );
  485. }
  486. // morph
  487. function updateAttributes( attribute, morph, ratio ) {
  488. for ( var i = 0; i < morph.elementCount; i ++ ) {
  489. var element = morph.elements[ i ];
  490. var index;
  491. if ( data.metadata.format === 'pmd' ) {
  492. index = data.morphs[ 0 ].elements[ element.index ].index;
  493. } else {
  494. index = element.index;
  495. }
  496. attribute.array[ index * 3 + 0 ] += element.position[ 0 ] * ratio;
  497. attribute.array[ index * 3 + 1 ] += element.position[ 1 ] * ratio;
  498. attribute.array[ index * 3 + 2 ] += element.position[ 2 ] * ratio;
  499. }
  500. }
  501. for ( var i = 0; i < data.metadata.morphCount; i ++ ) {
  502. var morph = data.morphs[ i ];
  503. var params = { name: morph.name };
  504. var attribute = new THREE.Float32BufferAttribute( data.metadata.vertexCount * 3, 3 );
  505. attribute.name = morph.name;
  506. for ( var j = 0; j < data.metadata.vertexCount * 3; j ++ ) {
  507. attribute.array[ j ] = positions[ j ];
  508. }
  509. if ( data.metadata.format === 'pmd' ) {
  510. if ( i !== 0 ) {
  511. updateAttributes( attribute, morph, 1.0 );
  512. }
  513. } else {
  514. if ( morph.type === 0 ) { // group
  515. for ( var j = 0; j < morph.elementCount; j ++ ) {
  516. var morph2 = data.morphs[ morph.elements[ j ].index ];
  517. var ratio = morph.elements[ j ].ratio;
  518. if ( morph2.type === 1 ) {
  519. updateAttributes( attribute, morph2, ratio );
  520. } else {
  521. // TODO: implement
  522. }
  523. }
  524. } else if ( morph.type === 1 ) { // vertex
  525. updateAttributes( attribute, morph, 1.0 );
  526. } else if ( morph.type === 2 ) { // bone
  527. // TODO: implement
  528. } else if ( morph.type === 3 ) { // uv
  529. // TODO: implement
  530. } else if ( morph.type === 4 ) { // additional uv1
  531. // TODO: implement
  532. } else if ( morph.type === 5 ) { // additional uv2
  533. // TODO: implement
  534. } else if ( morph.type === 6 ) { // additional uv3
  535. // TODO: implement
  536. } else if ( morph.type === 7 ) { // additional uv4
  537. // TODO: implement
  538. } else if ( morph.type === 8 ) { // material
  539. // TODO: implement
  540. }
  541. }
  542. morphTargets.push( params );
  543. morphPositions.push( attribute );
  544. }
  545. // rigid bodies from rigidBodies field.
  546. for ( var i = 0; i < data.metadata.rigidBodyCount; i ++ ) {
  547. var rigidBody = data.rigidBodies[ i ];
  548. var params = {};
  549. for ( var key in rigidBody ) {
  550. params[ key ] = rigidBody[ key ];
  551. }
  552. /*
  553. * RigidBody position parameter in PMX seems global position
  554. * while the one in PMD seems offset from corresponding bone.
  555. * So unify being offset.
  556. */
  557. if ( data.metadata.format === 'pmx' ) {
  558. if ( params.boneIndex !== - 1 ) {
  559. var bone = data.bones[ params.boneIndex ];
  560. params.position[ 0 ] -= bone.position[ 0 ];
  561. params.position[ 1 ] -= bone.position[ 1 ];
  562. params.position[ 2 ] -= bone.position[ 2 ];
  563. }
  564. }
  565. rigidBodies.push( params );
  566. }
  567. // constraints from constraints field.
  568. for ( var i = 0; i < data.metadata.constraintCount; i ++ ) {
  569. var constraint = data.constraints[ i ];
  570. var params = {};
  571. for ( var key in constraint ) {
  572. params[ key ] = constraint[ key ];
  573. }
  574. var bodyA = rigidBodies[ params.rigidBodyIndex1 ];
  575. var bodyB = rigidBodies[ params.rigidBodyIndex2 ];
  576. // Refer to http://www20.atpages.jp/katwat/wp/?p=4135
  577. if ( bodyA.type !== 0 && bodyB.type === 2 ) {
  578. if ( bodyA.boneIndex !== - 1 && bodyB.boneIndex !== - 1 &&
  579. data.bones[ bodyB.boneIndex ].parentIndex === bodyA.boneIndex ) {
  580. bodyB.type = 1;
  581. }
  582. }
  583. constraints.push( params );
  584. }
  585. // build BufferGeometry.
  586. var geometry = new THREE.BufferGeometry();
  587. geometry.setAttribute( 'position', new THREE.Float32BufferAttribute( positions, 3 ) );
  588. geometry.setAttribute( 'normal', new THREE.Float32BufferAttribute( normals, 3 ) );
  589. geometry.setAttribute( 'uv', new THREE.Float32BufferAttribute( uvs, 2 ) );
  590. geometry.setAttribute( 'skinIndex', new THREE.Uint16BufferAttribute( skinIndices, 4 ) );
  591. geometry.setAttribute( 'skinWeight', new THREE.Float32BufferAttribute( skinWeights, 4 ) );
  592. geometry.setIndex( indices );
  593. for ( var i = 0, il = groups.length; i < il; i ++ ) {
  594. geometry.addGroup( groups[ i ].offset, groups[ i ].count, i );
  595. }
  596. geometry.bones = bones;
  597. geometry.morphTargets = morphTargets;
  598. geometry.morphAttributes.position = morphPositions;
  599. geometry.morphTargetsRelative = false;
  600. geometry.userData.MMD = {
  601. bones: bones,
  602. iks: iks,
  603. grants: grants,
  604. rigidBodies: rigidBodies,
  605. constraints: constraints,
  606. format: data.metadata.format
  607. };
  608. geometry.computeBoundingSphere();
  609. return geometry;
  610. }
  611. };
  612. //
  613. /**
  614. * @param {THREE.LoadingManager} manager
  615. */
  616. function MaterialBuilder( manager ) {
  617. this.manager = manager;
  618. this.textureLoader = new THREE.TextureLoader( this.manager );
  619. this.tgaLoader = null; // lazy generation
  620. }
  621. MaterialBuilder.prototype = {
  622. constructor: MaterialBuilder,
  623. crossOrigin: 'anonymous',
  624. resourcePath: undefined,
  625. /**
  626. * @param {string} crossOrigin
  627. * @return {MaterialBuilder}
  628. */
  629. setCrossOrigin: function ( crossOrigin ) {
  630. this.crossOrigin = crossOrigin;
  631. return this;
  632. },
  633. /**
  634. * @param {string} resourcePath
  635. * @return {MaterialBuilder}
  636. */
  637. setResourcePath: function ( resourcePath ) {
  638. this.resourcePath = resourcePath;
  639. return this;
  640. },
  641. /**
  642. * @param {Object} data - parsed PMD/PMX data
  643. * @param {THREE.BufferGeometry} geometry - some properties are dependend on geometry
  644. * @param {function} onProgress
  645. * @param {function} onError
  646. * @return {Array<THREE.MeshToonMaterial>}
  647. */
  648. build: function ( data, geometry /*, onProgress, onError */ ) {
  649. var materials = [];
  650. var textures = {};
  651. this.textureLoader.setCrossOrigin( this.crossOrigin );
  652. // materials
  653. for ( var i = 0; i < data.metadata.materialCount; i ++ ) {
  654. var material = data.materials[ i ];
  655. var params = { userData: {} };
  656. if ( material.name !== undefined ) params.name = material.name;
  657. /*
  658. * Color
  659. *
  660. * MMD MeshToonMaterial
  661. * diffuse - color
  662. * ambient - emissive * a
  663. * (a = 1.0 without map texture or 0.2 with map texture)
  664. *
  665. * MeshToonMaterial doesn't have ambient. Set it to emissive instead.
  666. * It'll be too bright if material has map texture so using coef 0.2.
  667. */
  668. params.color = new THREE.Color().fromArray( material.diffuse );
  669. params.opacity = material.diffuse[ 3 ];
  670. params.emissive = new THREE.Color().fromArray( material.ambient );
  671. params.transparent = params.opacity !== 1.0;
  672. //
  673. params.skinning = geometry.bones.length > 0 ? true : false;
  674. params.morphTargets = geometry.morphTargets.length > 0 ? true : false;
  675. params.fog = true;
  676. // blend
  677. params.blending = THREE.CustomBlending;
  678. params.blendSrc = THREE.SrcAlphaFactor;
  679. params.blendDst = THREE.OneMinusSrcAlphaFactor;
  680. params.blendSrcAlpha = THREE.SrcAlphaFactor;
  681. params.blendDstAlpha = THREE.DstAlphaFactor;
  682. // side
  683. if ( data.metadata.format === 'pmx' && ( material.flag & 0x1 ) === 1 ) {
  684. params.side = THREE.DoubleSide;
  685. } else {
  686. params.side = params.opacity === 1.0 ? THREE.FrontSide : THREE.DoubleSide;
  687. }
  688. if ( data.metadata.format === 'pmd' ) {
  689. // map, envMap
  690. if ( material.fileName ) {
  691. var fileName = material.fileName;
  692. var fileNames = fileName.split( '*' );
  693. // fileNames[ 0 ]: mapFileName
  694. // fileNames[ 1 ]: envMapFileName( optional )
  695. params.map = this._loadTexture( fileNames[ 0 ], textures );
  696. if ( fileNames.length > 1 ) {
  697. var extension = fileNames[ 1 ].slice( - 4 ).toLowerCase();
  698. params.envMap = this._loadTexture(
  699. fileNames[ 1 ],
  700. textures
  701. );
  702. params.combine = extension === '.sph'
  703. ? THREE.MultiplyOperation
  704. : THREE.AddOperation;
  705. }
  706. }
  707. // gradientMap
  708. var toonFileName = ( material.toonIndex === - 1 )
  709. ? 'toon00.bmp'
  710. : data.toonTextures[ material.toonIndex ].fileName;
  711. params.gradientMap = this._loadTexture(
  712. toonFileName,
  713. textures,
  714. {
  715. isToonTexture: true,
  716. isDefaultToonTexture: this._isDefaultToonTexture( toonFileName )
  717. }
  718. );
  719. // parameters for OutlineEffect
  720. params.userData.outlineParameters = {
  721. thickness: material.edgeFlag === 1 ? 0.003 : 0.0,
  722. color: [ 0, 0, 0 ],
  723. alpha: 1.0,
  724. visible: material.edgeFlag === 1
  725. };
  726. } else {
  727. // map
  728. if ( material.textureIndex !== - 1 ) {
  729. params.map = this._loadTexture( data.textures[ material.textureIndex ], textures );
  730. }
  731. // envMap TODO: support m.envFlag === 3
  732. if ( material.envTextureIndex !== - 1 && ( material.envFlag === 1 || material.envFlag == 2 ) ) {
  733. params.envMap = this._loadTexture(
  734. data.textures[ material.envTextureIndex ],
  735. textures
  736. );
  737. params.combine = material.envFlag === 1
  738. ? THREE.MultiplyOperation
  739. : THREE.AddOperation;
  740. }
  741. // gradientMap
  742. var toonFileName, isDefaultToon;
  743. if ( material.toonIndex === - 1 || material.toonFlag !== 0 ) {
  744. toonFileName = 'toon' + ( '0' + ( material.toonIndex + 1 ) ).slice( - 2 ) + '.bmp';
  745. isDefaultToon = true;
  746. } else {
  747. toonFileName = data.textures[ material.toonIndex ];
  748. isDefaultToon = false;
  749. }
  750. params.gradientMap = this._loadTexture(
  751. toonFileName,
  752. textures,
  753. {
  754. isToonTexture: true,
  755. isDefaultToonTexture: isDefaultToon
  756. }
  757. );
  758. // parameters for OutlineEffect
  759. params.userData.outlineParameters = {
  760. thickness: material.edgeSize / 300, // TODO: better calculation?
  761. color: material.edgeColor.slice( 0, 3 ),
  762. alpha: material.edgeColor[ 3 ],
  763. visible: ( material.flag & 0x10 ) !== 0 && material.edgeSize > 0.0
  764. };
  765. }
  766. if ( params.map !== undefined ) {
  767. if ( ! params.transparent ) {
  768. this._checkImageTransparency( params.map, geometry, i );
  769. }
  770. params.emissive.multiplyScalar( 0.2 );
  771. }
  772. materials.push( new THREE.MeshToonMaterial( params ) );
  773. }
  774. if ( data.metadata.format === 'pmx' ) {
  775. // set transparent true if alpha morph is defined.
  776. function checkAlphaMorph( elements, materials ) {
  777. for ( var i = 0, il = elements.length; i < il; i ++ ) {
  778. var element = elements[ i ];
  779. if ( element.index === - 1 ) continue;
  780. var material = materials[ element.index ];
  781. if ( material.opacity !== element.diffuse[ 3 ] ) {
  782. material.transparent = true;
  783. }
  784. }
  785. }
  786. for ( var i = 0, il = data.morphs.length; i < il; i ++ ) {
  787. var morph = data.morphs[ i ];
  788. var elements = morph.elements;
  789. if ( morph.type === 0 ) {
  790. for ( var j = 0, jl = elements.length; j < jl; j ++ ) {
  791. var morph2 = data.morphs[ elements[ j ].index ];
  792. if ( morph2.type !== 8 ) continue;
  793. checkAlphaMorph( morph2.elements, materials );
  794. }
  795. } else if ( morph.type === 8 ) {
  796. checkAlphaMorph( elements, materials );
  797. }
  798. }
  799. }
  800. return materials;
  801. },
  802. // private methods
  803. _getTGALoader: function () {
  804. if ( this.tgaLoader === null ) {
  805. if ( THREE.TGALoader === undefined ) {
  806. throw new Error( 'THREE.MMDLoader: Import THREE.TGALoader' );
  807. }
  808. this.tgaLoader = new THREE.TGALoader( this.manager );
  809. }
  810. return this.tgaLoader;
  811. },
  812. _isDefaultToonTexture: function ( name ) {
  813. if ( name.length !== 10 ) return false;
  814. return /toon(10|0[0-9])\.bmp/.test( name );
  815. },
  816. _loadTexture: function ( filePath, textures, params, onProgress, onError ) {
  817. params = params || {};
  818. var scope = this;
  819. var fullPath;
  820. if ( params.isDefaultToonTexture === true ) {
  821. var index;
  822. try {
  823. index = parseInt( filePath.match( /toon([0-9]{2})\.bmp$/ )[ 1 ] );
  824. } catch ( e ) {
  825. console.warn( 'THREE.MMDLoader: ' + filePath + ' seems like a '
  826. + 'not right default texture path. Using toon00.bmp instead.' );
  827. index = 0;
  828. }
  829. fullPath = DEFAULT_TOON_TEXTURES[ index ];
  830. } else {
  831. fullPath = this.resourcePath + filePath;
  832. }
  833. if ( textures[ fullPath ] !== undefined ) return textures[ fullPath ];
  834. var loader = this.manager.getHandler( fullPath );
  835. if ( loader === null ) {
  836. loader = ( filePath.slice( - 4 ).toLowerCase() === '.tga' )
  837. ? this._getTGALoader()
  838. : this.textureLoader;
  839. }
  840. var texture = loader.load( fullPath, function ( t ) {
  841. // MMD toon texture is Axis-Y oriented
  842. // but Three.js gradient map is Axis-X oriented.
  843. // So here replaces the toon texture image with the rotated one.
  844. if ( params.isToonTexture === true ) {
  845. t.image = scope._getRotatedImage( t.image );
  846. t.magFilter = THREE.NearestFilter;
  847. t.minFilter = THREE.NearestFilter;
  848. }
  849. t.flipY = false;
  850. t.wrapS = THREE.RepeatWrapping;
  851. t.wrapT = THREE.RepeatWrapping;
  852. for ( var i = 0; i < texture.readyCallbacks.length; i ++ ) {
  853. texture.readyCallbacks[ i ]( texture );
  854. }
  855. delete texture.readyCallbacks;
  856. }, onProgress, onError );
  857. texture.readyCallbacks = [];
  858. textures[ fullPath ] = texture;
  859. return texture;
  860. },
  861. _getRotatedImage: function ( image ) {
  862. var canvas = document.createElement( 'canvas' );
  863. var context = canvas.getContext( '2d' );
  864. var width = image.width;
  865. var height = image.height;
  866. canvas.width = width;
  867. canvas.height = height;
  868. context.clearRect( 0, 0, width, height );
  869. context.translate( width / 2.0, height / 2.0 );
  870. context.rotate( 0.5 * Math.PI ); // 90.0 * Math.PI / 180.0
  871. context.translate( - width / 2.0, - height / 2.0 );
  872. context.drawImage( image, 0, 0 );
  873. return context.getImageData( 0, 0, width, height );
  874. },
  875. // Check if the partial image area used by the texture is transparent.
  876. _checkImageTransparency: function ( map, geometry, groupIndex ) {
  877. map.readyCallbacks.push( function ( texture ) {
  878. // Is there any efficient ways?
  879. function createImageData( image ) {
  880. var canvas = document.createElement( 'canvas' );
  881. canvas.width = image.width;
  882. canvas.height = image.height;
  883. var context = canvas.getContext( '2d' );
  884. context.drawImage( image, 0, 0 );
  885. return context.getImageData( 0, 0, canvas.width, canvas.height );
  886. }
  887. function detectImageTransparency( image, uvs, indices ) {
  888. var width = image.width;
  889. var height = image.height;
  890. var data = image.data;
  891. var threshold = 253;
  892. if ( data.length / ( width * height ) !== 4 ) return false;
  893. for ( var i = 0; i < indices.length; i += 3 ) {
  894. var centerUV = { x: 0.0, y: 0.0 };
  895. for ( var j = 0; j < 3; j ++ ) {
  896. var index = indices[ i * 3 + j ];
  897. var uv = { x: uvs[ index * 2 + 0 ], y: uvs[ index * 2 + 1 ] };
  898. if ( getAlphaByUv( image, uv ) < threshold ) return true;
  899. centerUV.x += uv.x;
  900. centerUV.y += uv.y;
  901. }
  902. centerUV.x /= 3;
  903. centerUV.y /= 3;
  904. if ( getAlphaByUv( image, centerUV ) < threshold ) return true;
  905. }
  906. return false;
  907. }
  908. /*
  909. * This method expects
  910. * texture.flipY = false
  911. * texture.wrapS = THREE.RepeatWrapping
  912. * texture.wrapT = THREE.RepeatWrapping
  913. * TODO: more precise
  914. */
  915. function getAlphaByUv( image, uv ) {
  916. var width = image.width;
  917. var height = image.height;
  918. var x = Math.round( uv.x * width ) % width;
  919. var y = Math.round( uv.y * height ) % height;
  920. if ( x < 0 ) x += width;
  921. if ( y < 0 ) y += height;
  922. var index = y * width + x;
  923. return image.data[ index * 4 + 3 ];
  924. }
  925. var imageData = texture.image.data !== undefined
  926. ? texture.image
  927. : createImageData( texture.image );
  928. var group = geometry.groups[ groupIndex ];
  929. if ( detectImageTransparency(
  930. imageData,
  931. geometry.attributes.uv.array,
  932. geometry.index.array.slice( group.start, group.start + group.count ) ) ) {
  933. map.transparent = true;
  934. }
  935. } );
  936. }
  937. };
  938. //
  939. function AnimationBuilder() {
  940. }
  941. AnimationBuilder.prototype = {
  942. constructor: AnimationBuilder,
  943. /**
  944. * @param {Object} vmd - parsed VMD data
  945. * @param {THREE.SkinnedMesh} mesh - tracks will be fitting to mesh
  946. * @return {THREE.AnimationClip}
  947. */
  948. build: function ( vmd, mesh ) {
  949. // combine skeletal and morph animations
  950. var tracks = this.buildSkeletalAnimation( vmd, mesh ).tracks;
  951. var tracks2 = this.buildMorphAnimation( vmd, mesh ).tracks;
  952. for ( var i = 0, il = tracks2.length; i < il; i ++ ) {
  953. tracks.push( tracks2[ i ] );
  954. }
  955. return new THREE.AnimationClip( '', - 1, tracks );
  956. },
  957. /**
  958. * @param {Object} vmd - parsed VMD data
  959. * @param {THREE.SkinnedMesh} mesh - tracks will be fitting to mesh
  960. * @return {THREE.AnimationClip}
  961. */
  962. buildSkeletalAnimation: function ( vmd, mesh ) {
  963. function pushInterpolation( array, interpolation, index ) {
  964. array.push( interpolation[ index + 0 ] / 127 ); // x1
  965. array.push( interpolation[ index + 8 ] / 127 ); // x2
  966. array.push( interpolation[ index + 4 ] / 127 ); // y1
  967. array.push( interpolation[ index + 12 ] / 127 ); // y2
  968. }
  969. var tracks = [];
  970. var motions = {};
  971. var bones = mesh.skeleton.bones;
  972. var boneNameDictionary = {};
  973. for ( var i = 0, il = bones.length; i < il; i ++ ) {
  974. boneNameDictionary[ bones[ i ].name ] = true;
  975. }
  976. for ( var i = 0; i < vmd.metadata.motionCount; i ++ ) {
  977. var motion = vmd.motions[ i ];
  978. var boneName = motion.boneName;
  979. if ( boneNameDictionary[ boneName ] === undefined ) continue;
  980. motions[ boneName ] = motions[ boneName ] || [];
  981. motions[ boneName ].push( motion );
  982. }
  983. for ( var key in motions ) {
  984. var array = motions[ key ];
  985. array.sort( function ( a, b ) {
  986. return a.frameNum - b.frameNum;
  987. } );
  988. var times = [];
  989. var positions = [];
  990. var rotations = [];
  991. var pInterpolations = [];
  992. var rInterpolations = [];
  993. var basePosition = mesh.skeleton.getBoneByName( key ).position.toArray();
  994. for ( var i = 0, il = array.length; i < il; i ++ ) {
  995. var time = array[ i ].frameNum / 30;
  996. var position = array[ i ].position;
  997. var rotation = array[ i ].rotation;
  998. var interpolation = array[ i ].interpolation;
  999. times.push( time );
  1000. for ( var j = 0; j < 3; j ++ ) positions.push( basePosition[ j ] + position[ j ] );
  1001. for ( var j = 0; j < 4; j ++ ) rotations.push( rotation[ j ] );
  1002. for ( var j = 0; j < 3; j ++ ) pushInterpolation( pInterpolations, interpolation, j );
  1003. pushInterpolation( rInterpolations, interpolation, 3 );
  1004. }
  1005. var targetName = '.bones[' + key + ']';
  1006. tracks.push( this._createTrack( targetName + '.position', THREE.VectorKeyframeTrack, times, positions, pInterpolations ) );
  1007. tracks.push( this._createTrack( targetName + '.quaternion', THREE.QuaternionKeyframeTrack, times, rotations, rInterpolations ) );
  1008. }
  1009. return new THREE.AnimationClip( '', - 1, tracks );
  1010. },
  1011. /**
  1012. * @param {Object} vmd - parsed VMD data
  1013. * @param {THREE.SkinnedMesh} mesh - tracks will be fitting to mesh
  1014. * @return {THREE.AnimationClip}
  1015. */
  1016. buildMorphAnimation: function ( vmd, mesh ) {
  1017. var tracks = [];
  1018. var morphs = {};
  1019. var morphTargetDictionary = mesh.morphTargetDictionary;
  1020. for ( var i = 0; i < vmd.metadata.morphCount; i ++ ) {
  1021. var morph = vmd.morphs[ i ];
  1022. var morphName = morph.morphName;
  1023. if ( morphTargetDictionary[ morphName ] === undefined ) continue;
  1024. morphs[ morphName ] = morphs[ morphName ] || [];
  1025. morphs[ morphName ].push( morph );
  1026. }
  1027. for ( var key in morphs ) {
  1028. var array = morphs[ key ];
  1029. array.sort( function ( a, b ) {
  1030. return a.frameNum - b.frameNum;
  1031. } );
  1032. var times = [];
  1033. var values = [];
  1034. for ( var i = 0, il = array.length; i < il; i ++ ) {
  1035. times.push( array[ i ].frameNum / 30 );
  1036. values.push( array[ i ].weight );
  1037. }
  1038. tracks.push( new THREE.NumberKeyframeTrack( '.morphTargetInfluences[' + morphTargetDictionary[ key ] + ']', times, values ) );
  1039. }
  1040. return new THREE.AnimationClip( '', - 1, tracks );
  1041. },
  1042. /**
  1043. * @param {Object} vmd - parsed VMD data
  1044. * @return {THREE.AnimationClip}
  1045. */
  1046. buildCameraAnimation: function ( vmd ) {
  1047. function pushVector3( array, vec ) {
  1048. array.push( vec.x );
  1049. array.push( vec.y );
  1050. array.push( vec.z );
  1051. }
  1052. function pushQuaternion( array, q ) {
  1053. array.push( q.x );
  1054. array.push( q.y );
  1055. array.push( q.z );
  1056. array.push( q.w );
  1057. }
  1058. function pushInterpolation( array, interpolation, index ) {
  1059. array.push( interpolation[ index * 4 + 0 ] / 127 ); // x1
  1060. array.push( interpolation[ index * 4 + 1 ] / 127 ); // x2
  1061. array.push( interpolation[ index * 4 + 2 ] / 127 ); // y1
  1062. array.push( interpolation[ index * 4 + 3 ] / 127 ); // y2
  1063. }
  1064. var tracks = [];
  1065. var cameras = vmd.cameras === undefined ? [] : vmd.cameras.slice();
  1066. cameras.sort( function ( a, b ) {
  1067. return a.frameNum - b.frameNum;
  1068. } );
  1069. var times = [];
  1070. var centers = [];
  1071. var quaternions = [];
  1072. var positions = [];
  1073. var fovs = [];
  1074. var cInterpolations = [];
  1075. var qInterpolations = [];
  1076. var pInterpolations = [];
  1077. var fInterpolations = [];
  1078. var quaternion = new THREE.Quaternion();
  1079. var euler = new THREE.Euler();
  1080. var position = new THREE.Vector3();
  1081. var center = new THREE.Vector3();
  1082. for ( var i = 0, il = cameras.length; i < il; i ++ ) {
  1083. var motion = cameras[ i ];
  1084. var time = motion.frameNum / 30;
  1085. var pos = motion.position;
  1086. var rot = motion.rotation;
  1087. var distance = motion.distance;
  1088. var fov = motion.fov;
  1089. var interpolation = motion.interpolation;
  1090. times.push( time );
  1091. position.set( 0, 0, - distance );
  1092. center.set( pos[ 0 ], pos[ 1 ], pos[ 2 ] );
  1093. euler.set( - rot[ 0 ], - rot[ 1 ], - rot[ 2 ] );
  1094. quaternion.setFromEuler( euler );
  1095. position.add( center );
  1096. position.applyQuaternion( quaternion );
  1097. pushVector3( centers, center );
  1098. pushQuaternion( quaternions, quaternion );
  1099. pushVector3( positions, position );
  1100. fovs.push( fov );
  1101. for ( var j = 0; j < 3; j ++ ) {
  1102. pushInterpolation( cInterpolations, interpolation, j );
  1103. }
  1104. pushInterpolation( qInterpolations, interpolation, 3 );
  1105. // use the same parameter for x, y, z axis.
  1106. for ( var j = 0; j < 3; j ++ ) {
  1107. pushInterpolation( pInterpolations, interpolation, 4 );
  1108. }
  1109. pushInterpolation( fInterpolations, interpolation, 5 );
  1110. }
  1111. var tracks = [];
  1112. // I expect an object whose name 'target' exists under THREE.Camera
  1113. tracks.push( this._createTrack( 'target.position', THREE.VectorKeyframeTrack, times, centers, cInterpolations ) );
  1114. tracks.push( this._createTrack( '.quaternion', THREE.QuaternionKeyframeTrack, times, quaternions, qInterpolations ) );
  1115. tracks.push( this._createTrack( '.position', THREE.VectorKeyframeTrack, times, positions, pInterpolations ) );
  1116. tracks.push( this._createTrack( '.fov', THREE.NumberKeyframeTrack, times, fovs, fInterpolations ) );
  1117. return new THREE.AnimationClip( '', - 1, tracks );
  1118. },
  1119. // private method
  1120. _createTrack: function ( node, typedKeyframeTrack, times, values, interpolations ) {
  1121. /*
  1122. * optimizes here not to let KeyframeTrackPrototype optimize
  1123. * because KeyframeTrackPrototype optimizes times and values but
  1124. * doesn't optimize interpolations.
  1125. */
  1126. if ( times.length > 2 ) {
  1127. times = times.slice();
  1128. values = values.slice();
  1129. interpolations = interpolations.slice();
  1130. var stride = values.length / times.length;
  1131. var interpolateStride = interpolations.length / times.length;
  1132. var index = 1;
  1133. for ( var aheadIndex = 2, endIndex = times.length; aheadIndex < endIndex; aheadIndex ++ ) {
  1134. for ( var i = 0; i < stride; i ++ ) {
  1135. if ( values[ index * stride + i ] !== values[ ( index - 1 ) * stride + i ] ||
  1136. values[ index * stride + i ] !== values[ aheadIndex * stride + i ] ) {
  1137. index ++;
  1138. break;
  1139. }
  1140. }
  1141. if ( aheadIndex > index ) {
  1142. times[ index ] = times[ aheadIndex ];
  1143. for ( var i = 0; i < stride; i ++ ) {
  1144. values[ index * stride + i ] = values[ aheadIndex * stride + i ];
  1145. }
  1146. for ( var i = 0; i < interpolateStride; i ++ ) {
  1147. interpolations[ index * interpolateStride + i ] = interpolations[ aheadIndex * interpolateStride + i ];
  1148. }
  1149. }
  1150. }
  1151. times.length = index + 1;
  1152. values.length = ( index + 1 ) * stride;
  1153. interpolations.length = ( index + 1 ) * interpolateStride;
  1154. }
  1155. var track = new typedKeyframeTrack( node, times, values );
  1156. track.createInterpolant = function InterpolantFactoryMethodCubicBezier( result ) {
  1157. return new CubicBezierInterpolation( this.times, this.values, this.getValueSize(), result, new Float32Array( interpolations ) );
  1158. };
  1159. return track;
  1160. }
  1161. };
  1162. // interpolation
  1163. function CubicBezierInterpolation( parameterPositions, sampleValues, sampleSize, resultBuffer, params ) {
  1164. THREE.Interpolant.call( this, parameterPositions, sampleValues, sampleSize, resultBuffer );
  1165. this.interpolationParams = params;
  1166. }
  1167. CubicBezierInterpolation.prototype = Object.assign( Object.create( THREE.Interpolant.prototype ), {
  1168. constructor: CubicBezierInterpolation,
  1169. interpolate_: function ( i1, t0, t, t1 ) {
  1170. var result = this.resultBuffer;
  1171. var values = this.sampleValues;
  1172. var stride = this.valueSize;
  1173. var params = this.interpolationParams;
  1174. var offset1 = i1 * stride;
  1175. var offset0 = offset1 - stride;
  1176. // No interpolation if next key frame is in one frame in 30fps.
  1177. // This is from MMD animation spec.
  1178. // '1.5' is for precision loss. times are Float32 in Three.js Animation system.
  1179. var weight1 = ( ( t1 - t0 ) < 1 / 30 * 1.5 ) ? 0.0 : ( t - t0 ) / ( t1 - t0 );
  1180. if ( stride === 4 ) { // Quaternion
  1181. var x1 = params[ i1 * 4 + 0 ];
  1182. var x2 = params[ i1 * 4 + 1 ];
  1183. var y1 = params[ i1 * 4 + 2 ];
  1184. var y2 = params[ i1 * 4 + 3 ];
  1185. var ratio = this._calculate( x1, x2, y1, y2, weight1 );
  1186. THREE.Quaternion.slerpFlat( result, 0, values, offset0, values, offset1, ratio );
  1187. } else if ( stride === 3 ) { // Vector3
  1188. for ( var i = 0; i !== stride; ++ i ) {
  1189. var x1 = params[ i1 * 12 + i * 4 + 0 ];
  1190. var x2 = params[ i1 * 12 + i * 4 + 1 ];
  1191. var y1 = params[ i1 * 12 + i * 4 + 2 ];
  1192. var y2 = params[ i1 * 12 + i * 4 + 3 ];
  1193. var ratio = this._calculate( x1, x2, y1, y2, weight1 );
  1194. result[ i ] = values[ offset0 + i ] * ( 1 - ratio ) + values[ offset1 + i ] * ratio;
  1195. }
  1196. } else { // Number
  1197. var x1 = params[ i1 * 4 + 0 ];
  1198. var x2 = params[ i1 * 4 + 1 ];
  1199. var y1 = params[ i1 * 4 + 2 ];
  1200. var y2 = params[ i1 * 4 + 3 ];
  1201. var ratio = this._calculate( x1, x2, y1, y2, weight1 );
  1202. result[ 0 ] = values[ offset0 ] * ( 1 - ratio ) + values[ offset1 ] * ratio;
  1203. }
  1204. return result;
  1205. },
  1206. _calculate: function ( x1, x2, y1, y2, x ) {
  1207. /*
  1208. * Cubic Bezier curves
  1209. * https://en.wikipedia.org/wiki/B%C3%A9zier_curve#Cubic_B.C3.A9zier_curves
  1210. *
  1211. * B(t) = ( 1 - t ) ^ 3 * P0
  1212. * + 3 * ( 1 - t ) ^ 2 * t * P1
  1213. * + 3 * ( 1 - t ) * t^2 * P2
  1214. * + t ^ 3 * P3
  1215. * ( 0 <= t <= 1 )
  1216. *
  1217. * MMD uses Cubic Bezier curves for bone and camera animation interpolation.
  1218. * http://d.hatena.ne.jp/edvakf/20111016/1318716097
  1219. *
  1220. * x = ( 1 - t ) ^ 3 * x0
  1221. * + 3 * ( 1 - t ) ^ 2 * t * x1
  1222. * + 3 * ( 1 - t ) * t^2 * x2
  1223. * + t ^ 3 * x3
  1224. * y = ( 1 - t ) ^ 3 * y0
  1225. * + 3 * ( 1 - t ) ^ 2 * t * y1
  1226. * + 3 * ( 1 - t ) * t^2 * y2
  1227. * + t ^ 3 * y3
  1228. * ( x0 = 0, y0 = 0 )
  1229. * ( x3 = 1, y3 = 1 )
  1230. * ( 0 <= t, x1, x2, y1, y2 <= 1 )
  1231. *
  1232. * Here solves this equation with Bisection method,
  1233. * https://en.wikipedia.org/wiki/Bisection_method
  1234. * gets t, and then calculate y.
  1235. *
  1236. * f(t) = 3 * ( 1 - t ) ^ 2 * t * x1
  1237. * + 3 * ( 1 - t ) * t^2 * x2
  1238. * + t ^ 3 - x = 0
  1239. *
  1240. * (Another option: Newton's method
  1241. * https://en.wikipedia.org/wiki/Newton%27s_method)
  1242. */
  1243. var c = 0.5;
  1244. var t = c;
  1245. var s = 1.0 - t;
  1246. var loop = 15;
  1247. var eps = 1e-5;
  1248. var math = Math;
  1249. var sst3, stt3, ttt;
  1250. for ( var i = 0; i < loop; i ++ ) {
  1251. sst3 = 3.0 * s * s * t;
  1252. stt3 = 3.0 * s * t * t;
  1253. ttt = t * t * t;
  1254. var ft = ( sst3 * x1 ) + ( stt3 * x2 ) + ( ttt ) - x;
  1255. if ( math.abs( ft ) < eps ) break;
  1256. c /= 2.0;
  1257. t += ( ft < 0 ) ? c : - c;
  1258. s = 1.0 - t;
  1259. }
  1260. return ( sst3 * y1 ) + ( stt3 * y2 ) + ttt;
  1261. }
  1262. } );
  1263. return MMDLoader;
  1264. } )();