- Main Page
- Classes
- Files
- Directories

- File List
- File Members

Classes | Defines | Enumerations | Functions

# fbxio.h File Reference

`#include <fbxsdk/fbxsdk_def.h>`
`#include <fbxsdk/core/base/fbxstring.h>`
`#include <fbxsdk/core/base/fbxtime.h>`
`#include <fbxsdk/core/base/fbxstatus.h>`
`#include <fbxsdk/fbxsdk_nsbegin.h>`
`#include <fbxsdk/fbxsdk_nsend.h>`

Go to the source code of this file.

## Classes
class | FbxIODefaultRenderResolution
| Render and resolution information. More...
class | FbxIOFileHeaderInfo
| FBX header information used at beginning of the FBX file to get or set important values like the file format version number (mFileVersion). More...
class | FbxIO
| FbxIO represents an FBX file. More...
struct | FbxIO::FbxAutoResetXRefManager
## Defines
#define | FBX_FILE_VERSION_2000 2000
| Defines the current FBX file version number in four digits.
#define | FBX_FILE_VERSION_2001 2001
#define | FBX_FILE_VERSION_3000 3000
#define | FBX_FILE_VERSION_3001 3001
#define | FBX_FILE_VERSION_4000 4000
#define | FBX_FILE_VERSION_4001 4001
#define | FBX_FILE_VERSION_4050 4050
#define | FBX_FILE_VERSION_5000 5000
#define | FBX_FILE_VERSION_5800 5800
#define | FBX_FILE_VERSION_6000 6000
#define | FBX_FILE_VERSION_6100 6100
#define | FBX_FILE_VERSION_7000 7000
#define | FBX_FILE_VERSION_7099 7099
#define | FBX_FILE_VERSION_7100 7100
#define | FBX_FILE_VERSION_7200 7200
#define | FBX_FILE_VERSION_7300 7300
#define | FBX_FILE_VERSION_7400 7400
#define | FBX_DEFAULT_FILE_VERSION FBX_FILE_VERSION_7400
#define | FBX_53_MB55_COMPATIBLE "FBX53_MB55"
#define | FBX_60_COMPATIBLE "FBX60_MB60"
#define | FBX_2005_08_COMPATIBLE "FBX200508_MB70"
#define | FBX_2006_02_COMPATIBLE "FBX200602_MB75"
#define | FBX_2006_08_COMPATIBLE "FBX200608"
#define | FBX_2006_11_COMPATIBLE "FBX200611"
#define | FBX_2009_00_COMPATIBLE "FBX200900"
#define | FBX_2009_00_V7_COMPATIBLE "FBX200900v7"
#define | FBX_2010_00_COMPATIBLE "FBX201000"
#define | FBX_2011_00_COMPATIBLE "FBX201100"
#define | FBX_2012_00_COMPATIBLE "FBX201200"
#define | FBX_2013_00_COMPATIBLE "FBX201300"
#define | FBX_2014_00_COMPATIBLE "FBX201400"
## Enumerations
enum | { FBX_NO_SECTION = -1, FBX_MAIN_SECTION, FBX_EXTENSION_SECTION_0 }
## Functions
FBXSDK_DLL int | FbxFileVersionStrToInt (const char *pFileVersion)
| Convert the FBX file version string to an integral number for <= or >= tests purposes.

## Detailed Description

Definition in file fbxio.h.

## Define Documentation

#define FBX_FILE_VERSION_2000 2000

Search for all occurrences

Defines the current FBX file version number in four digits.

The first digit is the major version number a the last three digits are the minor version number (e.g. 7100 = 7.1). The following is the version history of FBX:

- Version 2000 - New KFCurve and embedded FBX, no FCurve/FCurve node storing. No more .takf file like in earlier version, no history.

- Version 2001 - Version incremented to support FbxTime save in native (integer, not double) format.

- Version 3000 - FiLMBOX 3.0 version, nothing changed in current class since version 2001. FBX SDK 3.0 and 3.6

- Version 3001 - FiLMBOX 3.0 encrypted version, only a trial. Encrypted files could only be written in debug versions. Cannot switch to a higher version number now because any file with a version number >= 3001 is read as encrypted. Hence, this value now only gives file type. (3000 or less -> binary, 3001 or more -> encrypted) FiLMBOX 3.2, FiLMBOX 3.5 and "Online" 3.51 have been released with version 3000.

