.. _boundingshapes:

.. raw:: html

   <div class="new new-prev">Since 3.1.7</div>

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.
-  **Orientation** -- The orientation of the shape. Can be one of:

  - **Camera** -- Use the current camera direction and up vectors to configure the orientation matrix of the shape.
  - **Equatorial system** -- Use the equatorial system.
  - **Ecliptic system** -- Use the ecliptic system.
  - **Galactic system** -- Use the galactic system.

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'.