User Tools
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
cppdev:fbxsdk [2011-01-29 12:27] carsten contents improved / finished |
cppdev:fbxsdk [2017-02-18 22:32] (current) Carsten we use version 2017.1 now |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Using the Autodesk FBX SDK ====== | ====== Using the Autodesk FBX SDK ====== | ||
| - | {{ http://images.autodesk.com/adsk/images/fbx_2011_badge_150x265.jpg}} | + | {{ http://images.autodesk.com/adsk/images/autodesk_fbx_badge_150x265.jpg}} |
| - | When you build Cafu from source, support for several file formats is provided by Cafu's own or included source code so that the Model Editor can import static and animated models in the most important file formats. | + | When you build Cafu from source, support for several file formats is provided by Cafu's own source code so that the Model Editor can import static and animated models in the most important file formats. |
| Optionally, it is possible to have the build scripts account for and use the Autodesk FBX SDK in order enable the Model Editor to import model files in these additional file formats as well: | Optionally, it is possible to have the build scripts account for and use the Autodesk FBX SDK in order enable the Model Editor to import model files in these additional file formats as well: | ||
| - | - Autodesk FBX (''.fbx''), version 6.0, 6.1, 7.0, 7.1 | + | |
| - | - Autodesk AutoCAD DXF (''.dxf''), version 13 and earlier | + | * Autodesk FBX (''.fbx''), version 6.0 to 7.2 |
| - | - Collada DAE (''.dae''), version 1.5 and earlier | + | * Autodesk AutoCAD DXF (''.dxf''), version 13 and earlier |
| - | - 3D Studio 3DS (''.3ds''), all versions | + | * Collada DAE (''.dae''), version 1.5 and earlier |
| - | - Alias OBJ (''.obj''), all versions | + | * 3D Studio 3DS (''.3ds''), all versions |
| + | * Alias OBJ (''.obj''), all versions | ||
| The FBX SDK is a separate download from Autodesk that we cannot distribute together with Cafu: The combined file size for all platforms is //massive//, Autodesk prefers that software vendors don't redistribute their SDK and in fact requires prior written permission, and we're happy to maintain a certain degree of independence, for example when we want to use Cafu with compilers or on platforms where the FBX SDK is not available. | The FBX SDK is a separate download from Autodesk that we cannot distribute together with Cafu: The combined file size for all platforms is //massive//, Autodesk prefers that software vendors don't redistribute their SDK and in fact requires prior written permission, and we're happy to maintain a certain degree of independence, for example when we want to use Cafu with compilers or on platforms where the FBX SDK is not available. | ||
| - | Therefore, we made the use of the Autodesk FBX SDK very easy, but entirely optional. If you don't use it, all that you're missing is that the Model Editor cannot load the ''FBX'' file format. (When we make official binary releases of Cafu, we always ship with FBX support enabled.) | + | Therefore, we made the use of the Autodesk FBX SDK very easy, but entirely optional. If you don't use it, all that you're missing is that the Model Editor cannot load the above mentioned file formats. (When we make official binary releases of Cafu, we always ship with FBX support enabled.) |
| Follow these steps in order to activate support for FBX: | Follow these steps in order to activate support for FBX: | ||
| - Download the Autodesk FBX SDK from http://www.autodesk.com/fbx | - Download the Autodesk FBX SDK from http://www.autodesk.com/fbx | ||
| - | * The download requires one-time registration, but it's free. | + | * The download requires a one-time registration, but it's free. |
| - | * You just need the FBX SDK, not the FBX Extensions SDK. | + | * You just need the FBX SDK, //not// the FBX Extensions SDK. |
| - | * At this time, we use version 2011.3.1 of the FBX SDK, but any later version should work as well. | + | * At this time, we use version 2017.1 of the FBX SDK, but any later version should work as well. |
| - | * Important: For each operating system, two editions of the FBX SDK are available: one with dynamic libraries and one with static libraries. Pick the download that your operating system with //static// libraries. (We use static libraries for Cafu because it makes application deployment easier.) | + | |
| - Run the installer to extract the SDK contents into a convenient location. Their installer is exceptionally nice, it neither modifies the Start Menu nor the Windows Registry, but just extracts the files into a directory. | - Run the installer to extract the SDK contents into a convenient location. Their installer is exceptionally nice, it neither modifies the Start Menu nor the Windows Registry, but just extracts the files into a directory. | ||
| - | * Assuming that your top level Cafu source code directory is ''Cafu/'', you can directly install the FBX SDK into ''Cafu/ExtLibs/fbx/''. \\ Make sure that the installer doesn't automatically append another directory for the SDK version, and if it asks if you would like to keep a copy of the old FBX installation, answer "No" (otherwise it first renames ''Cafu/ExtLibs/fbx/'' to ''Cafu/ExtLibs/fbx.old/'', creating an (easily fixed) problem if you use Subversion). | + | * Assuming that your top level Cafu source code directory is ''Cafu/'', you can directly install the FBX SDK into ''Cafu/ExtLibs/fbx/''. \\ Make sure that the installer doesn't automatically append another directory for the SDK version, and if it asks if you would like to keep a copy of the old FBX installation, answer "No" (otherwise it first renames ''Cafu/ExtLibs/fbx/'' to ''Cafu/ExtLibs/fbx.old/'', creating an (easily fixed) problem if you use Git). |
| * Alternatively, just install the FBX SDK into a convenient location first (e.g. into a temporary directory or the default directory suggested by the installer), then copy or move the contents into ''Cafu/ExtLibs/fbx/''. \\ (Under Linux, we recommend to //not// install into the suggested ''/usr'' directory. Better install into a temporary directory in your home folder, no root privileges required.) | * Alternatively, just install the FBX SDK into a convenient location first (e.g. into a temporary directory or the default directory suggested by the installer), then copy or move the contents into ''Cafu/ExtLibs/fbx/''. \\ (Under Linux, we recommend to //not// install into the suggested ''/usr'' directory. Better install into a temporary directory in your home folder, no root privileges required.) | ||
| - | - As a result from the previous step, make sure that you now have directories ''doc'', ''examples'', ''include'' and ''lib'' (and possibly others) immediately below ''Cafu/ExtLibs/fbx/''. | + | - As a result from the previous step, make sure that you now have directories ''examples'', ''include'' and ''lib'' (and possibly others) immediately below ''Cafu/ExtLibs/fbx/''. |
| - (Re-)Run SCons as described at [[cppdev:gettingstarted]] in order to automatically recompile with FBX support enabled. | - (Re-)Run SCons as described at [[cppdev:gettingstarted]] in order to automatically recompile with FBX support enabled. | ||
cppdev/fbxsdk.1296300427.txt.gz · Last modified: 2013-01-07 12:07 (external edit)