Rasagar/Library/PackageCache/com.unity.formats.fbx/CHANGELOG.md

# Changes in Fbx Exporter

## [5.1.1] - 2024-03-18
### Changed
- Updated the FBX SDK bindings to 5.1.1.

## [5.1.0] - 2023-09-18
### Changed
- Updated the FBX SDK bindings to 5.1.0.
- Refactored the whole user manual to consolidate the content and improve usability.

## [5.1.0-pre.1] - 2023-05-02
### Added
* Export camera focus distance and use depth of field properties.

## [5.0.0] - 2022-11-15
### Changed
- Updated the FBX SDK bindings to 5.0.0.
- Updated supported Unity, Maya and Max versions in the documentation.

## [5.0.0-pre.1] - 2022-09-07
### Added
- Exposed FBX Recorder Settings class to the public API.
- Exposed functions to pass export options on export to the public API.
- Exposed function to convert to prefab variant to the public API.

### Changed
- Added support for exporting texture offset, scale and wrap mode. Thank you to @hybridherbst for the additions.
- Updated the minimum Unity version to 2020.3.
- Updated the minimum Recorder version to 4.0.0.
- Updated the FBX SDK bindings to 5.0.0-pre.1.

### Fixed
- Cache result of SelectionContainsPrefabInstance in Editor Window to avoid unnecessary recalculations.
- Use lists instead of dictionaries for property channel maps in order to ensure consistent order of operations.
- Add optimizations to speed up convert to prefab variant.
- Improve formatting and functions of the FBX exporter. Thank you to @smitdylan2001 for the contributions.
- Fix errors when opening FBX export project settings on Linux.

## [4.2.0] - 2022-07-07
### Changed
- Add more details to documentation for material and texture export.
- Add troubleshooting documentation for exporting camera animation only from Maya plugin.

### Fixed
- Fix FBX recorder does not record blendshape animation.
- Fix only 4 uvs exported instead of 8.

## [4.2.0-pre.1] - 2022-04-20
### Changed
- Added export options to Keep Instances and Embed Textures. Thank you to @hybridherbst for the additions.
- Updated to the default file version, which allows exporting large binary FBX files. Make sure to update to Blender 2.79 or later to read these files.
- Moved Timeline Clip export menu from "GameObject > Export Selected Timeline Clip..." to Timeline Clip context menu.

## [4.1.2] - 2021-09-19
### Changed
- Added the ability to export meshes using more than 4 skin weights per vertex.

## [4.1.1] - 2021-09-03
### Changed
- Use EditorGUIUtility's GetIcon and SetIcon instead of reflection for prefab icons.

### Fixed
- Fixed one namespace being stripped instead of just the root namespace if all namespaces are unique.

## [4.1.0] - 2021-07-06
### Changed
- Update from prerelease to released package.
- Updated the FBX SDK bindings to 4.1.0.

## [4.1.0-pre.3] - 2021-06-28
### Changed
- Updated the FBX SDK bindings to 4.1.0-pre.3.

### Fixed
- Fix Fbx Export Project Settings break if they are open when changing scenes.
- Fix specular texture not being exported.
- Fix NullReferenceException if materials are null.
- Fix NullReferenceException if animation is missing.
- Fix error when exporting object with empty name.
- Fix misaligned text in export file name field.
- Fix warning about missing metafiles.
- Fix warning about using absolute paths when overwriting an fbx file.
- Fix exporting zero scale not importing correctly in 3ds Max.
- Fix window size cutting off text in export window.
- Fix object name not being undone after undo convert to prefab.
- Fix settings reset button not working.
- Fix not being able to export to a new folder on Mac.
- Fix hdrp materials being exported with max incandescence.
- Fix warning about ExportSettings not being in a file called ExportSettings.cs.
- Fix exception when exporting a missing or null mesh.
- Fix incorrect skinning if character bone hierarchy contains objects that do not have a bindpose.

## [4.1.0-pre.2] - 2021-05-05
### Known Issues
- FBX exporter integration with Probuilder broken with Probuilder 5.0.3. Exporting a Probuilder object may break the original object.

## [4.1.0-pre.1] - 2021-04-29
### Added
- Added ability to export blendshape animations when the "Animated Skinned Mesh" Export Option is selected.

