FBX

Reference

Category:Import-Export
Menu:File ‣ Import/Export ‣ FBX (.fbx)

Usage

This format is mainly use for interchanging character animations between applications and is supported by applications such as Cinema4D, Maya, Autodesk 3ds Max, Wings3D and engines such as Unity3D, Unreal Engine 3/UDK and Unreal Engine 4.

The exporter can bake mesh modifiers and animation into the FBX so the final result looks the same as in Blender.

Note

  • Bones would need to get a correction to their orientation (FBX bones seems to be -X aligned, Blender's are Y aligned), this does not affect skinning or animation, but imported bones in other applications will look wrong.
  • Animations (FBX AnimStacks, Blender actions) are not linked to their object, because there is no real way to know which stack to use as 'active' action for a given object, mesh or bone. This may be enhanced to be smarter in the future, but it's not really considered urgent, so for now you'll have to link actions to objects manually.
  • Armature instances are not supported.

Note

  • Bones' orientation importing is complex, you may have to play a bit with related settings until you get the expected results.
  • Animation support is minimal currently, we read all curves as if they were 'baked' ones (i.e. a set of close keyframes with linear interpolation).
  • Imported actions are linked to their related object, bone or shape key, on a 'first one wins' basis. If you export a set of them for a single object you'll have to reassign them yourself.

Note

Saving Just Animations

The FBX file format supports files that only contain takes. It is up to you to keep track of which animation belongs to which model. The animation that will be exported is the currently selected action within the Action editor. To reduce the file size, turn off the exporting of any parts you do not want and disable All Actions. For armature animations typically you just leave the armature enabled which is necessary for that type of animation. Reducing what is output makes the export and future import much faster. Normally each action will have its own name but the current or only take can be forced to be named "Default Take". Typically, this option can remain off.

Note

Blender now only supports complex node-based shading. FBX having a fixed pipeline-like support of materials, this add-on uses the generic wrapper featured by Blender to convert between both.

Properties

Import

Main

Manual Orientation
TODO.
Forward / Up Axis

Since many applications use a different axis for 'Up', these are axis conversion for these settings, Forward and Up axes -- By mapping these to different axes you can convert rotations between applications default up and forward axes.

Blender uses Y Forward, Z Up (since the front view looks along the +Y direction). For example, its common for applications to use Y as the up axis, in that case -Z Forward, Y Up is needed.

Apply Transform
TODO.
Import Normals
TODO.
Import Animation

TODO.

Animation Offset
TODO.
Import User Properties
TODO.
Import Enums As Strings
TODO.
Image Search
TODO.
Decal Offset
TODO.
Use Pre/Post Rotation
TODO.

Armatures

Ignore Leaf Bones
TODO.
Force Connect Children
TODO.
Automatic Bone Orientation
TODO.
Primary/Secondary Bone Axis
TODO.

Export

Main

Selected Objects
Only export the selected objects. Otherwise export all objects in the scene. Note, this does not apply when batch exporting.
Scale
Scale the exported data by this value. 10 is the default because this fits best with the scale most applications import FBX to.
Apply Scale
TODO.
Apply Scalings
TODO.
Forward / Up Axis

Since many applications use a different axis for 'Up', these are axis conversions for Forward and Up axes -- By mapping these to different axes you can convert rotations between applications default up and forward axes.

Blender uses Y Forward, Z Up (since the front view looks along the +Y direction). For example, its common for applications to use Y as the up axis, in that case -Z Forward, Y Up is needed.

Empty/Camera/Light/Armature/Mesh/Other
Enable/Disable exporting of respective object types.
Apply Transform
TODO.
Custom Properties
TODO.
Path Mode

When referencing paths in exported files you may want some control as to the method used since absolute paths may only be correct on your own system. Relative paths, on the other hand, are more portable but mean that you have to keep your files grouped when moving about on your local file system. In some cases, the path doesn't matter since the target application will search a set of predefined paths anyway so you have the option to strip the path too.

Auto:Uses relative paths for files which are in a subdirectory of the exported location, absolute for any directories outside that.
Absolute:Uses full paths.
Relative:Uses relative paths in every case (except when on a different drive on windows).
Match:Uses relative / absolute paths based on the paths used in Blender.
Strip Path:Only write the filename and omit the path component.
Copy:Copy the file on exporting and reference it with a relative path.
Embed Textures
TODO.
Batch Mode

When enabled, export each group or scene to a file.

Group/Scene
Choose whether to batch export groups or scenes to files. Note, when Group/Scene is enabled, you cannot use the animation option Current Action since it uses scene data and groups are not attached to any scenes. Also note, when Group/Scene is enabled you must include the armature objects in the group for animated actions to work.
Own Dir
When enabled, each file is exported into its own directory, this is useful when using the Copy Images option. So each directory contains one model with all the images it uses. Note, this requires a full Python installation. If you do not have a full Python installation, this button will not be shown.

Geometries

Apply Modifiers
When enabled, the mesh will be from the output of the modifiers applied to the mesh.
Use Modifiers Render Setting
TODO.
Smoothing
TODO.
Loose Edges
TODO.
Tangent Space
TODO.

Armatures

Only Deform Bones
TODO.
Add Leaf Bones
TODO.
Primary/Secondary Bone Axis
TODO.
Armature FBXNode Type
TODO.

Animation

Baked Animation
TODO.
Key All Bones
TODO.
NLA Strips
TODO.
All Actions
Export all actions compatible with the selected armatures start/end times which are derived from the keyframe range of each action. When disabled only the currently assigned action is exported.
Force Start/End Keying
TODO.
Sampling Rate
TODO.
Simplify
TODO.

Compatibility

Import

Note that the importer is a new addition and lacks many features the exporter supports.

  • binary FBX files only.
  • Version 7.1 or newer.

Missing

  • Mesh: shape keys.

Export

NURBS surfaces, text3D and metaballs are converted to meshes at export time.

Missing

Some of the following features are missing because they are not supported by the FBX format, others may be added later.

  • Object instancing -- exported objects do not share data, instanced objects will each be written with their own data.
  • Material textures
  • Vertex shape keys -- FBX supports them but this exporter does not write them yet.
  • Animated fluid simulation -- FBX does not support this kind of animation. You can however use the OBJ exporter to write a sequence of files.
  • Constraints -- The result of using constraints is exported as a keyframe animation however the constraints themselves are not saved in the FBX.
  • Instanced objects -- At the moment instanced objects are only written in static scenes (when animation is disabled).