.. highlightlang:: us

.. index:: ImageGetPixelGray

.. _imagegetpixelgray:

ImageGetPixelGray
=================

.. us.tag  ImageGetPixelGray GERMAN Image ImageGet New520 Changed532

:ref:`ImageGetPixelGray` liefert den Grauton eines Pixels oder eines Images.

.. function::  gray = ImageGetPixelGray(hImg, x, y)
               grayMat = ImageGetPixelGray(hImg)

.. us.return

**Returnwert**

*gray* ist der Grauton im Bereich 0 bis 255. Falls x oder y außerhalb  des
zulässigen Bereichs liegen, gibt die Funktion den Grauton des Pixels x=1, y=1 
zurück. Bei anderen Fehlern wird -1 zurück gegeben.

.. 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**

Das folgende Beispiel speichert die Grauton-Werte in einer Textdatei. Die Datei
kann dann mit Funktionen wie :ref:`dateiweitere-datei-funktionen3d-daten-matrix-laden`
weiterverarbeitet werden. Bei großen Auflösungen sollte die Pixelanzahl zuvor auf 
z. B. 500 mal 500 reduziert werden.

::

   def image_save_pixel(hImg, ssFile)
   {
       fp = fopen(ssFile, "wt");
       if (!fp) {
           return FALSE;
       }
       dx = ImageGetWidth(hImg);
       dy = ImageGetHeight(hImg);
       for (j in 1:dy) {
           for (i in 1:dx) {
               g = ImageGetPixelGray(hImg, i, j)
               fprintf(fp, "%d\t", g);
           }
           fprintf(fp, "\n"); 
       }
       fclose(fp);
       return TRUE;
   }

.. 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:`ImageGetWidth`,
   :ref:`ImageGetHeight`,
   :ref:`ImageGetPixelColor`,
   :ref:`ImageSetPixelGray`

:sub:`id-552611`