.. role:: blue
   :class: blue

MbInstance Insertion
====================
.. _MbInstance_Insertion_:

.. kernel version: 

The :blue:`MbInstance` class is declared in the *instance_item.h* file.

The **MbInstance** insertion is derived from the
:ref:`MbItem <MbItem_Geometric_Model_Object_>` class and is described by the
:blue:`MbItem` **item** geometric model object and the
:ref:`MbPlacement3D <MbPlacement3D_Local_Coordinate_System_>` **place** local coordinate system. The insertion is the
**item** object moved into the **place** local coordinate system.

The insertion has all properties of the **item** object. The difference is that
the :blue:`Move`\(), :blue:`Rotate`\(), and :blue:`Transform`\() methods modify the
**place** coordinate system without changing the **item** geometric object, which
can be shared by several insertions.

The insertion object may contain a solid, a wireframe, a point frame, or a polygonal
object, but it cannot contain another insertion (that is, **MbInstance** cannot be
used as **item** for another **MbInstance**).