- Version 4000 - MotionBuilder 4.0, new type in KFCurve tangents, supported in FiLMBOX 3.5 but not by earlier versions. Version number is now stored in section footer. Before September 3rd 2002, the version number was always 3000 in main section footer. Now the main section footer has version number 4000. The minimum version number in footer of an extension section is 4000.

- Version 4001 - ASCII Header is 4.1. MotionBuilder 4.01, to fix FCurveNode problem with layer types in version 4000 the main section footer has version number 4001. Now the footer for extension sections has version number 4001.

- Version 4050 - ASCII Header is 4.5. MotionBuilder 4.1 or 4.5 before January 22nd 2003. This is because EvaluationProperties now have color. Now the main section footer has version number 4050. Now the footer for extension sections has version number 4050.

- Version 5000 - ASCII Header is not compatible anymore with MotionBuilder 4.0, 4.01 and 4.02 and FBX SDK 3.6 and 3.7 MotionBuilder 4.03 and 4.1 or 4.5 from January 22nd 2003 FBX SDK 3.6.1. New extended header to improve FBX file version management. Now the extended header and the main section footer have version number 5000. Now the footer for extension sections has version number 5000.

- Version 5800 - This was a temporary version while waiting for version 6000 renders the previous versions incompatible with MotionBuilder 6.0. For now, however, this format is needed to allow some tools/plugins (For example Maya) to correctly detect that the file has some features that are not completely backward compatible (For example: pivots defined with _pre/_post nodes which require a special processing). By incrementing only the minor version we do not compromise the integrity of the files.

- Version 6000 - Header version is now 6.0. Extended header now contain a creation time stamp that can be retrieve without parsing the main section of the file. A creator tag (string) is now stored in the Extended header. This contain the originator (MB/FBXSDK) of the file and the build number of the originator. First release of the file format using the KProperties to store/retrieve information.

- Version 6100 - Added support for multiple attributes (mainly multiple geometry) at the node level. The pointer to the node attribute have been replaced by a connection between the node and its attribute(s).

- Version 7000 - First version of the 7.0 series; most likely very short-lived, developed for Protein, before ADP. Supports reference cloning, external documents, blobs, unique IDs (per file), property templates. So many changes that it was decided to break from 6.0 to keep Motion Builder intact.

- Version 7099 - Temporary version for FBX 2011 alpha releases.

- Version 7100 Official file version for FBX 2011, add support for animation to FBX 7. First version of FBX SDK with FBX 7 files as the default file format.

- Version 7200 Added support for multiple blend shape deformers and In-Between blend-shapes on each geometry. Moved shape(FbxShape) to its own section other than as a part of geometry section. Add support to store blend shape deformer(FbxBlendShape), blend shape channel(FbxBlendShapeChannel), Substance(FbxProceduralTexture) and Lines(FbxLine). Add support to store 3 different smooth binding modes of FbxSkin, including classic linear, dual quaternion and blended mode of previous two modes. Added the CLAMP_PROGRESSIVE tangent mode. The KFCurve::KeyAttrDataFloat data array now stores as integer values (ASCII mode) to to eliminate float to int precision errors. FbxLayeredTexture now stores alphas for its sub textures.

- Version 7300 Changed the way the CharacterPoses are written. Changed light property name HotSpot and ConeAngle to InnerAngle and OuterAngle

- Version 7400 Normals, tangents and binormals save the 4th component into a separate array

Definition at line 120 of file fbxio.h.

#define FBX_FILE_VERSION_2001 2001

Search for all occurrences

Definition at line 121 of file fbxio.h.

#define FBX_FILE_VERSION_3000 3000

Search for all occurrences

Definition at line 122 of file fbxio.h.

#define FBX_FILE_VERSION_3001 3001

Search for all occurrences

Definition at line 123 of file fbxio.h.

#define FBX_FILE_VERSION_4000 4000

Search for all occurrences

Definition at line 124 of file fbxio.h.

#define FBX_FILE_VERSION_4001 4001

Search for all occurrences

Definition at line 125 of file fbxio.h.

#define FBX_FILE_VERSION_4050 4050

Search for all occurrences

Definition at line 126 of file fbxio.h.

#define FBX_FILE_VERSION_5000 5000

Search for all occurrences

Definition at line 127 of file fbxio.h.

#define FBX_FILE_VERSION_5800 5800