### Changed
- Updating the minimum required version of the Unity Recorder package to 2.5.5.
- Updating the minimum required version of the Timeline package to 1.5.2.
- Updated the FBX SDK bindings to 4.1.0-pre.1.

## [4.0.1] - 2021-03-10
### Changed
- Update from prerelease to released package.
- Updated the FBX SDK bindings to 4.0.1.

## [4.0.0-pre.4] - 2021-01-26
### Fixed
- Fix ArgumentNullException on Linux when opening Export Options window.

## [4.0.0-pre.3] - 2021-01-13
### Changed
- Added missing release date information to changelog.
- Moved Asset Store update information to separate page in documentation.
- Moved Developer Guide to Scripting API index page.
- Reviewed the documentation overall.
- Fix missing icon error when using FBX recorder with Unity Recorder 2.5.2.

### Known issues
- Exporting an empty mesh (MeshFilter with null sharedMesh), fails to export with ArgumentNullException.

## [4.0.0-pre.1] - 2020-10-16
### Changed
- The Export and Convert to Prefab options can now be changed in the FBX Export Settings in Edit > Project Settings > Fbx Export.
    - The Export and Convert to Prefab Options windows will use these settings by default.
    - When modifying the settings in the Export/Convert to Prefab windows, the Project Settings are no longer updated, but the changes persist for the remainder of the Unity session.
- Disable buttons such as the "Install Integration" button when editing an FBX export setting preset.
- Rename "Show Convert UI" in project settings to "Display Options Window" and use it for both the Convert and Export windows instead of just the Convert to Prefab window.
- Updated the FBX SDK bindings to 4.0.0-pre.1
    - Made FBX SDK bindings Editor only so they are not copied into builds by default. In order to use at runtime, 
      add the FBXSDK_RUNTIME define to Edit > Project Settings... > Player > Other Settings > Scripting Define Symbols.
- Use DeepConvertScene from Autodesk® FBX SDK to convert from Unity (left handed system with odd parity) to Autodesk® Maya® (right handed system with odd parity) axis system.
    - Previously the conversion was performed by the FBX exporter.
    - For the majority of cases there will be no noticeable difference in the final export result. If any custom export code that is affected by the axis system has been added or modified, it will
      need to use Unity's axis system (left handed with odd parity), instead of converting directly to Autodesk® Maya®'s.
    - There may be discrepancies in the Aim constraint and Parent constraint export result compared to before, however these should still import correctly into Autodesk® Maya® and other DCCs.
- Export animation curve tangents instead of baking animation.
    - For more details see https://docs.unity3d.com/Packages/com.unity.formats.fbx@4.0/manual/exporting.html#animation
- Change dependency on Unity Recorder to an optional one so it is no longer immediately installed when installing the FBX exporter package.
- Update minimum supported Unity version to 2019.4.

