.. role:: blue
   :class: blue


MbLegend Auxiliary Geometric Object
===================================
.. _MbLegend_Auxiliary_Geometric_Object_:

.. версия ядра: 


Class :blue:`MbLegend` is declared in file *legend.h*.

Auxiliary object :blue:`MbLegend` is a derived class of
:ref:`MbSpaceItem <MbSpaceItem_Three-Dimensional_Geometrical_Object_>`, Fig. 1.

.. figure:: /MODELER/SPECIAL_OBJECTS/pictures/O.6.10.1.png
   :width: 15cm
   :align: center

   Fig. 1

The auxiliary object is an abstract class. The C3D geometric kernel
implements the following auxiliary objects that are derived from
class :blue:`MbLegend`:

:ref:`MbMarker <MbMarker_Marker_>` – a point and two
orthonormal vectors,

:ref:`MbThread <MbThread_Thread_Graphic_Symbol_>` – a thread,

:ref:`MbPointsSymbol <MbPointsSymbol_Symbol_>` – a conventional
symbol on base points,

:ref:`MbRough <MbRough_Surface_Finish_Symbol_>` – a surface
finish symbol,

:ref:`MbLeader <MbLeader_Leader_Line_Symbol_>` – a leader line
symbol.

Auxiliary objects are used for various purposes, but they all
interact with curves, surfaces, and objects of a geometric model.

Auxiliary objects override the following methods of a three-dimensional
geometric object:

methods that handle transformation of a geometric object,

:blue:`Move`\( const :blue:`MbVector3D` & **v**, MbRegTransform * iReg = NULL ),

:blue:`Rotate`\( const MbAxis3D & **axis**, double **angle**,
MbRegTransform * iReg = NULL ),

:blue:`Transform`\( const :blue:`MbMatrix3D` & **m**, MbRegTransform * iReg = NULL ),

methods that provide copying, equality check, ability-to-match check,
and make objects equal,

:blue:`MbSpaceItem` & :blue:`Duplicate`\( MbRegDuplicate * iReg = NULL ),

bool :blue:`IsSame`\( const :blue:`MbSpaceItem` & **item** ),

bool :blue:`IsSimilar`\( const :blue:`MbSpaceItem` & **item** ),

bool :blue:`SetEqual`\( const :blue:`MbSpaceItem` & **item** ),

methods that return a type from the enumeration of geometric objects,

MbeSpaceType :blue:`IsA`\(),

MbeSpaceType :blue:`Type`\(),

MbeSpaceType :blue:`Family`\(),

methods that provide access to and editing of internal data
of an object,

MbProperty & :blue:`CreateProperty`\( MbePrompt name ),

:blue:`GetProperties`\( MbProperties & *properties* ),

:blue:`SetProperties`\( MbProperties & *properties* ),

a method that fills a polygonal copy of a geometric object,

:blue:`CalculateWire`\( double sag, :blue:`MbMesh` & **mesh** ).