.. _boundingshapes:
.. raw:: html
Since 3.1.7
Bounding shapes
***************
You can add shapes around any focus-able object. To do so, right click on the object you want to add the shape around and a context menu like the following pops up:
.. figure:: img/screenshots/bounding-shapes.jpg
:alt: Add bounding shape in the context menu
:align: center
:target: _images/bounding-shapes.jpg
Add bounding shape, context menu
Adding bounding shapes
----------------------
If you select "Add shape around 'object'...", the following dialog shows up:
.. figure:: img/screenshots/bounding-shape-dialog.jpg
:alt: Bounding shape dialog
:align: center
:target: _images/bounding-shape-dialog.jpg
Add bounding shape dialog
When adding a shape around an object there are a few properties that we can choose:
- **Object name**: The name of the object. This will show up as the object label if 'Show name label' is checked.
- **Object size**: The size of the object, together with the units of the size.
- **Show name label**: Whether to show the label for the bounding shape or not.
- **Track object position**: When checked, the bounding shape will follow the object around if/when it moves. Otherwise, the shape will stay at the original position.
- **Shape type**: The shape type. Possible shapes are sphere, icosphere, octahedron sphere, cone, cylinder and ring.
- **Color**: The color of the shape.
- **Primitive type**: The primitive to use for rendering. If **LINES**, the shape is shown as a wireframe. If **TRIANGLES**, the shape is rendered as a solid object.
Removing shape objects
----------------------
You can remove shape object using the context menu. You can either only remove the shape objects linked to a particular object with 'Remove all shapes around Object', or remove all the shapes with 'Remove all shapes'.