Importing and Exporting FBX Files

The XSI FBX plug-in allows you to import, export, and merge-back scene data using the FBX (*.fbx) file format.

 

The XSI FBX plug-in included in the Crosswalk v2.0 toolset is a direct port of the XSI FBX 5.11 plug-in.

Importing FBX

1. In XSI, choose File > Crosswalk > Import FBX.

2. The Import FBX File dialog box opens:

- Select Autodesk (*.fbx) as the file type.

- Use the file browser to locate the FBX file you want to import.

- Select the name of the FBX file.

- Click Ok.

3. Set the FBX Importer Options:

- Set the appropriate import method from the Load Options area.

- Select the options that apply to your scene from the Import Options, Animation Options, and Special Options areas.

For more information about what scene elements are supported, see Supported Scene Elements and Attributes for FBX.

4. Click Ok.

FBX Importer Options

| Load Options | Scene Scaling | Import Options | Animation Options | Special Options

When you select an FBX file to import into XSI, the FBX Importer window opens where you can set the FBX import options. Note that geometry is always imported.

Load Options

Exclusive merge

Merges only the animation from the FBX file with the corresponding XSI elements.

Any modifications to geometry, textures, materials or envelope weighting in MotionBuilder is not included in the Exclusive merge process.

Add to new scene

Clears the XSI workspace before importing all data from the FBX file.

The objects created include all applicable textures, materials, animation, and envelope weighting.

Merge

Uses a combination of the Exclusive merge and Add to new scene. When enabled, the animation is merged with the elements that are already present in the XSI scene, and creates any other objects that are defined in the FBX file.

Scene Scaling

Factor

Shows the scale factor of the default XSI unit, which the plug-in will interpret as one centimeter (1 cm).

Import Options

Cameras

When disabled, the scene is imported without its cameras.

Lights

When disabled, the scene is imported without its lights.

Animation Options

Import animation

Activates the Import Animation option, and lets you select a take from the Take menu to import all the animation in the specified take.

Take

Use the Take menu to select the take that you want to import. [Default is No Animation]

Resample

Activate the Resample option to enter a new resampling rate for the animation. Resample is only used when the FBX importer has to resample FCurves.

Rate

Shows the resampling rate. This normally is the same as the scene’s frame rate.

Special Options

Protect expression-driven animation curves

Keeps any expression-driven animation when merging back your scene.

Import skeleton elements as nulls

Converts all effectors and bones to nulls. See Skeleton Conversions for more details.

Weighting on envelopes is not affected by this conversion.

Keep XSI effectors

Keeps all effectors as you created them.

The import process keeps the effectors under the root node of its respective chain. This import option setting must match the export option setting. See Skeleton Conversions for more details.

Set envelopes

Imports envelopes for skinning.

Force normalization of envelope weights

Correct any corrupted envelopes caused by a 3D software that does not support normalized weighting systems.

This feature performs only a limited amount of correction and is not normally necessary.

Show the Warnings and Errors dialog box

Enables or disables the Warnings and Errors dialog box that may appear during the import/export process. [Default is Enabled]

Reset/Ok/Cancel

Reset

Restores the options in the FBX importer window to their last saved values.

Ok

Starts the import process.

Cancel

Aborts the import process.

Exporting FBX

1. Create/Open a scene in XSI.

2. Choose File > Crosswalk > Export FBX.

3. The Export FBX File dialog box opens:

- Select Autodesk (*.fbx) as the file type.

- Use the file browser to locate where you want to export your FBX file.

- Type the name of the .fbx file in the File Name text box.

- Click Ok.

4. Set the FBX Exporter Options.

For more information about what scene elements are supported, see Supported Scene Elements and Attributes for FBX.

5. Click Ok.

FBX Exporter Options

| Scene Scaling | Export Options | Animation Options | Special Options

When you select an FBX file to export from XSI, the FBX Exporter window opens where you can set the FBX export options.

