FBXLoader.js 82 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566
  1. /**
  2. * @author Kyle-Larson https://github.com/Kyle-Larson
  3. * @author Takahiro https://github.com/takahirox
  4. * @author Lewy Blue https://github.com/looeee
  5. *
  6. * Loader loads FBX file and generates Group representing FBX scene.
  7. * Requires FBX file to be >= 7.0 and in ASCII or to be any version in Binary format.
  8. *
  9. * Supports:
  10. * Mesh Generation (Positional Data)
  11. * Normal Data (Per Vertex Drawing Instance)
  12. * UV Data (Per Vertex Drawing Instance)
  13. * Skinning
  14. * Animation
  15. * - Separated Animations based on stacks.
  16. * - Skeletal & Non-Skeletal Animations
  17. * NURBS (Open, Closed and Periodic forms)
  18. *
  19. * Needs Support:
  20. * Euler rotation order
  21. *
  22. *
  23. * FBX format references:
  24. * https://wiki.blender.org/index.php/User:Mont29/Foundation/FBX_File_Structure
  25. *
  26. * Binary format specification:
  27. * https://code.blender.org/2013/08/fbx-binary-file-format-specification/
  28. * https://wiki.rogiken.org/specifications/file-format/fbx/ (more detail but Japanese)
  29. */
  30. ( function () {
  31. THREE.FBXLoader = function ( manager ) {
  32. this.manager = ( manager !== undefined ) ? manager : THREE.DefaultLoadingManager;
  33. };
  34. Object.assign( THREE.FBXLoader.prototype, {
  35. load: function ( url, onLoad, onProgress, onError ) {
  36. var self = this;
  37. var resourceDirectory = THREE.LoaderUtils.extractUrlBase( url );
  38. var loader = new THREE.FileLoader( this.manager );
  39. loader.setResponseType( 'arraybuffer' );
  40. loader.load( url, function ( buffer ) {
  41. try {
  42. var scene = self.parse( buffer, resourceDirectory );
  43. onLoad( scene );
  44. } catch ( error ) {
  45. window.setTimeout( function () {
  46. if ( onError ) onError( error );
  47. self.manager.itemError( url );
  48. }, 0 );
  49. }
  50. }, onProgress, onError );
  51. },
  52. parse: function ( FBXBuffer, resourceDirectory ) {
  53. var FBXTree;
  54. if ( isFbxFormatBinary( FBXBuffer ) ) {
  55. FBXTree = new BinaryParser().parse( FBXBuffer );
  56. } else {
  57. var FBXText = convertArrayBufferToString( FBXBuffer );
  58. if ( ! isFbxFormatASCII( FBXText ) ) {
  59. throw new Error( 'THREE.FBXLoader: Unknown format.' );
  60. }
  61. if ( getFbxVersion( FBXText ) < 7000 ) {
  62. throw new Error( 'THREE.FBXLoader: FBX version not supported, FileVersion: ' + getFbxVersion( FBXText ) );
  63. }
  64. FBXTree = new TextParser().parse( FBXText );
  65. }
  66. // console.log( FBXTree );
  67. var connections = parseConnections( FBXTree );
  68. var images = parseImages( FBXTree );
  69. var textures = parseTextures( FBXTree, new THREE.TextureLoader( this.manager ).setPath( resourceDirectory ), images, connections );
  70. var materials = parseMaterials( FBXTree, textures, connections );
  71. var skeletons = parseDeformers( FBXTree, connections );
  72. var geometryMap = parseGeometries( FBXTree, connections, skeletons );
  73. var sceneGraph = parseScene( FBXTree, connections, skeletons, geometryMap, materials );
  74. return sceneGraph;
  75. }
  76. } );
  77. // Parses FBXTree.Connections which holds parent-child connections between objects (e.g. material -> texture, model->geometry )
  78. // and details the connection type
  79. function parseConnections( FBXTree ) {
  80. var connectionMap = new Map();
  81. if ( 'Connections' in FBXTree ) {
  82. var rawConnections = FBXTree.Connections.connections;
  83. rawConnections.forEach( function ( rawConnection ) {
  84. var fromID = rawConnection[ 0 ];
  85. var toID = rawConnection[ 1 ];
  86. var relationship = rawConnection[ 2 ];
  87. if ( ! connectionMap.has( fromID ) ) {
  88. connectionMap.set( fromID, {
  89. parents: [],
  90. children: []
  91. } );
  92. }
  93. var parentRelationship = { ID: toID, relationship: relationship };
  94. connectionMap.get( fromID ).parents.push( parentRelationship );
  95. if ( ! connectionMap.has( toID ) ) {
  96. connectionMap.set( toID, {
  97. parents: [],
  98. children: []
  99. } );
  100. }
  101. var childRelationship = { ID: fromID, relationship: relationship };
  102. connectionMap.get( toID ).children.push( childRelationship );
  103. } );
  104. }
  105. return connectionMap;
  106. }
  107. // Parse FBXTree.Objects.Video for embedded image data
  108. // These images are connected to textures in FBXTree.Objects.Textures
  109. // via FBXTree.Connections.
  110. function parseImages( FBXTree ) {
  111. var images = {};
  112. var blobs = {};
  113. if ( 'Video' in FBXTree.Objects ) {
  114. var videoNodes = FBXTree.Objects.Video;
  115. for ( var nodeID in videoNodes ) {
  116. var videoNode = videoNodes[ nodeID ];
  117. var id = parseInt( nodeID );
  118. images[ id ] = videoNode.Filename;
  119. // raw image data is in videoNode.Content
  120. if ( 'Content' in videoNode ) {
  121. var arrayBufferContent = ( videoNode.Content instanceof ArrayBuffer ) && ( videoNode.Content.byteLength > 0 );
  122. var base64Content = ( typeof videoNode.Content === 'string' ) && ( videoNode.Content !== '' );
  123. if ( arrayBufferContent || base64Content ) {
  124. var image = parseImage( videoNodes[ nodeID ] );
  125. blobs[ videoNode.Filename ] = image;
  126. }
  127. }
  128. }
  129. }
  130. for ( var id in images ) {
  131. var filename = images[ id ];
  132. if ( blobs[ filename ] !== undefined ) images[ id ] = blobs[ filename ];
  133. else images[ id ] = images[ id ].split( '\\' ).pop();
  134. }
  135. return images;
  136. }
  137. // Parse embedded image data in FBXTree.Video.Content
  138. function parseImage( videoNode ) {
  139. var content = videoNode.Content;
  140. var fileName = videoNode.RelativeFilename || videoNode.Filename;
  141. var extension = fileName.slice( fileName.lastIndexOf( '.' ) + 1 ).toLowerCase();
  142. var type;
  143. switch ( extension ) {
  144. case 'bmp':
  145. type = 'image/bmp';
  146. break;
  147. case 'jpg':
  148. case 'jpeg':
  149. type = 'image/jpeg';
  150. break;
  151. case 'png':
  152. type = 'image/png';
  153. break;
  154. case 'tif':
  155. type = 'image/tiff';
  156. break;
  157. default:
  158. console.warn( 'FBXLoader: Image type "' + extension + '" is not supported.' );
  159. return;
  160. }
  161. if ( typeof content === 'string' ) { // ASCII format
  162. return 'data:' + type + ';base64,' + content;
  163. } else { // Binary Format
  164. var array = new Uint8Array( content );
  165. return window.URL.createObjectURL( new Blob( [ array ], { type: type } ) );
  166. }
  167. }
  168. // Parse nodes in FBXTree.Objects.Texture
  169. // These contain details such as UV scaling, cropping, rotation etc and are connected
  170. // to images in FBXTree.Objects.Video
  171. function parseTextures( FBXTree, loader, images, connections ) {
  172. var textureMap = new Map();
  173. if ( 'Texture' in FBXTree.Objects ) {
  174. var textureNodes = FBXTree.Objects.Texture;
  175. for ( var nodeID in textureNodes ) {
  176. var texture = parseTexture( textureNodes[ nodeID ], loader, images, connections );
  177. textureMap.set( parseInt( nodeID ), texture );
  178. }
  179. }
  180. return textureMap;
  181. }
  182. // Parse individual node in FBXTree.Objects.Texture
  183. function parseTexture( textureNode, loader, images, connections ) {
  184. var texture = loadTexture( textureNode, loader, images, connections );
  185. texture.ID = textureNode.id;
  186. texture.name = textureNode.attrName;
  187. var wrapModeU = textureNode.WrapModeU;
  188. var wrapModeV = textureNode.WrapModeV;
  189. var valueU = wrapModeU !== undefined ? wrapModeU.value : 0;
  190. var valueV = wrapModeV !== undefined ? wrapModeV.value : 0;
  191. // http://download.autodesk.com/us/fbx/SDKdocs/FBX_SDK_Help/files/fbxsdkref/class_k_fbx_texture.html#889640e63e2e681259ea81061b85143a
  192. // 0: repeat(default), 1: clamp
  193. texture.wrapS = valueU === 0 ? THREE.RepeatWrapping : THREE.ClampToEdgeWrapping;
  194. texture.wrapT = valueV === 0 ? THREE.RepeatWrapping : THREE.ClampToEdgeWrapping;
  195. if ( 'Scaling' in textureNode ) {
  196. var values = textureNode.Scaling.value;
  197. texture.repeat.x = values[ 0 ];
  198. texture.repeat.y = values[ 1 ];
  199. }
  200. return texture;
  201. }
  202. // load a texture specified as a blob or data URI, or via an external URL using THREE.TextureLoader
  203. function loadTexture( textureNode, loader, images, connections ) {
  204. var fileName;
  205. var currentPath = loader.path;
  206. var children = connections.get( textureNode.id ).children;
  207. if ( children !== undefined && children.length > 0 && images[ children[ 0 ].ID ] !== undefined ) {
  208. fileName = images[ children[ 0 ].ID ];
  209. if ( fileName.indexOf( 'blob:' ) === 0 || fileName.indexOf( 'data:' ) === 0 ) {
  210. loader.setPath( undefined );
  211. }
  212. }
  213. var texture = loader.load( fileName );
  214. loader.setPath( currentPath );
  215. return texture;
  216. }
  217. // Parse nodes in FBXTree.Objects.Material
  218. function parseMaterials( FBXTree, textureMap, connections ) {
  219. var materialMap = new Map();
  220. if ( 'Material' in FBXTree.Objects ) {
  221. var materialNodes = FBXTree.Objects.Material;
  222. for ( var nodeID in materialNodes ) {
  223. var material = parseMaterial( FBXTree, materialNodes[ nodeID ], textureMap, connections );
  224. if ( material !== null ) materialMap.set( parseInt( nodeID ), material );
  225. }
  226. }
  227. return materialMap;
  228. }
  229. // Parse single node in FBXTree.Objects.Material
  230. // Materials are connected to texture maps in FBXTree.Objects.Textures
  231. // FBX format currently only supports Lambert and Phong shading models
  232. function parseMaterial( FBXTree, materialNode, textureMap, connections ) {
  233. var ID = materialNode.id;
  234. var name = materialNode.attrName;
  235. var type = materialNode.ShadingModel;
  236. //Case where FBX wraps shading model in property object.
  237. if ( typeof type === 'object' ) {
  238. type = type.value;
  239. }
  240. // Ignore unused materials which don't have any connections.
  241. if ( ! connections.has( ID ) ) return null;
  242. var parameters = parseParameters( FBXTree, materialNode, textureMap, ID, connections );
  243. var material;
  244. switch ( type.toLowerCase() ) {
  245. case 'phong':
  246. material = new THREE.MeshPhongMaterial();
  247. break;
  248. case 'lambert':
  249. material = new THREE.MeshLambertMaterial();
  250. break;
  251. default:
  252. console.warn( 'THREE.FBXLoader: unknown material type "%s". Defaulting to MeshPhongMaterial.', type );
  253. material = new THREE.MeshPhongMaterial( { color: 0x3300ff } );
  254. break;
  255. }
  256. material.setValues( parameters );
  257. material.name = name;
  258. return material;
  259. }
  260. // Parse FBX material and return parameters suitable for a three.js material
  261. // Also parse the texture map and return any textures associated with the material
  262. function parseParameters( FBXTree, properties, textureMap, ID, connections ) {
  263. var parameters = {};
  264. if ( properties.BumpFactor ) {
  265. parameters.bumpScale = properties.BumpFactor.value;
  266. }
  267. if ( properties.Diffuse ) {
  268. parameters.color = new THREE.Color().fromArray( properties.Diffuse.value );
  269. } else if ( properties.DiffuseColor && properties.DiffuseColor.type === 'Color' ) {
  270. // The blender exporter exports diffuse here instead of in properties.Diffuse
  271. parameters.color = new THREE.Color().fromArray( properties.DiffuseColor.value );
  272. }
  273. if ( properties.DisplacementFactor ) {
  274. parameters.displacementScale = properties.DisplacementFactor.value;
  275. }
  276. if ( properties.Emissive ) {
  277. parameters.emissive = new THREE.Color().fromArray( properties.Emissive.value );
  278. } else if ( properties.EmissiveColor && properties.EmissiveColor.type === 'Color' ) {
  279. // The blender exporter exports emissive color here instead of in properties.Emissive
  280. parameters.emissive = new THREE.Color().fromArray( properties.EmissiveColor.value );
  281. }
  282. if ( properties.EmissiveFactor ) {
  283. parameters.emissiveIntensity = parseFloat( properties.EmissiveFactor.value );
  284. }
  285. if ( properties.Opacity ) {
  286. parameters.opacity = parseFloat( properties.Opacity.value );
  287. }
  288. if ( parameters.opacity < 1.0 ) {
  289. parameters.transparent = true;
  290. }
  291. if ( properties.ReflectionFactor ) {
  292. parameters.reflectivity = properties.ReflectionFactor.value;
  293. }
  294. if ( properties.Shininess ) {
  295. parameters.shininess = properties.Shininess.value;
  296. }
  297. if ( properties.Specular ) {
  298. parameters.specular = new THREE.Color().fromArray( properties.Specular.value );
  299. } else if ( properties.SpecularColor && properties.SpecularColor.type === 'Color' ) {
  300. // The blender exporter exports specular color here instead of in properties.Specular
  301. parameters.specular = new THREE.Color().fromArray( properties.SpecularColor.value );
  302. }
  303. connections.get( ID ).children.forEach( function ( child ) {
  304. var type = child.relationship;
  305. switch ( type ) {
  306. case 'Bump':
  307. parameters.bumpMap = textureMap.get( child.ID );
  308. break;
  309. case 'DiffuseColor':
  310. parameters.map = getTexture( FBXTree, textureMap, child.ID, connections );
  311. break;
  312. case 'DisplacementColor':
  313. parameters.displacementMap = getTexture( FBXTree, textureMap, child.ID, connections );
  314. break;
  315. case 'EmissiveColor':
  316. parameters.emissiveMap = getTexture( FBXTree, textureMap, child.ID, connections );
  317. break;
  318. case 'NormalMap':
  319. parameters.normalMap = getTexture( FBXTree, textureMap, child.ID, connections );
  320. break;
  321. case 'ReflectionColor':
  322. parameters.envMap = getTexture( FBXTree, textureMap, child.ID, connections );
  323. parameters.envMap.mapping = THREE.EquirectangularReflectionMapping;
  324. break;
  325. case 'SpecularColor':
  326. parameters.specularMap = getTexture( FBXTree, textureMap, child.ID, connections );
  327. break;
  328. case 'TransparentColor':
  329. parameters.alphaMap = getTexture( FBXTree, textureMap, child.ID, connections );
  330. parameters.transparent = true;
  331. break;
  332. case 'AmbientColor':
  333. case 'ShininessExponent': // AKA glossiness map
  334. case 'SpecularFactor': // AKA specularLevel
  335. case 'VectorDisplacementColor': // NOTE: Seems to be a copy of DisplacementColor
  336. default:
  337. console.warn( 'THREE.FBXLoader: %s map is not supported in three.js, skipping texture.', type );
  338. break;
  339. }
  340. } );
  341. return parameters;
  342. }
  343. // get a texture from the textureMap for use by a material.
  344. function getTexture( FBXTree, textureMap, id, connections ) {
  345. // if the texture is a layered texture, just use the first layer and issue a warning
  346. if ( 'LayeredTexture' in FBXTree.Objects && id in FBXTree.Objects.LayeredTexture ) {
  347. console.warn( 'THREE.FBXLoader: layered textures are not supported in three.js. Discarding all but first layer.' );
  348. id = connections.get( id ).children[ 0 ].ID;
  349. }
  350. return textureMap.get( id );
  351. }
  352. // Parse nodes in FBXTree.Objects.Deformer
  353. // Deformer node can contain skinning or Vertex Cache animation data, however only skinning is supported here
  354. // Generates map of Skeleton-like objects for use later when generating and binding skeletons.
  355. function parseDeformers( FBXTree, connections ) {
  356. var skeletons = {};
  357. if ( 'Deformer' in FBXTree.Objects ) {
  358. var DeformerNodes = FBXTree.Objects.Deformer;
  359. for ( var nodeID in DeformerNodes ) {
  360. var deformerNode = DeformerNodes[ nodeID ];
  361. if ( deformerNode.attrType === 'Skin' ) {
  362. var relationships = connections.get( parseInt( nodeID ) );
  363. var skeleton = parseSkeleton( relationships, DeformerNodes );
  364. skeleton.ID = nodeID;
  365. if ( relationships.parents.length > 1 ) console.warn( 'THREE.FBXLoader: skeleton attached to more than one geometry is not supported.' );
  366. skeleton.geometryID = relationships.parents[ 0 ].ID;
  367. skeletons[ nodeID ] = skeleton;
  368. }
  369. }
  370. }
  371. return skeletons;
  372. }
  373. // Parse single nodes in FBXTree.Objects.Deformer
  374. // The top level deformer nodes have type 'Skin' and subDeformer nodes have type 'Cluster'
  375. // Each skin node represents a skeleton and each cluster node represents a bone
  376. function parseSkeleton( connections, deformerNodes ) {
  377. var rawBones = [];
  378. connections.children.forEach( function ( child ) {
  379. var subDeformerNode = deformerNodes[ child.ID ];
  380. if ( subDeformerNode.attrType !== 'Cluster' ) return;
  381. var rawBone = {
  382. ID: child.ID,
  383. indices: [],
  384. weights: [],
  385. transform: new THREE.Matrix4().fromArray( subDeformerNode.Transform.a ),
  386. transformLink: new THREE.Matrix4().fromArray( subDeformerNode.TransformLink.a ),
  387. linkMode: subDeformerNode.Mode,
  388. };
  389. if ( 'Indexes' in subDeformerNode ) {
  390. rawBone.indices = subDeformerNode.Indexes.a;
  391. rawBone.weights = subDeformerNode.Weights.a;
  392. }
  393. rawBones.push( rawBone );
  394. } );
  395. return {
  396. rawBones: rawBones,
  397. bones: []
  398. };
  399. }
  400. // Parse nodes in FBXTree.Objects.Geometry
  401. function parseGeometries( FBXTree, connections, skeletons ) {
  402. var geometryMap = new Map();
  403. if ( 'Geometry' in FBXTree.Objects ) {
  404. var geometryNodes = FBXTree.Objects.Geometry;
  405. for ( var nodeID in geometryNodes ) {
  406. var relationships = connections.get( parseInt( nodeID ) );
  407. var geo = parseGeometry( FBXTree, relationships, geometryNodes[ nodeID ], skeletons );
  408. geometryMap.set( parseInt( nodeID ), geo );
  409. }
  410. }
  411. return geometryMap;
  412. }
  413. // Parse single node in FBXTree.Objects.Geometry
  414. function parseGeometry( FBXTree, relationships, geometryNode, skeletons ) {
  415. switch ( geometryNode.attrType ) {
  416. case 'Mesh':
  417. return parseMeshGeometry( FBXTree, relationships, geometryNode, skeletons );
  418. break;
  419. case 'NurbsCurve':
  420. return parseNurbsGeometry( geometryNode );
  421. break;
  422. }
  423. }
  424. // Parse single node mesh geometry in FBXTree.Objects.Geometry
  425. function parseMeshGeometry( FBXTree, relationships, geometryNode, skeletons ) {
  426. var modelNodes = relationships.parents.map( function ( parent ) {
  427. return FBXTree.Objects.Model[ parent.ID ];
  428. } );
  429. // don't create geometry if it is not associated with any models
  430. if ( modelNodes.length === 0 ) return;
  431. var skeleton = relationships.children.reduce( function ( skeleton, child ) {
  432. if ( skeletons[ child.ID ] !== undefined ) skeleton = skeletons[ child.ID ];
  433. return skeleton;
  434. }, null );
  435. var preTransform = new THREE.Matrix4();
  436. // TODO: if there is more than one model associated with the geometry, AND the models have
  437. // different geometric transforms, then this will cause problems
  438. // if ( modelNodes.length > 1 ) { }
  439. // For now just assume one model and get the preRotations from that
  440. var modelNode = modelNodes[ 0 ];
  441. if ( 'GeometricRotation' in modelNode ) {
  442. var array = modelNode.GeometricRotation.value.map( THREE.Math.degToRad );
  443. array[ 3 ] = 'ZYX';
  444. preTransform.makeRotationFromEuler( new THREE.Euler().fromArray( array ) );
  445. }
  446. if ( 'GeometricTranslation' in modelNode ) {
  447. preTransform.setPosition( new THREE.Vector3().fromArray( modelNode.GeometricTranslation.value ) );
  448. }
  449. if ( 'GeometricScaling' in modelNode ) {
  450. preTransform.scale( new THREE.Vector3().fromArray( modelNode.GeometricScaling.value ) );
  451. }
  452. return genGeometry( FBXTree, relationships, geometryNode, skeleton, preTransform );
  453. }
  454. // Generate a THREE.BufferGeometry from a node in FBXTree.Objects.Geometry
  455. function genGeometry( FBXTree, relationships, geometryNode, skeleton, preTransform ) {
  456. var vertexPositions = geometryNode.Vertices.a;
  457. var vertexIndices = geometryNode.PolygonVertexIndex.a;
  458. // create arrays to hold the final data used to build the buffergeometry
  459. var vertexBuffer = [];
  460. var normalBuffer = [];
  461. var colorsBuffer = [];
  462. var uvsBuffer = [];
  463. var materialIndexBuffer = [];
  464. var vertexWeightsBuffer = [];
  465. var weightsIndicesBuffer = [];
  466. if ( geometryNode.LayerElementColor ) {
  467. var colorInfo = getColors( geometryNode.LayerElementColor[ 0 ] );
  468. }
  469. if ( geometryNode.LayerElementMaterial ) {
  470. var materialInfo = getMaterials( geometryNode.LayerElementMaterial[ 0 ] );
  471. }
  472. if ( geometryNode.LayerElementNormal ) {
  473. var normalInfo = getNormals( geometryNode.LayerElementNormal[ 0 ] );
  474. }
  475. if ( geometryNode.LayerElementUV ) {
  476. var uvInfo = [];
  477. var i = 0;
  478. while ( geometryNode.LayerElementUV[ i ] ) {
  479. uvInfo.push( getUVs( geometryNode.LayerElementUV[ i ] ) );
  480. i ++;
  481. }
  482. }
  483. var weightTable = {};
  484. if ( skeleton !== null ) {
  485. skeleton.rawBones.forEach( function ( rawBone, i ) {
  486. // loop over the bone's vertex indices and weights
  487. rawBone.indices.forEach( function ( index, j ) {
  488. if ( weightTable[ index ] === undefined ) weightTable[ index ] = [];
  489. weightTable[ index ].push( {
  490. id: i,
  491. weight: rawBone.weights[ j ],
  492. } );
  493. } );
  494. } );
  495. }
  496. var polygonIndex = 0;
  497. var faceLength = 0;
  498. var displayedWeightsWarning = false;
  499. // these will hold data for a single face
  500. var vertexPositionIndexes = [];
  501. var faceNormals = [];
  502. var faceColors = [];
  503. var faceUVs = [];
  504. var faceWeights = [];
  505. var faceWeightIndices = [];
  506. vertexIndices.forEach( function ( vertexIndex, polygonVertexIndex ) {
  507. var endOfFace = false;
  508. // Face index and vertex index arrays are combined in a single array
  509. // A cube with quad faces looks like this:
  510. // PolygonVertexIndex: *24 {
  511. // a: 0, 1, 3, -3, 2, 3, 5, -5, 4, 5, 7, -7, 6, 7, 1, -1, 1, 7, 5, -4, 6, 0, 2, -5
  512. // }
  513. // Negative numbers mark the end of a face - first face here is 0, 1, 3, -3
  514. // to find index of last vertex multiply by -1 and subtract 1: -3 * - 1 - 1 = 2
  515. if ( vertexIndex < 0 ) {
  516. vertexIndex = vertexIndex ^ - 1; // equivalent to ( x * -1 ) - 1
  517. vertexIndices[ polygonVertexIndex ] = vertexIndex;
  518. endOfFace = true;
  519. }
  520. var weightIndices = [];
  521. var weights = [];
  522. vertexPositionIndexes.push( vertexIndex * 3, vertexIndex * 3 + 1, vertexIndex * 3 + 2 );
  523. if ( colorInfo ) {
  524. var data = getData( polygonVertexIndex, polygonIndex, vertexIndex, colorInfo );
  525. faceColors.push( data[ 0 ], data[ 1 ], data[ 2 ] );
  526. }
  527. if ( skeleton ) {
  528. if ( weightTable[ vertexIndex ] !== undefined ) {
  529. weightTable[ vertexIndex ].forEach( function ( wt ) {
  530. weights.push( wt.weight );
  531. weightIndices.push( wt.id );
  532. } );
  533. }
  534. if ( weights.length > 4 ) {
  535. if ( ! displayedWeightsWarning ) {
  536. console.warn( 'THREE.FBXLoader: Vertex has more than 4 skinning weights assigned to vertex. Deleting additional weights.' );
  537. displayedWeightsWarning = true;
  538. }
  539. var wIndex = [ 0, 0, 0, 0 ];
  540. var Weight = [ 0, 0, 0, 0 ];
  541. weights.forEach( function ( weight, weightIndex ) {
  542. var currentWeight = weight;
  543. var currentIndex = weightIndices[ weightIndex ];
  544. Weight.forEach( function ( comparedWeight, comparedWeightIndex, comparedWeightArray ) {
  545. if ( currentWeight > comparedWeight ) {
  546. comparedWeightArray[ comparedWeightIndex ] = currentWeight;
  547. currentWeight = comparedWeight;
  548. var tmp = wIndex[ comparedWeightIndex ];
  549. wIndex[ comparedWeightIndex ] = currentIndex;
  550. currentIndex = tmp;
  551. }
  552. } );
  553. } );
  554. weightIndices = wIndex;
  555. weights = Weight;
  556. }
  557. // if the weight array is shorter than 4 pad with 0s
  558. while ( weights.length < 4 ) {
  559. weights.push( 0 );
  560. weightIndices.push( 0 );
  561. }
  562. for ( var i = 0; i < 4; ++ i ) {
  563. faceWeights.push( weights[ i ] );
  564. faceWeightIndices.push( weightIndices[ i ] );
  565. }
  566. }
  567. if ( normalInfo ) {
  568. var data = getData( polygonVertexIndex, polygonIndex, vertexIndex, normalInfo );
  569. faceNormals.push( data[ 0 ], data[ 1 ], data[ 2 ] );
  570. }
  571. if ( materialInfo && materialInfo.mappingType !== 'AllSame' ) {
  572. var materialIndex = getData( polygonVertexIndex, polygonIndex, vertexIndex, materialInfo )[ 0 ];
  573. }
  574. if ( uvInfo ) {
  575. uvInfo.forEach( function ( uv, i ) {
  576. var data = getData( polygonVertexIndex, polygonIndex, vertexIndex, uv );
  577. if ( faceUVs[ i ] === undefined ) {
  578. faceUVs[ i ] = [];
  579. }
  580. faceUVs[ i ].push( data[ 0 ] );
  581. faceUVs[ i ].push( data[ 1 ] );
  582. } );
  583. }
  584. faceLength ++;
  585. // we have reached the end of a face - it may have 4 sides though
  586. // in which case the data is split to represent two 3 sided faces
  587. if ( endOfFace ) {
  588. for ( var i = 2; i < faceLength; i ++ ) {
  589. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ 0 ] ] );
  590. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ 1 ] ] );
  591. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ 2 ] ] );
  592. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ ( i - 1 ) * 3 ] ] );
  593. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ ( i - 1 ) * 3 + 1 ] ] );
  594. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ ( i - 1 ) * 3 + 2 ] ] );
  595. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ i * 3 ] ] );
  596. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ i * 3 + 1 ] ] );
  597. vertexBuffer.push( vertexPositions[ vertexPositionIndexes[ i * 3 + 2 ] ] );
  598. if ( skeleton ) {
  599. vertexWeightsBuffer.push( faceWeights[ 0 ] );
  600. vertexWeightsBuffer.push( faceWeights[ 1 ] );
  601. vertexWeightsBuffer.push( faceWeights[ 2 ] );
  602. vertexWeightsBuffer.push( faceWeights[ 3 ] );
  603. vertexWeightsBuffer.push( faceWeights[ ( i - 1 ) * 4 ] );
  604. vertexWeightsBuffer.push( faceWeights[ ( i - 1 ) * 4 + 1 ] );
  605. vertexWeightsBuffer.push( faceWeights[ ( i - 1 ) * 4 + 2 ] );
  606. vertexWeightsBuffer.push( faceWeights[ ( i - 1 ) * 4 + 3 ] );
  607. vertexWeightsBuffer.push( faceWeights[ i * 4 ] );
  608. vertexWeightsBuffer.push( faceWeights[ i * 4 + 1 ] );
  609. vertexWeightsBuffer.push( faceWeights[ i * 4 + 2 ] );
  610. vertexWeightsBuffer.push( faceWeights[ i * 4 + 3 ] );
  611. weightsIndicesBuffer.push( faceWeightIndices[ 0 ] );
  612. weightsIndicesBuffer.push( faceWeightIndices[ 1 ] );
  613. weightsIndicesBuffer.push( faceWeightIndices[ 2 ] );
  614. weightsIndicesBuffer.push( faceWeightIndices[ 3 ] );
  615. weightsIndicesBuffer.push( faceWeightIndices[ ( i - 1 ) * 4 ] );
  616. weightsIndicesBuffer.push( faceWeightIndices[ ( i - 1 ) * 4 + 1 ] );
  617. weightsIndicesBuffer.push( faceWeightIndices[ ( i - 1 ) * 4 + 2 ] );
  618. weightsIndicesBuffer.push( faceWeightIndices[ ( i - 1 ) * 4 + 3 ] );
  619. weightsIndicesBuffer.push( faceWeightIndices[ i * 4 ] );
  620. weightsIndicesBuffer.push( faceWeightIndices[ i * 4 + 1 ] );
  621. weightsIndicesBuffer.push( faceWeightIndices[ i * 4 + 2 ] );
  622. weightsIndicesBuffer.push( faceWeightIndices[ i * 4 + 3 ] );
  623. }
  624. if ( colorInfo ) {
  625. colorsBuffer.push( faceColors[ 0 ] );
  626. colorsBuffer.push( faceColors[ 1 ] );
  627. colorsBuffer.push( faceColors[ 2 ] );
  628. colorsBuffer.push( faceColors[ ( i - 1 ) * 3 ] );
  629. colorsBuffer.push( faceColors[ ( i - 1 ) * 3 + 1 ] );
  630. colorsBuffer.push( faceColors[ ( i - 1 ) * 3 + 2 ] );
  631. colorsBuffer.push( faceColors[ i * 3 ] );
  632. colorsBuffer.push( faceColors[ i * 3 + 1 ] );
  633. colorsBuffer.push( faceColors[ i * 3 + 2 ] );
  634. }
  635. if ( materialInfo && materialInfo.mappingType !== 'AllSame' ) {
  636. materialIndexBuffer.push( materialIndex );
  637. materialIndexBuffer.push( materialIndex );
  638. materialIndexBuffer.push( materialIndex );
  639. }
  640. if ( normalInfo ) {
  641. normalBuffer.push( faceNormals[ 0 ] );
  642. normalBuffer.push( faceNormals[ 1 ] );
  643. normalBuffer.push( faceNormals[ 2 ] );
  644. normalBuffer.push( faceNormals[ ( i - 1 ) * 3 ] );
  645. normalBuffer.push( faceNormals[ ( i - 1 ) * 3 + 1 ] );
  646. normalBuffer.push( faceNormals[ ( i - 1 ) * 3 + 2 ] );
  647. normalBuffer.push( faceNormals[ i * 3 ] );
  648. normalBuffer.push( faceNormals[ i * 3 + 1 ] );
  649. normalBuffer.push( faceNormals[ i * 3 + 2 ] );
  650. }
  651. if ( uvInfo ) {
  652. uvInfo.forEach( function ( uv, j ) {
  653. if ( uvsBuffer[ j ] === undefined ) uvsBuffer[ j ] = [];
  654. uvsBuffer[ j ].push( faceUVs[ j ][ 0 ] );
  655. uvsBuffer[ j ].push( faceUVs[ j ][ 1 ] );
  656. uvsBuffer[ j ].push( faceUVs[ j ][ ( i - 1 ) * 2 ] );
  657. uvsBuffer[ j ].push( faceUVs[ j ][ ( i - 1 ) * 2 + 1 ] );
  658. uvsBuffer[ j ].push( faceUVs[ j ][ i * 2 ] );
  659. uvsBuffer[ j ].push( faceUVs[ j ][ i * 2 + 1 ] );
  660. } );
  661. }
  662. }
  663. polygonIndex ++;
  664. faceLength = 0;
  665. // reset arrays for the next face
  666. vertexPositionIndexes = [];
  667. faceNormals = [];
  668. faceColors = [];
  669. faceUVs = [];
  670. faceWeights = [];
  671. faceWeightIndices = [];
  672. }
  673. } );
  674. var geo = new THREE.BufferGeometry();
  675. geo.name = geometryNode.name;
  676. var positionAttribute = new THREE.Float32BufferAttribute( vertexBuffer, 3 );
  677. preTransform.applyToBufferAttribute( positionAttribute );
  678. geo.addAttribute( 'position', positionAttribute );
  679. if ( colorsBuffer.length > 0 ) {
  680. geo.addAttribute( 'color', new THREE.Float32BufferAttribute( colorsBuffer, 3 ) );
  681. }
  682. if ( skeleton ) {
  683. geo.addAttribute( 'skinIndex', new THREE.Uint16BufferAttribute( weightsIndicesBuffer, 4 ) );
  684. geo.addAttribute( 'skinWeight', new THREE.Float32BufferAttribute( vertexWeightsBuffer, 4 ) );
  685. // used later to bind the skeleton to the model
  686. geo.FBX_Deformer = skeleton;
  687. }
  688. if ( normalBuffer.length > 0 ) {
  689. var normalAttribute = new THREE.Float32BufferAttribute( normalBuffer, 3 );
  690. var normalMatrix = new THREE.Matrix3().getNormalMatrix( preTransform );
  691. normalMatrix.applyToBufferAttribute( normalAttribute );
  692. geo.addAttribute( 'normal', normalAttribute );
  693. }
  694. uvsBuffer.forEach( function ( uvBuffer, i ) {
  695. // subsequent uv buffers are called 'uv1', 'uv2', ...
  696. var name = 'uv' + ( i + 1 ).toString();
  697. // the first uv buffer is just called 'uv'
  698. if ( i === 0 ) {
  699. name = 'uv';
  700. }
  701. geo.addAttribute( name, new THREE.Float32BufferAttribute( uvsBuffer[ i ], 2 ) );
  702. } );
  703. if ( materialInfo && materialInfo.mappingType !== 'AllSame' ) {
  704. // Convert the material indices of each vertex into rendering groups on the geometry.
  705. var prevMaterialIndex = materialIndexBuffer[ 0 ];
  706. var startIndex = 0;
  707. materialIndexBuffer.forEach( function ( currentIndex, i ) {
  708. if ( currentIndex !== prevMaterialIndex ) {
  709. geo.addGroup( startIndex, i - startIndex, prevMaterialIndex );
  710. prevMaterialIndex = currentIndex;
  711. startIndex = i;
  712. }
  713. } );
  714. // the loop above doesn't add the last group, do that here.
  715. if ( geo.groups.length > 0 ) {
  716. var lastGroup = geo.groups[ geo.groups.length - 1 ];
  717. var lastIndex = lastGroup.start + lastGroup.count;
  718. if ( lastIndex !== materialIndexBuffer.length ) {
  719. geo.addGroup( lastIndex, materialIndexBuffer.length - lastIndex, prevMaterialIndex );
  720. }
  721. }
  722. // case where there are multiple materials but the whole geometry is only
  723. // using one of them
  724. if ( geo.groups.length === 0 ) {
  725. geo.addGroup( 0, materialIndexBuffer.length, materialIndexBuffer[ 0 ] );
  726. }
  727. }
  728. return geo;
  729. }
  730. // Parse normal from FBXTree.Objects.Geometry.LayerElementNormal if it exists
  731. function getNormals( NormalNode ) {
  732. var mappingType = NormalNode.MappingInformationType;
  733. var referenceType = NormalNode.ReferenceInformationType;
  734. var buffer = NormalNode.Normals.a;
  735. var indexBuffer = [];
  736. if ( referenceType === 'IndexToDirect' ) {
  737. if ( 'NormalIndex' in NormalNode ) {
  738. indexBuffer = NormalNode.NormalIndex.a;
  739. } else if ( 'NormalsIndex' in NormalNode ) {
  740. indexBuffer = NormalNode.NormalsIndex.a;
  741. }
  742. }
  743. return {
  744. dataSize: 3,
  745. buffer: buffer,
  746. indices: indexBuffer,
  747. mappingType: mappingType,
  748. referenceType: referenceType
  749. };
  750. }
  751. // Parse UVs from FBXTree.Objects.Geometry.LayerElementUV if it exists
  752. function getUVs( UVNode ) {
  753. var mappingType = UVNode.MappingInformationType;
  754. var referenceType = UVNode.ReferenceInformationType;
  755. var buffer = UVNode.UV.a;
  756. var indexBuffer = [];
  757. if ( referenceType === 'IndexToDirect' ) {
  758. indexBuffer = UVNode.UVIndex.a;
  759. }
  760. return {
  761. dataSize: 2,
  762. buffer: buffer,
  763. indices: indexBuffer,
  764. mappingType: mappingType,
  765. referenceType: referenceType
  766. };
  767. }
  768. // Parse Vertex Colors from FBXTree.Objects.Geometry.LayerElementColor if it exists
  769. function getColors( ColorNode ) {
  770. var mappingType = ColorNode.MappingInformationType;
  771. var referenceType = ColorNode.ReferenceInformationType;
  772. var buffer = ColorNode.Colors.a;
  773. var indexBuffer = [];
  774. if ( referenceType === 'IndexToDirect' ) {
  775. indexBuffer = ColorNode.ColorIndex.a;
  776. }
  777. return {
  778. dataSize: 4,
  779. buffer: buffer,
  780. indices: indexBuffer,
  781. mappingType: mappingType,
  782. referenceType: referenceType
  783. };
  784. }
  785. // Parse mapping and material data in FBXTree.Objects.Geometry.LayerElementMaterial if it exists
  786. function getMaterials( MaterialNode ) {
  787. var mappingType = MaterialNode.MappingInformationType;
  788. var referenceType = MaterialNode.ReferenceInformationType;
  789. if ( mappingType === 'NoMappingInformation' ) {
  790. return {
  791. dataSize: 1,
  792. buffer: [ 0 ],
  793. indices: [ 0 ],
  794. mappingType: 'AllSame',
  795. referenceType: referenceType
  796. };
  797. }
  798. var materialIndexBuffer = MaterialNode.Materials.a;
  799. // Since materials are stored as indices, there's a bit of a mismatch between FBX and what
  800. // we expect.So we create an intermediate buffer that points to the index in the buffer,
  801. // for conforming with the other functions we've written for other data.
  802. var materialIndices = [];
  803. for ( var i = 0; i < materialIndexBuffer.length; ++ i ) {
  804. materialIndices.push( i );
  805. }
  806. return {
  807. dataSize: 1,
  808. buffer: materialIndexBuffer,
  809. indices: materialIndices,
  810. mappingType: mappingType,
  811. referenceType: referenceType
  812. };
  813. }
  814. // Functions use the infoObject and given indices to return value array of geometry.
  815. // Parameters:
  816. // - polygonVertexIndex - Index of vertex in draw order (which index of the index buffer refers to this vertex).
  817. // - polygonIndex - Index of polygon in geometry.
  818. // - vertexIndex - Index of vertex inside vertex buffer (used because some data refers to old index buffer that we don't use anymore).
  819. // - infoObject: can be materialInfo, normalInfo, UVInfo or colorInfo
  820. // Index type:
  821. // - Direct: index is same as polygonVertexIndex
  822. // - IndexToDirect: infoObject has it's own set of indices
  823. var dataArray = [];
  824. var GetData = {
  825. ByPolygonVertex: {
  826. Direct: function ( polygonVertexIndex, polygonIndex, vertexIndex, infoObject ) {
  827. var from = ( polygonVertexIndex * infoObject.dataSize );
  828. var to = ( polygonVertexIndex * infoObject.dataSize ) + infoObject.dataSize;
  829. return slice( dataArray, infoObject.buffer, from, to );
  830. },
  831. IndexToDirect: function ( polygonVertexIndex, polygonIndex, vertexIndex, infoObject ) {
  832. var index = infoObject.indices[ polygonVertexIndex ];
  833. var from = ( index * infoObject.dataSize );
  834. var to = ( index * infoObject.dataSize ) + infoObject.dataSize;
  835. return slice( dataArray, infoObject.buffer, from, to );
  836. }
  837. },
  838. ByPolygon: {
  839. Direct: function ( polygonVertexIndex, polygonIndex, vertexIndex, infoObject ) {
  840. var from = polygonIndex * infoObject.dataSize;
  841. var to = polygonIndex * infoObject.dataSize + infoObject.dataSize;
  842. return slice( dataArray, infoObject.buffer, from, to );
  843. },
  844. IndexToDirect: function ( polygonVertexIndex, polygonIndex, vertexIndex, infoObject ) {
  845. var index = infoObject.indices[ polygonIndex ];
  846. var from = index * infoObject.dataSize;
  847. var to = index * infoObject.dataSize + infoObject.dataSize;
  848. return slice( dataArray, infoObject.buffer, from, to );
  849. }
  850. },
  851. ByVertice: {
  852. Direct: function ( polygonVertexIndex, polygonIndex, vertexIndex, infoObject ) {
  853. var from = ( vertexIndex * infoObject.dataSize );
  854. var to = ( vertexIndex * infoObject.dataSize ) + infoObject.dataSize;
  855. return slice( dataArray, infoObject.buffer, from, to );
  856. }
  857. },
  858. AllSame: {
  859. IndexToDirect: function ( polygonVertexIndex, polygonIndex, vertexIndex, infoObject ) {
  860. var from = infoObject.indices[ 0 ] * infoObject.dataSize;
  861. var to = infoObject.indices[ 0 ] * infoObject.dataSize + infoObject.dataSize;
  862. return slice( dataArray, infoObject.buffer, from, to );
  863. }
  864. }
  865. };
  866. function getData( polygonVertexIndex, polygonIndex, vertexIndex, infoObject ) {
  867. return GetData[ infoObject.mappingType ][ infoObject.referenceType ]( polygonVertexIndex, polygonIndex, vertexIndex, infoObject );
  868. }
  869. // Generate a NurbGeometry from a node in FBXTree.Objects.Geometry
  870. function parseNurbsGeometry( geometryNode ) {
  871. if ( THREE.NURBSCurve === undefined ) {
  872. console.error( 'THREE.FBXLoader: The loader relies on THREE.NURBSCurve for any nurbs present in the model. Nurbs will show up as empty geometry.' );
  873. return new THREE.BufferGeometry();
  874. }
  875. var order = parseInt( geometryNode.Order );
  876. if ( isNaN( order ) ) {
  877. console.error( 'THREE.FBXLoader: Invalid Order %s given for geometry ID: %s', geometryNode.Order, geometryNode.id );
  878. return new THREE.BufferGeometry();
  879. }
  880. var degree = order - 1;
  881. var knots = geometryNode.KnotVector.a;
  882. var controlPoints = [];
  883. var pointsValues = geometryNode.Points.a;
  884. for ( var i = 0, l = pointsValues.length; i < l; i += 4 ) {
  885. controlPoints.push( new THREE.Vector4().fromArray( pointsValues, i ) );
  886. }
  887. var startKnot, endKnot;
  888. if ( geometryNode.Form === 'Closed' ) {
  889. controlPoints.push( controlPoints[ 0 ] );
  890. } else if ( geometryNode.Form === 'Periodic' ) {
  891. startKnot = degree;
  892. endKnot = knots.length - 1 - startKnot;
  893. for ( var i = 0; i < degree; ++ i ) {
  894. controlPoints.push( controlPoints[ i ] );
  895. }
  896. }
  897. var curve = new THREE.NURBSCurve( degree, knots, controlPoints, startKnot, endKnot );
  898. var vertices = curve.getPoints( controlPoints.length * 7 );
  899. var positions = new Float32Array( vertices.length * 3 );
  900. vertices.forEach( function ( vertex, i ) {
  901. vertex.toArray( positions, i * 3 );
  902. } );
  903. var geometry = new THREE.BufferGeometry();
  904. geometry.addAttribute( 'position', new THREE.BufferAttribute( positions, 3 ) );
  905. return geometry;
  906. }
  907. // create the main THREE.Group() to be returned by the loader
  908. function parseScene( FBXTree, connections, skeletons, geometryMap, materialMap ) {
  909. var sceneGraph = new THREE.Group();
  910. var modelMap = parseModels( FBXTree, skeletons, geometryMap, materialMap, connections );
  911. var modelNodes = FBXTree.Objects.Model;
  912. modelMap.forEach( function ( model ) {
  913. var modelNode = modelNodes[ model.ID ];
  914. setLookAtProperties( FBXTree, model, modelNode, connections, sceneGraph );
  915. var parentConnections = connections.get( model.ID ).parents;
  916. parentConnections.forEach( function ( connection ) {
  917. var parent = modelMap.get( connection.ID );
  918. if ( parent !== undefined ) parent.add( model );
  919. } );
  920. if ( model.parent === null ) {
  921. sceneGraph.add( model );
  922. }
  923. } );
  924. bindSkeleton( FBXTree, skeletons, geometryMap, modelMap, connections );
  925. addAnimations( FBXTree, connections, sceneGraph );
  926. createAmbientLight( FBXTree, sceneGraph );
  927. return sceneGraph;
  928. }
  929. // parse nodes in FBXTree.Objects.Model
  930. function parseModels( FBXTree, skeletons, geometryMap, materialMap, connections ) {
  931. var modelMap = new Map();
  932. var modelNodes = FBXTree.Objects.Model;
  933. for ( var nodeID in modelNodes ) {
  934. var id = parseInt( nodeID );
  935. var node = modelNodes[ nodeID ];
  936. var relationships = connections.get( id );
  937. var model = buildSkeleton( relationships, skeletons, id, node.attrName );
  938. if ( ! model ) {
  939. switch ( node.attrType ) {
  940. case 'Camera':
  941. model = createCamera( FBXTree, relationships );
  942. break;
  943. case 'Light':
  944. model = createLight( FBXTree, relationships );
  945. break;
  946. case 'Mesh':
  947. model = createMesh( FBXTree, relationships, geometryMap, materialMap );
  948. break;
  949. case 'NurbsCurve':
  950. model = createCurve( relationships, geometryMap );
  951. break;
  952. case 'LimbNode': // usually associated with a Bone, however if a Bone was not created we'll make a Group instead
  953. case 'Null':
  954. default:
  955. model = new THREE.Group();
  956. break;
  957. }
  958. model.name = THREE.PropertyBinding.sanitizeNodeName( node.attrName );
  959. model.ID = id;
  960. }
  961. setModelTransforms( FBXTree, model, node );
  962. modelMap.set( id, model );
  963. }
  964. return modelMap;
  965. }
  966. function buildSkeleton( relationships, skeletons, id, name ) {
  967. var bone = null;
  968. relationships.parents.forEach( function ( parent ) {
  969. for ( var ID in skeletons ) {
  970. var skeleton = skeletons[ ID ];
  971. skeleton.rawBones.forEach( function ( rawBone, i ) {
  972. if ( rawBone.ID === parent.ID ) {
  973. var subBone = bone;
  974. bone = new THREE.Bone();
  975. bone.matrixWorld.copy( rawBone.transformLink );
  976. // set name and id here - otherwise in cases where "subBone" is created it will not have a name / id
  977. bone.name = THREE.PropertyBinding.sanitizeNodeName( name );
  978. bone.ID = id;
  979. skeleton.bones[ i ] = bone;
  980. // In cases where a bone is shared between multiple meshes
  981. // duplicate the bone here and and it as a child of the first bone
  982. if ( subBone !== null ) {
  983. bone.add( subBone );
  984. }
  985. }
  986. } );
  987. }
  988. } );
  989. return bone;
  990. }
  991. // create a THREE.PerspectiveCamera or THREE.OrthographicCamera
  992. function createCamera( FBXTree, relationships ) {
  993. var model;
  994. var cameraAttribute;
  995. relationships.children.forEach( function ( child ) {
  996. var attr = FBXTree.Objects.NodeAttribute[ child.ID ];
  997. if ( attr !== undefined ) {
  998. cameraAttribute = attr;
  999. }
  1000. } );
  1001. if ( cameraAttribute === undefined ) {
  1002. model = new THREE.Object3D();
  1003. } else {
  1004. var type = 0;
  1005. if ( cameraAttribute.CameraProjectionType !== undefined && cameraAttribute.CameraProjectionType.value === 1 ) {
  1006. type = 1;
  1007. }
  1008. var nearClippingPlane = 1;
  1009. if ( cameraAttribute.NearPlane !== undefined ) {
  1010. nearClippingPlane = cameraAttribute.NearPlane.value / 1000;
  1011. }
  1012. var farClippingPlane = 1000;
  1013. if ( cameraAttribute.FarPlane !== undefined ) {
  1014. farClippingPlane = cameraAttribute.FarPlane.value / 1000;
  1015. }
  1016. var width = window.innerWidth;
  1017. var height = window.innerHeight;
  1018. if ( cameraAttribute.AspectWidth !== undefined && cameraAttribute.AspectHeight !== undefined ) {
  1019. width = cameraAttribute.AspectWidth.value;
  1020. height = cameraAttribute.AspectHeight.value;
  1021. }
  1022. var aspect = width / height;
  1023. var fov = 45;
  1024. if ( cameraAttribute.FieldOfView !== undefined ) {
  1025. fov = cameraAttribute.FieldOfView.value;
  1026. }
  1027. var focalLength = cameraAttribute.FocalLength ? cameraAttribute.FocalLength.value : null;
  1028. switch ( type ) {
  1029. case 0: // Perspective
  1030. model = new THREE.PerspectiveCamera( fov, aspect, nearClippingPlane, farClippingPlane );
  1031. if ( focalLength !== null ) model.setFocalLength( focalLength );
  1032. break;
  1033. case 1: // Orthographic
  1034. model = new THREE.OrthographicCamera( - width / 2, width / 2, height / 2, - height / 2, nearClippingPlane, farClippingPlane );
  1035. break;
  1036. default:
  1037. console.warn( 'THREE.FBXLoader: Unknown camera type ' + type + '.' );
  1038. model = new THREE.Object3D();
  1039. break;
  1040. }
  1041. }
  1042. return model;
  1043. }
  1044. // Create a THREE.DirectionalLight, THREE.PointLight or THREE.SpotLight
  1045. function createLight( FBXTree, relationships ) {
  1046. var model;
  1047. var lightAttribute;
  1048. relationships.children.forEach( function ( child ) {
  1049. var attr = FBXTree.Objects.NodeAttribute[ child.ID ];
  1050. if ( attr !== undefined ) {
  1051. lightAttribute = attr;
  1052. }
  1053. } );
  1054. if ( lightAttribute === undefined ) {
  1055. model = new THREE.Object3D();
  1056. } else {
  1057. var type;
  1058. // LightType can be undefined for Point lights
  1059. if ( lightAttribute.LightType === undefined ) {
  1060. type = 0;
  1061. } else {
  1062. type = lightAttribute.LightType.value;
  1063. }
  1064. var color = 0xffffff;
  1065. if ( lightAttribute.Color !== undefined ) {
  1066. color = new THREE.Color().fromArray( lightAttribute.Color.value );
  1067. }
  1068. var intensity = ( lightAttribute.Intensity === undefined ) ? 1 : lightAttribute.Intensity.value / 100;
  1069. // light disabled
  1070. if ( lightAttribute.CastLightOnObject !== undefined && lightAttribute.CastLightOnObject.value === 0 ) {
  1071. intensity = 0;
  1072. }
  1073. var distance = 0;
  1074. if ( lightAttribute.FarAttenuationEnd !== undefined ) {
  1075. if ( lightAttribute.EnableFarAttenuation !== undefined && lightAttribute.EnableFarAttenuation.value === 0 ) {
  1076. distance = 0;
  1077. } else {
  1078. distance = lightAttribute.FarAttenuationEnd.value;
  1079. }
  1080. }
  1081. // TODO: could this be calculated linearly from FarAttenuationStart to FarAttenuationEnd?
  1082. var decay = 1;
  1083. switch ( type ) {
  1084. case 0: // Point
  1085. model = new THREE.PointLight( color, intensity, distance, decay );
  1086. break;
  1087. case 1: // Directional
  1088. model = new THREE.DirectionalLight( color, intensity );
  1089. break;
  1090. case 2: // Spot
  1091. var angle = Math.PI / 3;
  1092. if ( lightAttribute.InnerAngle !== undefined ) {
  1093. angle = THREE.Math.degToRad( lightAttribute.InnerAngle.value );
  1094. }
  1095. var penumbra = 0;
  1096. if ( lightAttribute.OuterAngle !== undefined ) {
  1097. // TODO: this is not correct - FBX calculates outer and inner angle in degrees
  1098. // with OuterAngle > InnerAngle && OuterAngle <= Math.PI
  1099. // while three.js uses a penumbra between (0, 1) to attenuate the inner angle
  1100. penumbra = THREE.Math.degToRad( lightAttribute.OuterAngle.value );
  1101. penumbra = Math.max( penumbra, 1 );
  1102. }
  1103. model = new THREE.SpotLight( color, intensity, distance, angle, penumbra, decay );
  1104. break;
  1105. default:
  1106. console.warn( 'THREE.FBXLoader: Unknown light type ' + lightAttribute.LightType.value + ', defaulting to a THREE.PointLight.' );
  1107. model = new THREE.PointLight( color, intensity );
  1108. break;
  1109. }
  1110. if ( lightAttribute.CastShadows !== undefined && lightAttribute.CastShadows.value === 1 ) {
  1111. model.castShadow = true;
  1112. }
  1113. }
  1114. return model;
  1115. }
  1116. function createMesh( FBXTree, relationships, geometryMap, materialMap ) {
  1117. var model;
  1118. var geometry = null;
  1119. var material = null;
  1120. var materials = [];
  1121. // get geometry and materials(s) from connections
  1122. relationships.children.forEach( function ( child ) {
  1123. if ( geometryMap.has( child.ID ) ) {
  1124. geometry = geometryMap.get( child.ID );
  1125. }
  1126. if ( materialMap.has( child.ID ) ) {
  1127. materials.push( materialMap.get( child.ID ) );
  1128. }
  1129. } );
  1130. if ( materials.length > 1 ) {
  1131. material = materials;
  1132. } else if ( materials.length > 0 ) {
  1133. material = materials[ 0 ];
  1134. } else {
  1135. material = new THREE.MeshPhongMaterial( { color: 0xcccccc } );
  1136. materials.push( material );
  1137. }
  1138. if ( 'color' in geometry.attributes ) {
  1139. materials.forEach( function ( material ) {
  1140. material.vertexColors = THREE.VertexColors;
  1141. } );
  1142. }
  1143. if ( geometry.FBX_Deformer ) {
  1144. materials.forEach( function ( material ) {
  1145. material.skinning = true;
  1146. } );
  1147. model = new THREE.SkinnedMesh( geometry, material );
  1148. } else {
  1149. model = new THREE.Mesh( geometry, material );
  1150. }
  1151. return model;
  1152. }
  1153. function createCurve( relationships, geometryMap ) {
  1154. var geometry = relationships.children.reduce( function ( geo, child ) {
  1155. if ( geometryMap.has( child.ID ) ) geo = geometryMap.get( child.ID );
  1156. return geo;
  1157. }, null );
  1158. // FBX does not list materials for Nurbs lines, so we'll just put our own in here.
  1159. var material = new THREE.LineBasicMaterial( { color: 0x3300ff, linewidth: 1 } );
  1160. return new THREE.Line( geometry, material );
  1161. }
  1162. // Parse ambient color in FBXTree.GlobalSettings - if it's not set to black (default), create an ambient light
  1163. function createAmbientLight( FBXTree, sceneGraph ) {
  1164. if ( 'GlobalSettings' in FBXTree && 'AmbientColor' in FBXTree.GlobalSettings ) {
  1165. var ambientColor = FBXTree.GlobalSettings.AmbientColor.value;
  1166. var r = ambientColor[ 0 ];
  1167. var g = ambientColor[ 1 ];
  1168. var b = ambientColor[ 2 ];
  1169. if ( r !== 0 || g !== 0 || b !== 0 ) {
  1170. var color = new THREE.Color( r, g, b );
  1171. sceneGraph.add( new THREE.AmbientLight( color, 1 ) );
  1172. }
  1173. }
  1174. }
  1175. function setLookAtProperties( FBXTree, model, modelNode, connections, sceneGraph ) {
  1176. if ( 'LookAtProperty' in modelNode ) {
  1177. var children = connections.get( model.ID ).children;
  1178. children.forEach( function ( child ) {
  1179. if ( child.relationship === 'LookAtProperty' ) {
  1180. var lookAtTarget = FBXTree.Objects.Model[ child.ID ];
  1181. if ( 'Lcl_Translation' in lookAtTarget ) {
  1182. var pos = lookAtTarget.Lcl_Translation.value;
  1183. // DirectionalLight, SpotLight
  1184. if ( model.target !== undefined ) {
  1185. model.target.position.fromArray( pos );
  1186. sceneGraph.add( model.target );
  1187. } else { // Cameras and other Object3Ds
  1188. model.lookAt( new THREE.Vector3().fromArray( pos ) );
  1189. }
  1190. }
  1191. }
  1192. } );
  1193. }
  1194. }
  1195. // parse the model node for transform details and apply them to the model
  1196. function setModelTransforms( FBXTree, model, modelNode ) {
  1197. // http://help.autodesk.com/view/FBX/2017/ENU/?guid=__cpp_ref_class_fbx_euler_html
  1198. if ( 'RotationOrder' in modelNode ) {
  1199. var enums = [
  1200. 'XYZ', // default
  1201. 'XZY',
  1202. 'YZX',
  1203. 'ZXY',
  1204. 'YXZ',
  1205. 'ZYX',
  1206. 'SphericXYZ',
  1207. ];
  1208. var value = parseInt( modelNode.RotationOrder.value, 10 );
  1209. if ( value > 0 && value < 6 ) {
  1210. // model.rotation.order = enums[ value ];
  1211. // Note: Euler order other than XYZ is currently not supported, so just display a warning for now
  1212. console.warn( 'THREE.FBXLoader: unsupported Euler Order: %s. Currently only XYZ order is supported. Animations and rotations may be incorrect.', enums[ value ] );
  1213. } else if ( value === 6 ) {
  1214. console.warn( 'THREE.FBXLoader: unsupported Euler Order: Spherical XYZ. Animations and rotations may be incorrect.' );
  1215. }
  1216. }
  1217. if ( 'Lcl_Translation' in modelNode ) {
  1218. model.position.fromArray( modelNode.Lcl_Translation.value );
  1219. }
  1220. if ( 'Lcl_Rotation' in modelNode ) {
  1221. var rotation = modelNode.Lcl_Rotation.value.map( THREE.Math.degToRad );
  1222. rotation.push( 'ZYX' );
  1223. model.quaternion.setFromEuler( new THREE.Euler().fromArray( rotation ) );
  1224. }
  1225. if ( 'Lcl_Scaling' in modelNode ) {
  1226. model.scale.fromArray( modelNode.Lcl_Scaling.value );
  1227. }
  1228. if ( 'PreRotation' in modelNode ) {
  1229. var array = modelNode.PreRotation.value.map( THREE.Math.degToRad );
  1230. array[ 3 ] = 'ZYX';
  1231. var preRotations = new THREE.Euler().fromArray( array );
  1232. preRotations = new THREE.Quaternion().setFromEuler( preRotations );
  1233. model.quaternion.premultiply( preRotations );
  1234. }
  1235. }
  1236. function bindSkeleton( FBXTree, skeletons, geometryMap, modelMap, connections ) {
  1237. var bindMatrices = parsePoseNodes( FBXTree );
  1238. for ( var ID in skeletons ) {
  1239. var skeleton = skeletons[ ID ];
  1240. var parents = connections.get( parseInt( skeleton.ID ) ).parents;
  1241. parents.forEach( function ( parent ) {
  1242. if ( geometryMap.has( parent.ID ) ) {
  1243. var geoID = parent.ID;
  1244. var geoRelationships = connections.get( geoID );
  1245. geoRelationships.parents.forEach( function ( geoConnParent ) {
  1246. if ( modelMap.has( geoConnParent.ID ) ) {
  1247. var model = modelMap.get( geoConnParent.ID );
  1248. model.bind( new THREE.Skeleton( skeleton.bones ), bindMatrices[ geoConnParent.ID ] );
  1249. }
  1250. } );
  1251. }
  1252. } );
  1253. }
  1254. }
  1255. function parsePoseNodes( FBXTree ) {
  1256. var bindMatrices = {};
  1257. if ( 'Pose' in FBXTree.Objects ) {
  1258. var BindPoseNode = FBXTree.Objects.Pose;
  1259. for ( var nodeID in BindPoseNode ) {
  1260. if ( BindPoseNode[ nodeID ].attrType === 'BindPose' ) {
  1261. var poseNodes = BindPoseNode[ nodeID ].PoseNode;
  1262. if ( Array.isArray( poseNodes ) ) {
  1263. poseNodes.forEach( function ( poseNode ) {
  1264. bindMatrices[ poseNode.Node ] = new THREE.Matrix4().fromArray( poseNode.Matrix.a );
  1265. } );
  1266. } else {
  1267. bindMatrices[ poseNodes.Node ] = new THREE.Matrix4().fromArray( poseNodes.Matrix.a );
  1268. }
  1269. }
  1270. }
  1271. }
  1272. return bindMatrices;
  1273. }
  1274. function parseAnimations( FBXTree, connections ) {
  1275. // since the actual transformation data is stored in FBXTree.Objects.AnimationCurve,
  1276. // if this is undefined we can safely assume there are no animations
  1277. if ( FBXTree.Objects.AnimationCurve === undefined ) return undefined;
  1278. var curveNodesMap = parseAnimationCurveNodes( FBXTree );
  1279. parseAnimationCurves( FBXTree, connections, curveNodesMap );
  1280. var layersMap = parseAnimationLayers( FBXTree, connections, curveNodesMap );
  1281. var rawClips = parseAnimStacks( FBXTree, connections, layersMap );
  1282. return rawClips;
  1283. }
  1284. // parse nodes in FBXTree.Objects.AnimationCurveNode
  1285. // each AnimationCurveNode holds data for an animation transform for a model (e.g. left arm rotation )
  1286. // and is referenced by an AnimationLayer
  1287. function parseAnimationCurveNodes( FBXTree ) {
  1288. var rawCurveNodes = FBXTree.Objects.AnimationCurveNode;
  1289. var curveNodesMap = new Map();
  1290. for ( var nodeID in rawCurveNodes ) {
  1291. var rawCurveNode = rawCurveNodes[ nodeID ];
  1292. if ( rawCurveNode.attrName.match( /S|R|T/ ) !== null ) {
  1293. var curveNode = {
  1294. id: rawCurveNode.id,
  1295. attr: rawCurveNode.attrName,
  1296. curves: {},
  1297. };
  1298. curveNodesMap.set( curveNode.id, curveNode );
  1299. }
  1300. }
  1301. return curveNodesMap;
  1302. }
  1303. // parse nodes in FBXTree.Objects.AnimationCurve and connect them up to
  1304. // previously parsed AnimationCurveNodes. Each AnimationCurve holds data for a single animated
  1305. // axis ( e.g. times and values of x rotation)
  1306. function parseAnimationCurves( FBXTree, connections, curveNodesMap ) {
  1307. var rawCurves = FBXTree.Objects.AnimationCurve;
  1308. for ( var nodeID in rawCurves ) {
  1309. var animationCurve = {
  1310. id: rawCurves[ nodeID ].id,
  1311. times: rawCurves[ nodeID ].KeyTime.a.map( convertFBXTimeToSeconds ),
  1312. values: rawCurves[ nodeID ].KeyValueFloat.a,
  1313. };
  1314. var offset = animationCurve.times[ 0 ];
  1315. for ( var i = 0; i < animationCurve.times.length; i++ ) {
  1316. animationCurve.times[ i ] -= offset;
  1317. }
  1318. var relationships = connections.get( animationCurve.id );
  1319. if ( relationships !== undefined ) {
  1320. var animationCurveID = relationships.parents[ 0 ].ID;
  1321. var animationCurveRelationship = relationships.parents[ 0 ].relationship;
  1322. var axis = '';
  1323. if ( animationCurveRelationship.match( /X/ ) ) {
  1324. axis = 'x';
  1325. } else if ( animationCurveRelationship.match( /Y/ ) ) {
  1326. axis = 'y';
  1327. } else if ( animationCurveRelationship.match( /Z/ ) ) {
  1328. axis = 'z';
  1329. } else {
  1330. continue;
  1331. }
  1332. curveNodesMap.get( animationCurveID ).curves[ axis ] = animationCurve;
  1333. }
  1334. }
  1335. }
  1336. // parse nodes in FBXTree.Objects.AnimationLayer. Each layers holds references
  1337. // to various AnimationCurveNodes and is referenced by an AnimationStack node
  1338. // note: theoretically a stack can multiple layers, however in practice there always seems to be one per stack
  1339. function parseAnimationLayers( FBXTree, connections, curveNodesMap ) {
  1340. var rawLayers = FBXTree.Objects.AnimationLayer;
  1341. var layersMap = new Map();
  1342. for ( var nodeID in rawLayers ) {
  1343. var layerCurveNodes = [];
  1344. var connection = connections.get( parseInt( nodeID ) );
  1345. if ( connection !== undefined ) {
  1346. // all the animationCurveNodes used in the layer
  1347. var children = connection.children;
  1348. children.forEach( function ( child, i ) {
  1349. if ( curveNodesMap.has( child.ID ) ) {
  1350. var curveNode = curveNodesMap.get( child.ID );
  1351. // check that the curves are defined for at least one axis, otherwise ignore the curveNode
  1352. if ( curveNode.curves.x !== undefined || curveNode.curves.y !== undefined || curveNode.curves.z !== undefined ) {
  1353. if ( layerCurveNodes[ i ] === undefined ) {
  1354. var modelID;
  1355. connections.get( child.ID ).parents.forEach( function ( parent ) {
  1356. if ( parent.relationship !== undefined ) modelID = parent.ID;
  1357. } );
  1358. var rawModel = FBXTree.Objects.Model[ modelID.toString() ];
  1359. var node = {
  1360. modelName: THREE.PropertyBinding.sanitizeNodeName( rawModel.attrName ),
  1361. initialPosition: [ 0, 0, 0 ],
  1362. initialRotation: [ 0, 0, 0 ],
  1363. initialScale: [ 1, 1, 1 ],
  1364. };
  1365. if ( 'Lcl_Translation' in rawModel ) node.initialPosition = rawModel.Lcl_Translation.value;
  1366. if ( 'Lcl_Rotation' in rawModel ) node.initialRotation = rawModel.Lcl_Rotation.value;
  1367. if ( 'Lcl_Scaling' in rawModel ) node.initialScale = rawModel.Lcl_Scaling.value;
  1368. // if the animated model is pre rotated, we'll have to apply the pre rotations to every
  1369. // animation value as well
  1370. if ( 'PreRotation' in rawModel ) node.preRotations = rawModel.PreRotation.value;
  1371. layerCurveNodes[ i ] = node;
  1372. }
  1373. layerCurveNodes[ i ][ curveNode.attr ] = curveNode;
  1374. }
  1375. }
  1376. } );
  1377. layersMap.set( parseInt( nodeID ), layerCurveNodes );
  1378. }
  1379. }
  1380. return layersMap;
  1381. }
  1382. // parse nodes in FBXTree.Objects.AnimationStack. These are the top level node in the animation
  1383. // hierarchy. Each Stack node will be used to create a THREE.AnimationClip
  1384. function parseAnimStacks( FBXTree, connections, layersMap ) {
  1385. var rawStacks = FBXTree.Objects.AnimationStack;
  1386. // connect the stacks (clips) up to the layers
  1387. var rawClips = {};
  1388. for ( var nodeID in rawStacks ) {
  1389. var children = connections.get( parseInt( nodeID ) ).children;
  1390. if ( children.length > 1 ) {
  1391. // it seems like stacks will always be associated with a single layer. But just in case there are files
  1392. // where there are multiple layers per stack, we'll display a warning
  1393. console.warn( 'THREE.FBXLoader: Encountered an animation stack with multiple layers, this is currently not supported. Ignoring subsequent layers.' );
  1394. }
  1395. var layer = layersMap.get( children[ 0 ].ID );
  1396. rawClips[ nodeID ] = {
  1397. name: rawStacks[ nodeID ].attrName,
  1398. layer: layer,
  1399. };
  1400. }
  1401. return rawClips;
  1402. }
  1403. // take raw animation data from parseAnimations and connect it up to the loaded models
  1404. function addAnimations( FBXTree, connections, sceneGraph ) {
  1405. sceneGraph.animations = [];
  1406. var rawClips = parseAnimations( FBXTree, connections );
  1407. if ( rawClips === undefined ) return;
  1408. for ( var key in rawClips ) {
  1409. var rawClip = rawClips[ key ];
  1410. var clip = addClip( rawClip );
  1411. sceneGraph.animations.push( clip );
  1412. }
  1413. }
  1414. function addClip( rawClip ) {
  1415. var tracks = [];
  1416. rawClip.layer.forEach( function ( rawTracks ) {
  1417. tracks = tracks.concat( generateTracks( rawTracks ) );
  1418. } );
  1419. return new THREE.AnimationClip( rawClip.name, - 1, tracks );
  1420. }
  1421. function generateTracks( rawTracks ) {
  1422. var tracks = [];
  1423. if ( rawTracks.T !== undefined && Object.keys( rawTracks.T.curves ).length > 0 ) {
  1424. var positionTrack = generateVectorTrack( rawTracks.modelName, rawTracks.T.curves, rawTracks.initialPosition, 'position' );
  1425. if ( positionTrack !== undefined ) tracks.push( positionTrack );
  1426. }
  1427. if ( rawTracks.R !== undefined && Object.keys( rawTracks.R.curves ).length > 0 ) {
  1428. var rotationTrack = generateRotationTrack( rawTracks.modelName, rawTracks.R.curves, rawTracks.initialRotation, rawTracks.preRotations );
  1429. if ( rotationTrack !== undefined ) tracks.push( rotationTrack );
  1430. }
  1431. if ( rawTracks.S !== undefined && Object.keys( rawTracks.S.curves ).length > 0 ) {
  1432. var scaleTrack = generateVectorTrack( rawTracks.modelName, rawTracks.S.curves, rawTracks.initialScale, 'scale' );
  1433. if ( scaleTrack !== undefined ) tracks.push( scaleTrack );
  1434. }
  1435. return tracks;
  1436. }
  1437. function generateVectorTrack( modelName, curves, initialValue, type ) {
  1438. var times = getTimesForAllAxes( curves );
  1439. var values = getKeyframeTrackValues( times, curves, initialValue );
  1440. return new THREE.VectorKeyframeTrack( modelName + '.' + type, times, values );
  1441. }
  1442. function generateRotationTrack( modelName, curves, initialValue, preRotations ) {
  1443. if ( curves.x !== undefined ) curves.x.values = curves.x.values.map( THREE.Math.degToRad );
  1444. if ( curves.y !== undefined ) curves.y.values = curves.y.values.map( THREE.Math.degToRad );
  1445. if ( curves.z !== undefined ) curves.z.values = curves.z.values.map( THREE.Math.degToRad );
  1446. var times = getTimesForAllAxes( curves );
  1447. var values = getKeyframeTrackValues( times, curves, initialValue );
  1448. if ( preRotations !== undefined ) {
  1449. preRotations = preRotations.map( THREE.Math.degToRad );
  1450. preRotations.push( 'ZYX' );
  1451. preRotations = new THREE.Euler().fromArray( preRotations );
  1452. preRotations = new THREE.Quaternion().setFromEuler( preRotations );
  1453. }
  1454. var quaternion = new THREE.Quaternion();
  1455. var euler = new THREE.Euler();
  1456. var quaternionValues = [];
  1457. for ( var i = 0; i < values.length; i += 3 ) {
  1458. euler.set( values[ i ], values[ i + 1 ], values[ i + 2 ], 'ZYX' );
  1459. quaternion.setFromEuler( euler );
  1460. if ( preRotations !== undefined )quaternion.premultiply( preRotations );
  1461. quaternion.toArray( quaternionValues, ( i / 3 ) * 4 );
  1462. }
  1463. return new THREE.QuaternionKeyframeTrack( modelName + '.quaternion', times, quaternionValues );
  1464. }
  1465. function getKeyframeTrackValues( times, curves, initialValue ) {
  1466. var prevValue = initialValue;
  1467. var values = [];
  1468. var xIndex = - 1;
  1469. var yIndex = - 1;
  1470. var zIndex = - 1;
  1471. times.forEach( function ( time ) {
  1472. if ( curves.x ) xIndex = curves.x.times.indexOf( time );
  1473. if ( curves.y ) yIndex = curves.y.times.indexOf( time );
  1474. if ( curves.z ) zIndex = curves.z.times.indexOf( time );
  1475. // if there is an x value defined for this frame, use that
  1476. if ( xIndex !== - 1 ) {
  1477. var xValue = curves.x.values[ xIndex ];
  1478. values.push( xValue );
  1479. prevValue[ 0 ] = xValue;
  1480. } else {
  1481. // otherwise use the x value from the previous frame
  1482. values.push( prevValue[ 0 ] );
  1483. }
  1484. if ( yIndex !== - 1 ) {
  1485. var yValue = curves.y.values[ yIndex ];
  1486. values.push( yValue );
  1487. prevValue[ 1 ] = yValue;
  1488. } else {
  1489. values.push( prevValue[ 1 ] );
  1490. }
  1491. if ( zIndex !== - 1 ) {
  1492. var zValue = curves.z.values[ zIndex ];
  1493. values.push( zValue );
  1494. prevValue[ 2 ] = zValue;
  1495. } else {
  1496. values.push( prevValue[ 2 ] );
  1497. }
  1498. } );
  1499. return values;
  1500. }
  1501. // For all animated objects, times are defined separately for each axis
  1502. // Here we'll combine the times into one sorted array without duplicates
  1503. function getTimesForAllAxes( curves ) {
  1504. var times = [];
  1505. // first join together the times for each axis, if defined
  1506. if ( curves.x !== undefined ) times = times.concat( curves.x.times );
  1507. if ( curves.y !== undefined ) times = times.concat( curves.y.times );
  1508. if ( curves.z !== undefined ) times = times.concat( curves.z.times );
  1509. // then sort them and remove duplicates
  1510. times = times.sort( function ( a, b ) {
  1511. return a - b;
  1512. } ).filter( function ( elem, index, array ) {
  1513. return array.indexOf( elem ) == index;
  1514. } );
  1515. return times;
  1516. }
  1517. // parse an FBX file in ASCII format
  1518. function TextParser() {}
  1519. Object.assign( TextParser.prototype, {
  1520. getPrevNode: function () {
  1521. return this.nodeStack[ this.currentIndent - 2 ];
  1522. },
  1523. getCurrentNode: function () {
  1524. return this.nodeStack[ this.currentIndent - 1 ];
  1525. },
  1526. getCurrentProp: function () {
  1527. return this.currentProp;
  1528. },
  1529. pushStack: function ( node ) {
  1530. this.nodeStack.push( node );
  1531. this.currentIndent += 1;
  1532. },
  1533. popStack: function () {
  1534. this.nodeStack.pop();
  1535. this.currentIndent -= 1;
  1536. },
  1537. setCurrentProp: function ( val, name ) {
  1538. this.currentProp = val;
  1539. this.currentPropName = name;
  1540. },
  1541. parse: function ( text ) {
  1542. this.currentIndent = 0;
  1543. this.allNodes = new FBXTree();
  1544. this.nodeStack = [];
  1545. this.currentProp = [];
  1546. this.currentPropName = '';
  1547. var self = this;
  1548. var split = text.split( '\n' );
  1549. split.forEach( function ( line, i ) {
  1550. var matchComment = line.match( /^[\s\t]*;/ );
  1551. var matchEmpty = line.match( /^[\s\t]*$/ );
  1552. if ( matchComment || matchEmpty ) return;
  1553. var matchBeginning = line.match( '^\\t{' + self.currentIndent + '}(\\w+):(.*){', '' );
  1554. var matchProperty = line.match( '^\\t{' + ( self.currentIndent ) + '}(\\w+):[\\s\\t\\r\\n](.*)' );
  1555. var matchEnd = line.match( '^\\t{' + ( self.currentIndent - 1 ) + '}}' );
  1556. if ( matchBeginning ) {
  1557. self.parseNodeBegin( line, matchBeginning );
  1558. } else if ( matchProperty ) {
  1559. self.parseNodeProperty( line, matchProperty, split[ ++ i ] );
  1560. } else if ( matchEnd ) {
  1561. self.popStack();
  1562. } else if ( line.match( /^[^\s\t}]/ ) ) {
  1563. // large arrays are split over multiple lines terminated with a ',' character
  1564. // if this is encountered the line needs to be joined to the previous line
  1565. self.parseNodePropertyContinued( line );
  1566. }
  1567. } );
  1568. return this.allNodes;
  1569. },
  1570. parseNodeBegin: function ( line, property ) {
  1571. var nodeName = property[ 1 ].trim().replace( /^"/, '' ).replace( /"$/, '' );
  1572. var nodeAttrs = property[ 2 ].split( ',' ).map( function ( attr ) {
  1573. return attr.trim().replace( /^"/, '' ).replace( /"$/, '' );
  1574. } );
  1575. var node = { name: nodeName };
  1576. var attrs = this.parseNodeAttr( nodeAttrs );
  1577. var currentNode = this.getCurrentNode();
  1578. // a top node
  1579. if ( this.currentIndent === 0 ) {
  1580. this.allNodes.add( nodeName, node );
  1581. } else { // a subnode
  1582. // if the subnode already exists, append it
  1583. if ( nodeName in currentNode ) {
  1584. // special case Pose needs PoseNodes as an array
  1585. if ( nodeName === 'PoseNode' ) {
  1586. currentNode.PoseNode.push( node );
  1587. } else if ( currentNode[ nodeName ].id !== undefined ) {
  1588. currentNode[ nodeName ] = {};
  1589. currentNode[ nodeName ][ currentNode[ nodeName ].id ] = currentNode[ nodeName ];
  1590. }
  1591. if ( attrs.id !== '' ) currentNode[ nodeName ][ attrs.id ] = node;
  1592. } else if ( typeof attrs.id === 'number' ) {
  1593. currentNode[ nodeName ] = {};
  1594. currentNode[ nodeName ][ attrs.id ] = node;
  1595. } else if ( nodeName !== 'Properties70' ) {
  1596. if ( nodeName === 'PoseNode' ) currentNode[ nodeName ] = [ node ];
  1597. else currentNode[ nodeName ] = node;
  1598. }
  1599. }
  1600. if ( typeof attrs.id === 'number' ) node.id = attrs.id;
  1601. if ( attrs.name !== '' ) node.attrName = attrs.name;
  1602. if ( attrs.type !== '' ) node.attrType = attrs.type;
  1603. this.pushStack( node );
  1604. },
  1605. parseNodeAttr: function ( attrs ) {
  1606. var id = attrs[ 0 ];
  1607. if ( attrs[ 0 ] !== '' ) {
  1608. id = parseInt( attrs[ 0 ] );
  1609. if ( isNaN( id ) ) {
  1610. id = attrs[ 0 ];
  1611. }
  1612. }
  1613. var name = '', type = '';
  1614. if ( attrs.length > 1 ) {
  1615. name = attrs[ 1 ].replace( /^(\w+)::/, '' );
  1616. type = attrs[ 2 ];
  1617. }
  1618. return { id: id, name: name, type: type };
  1619. },
  1620. parseNodeProperty: function ( line, property, contentLine ) {
  1621. var propName = property[ 1 ].replace( /^"/, '' ).replace( /"$/, '' ).trim();
  1622. var propValue = property[ 2 ].replace( /^"/, '' ).replace( /"$/, '' ).trim();
  1623. // for special case: base64 image data follows "Content: ," line
  1624. // Content: ,
  1625. // "/9j/4RDaRXhpZgAATU0A..."
  1626. if ( propName === 'Content' && propValue === ',' ) {
  1627. propValue = contentLine.replace( /"/g, '' ).replace( /,$/, '' ).trim();
  1628. }
  1629. var currentNode = this.getCurrentNode();
  1630. var parentName = currentNode.name;
  1631. if ( parentName === 'Properties70' ) {
  1632. this.parseNodeSpecialProperty( line, propName, propValue );
  1633. return;
  1634. }
  1635. // Connections
  1636. if ( propName === 'C' ) {
  1637. var connProps = propValue.split( ',' ).slice( 1 );
  1638. var from = parseInt( connProps[ 0 ] );
  1639. var to = parseInt( connProps[ 1 ] );
  1640. var rest = propValue.split( ',' ).slice( 3 );
  1641. rest = rest.map( function ( elem ) {
  1642. return elem.trim().replace( /^"/, '' );
  1643. } );
  1644. propName = 'connections';
  1645. propValue = [ from, to ];
  1646. append( propValue, rest );
  1647. if ( currentNode[ propName ] === undefined ) {
  1648. currentNode[ propName ] = [];
  1649. }
  1650. }
  1651. // Node
  1652. if ( propName === 'Node' ) currentNode.id = propValue;
  1653. // connections
  1654. if ( propName in currentNode && Array.isArray( currentNode[ propName ] ) ) {
  1655. currentNode[ propName ].push( propValue );
  1656. } else {
  1657. if ( propName !== 'a' ) currentNode[ propName ] = propValue;
  1658. else currentNode.a = propValue;
  1659. }
  1660. this.setCurrentProp( currentNode, propName );
  1661. // convert string to array, unless it ends in ',' in which case more will be added to it
  1662. if ( propName === 'a' && propValue.slice( - 1 ) !== ',' ) {
  1663. currentNode.a = parseNumberArray( propValue );
  1664. }
  1665. },
  1666. parseNodePropertyContinued: function ( line ) {
  1667. var currentNode = this.getCurrentNode();
  1668. currentNode.a += line;
  1669. // if the line doesn't end in ',' we have reached the end of the property value
  1670. // so convert the string to an array
  1671. if ( line.slice( - 1 ) !== ',' ) {
  1672. currentNode.a = parseNumberArray( currentNode.a );
  1673. }
  1674. },
  1675. // parse "Property70"
  1676. parseNodeSpecialProperty: function ( line, propName, propValue ) {
  1677. // split this
  1678. // P: "Lcl Scaling", "Lcl Scaling", "", "A",1,1,1
  1679. // into array like below
  1680. // ["Lcl Scaling", "Lcl Scaling", "", "A", "1,1,1" ]
  1681. var props = propValue.split( '",' ).map( function ( prop ) {
  1682. return prop.trim().replace( /^\"/, '' ).replace( /\s/, '_' );
  1683. } );
  1684. var innerPropName = props[ 0 ];
  1685. var innerPropType1 = props[ 1 ];
  1686. var innerPropType2 = props[ 2 ];
  1687. var innerPropFlag = props[ 3 ];
  1688. var innerPropValue = props[ 4 ];
  1689. // cast values where needed, otherwise leave as strings
  1690. switch ( innerPropType1 ) {
  1691. case 'int':
  1692. case 'enum':
  1693. case 'bool':
  1694. case 'ULongLong':
  1695. case 'double':
  1696. case 'Number':
  1697. case 'FieldOfView':
  1698. innerPropValue = parseFloat( innerPropValue );
  1699. break;
  1700. case 'Color':
  1701. case 'ColorRGB':
  1702. case 'Vector3D':
  1703. case 'Lcl_Translation':
  1704. case 'Lcl_Rotation':
  1705. case 'Lcl_Scaling':
  1706. innerPropValue = parseNumberArray( innerPropValue );
  1707. break;
  1708. }
  1709. // CAUTION: these props must append to parent's parent
  1710. this.getPrevNode()[ innerPropName ] = {
  1711. 'type': innerPropType1,
  1712. 'type2': innerPropType2,
  1713. 'flag': innerPropFlag,
  1714. 'value': innerPropValue
  1715. };
  1716. this.setCurrentProp( this.getPrevNode(), innerPropName );
  1717. },
  1718. } );
  1719. // Parse an FBX file in Binary format
  1720. function BinaryParser() {}
  1721. Object.assign( BinaryParser.prototype, {
  1722. parse: function ( buffer ) {
  1723. var reader = new BinaryReader( buffer );
  1724. reader.skip( 23 ); // skip magic 23 bytes
  1725. var version = reader.getUint32();
  1726. console.log( 'THREE.FBXLoader: FBX binary version: ' + version );
  1727. var allNodes = new FBXTree();
  1728. while ( ! this.endOfContent( reader ) ) {
  1729. var node = this.parseNode( reader, version );
  1730. if ( node !== null ) allNodes.add( node.name, node );
  1731. }
  1732. return allNodes;
  1733. },
  1734. // Check if reader has reached the end of content.
  1735. endOfContent: function ( reader ) {
  1736. // footer size: 160bytes + 16-byte alignment padding
  1737. // - 16bytes: magic
  1738. // - padding til 16-byte alignment (at least 1byte?)
  1739. // (seems like some exporters embed fixed 15 or 16bytes?)
  1740. // - 4bytes: magic
  1741. // - 4bytes: version
  1742. // - 120bytes: zero
  1743. // - 16bytes: magic
  1744. if ( reader.size() % 16 === 0 ) {
  1745. return ( ( reader.getOffset() + 160 + 16 ) & ~ 0xf ) >= reader.size();
  1746. } else {
  1747. return reader.getOffset() + 160 + 16 >= reader.size();
  1748. }
  1749. },
  1750. // recursively parse nodes until the end of the file is reached
  1751. parseNode: function ( reader, version ) {
  1752. var node = {};
  1753. // The first three data sizes depends on version.
  1754. var endOffset = ( version >= 7500 ) ? reader.getUint64() : reader.getUint32();
  1755. var numProperties = ( version >= 7500 ) ? reader.getUint64() : reader.getUint32();
  1756. // note: do not remove this even if you get a linter warning as it moves the buffer forward
  1757. var propertyListLen = ( version >= 7500 ) ? reader.getUint64() : reader.getUint32();
  1758. var nameLen = reader.getUint8();
  1759. var name = reader.getString( nameLen );
  1760. // Regards this node as NULL-record if endOffset is zero
  1761. if ( endOffset === 0 ) return null;
  1762. var propertyList = [];
  1763. for ( var i = 0; i < numProperties; i ++ ) {
  1764. propertyList.push( this.parseProperty( reader ) );
  1765. }
  1766. // Regards the first three elements in propertyList as id, attrName, and attrType
  1767. var id = propertyList.length > 0 ? propertyList[ 0 ] : '';
  1768. var attrName = propertyList.length > 1 ? propertyList[ 1 ] : '';
  1769. var attrType = propertyList.length > 2 ? propertyList[ 2 ] : '';
  1770. // check if this node represents just a single property
  1771. // like (name, 0) set or (name2, [0, 1, 2]) set of {name: 0, name2: [0, 1, 2]}
  1772. node.singleProperty = ( numProperties === 1 && reader.getOffset() === endOffset ) ? true : false;
  1773. while ( endOffset > reader.getOffset() ) {
  1774. var subNode = this.parseNode( reader, version );
  1775. if ( subNode !== null ) this.parseSubNode( name, node, subNode );
  1776. }
  1777. node.propertyList = propertyList; // raw property list used by parent
  1778. if ( typeof id === 'number' ) node.id = id;
  1779. if ( attrName !== '' ) node.attrName = attrName;
  1780. if ( attrType !== '' ) node.attrType = attrType;
  1781. if ( name !== '' ) node.name = name;
  1782. return node;
  1783. },
  1784. parseSubNode: function ( name, node, subNode ) {
  1785. // special case: child node is single property
  1786. if ( subNode.singleProperty === true ) {
  1787. var value = subNode.propertyList[ 0 ];
  1788. if ( Array.isArray( value ) ) {
  1789. node[ subNode.name ] = subNode;
  1790. subNode.a = value;
  1791. } else {
  1792. node[ subNode.name ] = value;
  1793. }
  1794. } else if ( name === 'Connections' && subNode.name === 'C' ) {
  1795. var array = [];
  1796. subNode.propertyList.forEach( function ( property, i ) {
  1797. // first Connection is FBX type (OO, OP, etc.). We'll discard these
  1798. if ( i !== 0 ) array.push( property );
  1799. } );
  1800. if ( node.connections === undefined ) {
  1801. node.connections = [];
  1802. }
  1803. node.connections.push( array );
  1804. } else if ( subNode.name === 'Properties70' ) {
  1805. var keys = Object.keys( subNode );
  1806. keys.forEach( function ( key ) {
  1807. node[ key ] = subNode[ key ];
  1808. } );
  1809. } else if ( name === 'Properties70' && subNode.name === 'P' ) {
  1810. var innerPropName = subNode.propertyList[ 0 ];
  1811. var innerPropType1 = subNode.propertyList[ 1 ];
  1812. var innerPropType2 = subNode.propertyList[ 2 ];
  1813. var innerPropFlag = subNode.propertyList[ 3 ];
  1814. var innerPropValue;
  1815. if ( innerPropName.indexOf( 'Lcl ' ) === 0 ) innerPropName = innerPropName.replace( 'Lcl ', 'Lcl_' );
  1816. if ( innerPropType1.indexOf( 'Lcl ' ) === 0 ) innerPropType1 = innerPropType1.replace( 'Lcl ', 'Lcl_' );
  1817. if ( innerPropType1 === 'Color' || innerPropType1 === 'ColorRGB' || innerPropType1 === 'Vector' || innerPropType1 === 'Vector3D' || innerPropType1.indexOf( 'Lcl_' ) === 0 ) {
  1818. innerPropValue = [
  1819. subNode.propertyList[ 4 ],
  1820. subNode.propertyList[ 5 ],
  1821. subNode.propertyList[ 6 ]
  1822. ];
  1823. } else {
  1824. innerPropValue = subNode.propertyList[ 4 ];
  1825. }
  1826. // this will be copied to parent, see above
  1827. node[ innerPropName ] = {
  1828. 'type': innerPropType1,
  1829. 'type2': innerPropType2,
  1830. 'flag': innerPropFlag,
  1831. 'value': innerPropValue
  1832. };
  1833. } else if ( node[ subNode.name ] === undefined ) {
  1834. if ( typeof subNode.id === 'number' ) {
  1835. node[ subNode.name ] = {};
  1836. node[ subNode.name ][ subNode.id ] = subNode;
  1837. } else {
  1838. node[ subNode.name ] = subNode;
  1839. }
  1840. } else {
  1841. if ( subNode.name === 'PoseNode' ) {
  1842. if ( ! Array.isArray( node[ subNode.name ] ) ) {
  1843. node[ subNode.name ] = [ node[ subNode.name ] ];
  1844. }
  1845. node[ subNode.name ].push( subNode );
  1846. } else if ( node[ subNode.name ][ subNode.id ] === undefined ) {
  1847. node[ subNode.name ][ subNode.id ] = subNode;
  1848. }
  1849. }
  1850. },
  1851. parseProperty: function ( reader ) {
  1852. var type = reader.getString( 1 );
  1853. switch ( type ) {
  1854. case 'C':
  1855. return reader.getBoolean();
  1856. case 'D':
  1857. return reader.getFloat64();
  1858. case 'F':
  1859. return reader.getFloat32();
  1860. case 'I':
  1861. return reader.getInt32();
  1862. case 'L':
  1863. return reader.getInt64();
  1864. case 'R':
  1865. var length = reader.getUint32();
  1866. return reader.getArrayBuffer( length );
  1867. case 'S':
  1868. var length = reader.getUint32();
  1869. return reader.getString( length );
  1870. case 'Y':
  1871. return reader.getInt16();
  1872. case 'b':
  1873. case 'c':
  1874. case 'd':
  1875. case 'f':
  1876. case 'i':
  1877. case 'l':
  1878. var arrayLength = reader.getUint32();
  1879. var encoding = reader.getUint32(); // 0: non-compressed, 1: compressed
  1880. var compressedLength = reader.getUint32();
  1881. if ( encoding === 0 ) {
  1882. switch ( type ) {
  1883. case 'b':
  1884. case 'c':
  1885. return reader.getBooleanArray( arrayLength );
  1886. case 'd':
  1887. return reader.getFloat64Array( arrayLength );
  1888. case 'f':
  1889. return reader.getFloat32Array( arrayLength );
  1890. case 'i':
  1891. return reader.getInt32Array( arrayLength );
  1892. case 'l':
  1893. return reader.getInt64Array( arrayLength );
  1894. }
  1895. }
  1896. if ( window.Zlib === undefined ) {
  1897. console.error( 'THREE.FBXLoader: External library Inflate.min.js required, obtain or import from https://github.com/imaya/zlib.js' );
  1898. }
  1899. var inflate = new Zlib.Inflate( new Uint8Array( reader.getArrayBuffer( compressedLength ) ) ); // eslint-disable-line no-undef
  1900. var reader2 = new BinaryReader( inflate.decompress().buffer );
  1901. switch ( type ) {
  1902. case 'b':
  1903. case 'c':
  1904. return reader2.getBooleanArray( arrayLength );
  1905. case 'd':
  1906. return reader2.getFloat64Array( arrayLength );
  1907. case 'f':
  1908. return reader2.getFloat32Array( arrayLength );
  1909. case 'i':
  1910. return reader2.getInt32Array( arrayLength );
  1911. case 'l':
  1912. return reader2.getInt64Array( arrayLength );
  1913. }
  1914. default:
  1915. throw new Error( 'THREE.FBXLoader: Unknown property type ' + type );
  1916. }
  1917. }
  1918. } );
  1919. function BinaryReader( buffer, littleEndian ) {
  1920. this.dv = new DataView( buffer );
  1921. this.offset = 0;
  1922. this.littleEndian = ( littleEndian !== undefined ) ? littleEndian : true;
  1923. }
  1924. Object.assign( BinaryReader.prototype, {
  1925. getOffset: function () {
  1926. return this.offset;
  1927. },
  1928. size: function () {
  1929. return this.dv.buffer.byteLength;
  1930. },
  1931. skip: function ( length ) {
  1932. this.offset += length;
  1933. },
  1934. // seems like true/false representation depends on exporter.
  1935. // true: 1 or 'Y'(=0x59), false: 0 or 'T'(=0x54)
  1936. // then sees LSB.
  1937. getBoolean: function () {
  1938. return ( this.getUint8() & 1 ) === 1;
  1939. },
  1940. getBooleanArray: function ( size ) {
  1941. var a = [];
  1942. for ( var i = 0; i < size; i ++ ) {
  1943. a.push( this.getBoolean() );
  1944. }
  1945. return a;
  1946. },
  1947. getUint8: function () {
  1948. var value = this.dv.getUint8( this.offset );
  1949. this.offset += 1;
  1950. return value;
  1951. },
  1952. getInt16: function () {
  1953. var value = this.dv.getInt16( this.offset, this.littleEndian );
  1954. this.offset += 2;
  1955. return value;
  1956. },
  1957. getInt32: function () {
  1958. var value = this.dv.getInt32( this.offset, this.littleEndian );
  1959. this.offset += 4;
  1960. return value;
  1961. },
  1962. getInt32Array: function ( size ) {
  1963. var a = [];
  1964. for ( var i = 0; i < size; i ++ ) {
  1965. a.push( this.getInt32() );
  1966. }
  1967. return a;
  1968. },
  1969. getUint32: function () {
  1970. var value = this.dv.getUint32( this.offset, this.littleEndian );
  1971. this.offset += 4;
  1972. return value;
  1973. },
  1974. // JavaScript doesn't support 64-bit integer so calculate this here
  1975. // 1 << 32 will return 1 so using multiply operation instead here.
  1976. // There's a possibility that this method returns wrong value if the value
  1977. // is out of the range between Number.MAX_SAFE_INTEGER and Number.MIN_SAFE_INTEGER.
  1978. // TODO: safely handle 64-bit integer
  1979. getInt64: function () {
  1980. var low, high;
  1981. if ( this.littleEndian ) {
  1982. low = this.getUint32();
  1983. high = this.getUint32();
  1984. } else {
  1985. high = this.getUint32();
  1986. low = this.getUint32();
  1987. }
  1988. // calculate negative value
  1989. if ( high & 0x80000000 ) {
  1990. high = ~ high & 0xFFFFFFFF;
  1991. low = ~ low & 0xFFFFFFFF;
  1992. if ( low === 0xFFFFFFFF ) high = ( high + 1 ) & 0xFFFFFFFF;
  1993. low = ( low + 1 ) & 0xFFFFFFFF;
  1994. return - ( high * 0x100000000 + low );
  1995. }
  1996. return high * 0x100000000 + low;
  1997. },
  1998. getInt64Array: function ( size ) {
  1999. var a = [];
  2000. for ( var i = 0; i < size; i ++ ) {
  2001. a.push( this.getInt64() );
  2002. }
  2003. return a;
  2004. },
  2005. // Note: see getInt64() comment
  2006. getUint64: function () {
  2007. var low, high;
  2008. if ( this.littleEndian ) {
  2009. low = this.getUint32();
  2010. high = this.getUint32();
  2011. } else {
  2012. high = this.getUint32();
  2013. low = this.getUint32();
  2014. }
  2015. return high * 0x100000000 + low;
  2016. },
  2017. getFloat32: function () {
  2018. var value = this.dv.getFloat32( this.offset, this.littleEndian );
  2019. this.offset += 4;
  2020. return value;
  2021. },
  2022. getFloat32Array: function ( size ) {
  2023. var a = [];
  2024. for ( var i = 0; i < size; i ++ ) {
  2025. a.push( this.getFloat32() );
  2026. }
  2027. return a;
  2028. },
  2029. getFloat64: function () {
  2030. var value = this.dv.getFloat64( this.offset, this.littleEndian );
  2031. this.offset += 8;
  2032. return value;
  2033. },
  2034. getFloat64Array: function ( size ) {
  2035. var a = [];
  2036. for ( var i = 0; i < size; i ++ ) {
  2037. a.push( this.getFloat64() );
  2038. }
  2039. return a;
  2040. },
  2041. getArrayBuffer: function ( size ) {
  2042. var value = this.dv.buffer.slice( this.offset, this.offset + size );
  2043. this.offset += size;
  2044. return value;
  2045. },
  2046. getString: function ( size ) {
  2047. var a = new Uint8Array( size );
  2048. for ( var i = 0; i < size; i ++ ) {
  2049. a[ i ] = this.getUint8();
  2050. }
  2051. var nullByte = a.indexOf( 0 );
  2052. if ( nullByte >= 0 ) a = a.slice( 0, nullByte );
  2053. return THREE.LoaderUtils.decodeText( a );
  2054. }
  2055. } );
  2056. // FBXTree holds a representation of the FBX data, returned by the TextParser ( FBX ASCII format)
  2057. // and BinaryParser( FBX Binary format)
  2058. function FBXTree() {}
  2059. Object.assign( FBXTree.prototype, {
  2060. add: function ( key, val ) {
  2061. this[ key ] = val;
  2062. },
  2063. } );
  2064. function isFbxFormatBinary( buffer ) {
  2065. var CORRECT = 'Kaydara FBX Binary \0';
  2066. return buffer.byteLength >= CORRECT.length && CORRECT === convertArrayBufferToString( buffer, 0, CORRECT.length );
  2067. }
  2068. function isFbxFormatASCII( text ) {
  2069. var CORRECT = [ 'K', 'a', 'y', 'd', 'a', 'r', 'a', '\\', 'F', 'B', 'X', '\\', 'B', 'i', 'n', 'a', 'r', 'y', '\\', '\\' ];
  2070. var cursor = 0;
  2071. function read( offset ) {
  2072. var result = text[ offset - 1 ];
  2073. text = text.slice( cursor + offset );
  2074. cursor ++;
  2075. return result;
  2076. }
  2077. for ( var i = 0; i < CORRECT.length; ++ i ) {
  2078. var num = read( 1 );
  2079. if ( num === CORRECT[ i ] ) {
  2080. return false;
  2081. }
  2082. }
  2083. return true;
  2084. }
  2085. function getFbxVersion( text ) {
  2086. var versionRegExp = /FBXVersion: (\d+)/;
  2087. var match = text.match( versionRegExp );
  2088. if ( match ) {
  2089. var version = parseInt( match[ 1 ] );
  2090. return version;
  2091. }
  2092. throw new Error( 'THREE.FBXLoader: Cannot find the version number for the file given.' );
  2093. }
  2094. // Converts FBX ticks into real time seconds.
  2095. function convertFBXTimeToSeconds( time ) {
  2096. return time / 46186158000;
  2097. }
  2098. // Parses comma separated list of numbers and returns them an array.
  2099. // Used internally by the TextParser
  2100. function parseNumberArray( value ) {
  2101. var array = value.split( ',' ).map( function ( val ) {
  2102. return parseFloat( val );
  2103. } );
  2104. return array;
  2105. }
  2106. function convertArrayBufferToString( buffer, from, to ) {
  2107. if ( from === undefined ) from = 0;
  2108. if ( to === undefined ) to = buffer.byteLength;
  2109. return THREE.LoaderUtils.decodeText( new Uint8Array( buffer, from, to ) );
  2110. }
  2111. function append( a, b ) {
  2112. for ( var i = 0, j = a.length, l = b.length; i < l; i ++, j ++ ) {
  2113. a[ j ] = b[ i ];
  2114. }
  2115. }
  2116. function slice( a, b, from, to ) {
  2117. for ( var i = from, j = 0; i < to; i ++, j ++ ) {
  2118. a[ j ] = b[ i ];
  2119. }
  2120. return a;
  2121. }
  2122. } )();