Search for all occurrences

Definition at line 128 of file fbxio.h.

#define FBX_FILE_VERSION_6000 6000

Search for all occurrences

Definition at line 129 of file fbxio.h.

#define FBX_FILE_VERSION_6100 6100

Search for all occurrences

Definition at line 130 of file fbxio.h.

#define FBX_FILE_VERSION_7000 7000

Search for all occurrences

Definition at line 131 of file fbxio.h.

#define FBX_FILE_VERSION_7099 7099

Search for all occurrences

Definition at line 132 of file fbxio.h.

#define FBX_FILE_VERSION_7100 7100

Search for all occurrences

Definition at line 133 of file fbxio.h.

#define FBX_FILE_VERSION_7200 7200

Search for all occurrences

Definition at line 134 of file fbxio.h.

#define FBX_FILE_VERSION_7300 7300

Search for all occurrences

Definition at line 135 of file fbxio.h.

#define FBX_FILE_VERSION_7400 7400

Search for all occurrences

Definition at line 136 of file fbxio.h.

#define FBX_DEFAULT_FILE_VERSION FBX_FILE_VERSION_7400

Search for all occurrences

Definition at line 139 of file fbxio.h.

#define FBX_53_MB55_COMPATIBLE "FBX53_MB55"

Search for all occurrences

Definition at line 142 of file fbxio.h.

#define FBX_60_COMPATIBLE "FBX60_MB60"

Search for all occurrences

Definition at line 143 of file fbxio.h.

#define FBX_2005_08_COMPATIBLE "FBX200508_MB70"

Search for all occurrences

Definition at line 144 of file fbxio.h.

#define FBX_2006_02_COMPATIBLE "FBX200602_MB75"

Search for all occurrences

Definition at line 145 of file fbxio.h.

#define FBX_2006_08_COMPATIBLE "FBX200608"

Search for all occurrences

Definition at line 146 of file fbxio.h.

#define FBX_2006_11_COMPATIBLE "FBX200611"

Search for all occurrences

Definition at line 147 of file fbxio.h.

#define FBX_2009_00_COMPATIBLE "FBX200900"

Search for all occurrences

Definition at line 148 of file fbxio.h.

#define FBX_2009_00_V7_COMPATIBLE "FBX200900v7"

Search for all occurrences

Definition at line 149 of file fbxio.h.

#define FBX_2010_00_COMPATIBLE "FBX201000"

Search for all occurrences

Definition at line 150 of file fbxio.h.

#define FBX_2011_00_COMPATIBLE "FBX201100"

Search for all occurrences

Definition at line 151 of file fbxio.h.

#define FBX_2012_00_COMPATIBLE "FBX201200"

Search for all occurrences

Definition at line 152 of file fbxio.h.

#define FBX_2013_00_COMPATIBLE "FBX201300"

Search for all occurrences

Definition at line 153 of file fbxio.h.

#define FBX_2014_00_COMPATIBLE "FBX201400"

Search for all occurrences

Definition at line 154 of file fbxio.h.

## Enumeration Type Documentation

anonymous enum

Search for all occurrences

Used internally by readers to evaluate what is the current section

Enumerator:

  FBX_NO_SECTION | indicate not in a valid section Search for all occurrences
  FBX_MAIN_SECTION | indicate currently in the main section Search for all occurrences
  FBX_EXTENSION_SECTION_0 | indicate currently in the extention section 0 Search for all occurrences

Definition at line 172 of file fbxio.h.

    {
        FBX_NO_SECTION = -1,
        FBX_MAIN_SECTION,
        FBX_EXTENSION_SECTION_0
    };

## Function Documentation

FBXSDK_DLL int FbxFileVersionStrToInt | ( | const char * | pFileVersion | ) |

Search for all occurrences

Convert the FBX file version string to an integral number for <= or >= tests purposes.

Parameters:

  pFileVersion | File version string. Some examples:
           int version;
               version = FileVersionStrToInt(FBX2012_00_COMPATIBLE);    // version = 201200
               version = FileVersionStrToInt(FBX60_COMPATIBLE);         // version = 6000
               version = FileVersionStrToInt("FBX200900");              // version = 200900
               version = FileVersionStrToInt("Toto");                   // version = 0
               version = FileVersionStrToInt("");                       // version = -1

Returns:
  the file version number or 0 if an unsupported string value is passed.