.. highlightlang:: us

.. _auto_xyz_setisolinestyle:

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

.. index:: auto_xyz_SetIsolineStyle

.. us.tag  auto_xyz_SetIsolineStyle GERMAN auto_xyz New300

Die Funktion setzt für einen 3D-Datensatz die Linien-Darstellung für die Isolinien.
Die Funktion greift nicht auf die Stildatei zu.

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

.. 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 eines 3D-Datensatzes.
   Die Zugriffsnummer wird z. B. von der Funktion
   :ref:`auto_LoadDataset` zurückgeliefert.

.. uparam:: nStyle

   *nStyle* ist einer der folgenden Werte:

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

   * - Wert
     - Bedeutung
   * - PS_SOLID
     - durchgezogener Zeichenstift
   * - PS_DASH
     - gestrichelter Zeichenstift
   * - PS_DOT
     - gepunkteter Zeichenstift
   * - PS_DASHDOT
     - strich-punktierter Zeichenstift
   * - PS_DASHDOTDOT
     - strich-doppel-punktierter Zeichenstift
   * - PS_NULL
     - nicht sichtbarer Zeichenstift

.. uparam:: nWidth

   *nWidth* ist die Dicke des
   Zeichenstifts in 0.1 mm.

.. uparam:: rvColorRGB

   *rvColorRGB* ein Vektor mit drei Elementen,
   der die Farbe des Zeichenstifts angibt:

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

   * - Wert
     - Bedeutung
   * - rvColorRGB[1]
     - Rotanteil der Farbe im Bereich 0 bis 255
   * - rvColorRGB[2]
     - Grünanteil der Farbe im Bereich 0 bis 255
   * - rvColorRGB[3]
     - Blauanteil der Farbe im Bereich 0 bis 255

.. us.example

**Beispiel**

Beispielaufrufe

::

   auto_xyz_SetIsolineStyle(hData, PS_SOLID, 4, [255,0,0]); // Rot

Setzt alle Isolinien, die im Bereich 50 bis 100 liegen, auf
den angegebenen Linienstil:

::

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

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadDataset`,
   :ref:`PenCreate`,
   :ref:`MarkerCreate`

:sub:`id-277409`