diff --git a/docs/user-manual/assets/models/units.md b/docs/user-manual/assets/models/units.md index c2a8c7a786..d898b9d4f4 100644 --- a/docs/user-manual/assets/models/units.md +++ b/docs/user-manual/assets/models/units.md @@ -7,6 +7,16 @@ PlayCanvas scenes generally treat 1 unit as 1 meter. When authoring artwork for PlayCanvas, it is important to ensure you do so to the desired scale. To do this, you should check the working units for your scene in your modelling application of choice. You can choose whatever working units you like, but just ensure you respect them. For example, to make a cube that is 1 meter in dimension, you could set your working units to meters and create a 1x1x1 cube. Alternatively, you could set working units to centimeters and create a 100x100x100 cube. Exporting either scene to FBX and importing it to PlayCanvas will result in a cube which is 1x1x1. +### Blender + +To ensure units are exported correctly from Blender, check that Scene Properties unit system is set to metric and that scale is set to 1.0: + +![Blender units](/img/user-manual/assets/models/units/blender-units.png) + +In addition, when exporting to FBX format, check that "Apply Scaling" is set to "FBX All": + +![Blender FBX Export](/img/user-manual/assets/models/units/blender-fbx-export.png) + ### Autodesk 3D Studio Max To check or set working units in 3D Studio Max, open the Units Setup dialog and click the System Unit Setup button: diff --git a/static/img/user-manual/assets/models/units/blender-fbx-export.png b/static/img/user-manual/assets/models/units/blender-fbx-export.png new file mode 100644 index 0000000000..65a23c148a Binary files /dev/null and b/static/img/user-manual/assets/models/units/blender-fbx-export.png differ diff --git a/static/img/user-manual/assets/models/units/blender-units.png b/static/img/user-manual/assets/models/units/blender-units.png new file mode 100644 index 0000000000..a729ce88fc Binary files /dev/null and b/static/img/user-manual/assets/models/units/blender-units.png differ