.. highlightlang:: us

.. _objgetcolorgradient:

OBJGetColorGradient
===================

.. index:: OBJGetColorGradient

.. us.tag  OBJGetColorGradient GERMAN draw-get Changed6002

:ref:`OBJGetColorGradient` liefert zwei RGB-Farben, die den Farbverlauf eines
Objektes definieren.

.. function::  rmRGB = OBJGetColorGradient(hobj)
               rmARGB = OBJGetColorGradient(hobj, bTransparency)

.. us.return

**Returnwert**

*rmRGB* ist eine Matrix mit 2 Zeilen und 3 Spalten.

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

   * - Wert
     - Bedeutung
   * - rmRGB[1;1]
     - (Unten) Rot (0 bis 255)
   * - rmRGB[1;2]
     - (Unten) Grün (0 bis 255)
   * - rmRGB[1;3]
     - (Unten) Blau (0 bis 255)
   * - rmRGB[2;1]
     - (Oben) Rot (0 bis 255)
   * - rmRGB[2;2]
     - (Oben) Grün (0 bis 255)
   * - rmRGB[2;3]
     - (Oben) Blau (0 bis 255)

Falls *bTransparency* TRUE (1) ist, ist *rmARGB* eine MAtrix mit 4 Spalten:

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

   * - Wert
     - Bedeutung
   * - rmARGB[1;1]
     - (Unten) Transparenzwert (Alphawert) zwischen 0 und 255. 0 entspricht vollständiger
       Transparenz und 255 vollständiger Deckung.
   * - rmARGB[1;2]
     - (Unten) Rotanteil (0 bis 255)
   * - rmARGB[1;3]
     - (Unten) Grünanteil (0 bis 255)
   * - rmARGB[1;4]
     - (Unten) Blauanteil (0 bis 255)
   * - rmARGB[2;1]
     - (Oben) Transparenzwert (Alphawert) zwischen 0 und 255. 0 entspricht vollständiger
       Transparenz und 255 vollständiger Deckung.
   * - rmARGB[2;2]
     - (Oben) Rotanteil (0 bis 255)
   * - rmARGB[2;3]
     - (Oben) Grünanteil (0 bis 255)
   * - rmARGB[2;4]
     - (Oben) Blauanteil (0 bis 255)

.. us.params

**Parameter**

.. uparam:: hobj

   *hobj* ist die Zugriffsnummer einer Linie, eines
   Textes, eines Rechtecks, einer Ellipse oder eines Layers (Diagramms).

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2018.3
     - Neuer Parameter *bTransparency*.

.. seealso::
   :ref:`uberblick-zeichenobjekte`,
   :ref:`OBJSetColorGradient`

:sub:`id-825385`