### Fixed
- Fix Export Model and Convert to Prefab Variant setting presets not serializing settings properly.
- Fix NullReferenceException when modifying a preset for the FBX export settings in Edit > Project Settings > Fbx Export.
- Fix error in an export when the project settings are not writeable (e.g. if you're using Perforce).
- Fix Compatible Naming checkbox not aligned properly in Export/Convert UI.
- FBX SDK bindings no longer included in builds, fixing an issue with shipping on the Mac App Store.

### Known issues
- Negative scale will not export properly.
    
## [3.2.1-preview.2] - 2020-08-05
### Added
- Add an export option to preserve model import settings when overwriting an fbx file.
- Add the option to export FBX files outside of the Assets folder.

### Changed
- Renamed label in Autodesk® Maya® from Unity Fbx Namespace to Strip Specific Namespace.
- Renamed Export as FBX Linked Prefab to Export as FBX Prefab Variant.
- Mesh instances are now exported as instances of a single mesh instead of exporting multiple, identical meshes.
- Updated to latest com.autodesk.fbx (3.1.0-preview.2).
- Updated minimum supported Unity version to 2018.4.

### Fixed
- No longer initiate export if no objects are selected in Autodesk® 3ds Max®.
- Added a null check for bones, so export no longer fails if a skeleton has missing bones.
- Fix incorrect relative paths for textures in FBX files.
- Fix for Editor focus lockup when creating an FBX Prefab Variant on Mac.

## [3.2.0-preview.2] - 2020-05-19
### Added
- Added an option to the Autodesk® Maya® integration Unity menu for creating an export set.
    - The option can be found in File > Unity > Create Export Set
    - Selecting this option will open a dialog allowing the user to select the desired export locations for model and animation files.
    - File > Unity > Export [Model Only|Animation Only] will also open the same dialog if the objects selected for export
      are not already in an export set.

### Changed
- Do not search for Autodesk® installs in `D:/Program Files/Autodesk` (not a standard drive).
- Update Unity Recorder dependency to version 2.2.0-preview.4.

### Fixed
- Added a null check when inspecting whether a Timeline Clip is selected for export. This fixes a NullReferenceException when an object in the selection is null.
- Fix issue where different Materials and Meshes with identical names export as a single material/mesh.
- Fix skinned mesh always exports in bind pose regardless of current pose.
- Import/Export in Maya Integration fails if FBX Import/Export settings file missing.

## [3.1.0-preview.1] - 2020-04-02
### Fixed
- Blendshapes naming in FBX so that multiple blendshapes all import correctly in Autodesk® Maya®. Thank you to @lazlo-bonin for the fix.
- Don't override transforms when creating FBX Linked Prefab, so that the prefab updates properly when the FBX transforms are modified.
- Changed FBX Linked Prefab to keep Unity materials instead of using materials exported to FBX file.
    - To revert to using the FBX materials in the Linked Prefab, open the prefab editor and remove the material overrides.
- Fix issue where root bone is imported as null object in Autodesk® Maya® if it doesn't have any descendants that are also bones.
- Don't reduce keyframes after recording as it can create unnecessary errors/discrepancies in the exported curve.
- Updated to latest com.autodesk.fbx (3.0.1-preview.1), to fix DLL not found errors if building for non-standalone platforms (e.g. Android, WebGL).

## [3.0.1-preview.2] - 2020-01-22
### Added
- Added option to export geometry when recording with the FBX recorder (in previous version geometry was always exported).
- Added settings to transfer animation between two transforms in the recorded hierarchy.

### Fixed
- It is now possible to record animated characters with the FBX recorder.

## [3.0.0-preview.2] - 2020-01-13
### Added
- Added FBX Recorder to record animations from the Unity Recorder directly to FBX (adds dependency to Unity Recorder).
- Export animated focal length and lens shift of cameras.

### Changed
- Updated dependency to com.autodesk.fbx version 3.0.0-preview.1, which means we update to [FBX SDK 2020](http://help.autodesk.com/view/FBX/2020/ENU/).

### Fixed
- Fixed camera aspect and gate fit exporting as incorrect values.

### Known Issues
- Using the FBX Recorder to record animated characters is not supported yet, and fails in some cases.

## [2.0.3-preview.3] - 2019-09-24

FIXES
* Integrations were missing in 2.0.2 and 2.0.1 due to a packaging bug. They are back now.

## [2.0.2-preview.1] - 2019-06-20

NEW FEATURES

* It is no longer necessary to manually create Prefab Variants for FBX files. 
* Added **Convert to FBX Linked Prefab** menu item for creating FBX Linked Prefabs. FBX Linked Prefabs are Prefab Variants of the exported FBX's Model Prefab.
* Updated the documentation.

FIXES
* Fixed error when exporting selected Timeline Clip

## [2.0.1-preview.11] - 2019-04-10

CHANGES
* Fixed ExportTimelineClipTest failing in unit tests.

## [2.0.1-preview.10] - 2019-04-01
FIXES
* Fixed the integration files that were still missing. These were ignored by ``.npmignore` (created when running Package Validation).

## [2.0.1-preview.9] - 2019-04-01
FIXES
* Fixed the missing integration files in the previous release.

## [2.0.1-preview.8] - 2019-03-29
FIXES
* Fixed the `FbxExportSettings` compile error on 2018.3.

## [2.0.1-preview.7] - 2019-03-22
FIXES
* Fixed the issue where the Autodesk® 3ds Max® 2020 integration was hanging during installation.
* Fixed the duplicate DCCs showing in the integration install dropdown menu if `MAYA_LOCATION` was set.

## [2.0.1-preview.6] - 2019-02-08
CHANGES
* Updated the `package.json` manifest file.
* Reverted the change to the Runtime asmdef file.
* Fixed the non-deterministic behavior in tests.
* Updated the dependence on **com.autodesk.fbx** to version **2.0.0-preview.7**.

## [2.0.1-preview.5] - 2019-02-01

CHANGES
* Updated the dependence on **com.autodesk.fbx** to version **2.0.0-preview.6**.
* Updated the asmdef files to only include Editor platforms.

## [2.0.1-preview.4] - 2019-01-31
CHANGES
* Updated the **unityRelease** version in the `package.json` manifest file.

## [2.0.1-preview.3] - 2019-01-24
CHANGES
* Moved tests to a separate `.tests` package
* Added a dependency on Timeline.
* Export of blendshapes is experimental, YMMV.

## [2.0.1-preview.2] - 2018-12-05

CHANGES
* Updated the dependence on **com.autodesk.fbx** to version **2.0.0-preview.4**.

## [2.0.1-preview.1] - 2018-12-04
CHANGES
* Updated the dependence on **com.autodesk.fbx** to version **2.0.0-preview.3**.

## [2.0.1-preview] - 2018-11-13
NEW FEATURES
* For Unity 2018.3 and later, Prefab Variants replaced Linked Prefabs. Linked Prefabs were created by adding an `FbxPrefab` component to a Regular Prefab in order to connect it to an FBX file.
* The **Convert To Linked Prefab** menu items have been removed.
* Updated the documentation.

FIXES
* Fixed the error when exporting SkinnedMesh with bones that are not descendants of the root bone.
* Fixed an issue where animation-only exporting was not actually exporting animation in v2.0.0.
* Fixed calculating the center of root objects when exporting "Local Pivot"/"Local Centered".

KNOWN ISSUES
* In Unity 2018.3, exported blendshape normals may not match the original blendshape normals.

## [2.0.0] - 2018-06-22
NEW FEATURES
* The FBX Exporter is now distributed via the Package Manager.
* Added support for Physical Cameras
* The FBX Exporter is now compatible with Unity 2018.2.
* Roundtripping Assets can now be started from Autodesk® Maya® with Assets that have not been exported from Unity.
* The DCC integration plug-in sources have been removed from the packages folder. You can still find them in the zip file.
* The FBX Exporter now uses the FBX SDK version 2018.1.
* Conformed to Unity's API guidelines.
* Added support for exporting constraints (Rotation, Aim, Position, Scale, and Parent).
* ConvertToPrefab: Add the ability to convert an FBX file or a Prefab Asset from the Project view.
  * Right-click on an FBX file in the Project view and then select **Convert to Linked Prefab** to create a Linked Prefab Asset for the FBX file. It will not create an instance in the Scene.
  * Right-click on a Prefab in the Project view and select **Convert to Linked Prefab** to export the Prefab to an FBX file and link the existing Prefab to the newly created FBX file.

FIXES
* Fixed skinned mesh bone update when the number of bones changes between updates.
* Keyframes were sometimes missing when exporting animation curves.
* Fixed the visibility of the file name fields in the FBX Export dialog in Unity Pro's dark theme.

KNOWN ISSUES
* ConvertToPrefab: the UI doesn't provide feedback about whether it will convert an existing file or create new files.
  * When converting an existing FBX file, the FBX filename and FBX Export options are ignored (but not greyed out).
  * When converting an existing Prefab, the Prefab filename is ignored (but not greyed out)

## [1.7.0] - 2018-06-01

FIXES

* Fixed violations of the C# Framework Design Guidelines (FDG).
* Fixed errors reported while running the Package Validation Suite.

## [1.6.0] - 2018-05-29

NEW FEATURES

* Added support for Physical Cameras.

FIXES

* Fixed skinned mesh bone updates.

## [1.5.0] - 2018-05-22

NEW FEATURES

* Roundtripping Assets can now be started from Maya using Assets that have not been exported from Unity.
* DCC integration plug-in sources have been moved out of the package.
* The Windows version is now using the FBX SDK version 2018.1.1.
* Streamlined public interface for the `ModelExporter` class.

FIXES:

* The DCC integration plug-ins now work with the Package Manager.

## [1.4.0] - 2018-04-23

NEW FEATURES

* The FBX Exporter is now distributed via the Package Manager.
* The FBX Exporter now exports Unity constraints to FBX.
* The FBX Exporter now adds the ability to convert an FBX or Prefab Asset from the Project view.

FIXES:

* The FBX Exporter is now compatible with Unity 2018.2.0b3.
* Fixed an issue where the last frame was sometimes not exported.
* Fixed an issue where the FBX export dialog was hard to read in Unity Pro's dark theme.

KNOWN ISSUES

* The UI doesn't provide feedback about whether it will be converting an existing file or creating new files with ConvertToPrefab.
* When converting an existing FBX file, the FBX Filename and FBX Export options are ignored (but not greyed out).
* When converting an existing Prefab, the Prefab Filename is ignored (but not greyed out).

## [1.3.0] - 2018-04-17
NOTES
* This is the last Asset Store version. It is also known as 1.3.0f1.

NEW FEATURES
* `Unity3dsMaxIntegration`: 
	* Allows multiple file import.
	* Allows multiple file export by scene selection.
* `FbxExporter`: Export animation clips from Timeline
* `FbxExportSettings`: 
	* Added new UI to set export settings.
	* Added option to transfer transform animation on export.
	* Added option to export model only.
	* Added option to export animation only.
	* Added option not to export animation on skinned meshes.
	* Added option to export meshes without renderers.
	* Added LOD export option.
* `UnityMayaIntegration`: 
	* Allows multiple file import.
	* Allows multiple file export by scene selection.
* `FbxPrefabAutoUpdater`: Added new UI to help manage name changes.
* `FbxExporter`: 
	* Added support for exporting Blendshapes.
	* Added support for exporting SkinnedMeshes with legacy and generic animation.
	* Added support for exporting Lights with animatable properties (Intensity, Spot Angle, Color).
	* Added support for exporting Cameras with animatable properties (Field of View).
	* Added ability to export animation on transforms.
* Added one-button import and export for Autodesk® Maya®, Autodesk® Maya® LT, and Autodesk® 3ds Max®.
* Added Camera export support.
* Added the ability to export FBX files from Unity.
* Added a linked Prefab converter to create a Prefab that auto-updates with the linked FBX file.

FIXES
* `ConvertToPrefab`: 
	* Fixed an issue where the Mesh Collider was not pointing to the exported Mesh after conversion.
	* Now no longer re-exports FBX Model instances.
* `FbxExporter`: 
	* Fixed an issue where Compatible Naming doesn't modify the Scene while exporting.
	* Now links Materials to objects connected to Mesh instances.
	* Now exports Meshes in Model Prefab instances as Mesh instances in the FBX file.
	* Fixed an issue where animating spot angle in Unity was failing to animate the cone angle in Autodesk® Maya® (not the penumbra).
	* Now exports the correct rotation order (xyz) for euler rotation animations (previously would export as zxy).
* `FbxExportSettings`: Fixed the console error on Mac when clicking **Install Unity Integration**.
* Fixed Universal Windows Platform build errors caused by `UnityFbxSdk.dll` being set as compatible with any platform instead of the Editor only.
* Fixed an issue where Object references were lost when using **Convert to Linked Prefab Instance**.
* Fixed an issue with Autodesk® Maya® Integration dropdown not appearing in the FBX Export options.

KNOWN ISSUES
* Cannot export animation only from Autodesk® 3ds Max®.
* `FbxExporter`: 
	* Animated skinned Meshes must be in the bind pose on export (that is, not being previewed in the Animation or Timeline windows, and the original rig's FBX must not contain animation).
	* Animated Meshes in bone hierarchy are not supported.
	* For skinned Meshes, all bones must be descendants of the root bone.
* `3DIntegration`: FBX files containing rigs must have file units in centimeters in order to properly apply animation exported from Unity.
* `ConvertToPrefab`: Converting Model instances that have been modified in the Scene won't re-export the FBX file.
* Requires Unity 2018.1.0.
* When exporting with an animated transform for a Camera or a Light, the resulting rotation does not take the forward direction into account and is off by 90 degrees.
* The FBX Exporter does not export key tangents and the default key tangent setting is different between Unity, the FBX SDK and Autodesk® Maya®. This causes the curve shape to change between Unity and Autodesk® Maya®.
* The FBX Exporter does not maintain animated continuous rotations.
* The FBX Exporter does not convert animated rotations with Euler Angles (Quaternion) or Quaternion interpolation, to the correct Euler equivalent.