.. highlightlang:: us

.. index:: ImageGetPixelColor

.. _imagegetpixelcolor:

ImageGetPixelColor
==================

.. us.tag  ImageGetPixelColor GERMAN Image ImageGet New520 Changed532

:ref:`ImageGetPixelColor` liefert die Farbe eines Pixels als RGB-Wert.

.. function::  rgb = ImageGetPixelColor(hImg, x, y)
    rgbMat = ImageGetPixelColor(hImg)

.. us.return

**Returnwert**

*rgb* ist der RGB-Wert des Bildpunktes. Falls x oder y außerhalb  des zulässigen
Bereichs liegen, gibt die Funktion den Wert für x und y gleich 1 zurück. Bei
anderen Fehlern wird -1 zurück gegeben. *rgbMat* ist die Matrix mit den
RGB-Werten. Blue = (rgbMat & 0x00ff0000) >> 16, Green = (rgbMat & 0xff00) >> 8,
Red = rgbMat & 0x000000ff kodiert sind.

Um aus den Rot-/Grün- und Blau-Matrizen eine RGB-Matrix zu erzeugen kann die
folgende Anweisung verwendet werden::

   rgbMat = Blue << 16 | Green << 8 | Red;

.. us.params

**Parameter**

.. uparam:: hImg

   *hImg* ist die Zugriffsnummer (Handle) des mit :ref:`ImageCreate` erzeugten
   Bildobjekts. 

.. uparam:: x

   *x* ist die horizontale Pixel-Position. Bereich ist 1 bis :ref:`ImageGetWidth`.

.. uparam:: y

   *y* ist die vertikale Pixel-Position. Bereich ist 1 bis :ref:`ImageGetHeight`.

.. us.example

**Beispiel**

Siehe Beispiel unter :ref:`ImageGetPixelGray`.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.3.2
     - Die Funktion kann ohne die Parameter *x*  und *y*  aufgerufen werden, um die gesamte Matrix zu erhalten.
   * - 5.2.0
     - Neu.

.. seealso::
   :ref:`uberblick-bilder`,
   :ref:`ImageGetPixelGray`,
   :ref:`ImageGetWidth`,
   :ref:`ImageGetHeight`

:sub:`id-968740`