Scene Importer & Exporter

The Simplygon API provides classes for loading and saving various scene file formats. Currently the supported format are

• Simplygon (.sg)
• OBJ (.obj)
• FBX (.fbx)
• glTF (.gltf, .glb)

Importing

Importing scene data is done by the ISceneImporter class. The file information is then stored in an IScene, where both the geometries, materials and textures of the imported file can be found.

void LoadScene( const char* readFrom )
{
    spSceneImporter importer = sg->CreateSceneImporter();
    spScene scene;

    // Set the path of the file to load
    importer->SetImportFilePath( readFrom );
    if( importer->RunImport() )
    {
        scene = importer->GetScene();
    }
    // do stuff with scene
}

void LoadScene( string readFrom )
{
    spSceneImporter importer = sg.CreateSceneImporter();
    spScene scene;

    // Set the path of the file to load
    importer.SetImportFilePath( readFrom );
    if( importer.RunImport() )
    {   
        scene = importer.GetScene();
    }
    // do stuff with scene
}

def LoadScene( readFrom ):
    importer = sg.CreateSceneImporter()
    scene = None
	
	# Set the path of the file to load
    importer.SetImportFilePath( readFrom )
    if importer.RunImport():
        scene = importer.GetScene()
    # do stuff with scene

Exporting

Exporting scene data is done by the ISceneExporter class. The file format is determined by the file name extension.

If the file name does not contain a known supported file extension (see list above) it will output the internal Simplygon binary scene dump format (same as if you export a file with .sg extension), which can then be read by the scene importer. This is useful for integrating the batch tool into your data pipeline or when requesting support, as it contains an exact representation of the Simplygon scene data.

void SaveScene( const char* fileName, spScene scene )
{
    spSceneExporter exporter = sg->CreateSceneExporter();
    exporter->SetScene( scene );
    exporter->SetExportFilePath( fileName );
    
    // For file formats that only supports a limited set of texture coordinate layers,
    // set the name of the primary layer to export
    exporter->SetPrimaryTexCoordName( "tex0" );

    // Some file formats that support embedding texture and other data in the main scene
    // file, this flag controls if such data will be embedded or written to separate files
    exporter->SetEmbedReferences( true );

    exporter->RunExport();
}

void SaveScene( string fileName, spScene scene )
{
    spSceneExporter exporter = sg.CreateSceneExporter();
    exporter.SetScene( scene );
    exporter.SetExportFilePath( fileName );
    
    // For file formats that only supports a limited set of texture coordinate layers,
    // set the name of the primary layer to export
    exporter.SetPrimaryTexCoordName( "tex0" );

    // Some file formats that support embedding texture and other data in the main scene
    // file, this flag controls if such data will be embedded or written to separate files
    exporter.SetEmbedReferences( true );

    exporter.RunExport();
}

def SaveScene( fileName, scene ):
{
    exporter = sg.CreateSceneExporter()
    exporter.SetScene( scene )
    exporter.SetExportFilePath( fileName )
    
    # For file formats that only supports a limited set of texture coordinate layers,
    # set the name of the primary layer to export
    exporter.SetPrimaryTexCoordName( "tex0" )

    # Some file formats that support embedding texture and other data in the main scene
    # file, this flag controls if such data will be embedded or written to separate files
    exporter.SetEmbedReferences( True )

    exporter.RunExport()
}

Limitations

Currently there are a number of limitations to features supported in the various file formats

FBX

• Bone data and skinned meshes are not supported
• Selection sets are not supported
• There is limited support for blend modes and custom materials/shaders
• Due to limitations in the FBX SDK, all importer & exporter calls will be limited to one concurrent thread

glTF

• Bone data and skinned meshes are not supported