.. role:: blue
   :class: blue

Построение двумерной составной кривой
======================================
.. _Constructing_Two-Dimensional_Compound_Curve:

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

Функция

.. code-block:: cpp

   MbResultType CreateContour( MbCurve  &   curve,
                               MbContour *& result )

выполняет построение составной кривой (контура) на базе одной исходной кривой.

Входным параметром функции является исходная кривая **curve**.

Выходным параметром функции является построенная составная кривая (контур) **result**.

При успешном завершении работы функция возвращает :blue:`rt_Success`, в противном случае
функция возвращает код ошибки из перечисления :ref:`MbResultType <MbResultType>`.

Функция объявлена в файле *action_curve.h*.

Функция создает составную кривую **result** на базе исходной кривой **curve**.
Если исходная кривая **curve** является составной кривой, то в кривую **result** будут
положены составляющие элементы исходной кривой. Двумерная составная кривая описана
в параграфе :ref:`Двумерный контур MbContour <MbContour_Two-Dimensional_Contour>`.

Функция

.. code-block:: cpp

   MbResultType AddCurveToContour( MbCurve  &  curve,
                                   MbContour & contour,
                                   bool        toEnd,
                                   double      epsilon = METRIC_REGION )

модифицирует составную кривую путём добавления кривой.

Входными параметрами функции являются:

- **curve** — добавляемая кривая;
- **contour** — модифицируемая составная кривая;
- **toEnd** — флаг места добавления кривой;
- **epsilon** — близость точек стыка при добавлении кривой.

Выходным параметром функции является модифицируемая кривая **contour**.

При успешном завершении работы функция возвращает :blue:`rt_Success`, в противном случае
функция возвращает код ошибки из перечисления :ref:`MbResultType <MbResultType>`.

Функция объявлена в файле *action_curve.h*.

Функция модифицирует составную кривую **contour** путём добавления кривой **curve**
в начало или конец составной кривой.

Если **toEnd** = *true*, то кривая **curve** будет добавлена в конец составной кривой
**contour**, если **toEnd** = *false*, то кривая **curve** будет добавлена в начало
составной кривой **contour**. Точки стыковки модифицируемой кривой и добавляемой кривой
должны совпадать с точностью **epsilon**:

.. figure:: /MODELER/TWO-DIMENSIONAL_CURVE_CONSTRUCTION_METHODS/pictures/M.3.7.1.png
   :width: 12cm
   :align: center

Если добавляемая кривая **curve** является составной кривой, то в кривую **contour**
будут добавлены составляющие элементы добавляемой кривой.