.. highlightlang:: us

.. index:: XYZSetFillColors

.. _xyzsetfillcolors:

XYZSetFillColors
================

.. us.tag  XYZSetFillColors GERMAN XYZSet_iso Changed412

:ref:`XYZSetFillColors` setzt die Farben für das Füllen der Flächen zwischen den
Isolinien bzw. für den Farbverlauf der 3D-Oberfläche.

.. function::  bool = XYZSetFillColors(hData, rmRGB)

.. 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` erzeugt wurde.

.. uparam:: rmRGB

   *rmRGB* ist eine 3-spaltige Matrix:

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

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

   Die Matrix darf maximal 100 Zeilen haben. "i" ist der Index der
   entsprechenden Isowerts. Der Index beginnt mit 1.

.. us.comment

**Kommentar**

Die Änderung wird erst nach Aufruf der Funktion :ref:`XYZUpdate` aktiv.

.. us.example

**Beispiel**

::

   def test_XYZSetFillColors()
   {
       hDoc = DocCreate();
       hPage = PageCreate();
       DocAddPage(hDoc, hPage);
       hLayer = LayerCreate();
       PageAddLayer(hPage, hLayer)
       x = linspace(-10, 6.0, 30);
       y = linspace(-10, 5.0, 30);
       <xx, yy> = meshdom(x,y);
       zz = sin(sqrt(xx.*xx + yy.*yy)) + sin(xx);
       rvRange = [x[1], y[1], x[len(x)], y[len(y)]];
       hData = XYZCreateFromMatrix("sin", zz, rvRange);
       LayerAddDataset(hLayer, hData);
       LayerAutoScale(hLayer);
       XYZDeleteIsoValues(hData);
       rvIso = [-2:0.4:2];
       XYZAddIsoValues(hData, rvIso);
       rmColor = _InterpolateColors([0,0,255], [255,0,0], len(rvIso));
       XYZSetFillMinColor(hData, [0,0,255]);
       XYZSetFillColors(hData, rmColor);
       XYZSetFill(hData, TRUE);
       XYZUpdate(hData);
       PageReplot(hPage);
   }

.. seealso::
   :ref:`uberblick-xyz-datensatze`,
   :ref:`XYZCreate`,
   :ref:`XYZSetFillMinColor`,
   :ref:`XYZGetFillColors`,
   :ref:`XYZGetFillMinColor`,
   :ref:`XYZGetIsoValues`,
   :ref:`XYZSetFill`

:sub:`id-1671761`