FBXLoader.js 80 KB

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