The options in the FBX Exporter window are saved when you exit the XSI application, with the exception of the Sampling rate (see the Resample option), which is read from the scene.

Scene Scaling

Factor

Shows the scale factor for the default XSI unit, which the plug-in interprets as one centimeter (1 cm).

Export Options

Geometry

Exports the scene’s geometry. If you disable the Geometry option, the scene is exported with no models.

Note that cameras and lights are not considered models by the FBX exporter.

Shapes

Exports the scene’s shapes.

Skins

Exports the scene’s envelopes.

When disabled the scene is exported without envelopes. The geometry is still exported but does not have any weighting assigned to it.

Cameras

Exports the scene’s cameras.

Lights

Exports the scene’s lights.

Embed Textures

Embeds the textures and images associated with the FBX file when exporting.

Embedding textures is useful when transferring the FBX file to a location where the texture path is inaccessible.

Note that embedding textures increases the file’s size.

Convert to Portable Format (TIFF)

Saves the embedded texture images to the TIFF format so that can be read on different platforms and by most applications.

Export to ASCII Format

Saves the FBX file in ASCII format.

Animation Options

Export Animation

Exports all the scene’s animation.

Resample

Activate Resample to enter a new resampling rate for the animation. Resample is used when the FBX exporter needs to perform FCurve resampling.

Rate

Shows the resampling rate. This normally is the same as the scene’s Frame rate.

Special Options

Keep XSI effectors

Exports the skeleton and its effectors as they were defined in XSI. See Skeleton Conversions for more details.

When this option is enabled, the effectors are not transferred under the last bone of their chain. If you keep XSI effectors you cannot characterize your skeleton in MotionBuilder, although keyframing is still available.

When this option is disabled, the effectors are moved so that their parent becomes the last bone of their chain. This is required for characterizing in MotionBuilder.

When using XSI’s Animation Mixer to animate your character, make sure that the animation is plotted and that there are no clips in the Animation Mixer or the file may not export correctly. Save your file before deleting your clips.

Show the Warnings and Errors dialog box

Lets you enable or disable any warning or error dialog boxes that may appear during the export process. [Default is Enabled]

Reset/Ok/Cancel

Reset

Restores the options in the FBX exporter window to their last saved values.

Ok

Starts the export process.

Cancel

Aborts the export process.

Batch Processing Commands

The FBX import and export dialog box options are not available from the command line but, since they are stored, you can get and set them using their equivalent batch processing commands. You can use these commands to run batch scripts in one of the four compatible scripting languages (VBScript, JScript, PerlScript, and Python ActiveX).

Command

Description

FBXExport

Exports an FBX file. See Exporting FBX.

FBXExportScaleFactor

See Scene Scaling.

FBXExportGeometries

See Geometry.

FBXExportShapes

See Shapes.

FBXExportSkins

See Skins.

FBXExportCameras

See Cameras.

FBXExportLights

See Lights.

FBXExportEmbedMedias

See Embed Textures.

FBXExportConvert2Tif

See Convert to Portable Format (TIFF).

FBXExportAnimation

See Export Animation.

FBXExportFrameRate

See Rate.

FBXExportKeepXSIEffectors

See Keep XSI effectors.

FBXImport

Imports an FBX file. See Importing FBX and Take.

FBXImportMode

See Load Options.

FBXImportScaleFactor

See Scene Scaling.

FBXImportCameras

See Cameras.

FBXImportLights

See Lights.

FBXImportAnimation

See Import animation.

FBXImportProtectExprDriven

See Protect expression-driven animation curves.

FBXImportSkeletonAsNulls

See Import skeleton elements as nulls.

FBXImportKeepXSIEffectors

See Keep XSI effectors.

FBXImportSetEnvelopes

See Set envelopes.

FBXImportForceNormEnvelope

See Force normalization of envelope weights.

FBXImportNamespaceReplacement

Sets the namespace string to be replaced during import.

 



Softimage|Crosswalk v3.11