diff --git a/img/3dimp_BlenderEmptyDrawTypes.png b/img/3dimp_BlenderEmptyDrawTypes.png new file mode 100644 index 000000000..20a0116e3 Binary files /dev/null and b/img/3dimp_BlenderEmptyDrawTypes.png differ diff --git a/tutorials/3d/importing_3d_scenes.rst b/tutorials/3d/importing_3d_scenes.rst index 51154ffab..cebaab9e9 100644 --- a/tutorials/3d/importing_3d_scenes.rst +++ b/tutorials/3d/importing_3d_scenes.rst @@ -251,9 +251,8 @@ that vertex colors are desired. Create collisions (-col, -colonly) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -These will only work for Mesh nodes, If the "-col" option is detected, a -child static collision node will be added, using the same geometry as -the mesh. +Option "-col" will work only for Mesh nodes. If it is detected, a child +static collision node will be added, using the same geometry as the mesh. However, it is often the case that the visual geometry is too complex or too un-smooth for collisions, which end up not working well. To solve @@ -261,6 +260,21 @@ this, the "-colonly" modifier exists, which will remove the mesh upon import and create a `StaticBody `__ collision instead. This helps the visual mesh and actual collision to be separated. +Option "-colonly" can be also used with Blender's empty objects. +On import it will create a `StaticBody `__ with +collision node as a child. Collision node will have one of predefined shapes, +depending on the Blender's empty draw type: + +.. image:: /img/3dimp_BlenderEmptyDrawTypes.png + +- Single arrow will create `RayShape `__ +- Cube will create `BoxShape `__ +- Image will create `PlaneShape `__ +- Sphere (and other non-listed) will create `SphereShape `__ + +For better visibility in Blender's editor user can set "X-Ray" option on collision +empties and set some distinct color for them in User Preferences / Themes / 3D View / Empty. + Create rooms (-room) ^^^^^^^^^^^^^^^^^^^^