@cocos/fbx2gltf-node
v1.0.0-alpha.0
Published
This is a FBX to glTF file format converter that works in Node.js environment.
Downloads
2
Keywords
Readme
FBX to glTF File Format Converter(Node.js)
This is a FBX to glTF file format converter that works in Node.js environment.
Why
This tool is essentially used as a part of the Cocos Creator. In former, Cocos Creator supports FBX file format through the excellent FBX2glTF.
But Cocos team has to find another approach because:
- FBX2glTF store the glTF result files onto disk and Creator read the files. This is the only way that Creator can communicate with FBX2glTF. File system I/O is slow.
- Author of FBX2glTF is tired.
- FBX is complex and all exporters working for it are buggy. We usually need to fix strange issues. However FBX2glTF is written in C++. It really bothers since once we need to fix BUGs. we need to build executable for different platforms.
- Cocos expects to export more useful information which is FBX domain specific.
Usage
This project heavily depends on FBX SDK Node.js bindings. May you should pay attention to that.
Because the fbxsdk-node
is platform-specific, this project allow you to customize how the fbxsdk-node
can be found by this project.
There are several ways:
For local development. Run
'./LinkFbxSdk.ps1'
to link thefbxsdk-node
built to./fbxsdk-node
.Invoke the Node.js module
./get-fbxsdk.js
'sset(sdk)
to manually set thefbxsdk-node
. You should do this before you can importfbx2gltf-node
module.Set the
fbxsdk-node
module's path into environment variableFBXSDK_NODE_MODULE
. You should do this before you can importfbx2gltf-node
module.
Local development
- Grab the FBX SDK Node.js bindings and build.
- Run
'./LinkFbxSdk.ps1'
to link the above built to./fbxsdk-node
- Just run.
Thanks
Again, the FBX is complex and specification-less. In development, we often reference from or are inspired from the following predecessors: