.. highlightlang:: us

.. _xyzgethulldata:

XYZGetHullData
==============

.. index:: XYZGetHullData

.. us.tag  XYZGetHullData NOTREADYENGLISH XYZGet_hull

:ref:`XYZGetHullData` returns the data hull.

.. function::  rmXYS = XYZGetHullData(hData)

.. us.return

**Return Value**

*rmXYS* is a matrix with 3 columns. Column 1 contains the
x coordinates, column 2 the y coordinates. The third column
contains information for the line and label output: Each vector
element be one of the following ASCII characters:

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

   * - Value
     - Meaning
   * - ``"m"`` ASCII-Code = 109
     - MoveTo without z-value label.
   * - ``"M"`` ASCII-Code = 77
     - MoveTo with z-value label.
   * - ``"l"`` ASCII-Code = 108
     - LineTo without z-value label.
   * - ``"L"`` ASCII-Code = 76
     - LineTo with z-value label.

.. us.params

**Parameters**

.. uparam:: hData

   A handle for a dataset created with :ref:`XYZCreate`.

.. us.comment

**Comment**

The data returned depends on the hull settings (convex hull,
spline, user hull, etc.)

.. seealso::
   :ref:`overview-xyz-datasets`,
   :ref:`XYZSetHullNewData`,
   :ref:`XYZCreate`,
   :ref:`strcode`,
   :ref:`strchar`

:sub:`id-958508`