.. highlightlang:: us

.. _xyzsethullnewdata:

XYZSetHullNewData
=================

.. index:: XYZSetHullNewData

.. us.tag  XYZSetHullNewData GERMAN XYZSet_hull

:ref:`XYZSetHullNewData` erzeugt eine neue Datenhülle, die auch Inseln enthalten kann.

.. function::  bool = XYZSetHullNewData(hData, rvX, rvY, rvLineTo)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des Datensatzes, der mit :ref:`XYZCreate`
   oder :ref:`XYZCreateFromMatrix` erzeugt wurde.

.. uparam:: rvX

   *rvX* ist ein Vektor mit den X-Koordinaten.

.. uparam:: rvY

   *rvY* ist ein Vektor mit den Y-Koordinaten.

.. uparam:: rvLineTo

   *rvLineTo* ist ein Vektor, der die Form der Datenhülle festlegt (Volllastlinie).
   Jedes Vektorelement kann den ASCII-Code-Wert der Zeichen ``"m"``, ``"M"``,
   ``"l"`` und ``"L"`` annehmen.
   Die Zeichen haben folgende Bedeutung:

.. list-table::
   :header-rows: 1

   * - Wert
     - Bedeutung
   * - ``"m"`` ASCII-Code = 109
     - MoveTo ohne Beschriftung des z-Wertes.
   * - ``"M"`` ASCII-Code = 77
     - MoveTo mit Beschriftung des z-Wertes.
   * - ``"l"`` ASCII-Code = 108
     - LineTo ohne Beschriftung des z-Wertes.
   * - ``"L"`` ASCII-Code = 76
     - LineTo mit Beschriftung des z-Wertes.

.. us.comment

**Kommentar**

Alle Vektoren müssen die gleiche Anzahl an Elementen haben. Der z-Wert für die
Beschriftung der Hüllenpunkte wird interpoliert.

.. us.example

**Beispiel**

::

   rvHull = [10,10; 20,10; 20,20; 20,10];

   nRows = nr(rvHull);
   rvLineTo = zeros(nRows, 1) + 109; // MoveTo
   XYZSetHullNewData(hData, rvHull[;1], rvHull[;2], rvLineTo);
   XYZSetHullType(hData, HULL_USERDEF);
   XYZUpdate(hData);

.. seealso::
   :ref:`uberblick-xyz-datensatze`,
   :ref:`XYZCreate`,
   :ref:`XYZGetHullData`,
   :ref:`XYZSetHullType`,
   :ref:`XYZUpdate`,
   :ref:`strcode`,
   :ref:`strsplit`,
   :ref:`strchar`,
   :ref:`sum`

:sub:`id-892593`