89 lines
3.0 KiB
Markdown
89 lines
3.0 KiB
Markdown
# Developer’s Guide
|
||
|
||
As a developer you have access to the FBX Exporter from C# scripting. You can use the basic API by providing a single GameObject or a list of GameObjects. Note that default export settings are used for exporting the GameObjects to the FBX file.
|
||
|
||
You can call the FBX Exporter from C# using methods found in the [UnityEditor.Formats.Fbx.Exporter](../api/UnityEditor.Formats.Fbx.Exporter.html) namespace, for example:
|
||
|
||
```
|
||
using System.IO;
|
||
using UnityEngine;
|
||
using UnityEditor;
|
||
using UnityEditor.Formats.Fbx.Exporter;
|
||
|
||
public static void ExportGameObjects(Object[] objects)
|
||
{
|
||
string filePath = Path.Combine(Application.dataPath, "MyGame.fbx");
|
||
ModelExporter.ExportObjects(filePath, objects);
|
||
|
||
// ModelExporter.ExportObject can be used instead of
|
||
// ModelExporter.ExportObjects to export a single game object
|
||
}
|
||
```
|
||
|
||
## Runtime
|
||
|
||
The FBX SDK bindings can be executed during gameplay allowing import and export at runtime. Currently a custom importer/exporter needs to be written in order to do so, as the FBX Exporter is Editor only.
|
||
|
||
> **NOTE:** The FBX SDK bindings are Editor only by default and will not be included in a build. In order for the package to be included in the build, add the FBXSDK_RUNTIME define to Edit > Project Settings... > Player > Other Settings > Scripting Define Symbols.
|
||
|
||
### Basic Exporter:
|
||
|
||
```
|
||
using Autodesk.Fbx;
|
||
using UnityEngine;
|
||
using UnityEditor;
|
||
|
||
protected void ExportScene (string fileName)
|
||
{
|
||
using(FbxManager fbxManager = FbxManager.Create ()){
|
||
// configure IO settings.
|
||
fbxManager.SetIOSettings (FbxIOSettings.Create (fbxManager, Globals.IOSROOT));
|
||
|
||
// Export the scene
|
||
using (FbxExporter exporter = FbxExporter.Create (fbxManager, "myExporter")) {
|
||
|
||
// Initialize the exporter.
|
||
bool status = exporter.Initialize (fileName, -1, fbxManager.GetIOSettings ());
|
||
|
||
// Create a new scene to export
|
||
FbxScene scene = FbxScene.Create (fbxManager, "myScene");
|
||
|
||
// Export the scene to the file.
|
||
exporter.Export (scene);
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### Basic Importer:
|
||
|
||
```
|
||
using Autodesk.Fbx;
|
||
using UnityEngine;
|
||
using UnityEditor;
|
||
|
||
protected void ImportScene (string fileName)
|
||
{
|
||
using(FbxManager fbxManager = FbxManager.Create ()){
|
||
// configure IO settings.
|
||
fbxManager.SetIOSettings (FbxIOSettings.Create (fbxManager, Globals.IOSROOT));
|
||
|
||
// Import the scene to make sure file is valid
|
||
using (FbxImporter importer = FbxImporter.Create (fbxManager, "myImporter")) {
|
||
|
||
// Initialize the importer.
|
||
bool status = importer.Initialize (fileName, -1, fbxManager.GetIOSettings ());
|
||
|
||
// Create a new scene so it can be populated by the imported file.
|
||
FbxScene scene = FbxScene.Create (fbxManager, "myScene");
|
||
|
||
// Import the contents of the file into the scene.
|
||
importer.Import (scene);
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### Limitations
|
||
|
||
* Only 64 bit Windows, MacOS and Ubuntu standalone player builds are supported |