You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Packages/com.unity.formats.fbx/Documentation~/com.unity.formats.fbx.md
+27-18Lines changed: 27 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,11 +2,11 @@
2
2
3
3
__Version__: 2.0.0-preview
4
4
5
-
The FBX Exporter package provides round-trip workflows between Unity and 3D modeling software. Use this workflow to send geometry, Lights, Cameras, and animation from Unity to Maya, Maya LT, or 3ds Max, and back again, with minimal effort.
5
+
The FBX Exporter package provides round-trip workflows between Unity and 3D modeling software. Use this workflow to send geometry, lights, cameras, and animation from Unity to Maya, Maya LT, or 3ds Max, and back again, with minimal effort.
6
6
7
7
The FBX Exporter package includes the following features:
8
8
9
-
*[FBX Exporter](#ExportFBX): Export geometry, animation, Lights, and Cameras as FBX files so you can transfer game data to any 3D modeling software. Record gameplay and export it to make cinematics. Start grey-boxing with ProBuilder, then export to FBX to replace with final assets.
9
+
*[FBX Exporter](#ExportFBX): Export geometry, animation, Lights, and Cameras as FBX files so you can transfer game data to any 3D modeling software. Record gameplay and export it to make cinematics. Start grey-boxing with [ProBuilder](https://unity3d.com/unity/features/worldbuilding/probuilder), then export to FBX to replace with final assets.
10
10
11
11
*[Linked Prefab](#LinkedPrefab): Link a Prefab to a new or existing FBX file. When you later change the FBX file, Unity automatically updates the Prefab to integrate changes to the transforms and hierarchy (in addition to Meshes and Materials). This helps you avoid rebuilding your Prefabs from scratch.
12
12
@@ -36,9 +36,7 @@ The FBX Exporter package contains:
36
36
37
37
* FBX Exporter
38
38
* FBX Prefab Component
39
-
* Integration with 3D modeling software (3ds Max and Maya)
40
-
41
-

39
+
* Integration with 3D modeling software
42
40
43
41
## Known Issues
44
42
@@ -96,20 +94,24 @@ The FBX Exporter exports the following objects:
96
94
* Binormals
97
95
* Tangents
98
96
* Vertex Colors
99
-
* All 4 Mesh UVs, if present
97
+
* All 8 Mesh UVs, if present
100
98
* Quads or Triangles
101
99
* SkinnedMeshRenderers with the following exceptions:
102
100
* Humanoid rigs are not supported
103
101
* Animated meshes in bone hierarchy are not supported
104
102
* Materials as Phong if the material has specular; Lambert in all other cases
105
103
* Textures
106
-
* Cameras as film cameras with 35mm TV Projection; also the following camera attributes:
104
+
*Game Cameras as film cameras with 35mm TV Projection; also the following camera attributes:
107
105
* Projection type (perspective/orthographic)
108
-
* Aperture Width and Height (Height set to 0.612 inches, and width calculated based on aspect ratio)
106
+
* Aperture Width and Height (Height set to 0.612 inches, and width calculated based on aspect ratio; for Game Cameras, aspect ratio is dictated by the display viewport)
109
107
* Aspect ratio
110
108
* Focal length
111
-
*Field of view
109
+
*Vertical field of view
112
110
* Near and far clipping plane
111
+
* Physical Cameras
112
+
* Sensor Size
113
+
* Lens Shift
114
+
* Focal Length
113
115
* Lights of type *Directional*, *Spot* , *Point*, and *Area*; also the following light attributes:
114
116
* Spot Angle (for Spot lights)
115
117
* Color
@@ -125,6 +127,7 @@ The FBX Exporter exports the following objects:
125
127
* Cameras:
126
128
* Field of View
127
129
* Blendshapes
130
+
* Constraints
128
131
129
132
130
133
@@ -139,10 +142,10 @@ When exporting an FBX file, the following Export Options window opens, displayin
139
142
140
143
| Property:| Function: |
141
144
|:---|:---|
142
-
|__Export Name__|Specify the filename to export to. |
145
+
|__Export Name__|Specify the exported FBX's filename. |
143
146
|__Export Path__|Specify the location where the FBX Exporter will save the FBX file. |
144
-
|__Source__|Transfer the transform animation from this transform to the Destination. <br/><br/>**Notes:** - __Source__ must be an ancestor of __Destination__<br/> - __Source__ may be an ancestor of the selected object. |
145
-
|__Destination__|Where to transfer the transform animation to (which Transform object).<br/><br/>This object receives the transform animation on objects between __Source__ and __Destination__ as well as the animation on the Source itself. |
147
+
|__Source__|Transfer the transform animation from this object to the __Destination__ transform. <br/><br/>**Notes:** - __Source__ must be an ancestor of __Destination__<br/> - __Source__ may be an ancestor of the selected object. |
148
+
|__Destination__|Which object to transfer the transform animation to.<br/><br/>This object receives the transform animation on objects between __Source__ and __Destination__ as well as the animation on the Source itself. |
146
149
|__Export Format__|Select the format for the FBX Exporter to use when exporting the FBX file (ASCII or binary). |
147
150
|__Include__|Choose whether to export both Models and Animation, only Models, or only Animations. |
148
151
|__LOD level__|For level of detail (LOD) groups, choose the desired level of detail to export (all, highest, or lowest). <br/><br/>**Notes:** - The FBX Exporter ignores LODs outside of selected hierarchy.<br/> - The FBX Exporter does not filter out objects that are used as LODs and doesn't export them if they aren’t direct descendants of their respective LOD Group |
@@ -180,7 +183,7 @@ For example, when working with large models in Maya, to ensure that the models c
180
183
<aname="LinkedPrefab"></a>
181
184
# Converting GameObjects to Linked Prefabs
182
185
183
-
A Linked Prefab is a Prefab which maintains a link to an FBX file and is responsible for updating the Prefab so that it remains in sync with its source. What it adds to the default Unity behaviour is that the Linked Prefab integrates changes in the hierarchy and transforms (in addition to Meshes and Materials).
186
+
A Linked Prefab is a Prefab which maintains a link to an FBX file and is responsible for updating the Prefab so that it remains in sync with its source. The notable difference between a Linked Prefab and a stock Unity Prefab is that the Linked Prefab integrates changes in the hierarchy and transforms (in addition to Meshes and Materials).
184
187
185
188
During an update, the Linked Prefab preserves components and object references to the greatest extent possible. If you delete a node in the FBX, the Linked Prefab deletes the corresponding object in Unity along with its components.
186
189
@@ -203,12 +206,12 @@ When converting to a Linked Prefab, the following window opens, displaying optio
203
206
204
207
| Property:| Function: |
205
208
|:---|:---|
206
-
|__Export Name__|Specify the filename to export to|
209
+
|__Export Name__|Specify the exported FBX's filename|
207
210
|__Export Path__|Specify the location where the FBX Exporter will save the FBX file. |
208
-
|__Prefab Name__|Specify the filename to save the Linked Prefab to|
211
+
|__Prefab Name__|Specify the Linked Prefab's filename|
209
212
|__Prefab Path__|Specify the location where the FBX Exporter will save the linked prefab file. |
210
-
|__Source__|Transfer the transform animation from this transform to __Destination__.<br/><br/>**Notes:** - __Source__ must be an ancestor of __Destination__.<br/> - __Source__ may be an ancestor of the selected object. |
211
-
|__Destination__|Where to copy the transform animation to (which Transform object).<br/><br/>This object receives the transform animation on objects between Source and Destination as well as the animation on the Source itself. |
213
+
|__Source__|Transfer the transform animation from this object to the __Destination__ transform.__Destination__.<br/><br/>**Notes:** - __Source__ must be an ancestor of __Destination__.<br/> - __Source__ may be an ancestor of the selected object. |
214
+
|__Destination__|Which object to transfer the transform animation to.<br/><br/>This object receives the transform animation on objects between Source and Destination as well as the animation on the Source itself. |
212
215
|__Export Format__|Select the format for the FBX Exporter to use when exporting the FBX file (ASCII or binary). |
213
216
|__Include__|__Convert to Linked Prefab Instance__ always exports both Models and Animation in the hierarchy. |
214
217
|__LOD level__|__Convert to Linked Prefab Instance__ always exports All levels of detail (LOD) available in the hierarchy for LOD groups. |
@@ -295,7 +298,13 @@ To select a version of Maya, Maya LT, or 3ds Max installed outside the default l
295
298
296
299
Before installing Unity Integration, close all instances of the selected 3D modeling software that matches the specified version.
297
300
298
-
Click __Install Unity Integration__ to install the Unity Integration for the selected 3D modeling software. Unity Integration comes packaged in several zip files (one zip file per supported application). Then select a target folder to extract the Unity Integration to when prompted. The target folder can be outside of your current Project. Maya and Maya LT both use the same zip folder.
301
+
Click __Install Unity Integration__ to install the Unity Integration for the selected 3D modeling software.
302
+
303
+

304
+
305
+
If a previous integration was already unpacked in the selected folder, Unity will prompt you to either use the already existing integration or to overwrite it with the newer version.
306
+
307
+
Unity Integration comes packaged in several zip files (one zip file per supported application). Then select a target folder to extract the Unity Integration to when prompted. The target folder can be outside of your current Project. Maya and Maya LT both use the same zip folder.
299
308
300
309
The application starts, configures the plug-in, and automatically exits. Unity reports whether the installation was a success.
0 commit comments