.. highlightlang:: us

.. _auto_xyz_setisolinestyle:

auto_xyz_SetIsolineStyle
========================

.. index:: auto_xyz_SetIsolineStyle

.. us.tag  auto_xyz_SetIsolineStyle ENGLISH auto_xyz New300

:ref:`auto_xyz_SetIsolineStyle` sets the line style for all Isolines of a 3D dataset to
the specified style.

.. function::  bool = auto_xyz_SetIsolineStyle(hData, nStyle, nWidth, rvColorRGB)
    bool = auto_xyz_SetIsolineStyle(hData, nStyle, nWidth, rvColorRGB, rvMinIsoVal, rvMaxIsoVal)

.. us.return

**Return Value**

*bool* is TRUE (1) if the function was successful, otherwise
FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the handle of a 3D dataset. The
   handle is returned by the function :ref:`auto_LoadDataset`.

.. uparam:: nStyle

   *nStyle* is one of the following values:

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

   * - Value
     - Meaning
   * - PS_SOLID
     - solid line pen
   * - PS_DASH
     - dash pen
   * - PS_DOT
     - dot pen
   * - PS_DASHDOT
     - dash dot pen
   * - PS_DASHDOTDOT
     - dash dot dot pen
   * - PS_NULL
     - invisible pen

.. uparam:: nWidth

   *nWidth* is the width of the pen in 0.1 mm.

.. uparam:: rvColorRGB

   *rvColorRGB* is a vector with 3 elements that
   set the pen color:

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

   * - Value
     - Meaning
   * - rvColorRGB[1]
     - Red (0 to 255)
   * - rvColorRGB[2]
     - Green (0 to 255)
   * - rvColorRGB[3]
     - Blue (0 to 255)

.. us.example

**Example**

::

   auto_xy_SetIsolineStyle(hData, PS_SOLID, 4, [255,0,0]); // Red

Sets all Isolines in the range 50 to 100 to the specified
line style:

::

   auto_xyz_SetIsolineStyle(hData, PS_SOLID, 4, [255,0,0], 50, 100);

.. seealso::
   :ref:`overview-automation`,
   :ref:`auto_LoadDataset`,
   :ref:`PenCreate`,
   :ref:`MarkerCreate`

:sub:`id-277409`