-
Notifications
You must be signed in to change notification settings - Fork 1
License
metarutaiga/FBXSDK
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
 |  | |||
 |  | |||
 |  | |||
 |  | |||
 |  | |||
Repository files navigation
================================================================================
README
Autodesk FBX SDK 2019
-----------------------
Welcome to the FBX SDK readme! This document includes the latest changes since
the previous release version of the Autodesk FBX SDK, such as new features, bug
fixes, known issues, deprecated functions/classes and previous releases notes.
For more information, please visit us at http://www.autodesk.com/fbx/
To join the FBX Beta Program, please visit the Autodesk Feedback Community site
at http://beta.autodesk.com
Sincerely,
the Autodesk FBX team
================================================================================
TABLE OF CONTENTS
-----------------
1. Features, Improvements And Changes
2. Fixed And Known Issues
3. Release Notes From Previous Releases
4. Legal Disclaimer
1. FEATURES, IMPROVEMENTS AND CHANGES
-------------------------------------
1.1 Improvements and New Features
* Constant FBXSDK_TC_MILLISECOND have been changed from 46186158 to 141120 to accurately support
frame rates like ~23.976, ~29.97, 72 and 96 fps.
* The enum value eFrames119dot88 has been added to the FbxTime::EMode enum. In the same vein, the
FbxTCSetMNTSC_4Xnd and FbxTCGetMNTSC_4Xnd helper functions have been added to deal with this new
~119.88 frame rate.
* The class FbxAxysSystem has been extended and provides the new function "DeepConvertScene" that
modifies transforms, vertex positions, animation curves and so on throughout the hierarchy.
Consequently, it is able to accurately support handedness changes.
1.2 Changes and Deprecated Features
* The improvement of the FBXSDK_TC_MILLISECOND is big enough to break the compatibility with
version 7.5. To minimize adoption issues, the change in this version of the FBX SDK can be
triggered by calling FbxTCSetDefinition(FBXSDK_TC_STANDARD_DEFINITION). By default, we keep
using the old value (FBXSDK_TC_LEGACY_DEFINITION) and you "opt in" for the new one.
Over time, the "opt in" will become the default and the file version will be bumped to 8.0
(so previous versions of the FBX SDK can detect that the new file is incompatible).
In the meantime, it is expected that 7.7 files saved with the new precision, will still be
readable by previous FBX SDKs (2016,2017 and 2018) BUT with totally bad timings.
* custom defined ALEMBIC_VERSION_NS to avoid possible conflict with third partly Alembic library.
* removed the forced pack to 8 (the statements #pragma pack(push, 8) / pop() were enclosing all
the FBX SDK includes in fbxsdk.h)
2. FIXED AND KNOWN ISSUES
-------------------------
2.1 Fixed Issues
[FBXX-1513] Fix crash in MergeMeshes when user data is defined.
[FBXX-1510] Mixed folder separator character (\ & /) breaks extraction of embedded textures.
2.2 Known Issues
3. RELEASE NOTES FROM PREVIOUS RELEASES
---------------------------------------
2019.2
* Re-enabled the Alembic caches support for Ogawa archives. HDF5 is not supported anymore inside the
FBX SDK. Note that all the WindowStore and IOs architectures do not provide Alembic support.
* Consider animation corrupted if keys times are not ordered by increase value
(i.e: T(i) must be less or equal to T(i+1))
[FBXX-1499] Fix potential crash when writing Acclaim file.
[FBXX-1483] Security Improvements.
[FBXX-1481] Fix potential crash in FbxGeometryConverter::ComputeEdgeSmoothingFromNormals
[FBXX-1480] 3DS Reader returns a false positive error.
[FBXX-1479] FBXCollada improve write time of mesh data.
[FBXX-1476] FbxIO::GetTmpProjectName and FbxIO::SwapFromTmpProject bad execution.
[FBXX-1474] Password protected files status is overwritten.
[FBXX-1433] Update Alembic to version 1.7.5.
2019.1
* Added the FBX standardized renaming strategy to the Collada file read/write. This renaming
strategy will replace every character in the object names/ids, which does not comply with
the XML NCName scheme, with a string in the form "FBXASC###" were ### is the decimal value
of the ASCII character.
* Added extra parameter to GenerateTangentsData() family functions to skip testing for the tangent flip
* moved the static functions FbxRenamingStrategy::NoPrefixName to FbxRenamingStrategyUtils::NoPrefixName
and it now returns an FbxString instead of a char*
* Starting with this version of the FBX SDK your programs must explicitly link with the zlib and
libxml2 libraries. On Linux and MacOS, these libraries should already be part of the system. If
not, you must install them.
* disabled Alembic support
[FBXX-1438] Fixed EvaluateGlobalBoundingBoxMinMaxCenter so it correctly returns the 3D volume bounding box.
[FBXX-1417] Fixed Wgettimeofday and Wgetlogin already define linker error.
[FBXX-1383] Fixed stack overflow when importing Collada files defining external references.
2018.1.1
* [FBXX-1384] Regression issue introduced by the Audio transport feature.
* [FBXX-1386] Copying FbxSkin object into another does not copy all data.
2018.1
* [FBXX-1258] Add Audio transport support.
* [FBXX-1279] Added more options to the FbxSceneCheck utility class.
2018.0
* [FBXX-1303] Crash when deleting NURBS created with FbxGeometryConverter::ConvertPatchToNurbsSurface()
* [FBXX-1280] Invalid pointer access
* [FBXX-1257] Invalid value for a malloc
* [FBXX-1143] Collada reader
* [FBXX-1140] Crash in FbxGeometryConverter::Triangulate with huge poly count (60 millions +)
2017.1.1
Fixed some global HDF5 symbols that were missed during the previous namespacing. These
symbols only caused an issue on Linux builds when an application links with both the
FBX SDK and its own version of Alembic/HDF5 libraries static libraries.
2017.1
* [FBXX-1225] Security Improvements.
* Alembic code has been fully namespaced to avoid duplicated function conflicts when applications
link the FBX SDK and other Alembic libraries.
2017.0.2
* [FBXX-1207] FBX SDK library for VS2015 builds with the Target Platform Version 10.0.10586.0
2017.0.1
* [FBXX-999] Added the new eRelativeRepetition flag to the animation curves extrapolation flags.
* [FBXX-1023] Refactored FbxUtils to minimize possible buffer under/overflows.
* [FBXX-1031] Added new roll bones to the FbxCharacter definition.
* [FBXX-1066] The SDK version is still reported as an "Alpha" release
* [FBXX-1019] Loading a .3ds file with a texture is very slow when using Python bindings
* [FBXX-1026] Crash when triangulating NURBS surfaces
* [FBXX-1051] In some cases shape normals are written beyond array boundaries
Removed deprecated functions
FbxObject::Is(const FbxClassId& pClassId)
FbxObject::DisconnectAllSrcObject(FbxClassId pClassId)
FbxObject::GetSrcObjectCount(FbxClassId pClassId)
FbxObject::GetSrcObject(FbxClassId pClassId, int pIndex=0)
FbxObject::FindSrcObject(FbxClassId pClassId, const char* pName, int pStartIndex=0)
FbxObject::DisconnectAllDstObject(FbxClassId pClassId)
FbxObject::GetDstObjectCount(FbxClassId pClassId)
FbxObject::GetDstObject(FbxClassId pClassId, int pIndex=0)
FbxObject::FindDstObject(FbxClassId pClassId, const char* pName,int pStartIndex=0)
FbxProperty::DisconnectAllSrcObject(const FbxClassId& pClassId)
FbxProperty::GetSrcObjectCount(const FbxClassId& pClassId)
FbxProperty::GetSrcObject(const FbxClassId& pClassId, const int pIndex=0)
FbxProperty::FindSrcObject(const FbxClassId& pClassId, const char* pName, const int pStartIndex=0)
FbxProperty::DisconnectAllDstObject(const FbxClassId& pClassId)
FbxProperty::GetDstObjectCount(const FbxClassId& pClassId)
FbxProperty::GetDstObject(const FbxClassId& pClassId, const int pIndex=0)
FbxProperty::FindDstObject(const FbxClassId& pClassId, const char* pName, const int pStartIndex=0)
2016.1.2
* [FBXX-1009] StringList default values not correctly initialized (regression in 2016.1).
Properties created with the FbxStringListDT data type were failing to initialize their default
value since the implementation of [FBXX-946]
2016.1.1
* Added the GetMatrix(FbxAMAtrix& pMatrix) function to the FbxAxisSystem class that retrieves
the axis definition in the 4x4 matrix form.
* [FBXX-997] FBX SDK Sample ExportScene05 uses a "reserved" (ABC) file extension.
the ABC extension being also used by the Alembic reader, the sample was selecting
the wrong reader when trying to load the custom file. Changed the extension of the
sample so no more conflict can occur. Note that the ABC extension can still be used
but a manual detection of the readerID, by calling FindReaderIDByDescription(),
is mandatory.
* [FBXX-988] Resolved use of arbitrary up vector on cameras driven by a target.
The FbxAnimEvalClassic::ComputeGlobalTransform() was implicitly assuming in its calculations,
when the pApplyTarget is true, that the global up vector of cameras constrained by an aim
target is always (0,1,0). This was a false assumption if a different FbxSystemAxis had been
applied to the scene and, at best, produced an arbitrary rotation of these cameras when the
aim vector was parallel to the (0,1,0) vector.
* [FBXX-986] Fixed potential security issue when reading certain legacy FBX files
2016.1
* [FBXX-967] Improved the LodGroup object to allow it to store thresholds
as percentage values or distance from camera.
* [FBXX-946] Properties with the FbxEnumDT data type now perform a strict
validation to forbid duplicates when items are added, inserted or replaced
in the enumeration list. The new eFbxEnumM type identifier is available for
users who want to create their own runtime enumeration data type that can
accept duplicated entries.
* [FBXX-963] In the Collada reader, replaced xmlParseFile() function call with
xmlReadFile() so we can set XML_PARSE_HUGE flag, which relaxes any hard-coded
limit from the parser. This affects limits like maximum depth of a document or
the entity recursion, as well as limits of the size of text nodes.
* [FBXX-952] Fixed an issue with the Animation Curve Pre/Post Extrapolation
data. In the very particular case of a program creating an animation curve
directly in memory that set the extrapolation flags and then tries to evaluate
the curve outside the animation range, the extrapolation flags were not
considered until the curve was saved to disk.
* [MAYA-54538] An overlooked condition from the fix above introduced a regression
in the FBX SDK 2016.1 alpha.
* [MAXX-23051] An update to the FbxAMatrix::GetROnly() caused a regression when
detecting the Euler gimbal locks while extracting the rotation vector value.
The default threshold value used for this detection can be to small for a
correct detection if the matrix is constructed with very low precision single
floating point values.
The FBX SDK now provides a method (FbxEuler::SetDegenerateThreshold()) to allow
the client application to change the threshold value at runtime.
2016.0
* Visual Studio 2008 builds are no longer supported. Visual Studio 2010,
2012 and 2013 are supported.
* Updated file format to 7.5 (compatible with 2016+ products) which now
uses 64bit integers in the binary block headers to allow for large file
support (>2GB). These new FBX files will NOT import in older products
(2015 or less), so make sure you set the right export format if you need
to target these older products.
* iPhone Simulator build is now a universal binary that contain both 32 and
64bit architectures.
* Starting in this release, the FBX SDK name space will no longer contain
version indications.
* Improved the camera manipulator speed when very close to camera interest
position.
* Added RemoveBadPolygonsFromMeshes to FbxGeometryConverter class to allow
clean-up whole scene (typically, this function must be called before
Triangulate or any other utility functions that are manipulating meshes).
* Default export file format is now 7.5 (compatible with 2016+ products).
* Removed deprecated functions
- FbxProperty::SetParent
- FbxProperty::SetArraySize
- FbxProperty::GetArraySize
- FbxProperty::GetArrayItem
- FbxProperty::operator[]
* If user code retrieves the transform values directly from the LclTranslation,
LclRotation and LclScaling properties, the fixes made to the ConvertPivotAnimation
may require to change how these property values are retrieved.
Now, when ConvertPivotAnimation is called, the computed value may be stored on
the CurveNode channel instead of overwriting the property value. To correctly retrieve
the computed values, we encourage using the function FbxProperty::EvaluateValue() with the
time argument value different than FBXSDK_TIME_INFINITE.
Alternatively, users can test for the presence of the CurveNode and retrieve the value
directly from this object:
ex: if (LclTranslation.GetCurveNode())
x = LclTranslation.GetCurveNode()->GetChannelValue(0L);
* Fixed a compilation error when attempting to use FbxAutoDeletePtr on Unix
based systems.
* Fixed an issue with bounding box calculations.
* Fixed FbxPathUtils::Exist that was failing on MacOS for Sandboxed
applications.
* Fixed an issue with ConvertPivotAnimation that wasn't properly
de-activating Rotation pivots/limits after conversion.
* Fixed FbxMesh::RemoveBadPolygons() so that polygons with less than three
vertices are properly considered invalid.
* Improved CloneManager to avoid duplicating already cloned objects.
* Fix rare crash in FbxScene::ForceKill caused by FbxCharacterPose.
* Fixed an issue with GenerateTangentsDataForAllUVSets that was processing
tangents for each polygon instead of each mesh when calling
FbxGeometryConverter::SplitMeshPerMaterial.
* Fixed an issue with ConvertPivotAnimation when processing multiple takes.
* Fixed a crash with ReadUserElementData that was referencing invalid
pointers.
* Fixed a BVH import rotation issue on joints related to constant key
reducer.
* Fixed circular dependency in fbxsdk_nsbegin.h.
* Fixed missing template instantiation for FbxSimpleMap and FbxObjectMap.
* FbxAMatrix only works with XYZ rotation order.
* Skew and Stretch matrices are not supported.
* The FBX SDK is *NOT* thread safe.
* Deformers do not support instancing. This causes point cache deforming to
not be re-usable.
* While assigned material can change on the node, material layers on the
mesh cannot be instanced.
* When exporting various file format, sometimes the scene gets modified
permanently, resulting in data loss.
2015.1
* Added support for Visual Studio 2013 compiler.
* iOS build changes: minimum iOS version is now 7.0 and now supports 3 main
architectures (armv7, armv7s and arm64).
* MacOS build changes: GCC build support dropped. MacOS minimum version is
now 10.8, and is built with XCode 5.0 default Clang compiler.
* Native Alembic support added: now .abc files can be directly opened,
which will create the appropriate nodes and mesh in the FBX scene.
Afterwards, users can access FbxCache data in order to read cache data.
NOTE: Alembic support is currently only enabled for desktop operating
systems (i.e. disabled on iOS/WinStore).
* FbxCache now has a newer function, Read, which works regardless of cache
type.
* Add .zip read support: files and their dependencies, such as textures,
can now be packaged into a .zip file, which can be directly read by the
FBX SDK without unpacking. This is useful for file formats that don't
support embedding textures. Only one scene per .zip file is supported.
* FbxObject now has a virtual function Compact that can be overloaded, to
implement object compacting. Calling Compact on FbxScene or FbxDocument
will compact every objects connected as source.
* FbxArray now provides a AddCompact and Compact function to reduce memory
used by arrays.
* Added operator equality and inequality to FbxPair.
* Added new class FbxSharedPtr.
* Improved the FbxCameraManipulator behavior:
- Upon Frame-All, camera rotation is preserved
- Upon Frame-All, take into account deformations on meshes
- Make minimum distance to LookAt more robust
- Improved minimum speed when camera is at minimum distance to LookAt
* Added a new FBX_TRACE macro for debugging.
* Added a new parameter to FbxCamera::ComputeProjectionMatrix to specify if
the FOV should be preserved even if the viewport height is larger than
the viewport width.
* FbxGeometryConverter function ResetMeshesCenterToWorld renamed to
RecenterSceneToWorldCenter because it doesn't change the vertices data.
* Recent endianness changes were reverted because they are not necessary.
* Fixed an issue with the matrix converter filter that wasn't resetting all
members properly.
* Made path utility functions more robust: files are no longer mistaken for
folders, and trying to write in read-only folders should not crash any
more.
* The geometry converter Triangulate and SplitMeshesPerMaterials now
properly handles blend shapes.
* Fixed an issue with left over shape data upon reading FBX files.
* Fixed a major corruption problem when trying to save files in iOS builds.
* FBXSDK_ENV_IOS should no longer be defined on MacOS builds.
* FbxThumbnails are now properly shared between document and importer's
scene info.
* Converting a scene's axis system with the FbxAxisSystem will now ignore
pre/post rotation and rotation order values on node if RotationActive
property is set to false.
* Cleaned-up many warnings when compiling using XCode 5.0.
* Fix a crash with layer element material cloning that was still pointing
to an not-cloned FbxSurfaceMaterial object.
* Fixed an issue with local time span not always written to FBX file.
* Now when using FbxGeometryConverter::SplitMeshesPerMaterial, all layer
elements will be copied to the new meshes instead of only the first one.
* Fixed a rare crash upon loading corrupted FBX files.
* Fixed multiple crashes upon loading Collada and OBJ files.
2015.0
* Added 4 new functions in FbxMatrix to generate LookTo and LookAt
matrices.
* Class FbxVertexCacheDeformer now has a type property to define the type
of data it uses in the cache file channel.
* Added a new generic read function to FbxCache, which returns an array of
float managed internally. This function now works regardless of the cache
file type.
* FbxArray now use reference to elements rather than copies for greater
memory performance.
* Added a new function overload FbxMatrix::GetElements which now can return
a rotation vector instead of a quaternion.
* Matrix converter curve filter now supports TRS limits.
* Cleaned and standardized comparison functors across the SDK.
* Added operator += and -= to FbxRedBlackTree. FbxMap use this model.
* Added new function FbxArray::RemoveRange that allows removing multiple
items.
* Renamed FbxSet to FbxMultiMap to clearly describe what it does.
* Renamed FbxSet2 to FbxSet, since this is the actual set class in FBX SDK.
* Polished the interface of FbxVertexCacheDeformer class to use the FBX SDK
standard property model.
* FbxArray will now use reference values for most of its functions.
* FbxPropertyAttr members have been merged into FbxPropertyFlags for
consistency.
* Fix a regression with edge smoothing.
* Fixed multiple memory alignment issues for iOS builds.
* FbxProperty map in evaluate state now properly use an FbxProperty
reference instead of a pointer.
* Fixed issue with the evaluation state not properly clearing itself when
the scene changes. This was causing memory corruption.
* Fixed a crash when freeing the FbxManager in some circumstances.
* Fixed a crash when importing some Collada files.
* Fixed a crash when trying to create a folder in read-only locations on
Linux/Mac.
* Fixed an issue with tangents smoothing not considering flip.
2014.2.1
* The change to have the animation evaluator per manager instead of per
scene has been reverted because it was causing a loss of functionality
for some applications.
* Now to retrieve the current animation stack, please use
FbxScene::GetCurrentAnimationStack instead of
FbxAnimEvaluator::GetContext.
* FbxProperty::GetCurveNode should once again return the right curve node.
This caused animation to be completely wrong in some cases.
* Fixed an issue with camera node's LclTranslation property being
incorrectly overwritten by the camera Position property.
2014.2
* Added new FBX SDK library targets: Windows Store, Mac Clang and iOS.
* Major improvement to animation evaluation functions:
- Now, the FbxAnimEvaluator instance is stored in the manager rather than
the scene.
- Add evaluation state to animation stacks to allow simultaneous
evaluation of takes.
- One evaluation state remains in the evaluator to be able to evaluate
scene-less objects.
- Remove the necessity to provide an index to evaluation functions of the
evaluator. All 'fast' versions of these functions are no longer
necessary so they have been removed.
- Added a new function in FbxProperty to evaluate their value.
- Greatly improve performance of FbxProperty::GetCurveNode by caching
results in a map inside evaluation state.
- Greatly reduce the size of a node and property evaluation states.
* Greatly reduced the amount of memory allocations/free that were caused by
FbxCriteria and FbxQuery. Should improve performance in most cases.
* Added new global function FbxTypeComponentCount to retrieve a type's
component count.
* Added new functions FbxMapDelete, FbxMapFree and FbxMapDestroy to ease
the process of deleting map content.
* New function in FbxTime to retrieve the time string, which allow to
specify which 'start' and 'end' element it can returns.
* Added a new property to the camera manipulator to allow inverting
controls.
* FbxGeometry::ComputeBBox will no longer compute or change the bounding
box value if the content is unloaded.
* FbxString is now using a char pointer allocation again rather than an
opaque std::string implementation, for easier debugging and better
performance/memory footprint. It is no longer necessary to modify the
autoexp.dat file of Visual Studio to see string content with debuggers.
* More work has been put in to make it possible to clone a character and
its dependencies. Please see fbxclonemanager.h comments for more info.
* FbxGeometryConverter::SplitMeshesPerMaterial now correctly handles
skinning on splitted meshes.
* Exposed bounding box calculation function scene and nodes. Please check
out FbxScene::ComputeBoundingBoxMinMaxCenter and
FbxNode::EvaluateGlobalBoundingBoxMinMaxCenter.
* Added new function in FbxGeometryConverter to re-center the scene meshes,
please check out FbxGeometryConverter::ResetMeshesCenterToWorld.
* Added new function in mesh to generate normals, working the same way
generating tangents, which replace the old function
FbxMesh::ComputeVertexNormals which only supported smooth normals. Please
see FbxMesh::GenerateNormals.
* Implemented FbxScene::Clone to properly duplicate scenes.
* Added two new functions to FbxTime: SetFramePrecise and
GetFrameCountPrecise, which use double values instead of longlong.
* Added FbxMod to fbxmath.h.
* Added a sample code to demonstrate FbxStream class usage.
* FbxString no longer use std::string implementation.
* FBXSDK_sprintf, FBXSDK_snprintf, FBXSDK_vsprintf and FBXSDK_vsnprintf now
always take a single size parameter instead of being variant on different
platforms.
* Removed thumbnails in animation stack. Now only one thumbnail can be
saved per FBX file, found in the FbxSceneInfo class.
* Removed GetCurveNode in FbxProperty that used an animation stack name for
performance reasons.
* Changed ConvertPivot functions in FbxNode to use an animation stack
pointer instead of animation stack for performance reasons.
* Renamed class FbxPropertyFlagsExt to FbxPropertyFlags.
* Moved class FbxPropertyValue to a more global locations because it is now
also used by evaluation state.
* When using the camera manipulator, and the camera got flipped vertically,
the horizontal orbit was inversed. This has been fixed.
* Fixed an issue with matrix conversion to euler angles; degenerate case
(gimbal lock) detection was too sensitive.
* ContentUnload will now properly unload layers on geometry.
* When performing a 'frame-all' using the camera manipulator, if the mesh
content is unloaded, it will use the pre-computed bounding box, if it
exist, otherwise it will skip it.
* When performing a 'frame-all' using the camera manipulator, the camera
will now correctly center itself on the global bounding box center rather
than its centroid.
* Fixed many compilation warnings with clang compiler on Mac.
* Fixed camera orthogonal projection matrix generation issue.
* When manipulating camera, it shall no longer go through the interest
position.
* Fixed crash when writing encrypted FBX file.
* Fixed crash when opening OBJ files.
* Fixed typo with return value of FbxExporter::GetCurrentWritableVersions.
* FbxCameraManipulator Frame-All now works on orthographic cameras.
* Fixed edge detection to be more accurate. Previous code only stored one
edge from a single point. Now save all edges from one point and detect
duplicated edges in all situation.
* Fixed various warnings in macros generated when compiling with C++11.
* Fixed an issue when reading textures for OBJ files.
* Fixed an issue when reading material transparent properties in MTL files.
* Fix rare crash when reading 3DS files.
* Fixed rare memory leaks in specific situations.
* Fixed reversed normals when reading DXF files.
* Fixed a crash when writing collada files containing shapes.
* Fix function to generate tangents/binormals incorrectly sets W component
to greater values than -1 or 1.
* Cameras with a target up node or a look at node will now be able to be
moved around properly using the camera manipulator.
2014.1
* Introduced FBXSDK_ENV_WINRT preprocessor define (previously known as
FBXSDK_ENV_WINMETRO) which disable unsupported functions when targeting
Microsoft Windows Store applications. This define will automatically be
defined if you set Windows Store App Support to Yes in your Visual Studio
project settings.
* A number of changes to the architecture defines in fbxarch.h were changed
to add support for ARM processor:
Added FBXSDK_ARCH_IX86, only defined on Intel x86 targets.
Added FBXSDK_ARCH_AMD64, only defined on AMD64 targets.
Added FBXSDK_ARCH_ARM, only defined on ARM targets.
Renamed FBXSDK_ARCH_32 to FBXSDK_CPU_32, only defined for 32bit targets.
Renamed FBXSDK_ARCH_64 to FBXSDK_CPU_64, only defined for 64bit targets.
Also, please see deprecated details below.
* Added version information to the FBX SDK dll on Windows platform.
* Updated ViewScene sample to show how to support in-between blendshape
(progressive morph).
* Added support for the new Maya 2014 Cache files (*.mcx).
* Improved the tangents/binormals calculation functions to properly handle
mirrored faces by flipping the binormal when the face is inverted. It
also sets the fourth component of the tangent to -1 if it is flipped, 1
otherwise.
* FbxReference is now defined as FbxObject* rather than void*. This will
allow properties of FbxReference type to correctly respond to FbxCast and
other FBX SDK API, as well as restraining the assignment to FbxObject*
types.
* Improved the FbxCameraManipulator by adding a new action type: eFreePan.
It combines dollying and panning into a single action. For example, this
is very useful for manipulating the camera using a touch screen.
* Added a new object flag: FbxObject::eInitialized. This flag is
automatically set on all object after they are done with the Construct
stage. This is also used to prevent PropertyNotify to be called during
ConstructProperties stage.
* Now the class FbxCameraManipulator does not use an hidden class
internally anymore, and use the PropertyNotify event to re-initialize
when changing its affected camera.
* Added a new IOSetting flag (IMP_FBX_EXTRACT_EMBEDDED_DATA) to completely
disable embedded files extraction, which is set to true by default.
* Added a new function (FbxObject::ResetProperties) to reset all properties
to their default value.
* The parameter pForceSet of function StaticInit on FbxProperty is not
optional anymore. When calling it in ConstructProperties, the value of
pForceSet must be correctly passed to StaticInit for all properties to
ensure properties are not initialized more than once.
* Added new function FbxGeometryConverter::Triangulate which now replace
the old TriangulateMesh, TriangulateMeshAdvanced and TriangulateInPlace.
The new function can either take a node attribute, or a scene in
parameter. It can also replace original nodes with new ones and make sure
the scene stays clean.
* Added new function FbxGeometryConverter::SplitMeshesPerMaterial which can
take a scene in parameter, and can replace original meshes and make sure
the scene stays clean.
* Added a new constructor to FbxArray class, which takes an integer in
parameter to reserve the memory for that specific size.
* Added a new parameter to FbxMesh::GetPolygonVertexUV to allow it to return
an array of unmapped polygons. This is extremely useful to determine which
vertex has no UV associated.
* Removed the version number in library names on disk for all platforms.
Also, debug and release versions are now named the same, but in different
subfolders.
* FBXSDK_ARCH_32 and FBXSDK_ARCH_64 got renamed to FBXSDK_CPU_32 and
FBXSDK_CPU_64 respectively to dissociate them from the architecture.
* Cannot set void* types to FbxReference properties anymore to improve
robustness.
* Changed the signature of FbxObject::PropertyNotify to pass a reference to
the property instead of a pointer.
* Old triangulation functions are now deprecated. Please use
FbxGeometryConverter::Triangulate instead.
* Improve manipulation of free cameras by preventing nasty flips when view
axis reaches vertical.
* A regression with ConvertPivotAnimationRecursive that was introduced in
FBX 2013.3 has been fixed. It was causing some scenes to become resampled
and key-reduced wrongly.
* When including fbxsdk.h in your project, the define WIN32_LEAN_AND_MEAN
will not be automatically defined anymore.
* Fixed an issue with FbxPathUtils::GetRelativePath that wasn't working
properly with localized paths.
* Fixed a crash when exporting to 2010/2011 compatible files (FBX 6.1/7.1).
* Fixed a performance issue with Quaternion FCurve evaluation.
* All properties of FbxReference type now use the Source connection. Only a
handful of them weren't complying, in various FbxConstraint classes. In
FBX 2014 (7.4) or lower files, this will not change anything, but in
memory these objects are now always connected to the source of the
property.
* Blend Shape animation was missing when a take other than first is
imported, this has been corrected.
* FbxObject::PropertyNotify callback will not be called anymore during
ConstructProperties object creation stage.
* FbxPropertyT<FbxReference> now correctly receive the PropertyNotify event.
* Fixed an issue with FbxTime::SetTimeString when passing spaces between
elements.
* Fixed an issue with the FbxCamera Position property synchronization with
its node's local translation.
* Fixed FbxMarker class to not return property pointers.
* For all FbxMesh::GenerateTangentsData function: When the tangents data
already exist on the mesh, and that pOverwrite is set to false, the
function will now return true so that it is not considered as an error.
* Added a notification in the doxygen documentation of FbxStream that it
does not support other formats than FBX.
* Fixed a crash in FbxCache evaluation under Linux/Mac platforms.
* Fixed a rotation order issue with ASF motion files.
* Fixed a candidate value initialization with ASF motion files.
* Fixed a crash on Mac/Linux version in FbxPathUtils::Create.
* Made FbxGeoemetryConverter::SplitMeshPerMaterial much more robust; now
meshes that have material indexes that points to invalid materials will
not be assigned any materials, and they will be regrouped together.
* Fixed a crash when exporting blend shapes to an old FBX 6.x file format.
* Fixed an issue with tangents/binormals generation when some vertices
didn't have an UV mapped.
2014.0
* Visual Studio 2012 is now officially supported.
* FbxCamera::EvaluateUpDirection now support the Roll property.
* Added FBX 2014 file version, and his now the default target.
* The 4th vector element of normals, binormals and tangents are now
properly exported to FBX files in FBX 2014 file format.
* A new status reporting class has been introduced to replace the old
FbxError class. Please refer to the FbxStatus class. More usage of this
new class will be added over time.
* Added new functions for the default IK Pull value on markers.
* A default IK Pull value is now stored on markers.
* TimeMarkers functionality has been re-introduced in FBX 2014 file format.
The API to access them has been placed in FbxGlobalSettings class.
* Updated Python 3.1 support to Python 3.2 in the FBX Python SDK.
* MotionFiles readers/writers are now registered in the public FBX SDK.
This means the FBX SDK can now import and export the following motion
file formats: Biovision (BVH), MotionAnalysis (HTR/TRC), Acclaim (ASF/AMC),
Vicon (C3D), Adaptive Optics (AOA) and Superfluo (MCD).
* The FBX SDK libraries on Mac and Linux are now compiled with default
visibility set to hidden. Only symbols marked with FBXSDK_DLL are exported,
which makes it equal to the Windows version.
* FbxProperty flags have been clean-up. The flag ePublished as been renamed
to eAnimated, and eUser to eUserDefined, for clarity. The flag eStatic
now works, and will be turned on for all static properties by default.
Introduced the flag eImported, for properties that are created upon
import.
* New environment define FBXSDK_ENV_WINRT for Windows Metro support. Also
added FBXSDK_ARCH_ARM for ARM processor support, under work.
* FbxFolder has been re-worked. FbxFolder::Create, FbxFolder::Delete and
FbxFolder::Exist has been moved in FbxPathUtils, and now work pass the
Microsoft Certification Validation Kit for Windows Store applications.
Other functions of FbxFolder have been renamed for consistency. Please
see fbxfolder.h.
* New function FbxPathUtils::Exist now works on relative paths.
* New function FbxPathUtils::Create can take multiple paths as argument,
and they will all be created (if possible), just like mkdir on Unix.
* Improved FbxMesh::GetPolygonVertexCount to simply return the array size.
* Updated FbxProgress class to be simpler, and allow an additional argument
to be passed to the single-thread callback.
* The file fbxsdk_compatibility.h has been removed from the FBX SDK
distribution, so now it is required to use the latest API. Defining
FBXSDK_NEW_API is not necessary anymore and should be removed from your
projects.
* The support for Visual Studio 2005 has been discontinued.
* The support for MacOS/X SDK 10.5 has been discontinued. The minimum
requirement is now MacOS/X SDK 10.6.
* FbxString::Empty was renamed for FbxString::Clear to avoid confusion with
FbxString::IsEmpty.
* FbxError has been removed from all classes. Instead, functions that needs
to return an error string now use an optional parameter of type FbxStatus
similar to the MStatus in Maya API.
* FbxFolder::Create has been removed, please use FbxPathUtils::Create
instead.
* FbxFolder::Delete has been removed, please use FbxPathUtils::Delete
instead.
* FbxFolder::Exist has been removed, please use FbxPathUtils::Exist instead.
* FbxFolder::Remove has been removed from the FBX SDK API. Please now use
FbxPathUtils::Delete, which is now always recursive.
* Fixed a small issue with FbxCamera::EvaluateUpDirection that was
incorrectly using the TargetUp object.
* Updated various doxygen comments for clarity.
* Fixed a buffer overrun crash issue when importing specific 3DS files.
* Fixed a crash issue when trying to destroy the FbxManager at application
exit.
* Some samples were erroneously calling FbxString::Empty instead of
FbxString::IsEmpty.
* Fixed a buffer overflow in FbxStream::ReadString.
* Importing an OBJ file will not un-weld UV anymore.
* Fixed curve key comment in ASCII version; the code was not distinguishing
between the GenericTimeIndependent only and GenericClampProgressive.
* Improved the TranslationActive, RotationActive and ScalingActive
properties doxygen documentation.
* Fixed a crash when exporting to Collada when the scene was containing
other kinds of deformers than skins.
* The default value of FbxMarker::DrawLink is now set to true.
* Fixed a small issue with FbxCamera::EvaluateLookAtPosition that wasn't
returning the expected value.
* Fixed an issue when writing Collada files that was resulting in the
Effect field being written for each polygon, wrongly increasing the file
size.
* Various functions, such as FbxMin, that were returning a const reference
type value were fixed to return a copy of the value instead.
* Various function parameters that were asking for const reference intrinsic
type were changed to ask a copy of the intrinsic type (which is faster
than a const reference in this case).
* Fixed a small typo error in the Transform sample code.
* Small optimization on connection management for large scenes.
* Fixed a crash when calling FbxScene::ForceKill on a scene imported which
contained thumbnails.
* Made fbxiosettingspath.h header file compatible with C++x11 standard.
2013.3
* The class FbxCameraManipulator has been improved so that the FrameAll and
FrameSelected functions now take deformations into account, and also
properly adjust the camera distance for a better framing.
* Removed the FbxNode_internal class. Now all attributes of FbxNode are
visible within the FbxNode class declaration itself. This caused some
changes to the Pivot informations.
* Now the FbxCache using IFF component can scale to 64bit, allowing for
much larger cache files to be used.
* The dynamic library version of the FBX SDK library on the Windows
platform now use the static MSVCRT (/mt) rather than the dynamic MSVCRT
(/MD). This allows to distribute applications using the FBX SDK dll
without having to install the Microsoft Visual Studio Redist.
* From now on, all classes that previously overloaded Clone will now only
clone itself, and not its sources. For instance, cloning an FbxNode will
NOT clone its FbxNodeAttribute anymore. Instead, to reproduce this
behavior, one must use the FbxCloneManager which handles cloning object
networks. This now holds true for most objects of the FBX SDK. However,
objects such as meshes with their skins and clusters remain considered as
one entity.
* The class FbxScene now overload the Clone function, and uses the
FbxCloneManager to successfully clone the entire scene network.
* The FBX SDK now use default memory allocation functions when they are
called without being initialized. This only happens when static variables
are initialized before main. If you need to change the FBX SDK memory
allocation functions, make sure you are not using static FBX SDK objects
that could potentially be initialized before your main call.
* Added new functions to retrieve the memory allocation function currently
set, as well as the default ones. Please see fbxalloc.h file.
* Added support for 'locked' flags on properties. This won't prevent FBX
SDK users from changing property values, but it will allow applications
to store/retrieve the flags across. Since properties can have up to 4
members, we're using 4 bits to differenciate them.
* Fixed an issue when importing files with bump textures using foreign
languages.
* Added a bit more details to the installers detail pane on Windows.
* Fixed a crash with the Geometry Converter; duplicated edges are now
correctly detected.
* Fixed a minor issue in the ViewScene sample, concerning holes in the
mSubMeshes table.
* A lot of classes using direct pointers to objects have been corrected to
use reference properties, which makes the SDK more robust.
* Properties that have the NotSavable flag now do not write their
connections, thus making FBX files smaller.
* The ShadingModel property on FbxSurfaceMaterial inherited classes will
only be overwritten for unknown types.
* Clean-up remaining cases where the specified memory allocator wasn't
correctly used internally in the FBX SDK.
* Several classes needed an update to their ::Copy method so that all
elements are correctly copied.
* Fixed the MatrixConverter filter so that it doesn't get fooled by the
LeftHand system if the input animation has a negative scaling vector.
* Fix several issues with CharacterPose reading/writing mechanics.
* An invalid FBX reader/writer was chosen when opening older FBX files
(5.x/6.x) using FbxStream. Now the correct reader/writer are instanced.
* Fixed various warnings with FBX SDK samples on Mac/Linux.
* Fixed a crash when attempting to initialize objects before main, caused
by uninitialized memory allocation functions.
* Fixed an issue with the tangents/binormals generation in the smoothing
phase not taking into account UV seams. Now the smoothing should not
cross UV seams boundaries.
2013.2
* Basic Lambert and Phong material properties are now animatable.
* Installation paths for all FBX products is now consistent. For instance,
the FBX SDK will now install in ".../FBX/FBX SDK/20xx.x".
* Added support for FBX Python SDK on Linux 32bit.
* Added new function to evaluate camera target up, that will take into
account the Target-Up object position specified on the Node.
* Added new parameter to Readers and Writers registration process so that
now it is possible to override one, rather than just add it at the end of
the list.
* Removed dependency to WININET library on the Windows platform. Now, when
linking with the FBX SDK, no other dependency are generated. All samples
have been updated to reflect this.
* The FBX SDK library is now roughly ~10% smaller, since a lot of obsolete
code has been removed.
* The constructor and destructor mechanics have been standardized across
the whole SDK. Now, the required constructor when declaring a class that
inherit from FbxObject is defined by default in the FBXSDK_OBJECT_DECLARE
macro. If you need to execute code in the constructor or destructor, you
will need to override Construct and Destruct as detailed in the
documentation.
* The virtual function ConstructProperties signature now do not have any
return value. please update your code accordingly. As a reminder, please
do not forget to call ParentClass::ConstructProperties at the beginning
if you intend to override it.
* FbxRedBlackTree has been moved into its own file, which makes it easier
to read fbxmap.h now.
* The class FbxScopedPtr has been renamed FbxAutoPtr and has been moved
in fbxalloc.h so it is accessible by default. Also, a few basic overloads
with different deletion policy have been implemented. Those are
FbxAutoFreePtr, FbxAutoDeletePtr and FbxAutoDestroyPtr.
* All functions of the FBX SDK that used to take a ClassId or a FBX_TYPE
macro as input for filtering are now deprecated. Now, the templated
version of the same function name must be used. Since it is templated,
they now return the correct value type, and it is no longer necessary to
call FbxCast on the return value.
* Fixed an issue when specifying "ApplyTarget" with the classic evaluator.
* The tangents/binormals generation function in the FBX SDK has been
updated and now works on polygons with more than three sides.
* The class FbxExposureControl has been retired.
* The class FbxPlug has been retired.
* The function FbxProperty::GetCurve is not templated anymore.
* The function FbxObject::GetRootProperty is now deprecated. Please use the
member FbxObject::RootProperty instead.
* The function FbxCamera::GetUpVector is now deprecated. Please use
FbxCamera::EvaluateUpDirection instead.
* The function FbxCamera::ComputePerspective is now deprecated. Please use
FbxCamera::ComputeProjectionMatrix instead.
* Deprecated functions in fbxcompatibility.h file have been removed.
* The class FbxPointerGuard has been retired, because FbxAutoPtr and its
derivates replaces it.
* The function FbxArray::SetCount has been retired. Please use
FbxArray::Reserve or FbxArray::Resize instead.
* The function FbxArray::Empty is now deprecated. Please use
FbxArray::Clear instead.
* The function FbxArray::FindAfter is now deprecated. Please use
FbxArray::Find instead.
* The function FbxArray::FindBefore is now deprecated. Please use
FbxArray::FindReverse instead.
* The function FbxArray::AddMultiple is now deprecated. Please use
FbxArray::Grow instead.
* All functions in FbxObject, FbxProperty, FbxCollection and FbxDocument
that used to take a FbxClassId or an FBX_TYPE() macro, as the filtering
mechanism, are now deprecated. Please use the templated version of these
functions, such as: FbxObject::GetSrcObjectCount<Type>() or
FbxObject::GetSrcObject<Type>() The templated version returns the correct
type, so it is no longer needed to use FbxCast upon return of these
functions.
* All functions in FbxObject and FbxProperty that used to take a FbxClassId
plus an FbxCriteria have been retired instead of being deprecated,
because they didn't make sense from a logical standpoint, and can now
safely be replaced with the form Obj->Function<Type>(Criteria).
* The following functions have been made deprecated, and should be replaced
with their equivalent found in FbxObject:
FbxConnectSrc(Dst, Src) -> Dst->ConnectSrcObject(Src)
FbxConnectDst(Src, Dst) -> Src->ConnectDstObject(Dst)
FbxGetSrcCount(Obj) -> Obj->GetSrcCount()
FbxGetSrcCount(Obj, ClassId) -> Obj->GetSrcCount<Type>()
FbxGetSrc(Obj, Index) -> Obj->GetSrcObject(Index)
FbxGetSrc(Obj, Index, ClassId) -> Obj->GetSrcObject<Type>(Index)
FbxFindSrc(Obj, Name, Index) -> Obj->FindSrcObject(Name, Index)
FbxFindSrc(Obj, Name, ClassId, Index) -> Obj->FindSrcObject<Type>(Name, Index)
FbxDisconnectAllSrc(Obj) -> Obj->DisconnectAllSrcObject()
FbxGetDstCount(Obj) -> Obj->GetDstCount()
FbxGetDstCount(Obj, ClassId) -> Obj->GetDstCount<Type>()
FbxGetDst(Obj, Index) -> Obj->GetDstObject(Index)
FbxGetDst(Obj, Index, ClassId) -> Obj->GetDstObject<Type>(Index)
FbxFindDst(Obj, Name, Index) -> Obj->FindDstObject(Name, Index)
FbxFindDst(Obj, Name, ClassId, Index) -> Obj->FindDstObject<Type>(Name, Index)
FbxDisconnectAllDst(Obj) -> Obj->DisconnectAllDstObject()
* Fixed an issue with scaling inheritance not being computed properly by
the classic evaluator.
* The tangents and binormals generated by the FBX SDK will now be smoothed
according to the normal smoothing.
* Optimized tangents/binormals generation so that there not more of them
than there is normals on the mesh.
* The FBX SDK release version can now be safely linked into a debug app.
* Fixed a texture indice issue with old FBX 5.x content.
* Fixed a memory leak with runtime classes.
* The FBX SDK now uses the memory allocator in the FbxString class for all
allocations done by std::string.
* Changed the behavior of GetAnimationInterval so that it doesn't do a
union anymore. Now, the timespan parameter is always initialized properly
inside the function.
* Improved how the FBX SDK handle testing if file exist, resulting in a
faster file opening for missing assets that are over the network.
* Fixed a file crash when importing an FBX 5.x file without setting an IO
setting.
* Fix some issues with samples, as reported by users.
* Resolved issues with the memory allocator. For instance, FbxString now
use the specified memory allocator rather than the default STL allocator.
* Fixed a crash with a specific OBJ file.
* An issue with ResetPivotSetAndConvertAnimation breaking instanced mesh as
been corrected.
* Fixed multiple FBX Python SDK errors in samples.
* Fixed an issue with Collada export for meshes with multiple materials.
2013.1
* Renamed all classes with prefix "Fbx". Also renamed all structures with
the same prefix.
* Global functions and enumerations now start with the "Fbx" prefix.
* By default, the file fbxsdk_compatibility.h will be included when
including fbxsdk.h. This file defines a lot of the old class names to
help with the transition. However, if you want to use the new API, you
can define FBXSDK_NEW_API in your project and the compatibility file will
not be included, but will most likely result in a lot of errors to fix
in your application.
It is highly recommended that you start by fixing compilation errors
before defining FBXSDK_NEW_API in your project, but it is also highly
recommended to fully fix your code since the compatibility file might
be removed in a future release.
* Moved and renamed all enumerations into classes when possible.
* Moved files into appropriate folders, and grouped them.
* Removed KFbxMemoryAllocator class, instead use handlers setters functions
found in fbxalloc.h, such as FbxSetMallocHandler.
* Removed all KFCurveFilter classes, please use FbxAnimCurveFilter classes
instead.
* FbxFile is now exposed! See fbxfile.h for the list of available
functions.
* A new class, FbxFileUtils, now expose all static functions related to
file handling, such as remove or rename, etc.
* A new class, FbxPathUtils, now expose all static functions related to
file path handling, such as IsRelative or Clean, etc.
* Completely re-designed how Character Poses are stored in FBX.
* The FbxLight class has been augmented to support area lights and barn
doors.
* The FbxGeometryBase class has been augmented to support render options
such as PrimaryVisibility, CastShadow and ReceiveShadow.
* Many FBX SDK functions that were asking for file paths as inputs were
updated to support UTF-8. Their parameter names were updated to reflect
this change.
* It is now possible to retrieve the "long" version string of the FBX SDK
via the function FbxManager::GetVersion(true). This will allow developers
to get the version string of this library along with the name and the
revision number.
* Fixed various issues with sample codes.
* Now sample codes compile with warning level 4.
* Fixed an issue with animation evaluation that wasn't updated correctly
when told to.
* Fixed an issue with constraints being lost after export.
* Fixed an issue with animation evaluation sometimes returning twice the
value amount.
* Fixed an issue with RemovePolygon function on mesh class when mapping is
by polygon.
* Initial property values of LclTranslation, LclRotation and LclScaling
affect the evaluator's result when there are actually animation curves
connected to these properties. This has been corrected.
* Fixed an issue with writing cache data on Mac when a space was present
in the file path.
* Fixed a crash with xstring use in VS2010, caused by an assert.
* Improved precision in time and timecode classes.
* Changed how absolute and relative paths are handled during import. Now
if one of the two path is opening successfully, the other is changed to
work.
* Fixed an issue with the unroll animation filter.
* Now, when resampling animation, we move the default at the end rather
than at the start of the resampling.
2012.2
* Added Area Light support to KFbxLight class.
* Added Barn Doors support to KFbxLight class.
* HotSpot property on KFbxLight has been changed for InnerAngle.
* ConeAngle property on KFbxLight has been changed for OuterAngle.
* Various file I/O crashes.
* Duplicate material issue with material converter is fixed.
* Some minor fixes in sample codes.
* Fixed path issue in Collada reader.
* After writing FBX file, the scene should come back to its initial state.
* Fixed a crash on import of old scenes when it didn't contain blendshapes
or morpher data.
* Fixed issue with incorrect normals when converting from OBJ to FBX.
* Sample code "Cube Creator" was modifying the scene when exporting in OBJ,
This has been fixed.
* Fixed an issue with absolute versus relative file paths; now if one of them
is valid and the other is not, we fix the broken one.
* Fixed an issue with cache writing on Mac when there was a space in the file
name.
* Fixed an issue with the FBX exporter that would duplicate materials in very
specific conditions.
* After writing an FBX 6.x file with shapes, the scene was modified and data
was potentially lost. This has been corrected.
* Fixed an assert caused by stl string in VS2010.
* We now open FBX files in read-only mode rather than read+write. This allow
for other process to access the FBX file in parallel.
2012.1
* Added support for Image Sequences into KFbxVideo.
* Improved the reference documentation quite substantially.
* Refined how visibility inheritance works: added a new property for each
node allowing to specify if it should be inherited or not.
* Added a new option in IO Settings to import the time span found in FBX
files.
* Added a new function to KFbxAxisSystem to retrieve the front vector.
* Added a new function to KFbxAnimEvaluator and KFbxAnimEvalClassic to
allow users to calculate the local TRS from the global, with an offset.
See ComputeLocalTRSFromGlobal in kfbxanimevaluator.h for more info.
* Fix an issue with scale values of zero when passed to the matrix
converter.
* Added indentation to various parts of FBX ASCII files.
* Fixed an issue with some curves evaluating to infinite values.
* Multiple blend shapes with the same target resulted in corrupted file,
this has been corrected.
* An optimization to the file i/o reader and writer improved import
and export speed up to 60% faster.
* Fixed an issue with constant key mode in the filters.
* Changed the marker look property enum initialization to match the enum
in the header file.
* Fixed an issue in the classic evaluator which caused channels not
animated to sometimes return twice the value.
2012.0
* The FBX SDK Packaging on the Microsoft Windows platform has changed to
reduce the size of the downloads. Now the different compilers flavors are
distributed in separate installers. As a result of this, we also
uniformized the library file names across platforms.
* The file format version of FBX files as been incremented to 7.2.
There have been various small changes in the file format to support new
data.
* The preprocessor identifier that must be defined when linking with the
dynamic library version of the FBX SDK has changed from KFBX_DLLINFO to
FBXSDK_SHARED. KFBX_DLLINFO now serves no purpose. For any other FBX
SDK configuration no other preprocessor identifiers must be defined.
Note: Please change your projects to define FBXSDK_SHARED if you
intend to use the dynamic library version of the FBX SDK.
* Many improvements to the KFbxCharacter class have been made to improve
interoperability of character data with other Autodesk 3D applications.
* Support for vector displacement maps has been added to the FBX SDK.
* Support for Allegorithmic's Substance (procedural textures) has been
added to the FBX SDK core. Now the class KFbxTexture serves as the base
class for KFbxFileTexture, KFbxLayeredTexture and KFbxProceduralTexture.
KFbxFileTexture should now be used for bitmap textures, replacing
KFbxTexture.
* The Collada importer now supports the Collada 1.4.1 standard.
* New quaternion evaluation modes for rotation animation curves are now
available, equivalent to those found in Autodesk Maya.
* A new type of animation curve key has been added to the FBX SDK core to
allow for a better support of Autodesk 3dsMax "auto" keys with crease
in/out.
* Added support for Dual Quaternion Skinning. Please refer to the new class
KFbxDualQuaternion for more information.
* The visibility inheritance behavior of scene nodes have changed to better
align with popular Autodesk 3D applications.
* Many improvements to the import time of FBX files have been made.
* The memory footprint of FBX files has been reduced.
* Support for "in-between" blend shapes has been added in the FBX SDK core
to allow application plug-ins to import/export these states.
* Added five new functions to the KFbxNode class :
KFbxXMatrix& KFbxNode::EvaluateGlobalTransform(...)
KFbxXMatrix& KFbxNode::EvaluateLocalTransform(...)
KFbxVector4& KFbxNode::EvaluateLocalTranslation(...)
KFbxVector4& KFbxNode::EvaluateLocalRotation(...)
KFbxVector4& KFbxNode::EvaluateLocalScaling(...)
These functions are equivalent to calling KFbxScene->
GetEvaluator()->..., but have been made directly on the FbxNode for
convenience.
* Added a new function to the KFbxEvaluator abstract class :
void KFbxEvaluator::ResetEvaluationState()
This function enables users to completely clear the whole evaluation
cache by deleting all entries in it.
* The API documentation generated by Doxygen requires less disk space. Many
larger images have been removed to make the documentation easier to use.
* Added support for line geometry to FBX via the KFbxLine class.
* Added an option to KMemoryPool to control concurrent allocations.
Previously, the allocation was always in concurrent mode.
* The FBX SDK is now built with full optimization settings (i.e. both
size and speed) instead of being optimized for speed only.
* Roughly 25 new texture blend modes were added. Also, the default blend
mode is now Normal instead of Translucent.
* Object names will now appear in ASCII FBX files as comments in the
connection section for easier debugging.
* A new tessellation function was added to NURB curves to provide a work-
around for applications that do not support them. The tessellation will
produce a KFbxLine object (a series of vertices).
* A new file, fbxfilesdk_version.h has been added that contains all the
versioning information of the FBX SDK. It also defines a new preprocessor
identifier FBXSDK_VERSION_STRING that represents the version information
as a string.
* Ptex files can be transported just like any other texture format (png,
jpeg, etc.) provided that they are connected to a material property. For
more information about Ptex please visit http://ptex.us/documentation.html
* A new function KFbxImporter::SetEmbeddingExtractionFolder as been added
to allow developers to specify an extract folder when importing FBX files.
* New functions added to KFbxCache class: GetNextTimeWithData(),
GetDataCount() and GetDataTime().
* All FBX related DLLs shipped are now officially signed with the Autodesk
certificate.
* The two KFbxSdkManager::CreateClass(...) functions have been marked
deprecated and KFbxSdkManager::CreateNewObjectFromClassId(...) should be
used instead.
* The methods KFbxNode::Set/GetUseQuaternionForInterpolation() have been
marked deprecated. Their usage should be replaced with calls to
KFbxNode::Set/GetQuaternionInterpolation() respectively. These new
methods are using the following enumeration symbols to activate new
evaluation algorithms:
eQUATINTERP_OFF = 0
eQUATINTERP_CLASSIC = 1
eQUATINTERP_SLERP
eQUATINTERP_CUBIC
eQUATINTERP_TANGENTDEPENDENT
The eQUATINTERP_OFF is equivalent to the old way of passing the "false"
value to the parameter of the SetUseQuaternionForInterpolation() while
eQUATINTERP_CLASSIC correspond to the "true" value. The classic mode call
the evaluation algorithm that has been defined in the FBX SDK from the
earlier versions.
* The methods KFbxSdkManager::CreateClass have been deprecated in favor for
a new function, KFbxSdkManager::CreateNewObjectFromClassId(...) which
removes non-used parameters, and combine all functions into this single
call. The new function name also clearly indicate that a new object
instance is created, rather than a new class.
* The methods to access the properties of KFbxSurfaceMaterial and sub-class
have been deprecated. Now users can simply access the properties directly
just like any other FBX SDK object class.
* Many functions of KFbxShape have been deprecated with the introduction
of the support for in-between blendshapes.
* The .3DS file format writing as been retired. However, the .3DS file
reader will persist.
* The mDEBUG_String member was removed from the KString class to make sure
the debug and release version are the same size. As a result of this, to
debug the KString class on the Microsoft Windows platform, please open
and read the file kstring.txt provided along this readme.txt file.
* The static libraries are now built with _SECURE_SCL=1, which is the
default value when not specified by projects. If your project used to
define _SECURE_SCL=0 just to be able to link with the FBX SDK, then it
can now be safely removed from the predefined preprocessor identifiers.
* KFbxObject::Clone has been reviewed, and now offers an implementation
that should fit most, if not all, cloning logic for all classes that
inherit from KFbxObject. As a result objects that don't implement Clone
behave correctly and similarly across the SDK.
* Fixed an issue in the conversion of Euler value to quaternion values with
some corner cases.
* The FBX SDK no longer requires RTTI to be enabled by the host software.
This also means dynamic_cast can no longer be used to convert FBX SDK
objects. KFbxCast<CLASSTYPE> should be used instead.
* The class KFbxSurfacePhong can now be converted into its parent class,
KFbxSurfaceLambert, using KFbxCast.
* The properties of KFbxSurfaceMaterial and all its sub-classes are now
declared public.
* The function KFbxObject::GetTypeName() has been re-vamped to return a
const char* type instead of KString. Many classes that were
re-implementing this function without reason have been cleaned-up
throughout the SDK.
* The function ResetPivotSetAndConvertAnimation will now also iterate
through all animation stacks instead of just the first one it finds in
the scene.
* Fixed a crash wih KFbxAnimEvaluator::SetContext(...).
* A pragma pack directive was added to the file fbxsdk.h to set it to the
value used when the FBX SDK was compiled. This will allow developers
to include the FBX SDK in their project without having to worry about the
packing size used by their application.
* KFbxCache::GetChannelIndex() should return -1 instead of 0 when error
occurs or channel not found.
* Fixed several issues and memory leaks in FBX SDK sample codes.
* KString size in debug and release should now be the same, which fix the
crash resulting of that incompatibility.
* The Microsoft Visual Studio 2008 builds are now compiled using the
Service Pack 1.
* Added the const qualifier to several functions and members.
* Stereo Cameras now have the correct post-rotation set on export.
* An issue with multiple property-to-property connections in FBX files has
been corrected.
* An optimization to the way we allocate animation curves has been done to
improve the destroy speed with large scenes.
* Fixed an issue in KFbxMesh::TriangulateMeshAdvance(), an incorrect mesh
smooth group was set when the original mapping mode was "by edge".
* An issue with skew matrix in the classic evaluator has been fixed.
2011.3.1
* All functions related to local and global "state" in the KFbxNode
declaration were removed since their implementation didn't work anymore
since the last release. They should have been set to deprecated within
the header files, but they were forgotten.
* The unroll filter was inconsistent when applying its process on curves
data, this has been corrected.
* Fixed a crash in the function EmulateNormalsByPolygonVertex.
* Visual Studio 2010 builds were reporting missing PDB files, this has been
corrected.
* Importing various .OBJ file sometime resulted in much more vertices, this
is now working as intended.
* The mesh triangulation method has been re-written for a much more robust
algorithm. Now it can handle non-concave shapes. The method can be called
using TriangulateMeshAdvanced.
* A conversion error from Euler to Quaternion has been corrected, it is now
much more robust for corner cases.
2011.3
* The FBX SDK is now also ship in a dynamic library package format. To link
against the dynamic version, users will have to define KFBX_DLLINFO in
their project preprocessor settings. The static version still doesn't
require any preprocessor to be defined.
* Augmented the KFbxCache class to correctly support multiple data channels.
* Stereo Cameras now correctly support aim/up.
* Added three new functions to the KFbxAnimEvaluator class :
KFbxVector4& GetNodeLocalTranslation(...)
KFbxVector4& GetNodeLocalRotation(...)
KFbxVector4& GetNodeLocalScaling(...)
Allow users to calculate the local translation, rotation and scaling as it
was done in previous versions of the FBX SDK. On purpose, these new
functions will not take pre/post rotations, offsets and pivots in
consideration, but they still will consider translation, rotation and
scaling limits.
* Added the new KFbxCachedEffect node attribute. These are used to store
other kind of vertex (or position) caching.
* Fixed a crash at import time for various legacy FBX files when importing
animation curves data.
* Some UV Sets were lost in very specific cases during export, this has
been corrected.
* Fixed an issue with node's local transform calculation. Now it should
correctly return the result of ParentGlobal.Inverse * Global.
* Protein 2.0 Materials are now extract in the .fbm folder along the .fbx
file first, rather than the user's operating system temporary folder.
* The following files contain many newly deprecated calls. Please open them
and search for the macro K_DEPRECATED to find out. Because the list is so
big, it will not be listed here.
kfbxconstraint.h, kfbxconstraintaim.h, kfbxconstraintparent.h,
kfbxgeometry.h, kfbxnode.h, kfbxscene.h, kfbxkfcurvefilters.h,
kfbxdocument.h, kfbxreaderfbx.h, kfbxreaderfbx6.h, kfbximporter.h,
kfbxproperty.h
2011.2
* Officially dropped support for PowerPC architecture. Universal binaries
found in MacOS builds will now only contain 32/64-bit variances.
* Fixed a crash when importing some legacy MotionBuilder FBX 5.x files.
* Corrected the computation of the smoothing group for in mesh triangulation
function.
* Fixed Localization problems on the DAE, DFX and OBJ readers/writers.
* Extended the file size limit for FBX files from 2GB to 4GB.
* Augmented the Reference Documentation for a certain number of classes. For
example, check out KFbxNode or KFbxObject and tell us what you think! :)
2011.1
* Removed the KFbxTakeNodeContainer class. This was done with the redesign
of the animation system.
* A whole new set of classes are now available to evaluate animation with
the FBX SDK. For more information, please look at the reference
documentation for KFbxAnimStack, KFbxAnimLayer, KFbxAnimCurve,
KFbxAnimCurveNode, KFbxAnimEvaluator and KFbxAnimEvalClassic classes. Also
the evaluation result will now be stored outside the KFbxNode class and
only created on demand, resulting in a much smaller memory footprint.
* Removed all needed preprocessor defines to be able to correctly link with
the static version of the FBX SDK. Namely, those defines were K_PLUGIN,
K_FBXSDK and K_NODLL.
* The FBX file format as now been upgraded to our latest new technology,
FBX 7.1! This new FBX file format allow for much more flexibility,
supporting any number of instances, connections by GUID, reduced file size
with compression, embedding in ASCII files and much more!
* The KFbxSystemUnit class changed so that it doesn't modify the multiplier
parameter. Now it is simply carried along in the FBX file.
* A Python Binding for FBX SDK has been released for the first time! In this
first release, only the most basic functions to allow import/export and
scene traversal and property query has been exposed. More will be exposed
later on when we gather more feedback from user experience.
2010.2
* Improved processing speed of the function to retrieve polygon's indexes in
the mesh class KFbxMesh.
* Removed SetFileFormat on all classes that inherit from KFbxImporter and
KFbxExporter. Instead, the file format can be overwritten in the
Initialize functions. By default, the file format will now be auto-
matically be detected.
* Extended the KFbxMesh class to support standard mesh smoothing. We are
referring to edge/vertex creases, mesh smoothness, division levels,
subdivisions, continuity and border/edge preservation.
* Added Stereo Cameras support via the KFbxCameraStereo class.
* Added Display Layer and Selection Sets support via the KFbxDisplayLayer
and KFbxSelectionSet classes respectively.
* Fixed an issue preventing the use of the slash ( / ) character in property
names.
* Fixed a stack overflow error in KFbxRenamingStrategy.
* Added support for many new texture blend mode. See KFbxLayerElementTexture
for more information.
* Files not ending in .fbx but that still contain FBX formatting can now
successfully be opened with the FBX SDK.
* Properties can now be destroyed with KFbxProperty::Destroy().
* Fixed FBX 5.x reader to correctly set pivot information when importing
legacy files.
2010.0
* Dropped support for Microsoft Visual Studio 2003 libraries.
* Many, many issues fixed. Please refer to previous readme versions for more
details.
2009.x
* KFbxCache class supports int array.
* Added the Subdivision Display Smoothness to the KFbxSubdiv class.
* Added the optional argument to the IsValid() method in the KFbxTrimSurface
class to skip the check of boundary curves CV's overlaps.
* Re-factoring of the KFbxCamera class.
* Updates to class documentation.
* Added methods and properties to manipulate front/back planes & plates.
* Deprecated ECameraBackgroundDrawingMode type and replaced with
ECameraPlateDrawingMode
* Deprecated ECameraBackgroundPlacementOptions. This has been replaced with
the individual properties: FitImage, Center, KeepRatio and Crop.
* Deprecated GetBackgroundPlacementOptions() since now the flags are stored
in the above mentioned properties.
* Deprecated SetViewFrustum(bool pEnable), use SetViewNearFarPlanes()
* Deprecated GetViewFrustum(), use GetViewNearFarPlanes()
* Support of non-convex polygons in the triangulation algorithms.
* Overload of the new operator is not possible anymore (the
FBXSDK_OVERLOAD_NEW_OPERATOR macro has been removed). The usage of the
custom memory allocator can only be achieve by using the
KFbxMemoryAllocator class. See the ExportScene05 for an implementation
example.
* Enhanced algorithm for smoothing groups generation.
* Support of displacement map channel.
* The class KFbxStreamOptions is now obsolete and is gradually being
replaced by the class KFbxIOSettings.
* Added KFbxConstraintCustom class.
* Added KFbxContainerTemplate class.
* Added KFbxSubdiv class.
* Added KFbxEmbeddedFilesAccumulator class.
* Adjusted tangents to stay closer to the real value when the weight gets
ridiculously small.
* Fixed Collada plug-in to handle operating system locale. Depending on the
locale, the decimal point for numbers may have been represented with the
comma instead of the point causing parsing errors.
* Fixed support for the floor contact to the KFbxCharacter.
* Fixed infinite loop when loading .obj files on MAC OS.
* Removed some more memory leaks.
* Added the HasDefaultValue(KFbxProperty&) function to check if a property
value has changed from its default one.
* Added the BumpFactor property to the SurfaceMaterial class.
* Defined plug-ins of plug-ins interface in the fbxsdk manager. See the
Autodesk FBX SDK PRW readme file for more details.
* Re-factoring of the renaming strategy object.
* Removed unused eCONSTRAINT from the KFbxNodeAttribute.
* Deprecated FillNodeArray and FillNodeArrayRecursive
* Overwrite empty relative filename in texture objects with the correct
value.
* Fix for internal TRS cache so it correctly get reset when changing takes.
* Bug fixes in the Collada reader/writer.
* Fixed a bug that was causing the loss of Shape animation on NURBS objects.
* Fixed the fact that the layers were losing their name after a clone.
* Corrections for pivot conversion functions:
- Set source pivot to ACTIVE in function ResetPivotSetAndConvertAnimation.
- Update default transformation values to match the results of the pivot
conversion functions.
* Fixed the endless loop in the RemoveChar() method of the KString class.
* Fixed default values in the KFbxCharacter structure.
4. LEGAL DISCLAIMER
-------------------
Autodesk and FBX are registered trademarks or trademarks of Autodesk, Inc., in
the USA and/or other countries. All other brand names, product names, or trade-
marks belong to their respective holders.
Copyright (C) 2018 Autodesk, Inc.
All Rights Reserved
================================================================================
About
No description, website, or topics provided.
Resources
License
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published