Importing and Exporting Data using FBX

An Import Example

Importing a scene using the FBX importer is extremely simple. The example below illustrates this:

// Temporarily disable undos.
UT_UndoManager::disableUndoCreation();

// Tell the importer to import the file into a new scene
bool do_merge = false;
// Use default settings to import the file.
FBX_ImportOptions import_options;
// Use default types filter for the import.
FBX_ObjectTypeFilter type_filter;

// Create and run the importer
FBX_Translator fbx_translator;
bool did_succeed = fbx_translator.importScene("test.fbx", do_merge, &import_options, &type_filter);

// Re-enable undos.
UT_UndoManager::enableUndoCreation();

See FBX_ImportOptions and FBX_ObjectTypeFilter for documentation on setting various import options and importing only specific types of primitives such as lights or animation from FBX files.

Any errors or warnings produced by the importer can be retrieved as following:

// See if we have any errors
if (fbx_translator.getErrorManager()->getNumItems() > 0)
{
    UI_ErrorType     severity;
    UT_String        msg(UT_String::ALWAYS_DEEP);

    // See whether we have any critical errors or whether
    // all we've got are warnings:
    if (fbx_translator.getErrorManager()->getDidReportCriticalErrors())
        severity = UI_ERROR;
    else
        severity = UI_WARNING;

    fbx_translator.getErrorManager()->appendAllErrors(msg);
    fbx_translator.getErrorManager()->appendAllWarnings(msg);

    // Open a dialog with warnings/errors
    SIopenMessageDialog(msg, severity);
}

An Export Example

An example below illustrates the export of the current scene to an FBX file. Note that FBX is capable of containing entire scenes, including cameras, animation, lights, and skinning, instead of supporting only the geometry.

// Temporarily disable undos.
UT_UndoManager::disableUndoCreation();

// Create the wrapper and the options objects
ROP_FBXExporterWrapper fbx_exporter;
ROP_FBXExportOptions export_options;

// Initialize the exporter first
did_succeed = fbx_exporter.initializeExport("test_out.fbx", start_time, end_time, &export_options);
if(!did_succeed)
    fbx_exporter.getErrorManager()->addError("Could not initialize FBX exporter", true);
else
{
    // If everything is all right, perform the actual export.
    fbx_exporter.doExport();
    
    // Cleanup and check for errors
    did_succeed = fbx_exporter.finishExport();
    if(!did_succeed)
        fbx_exporter.getErrorManager()->addError("Could not finalize FBX export", true);
}

// Re-enable undos.
UT_UndoManager::enableUndoCreation();

See ROP_FBXExportOptions for more information on possible export options.