get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect (Operator)

Name

get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect — Zugriff auf Bilddatenzeiger und Bildpunkte innerhalb des kleinsten umschließenden Rechtecks der Domäne des Eingabebildes.

Signatur

get_image_pointer1_rect(Image : : : PixelPointer, Width, Height, VerticalPitch, HorizontalBitPitch, BitsPerPixel)

Beschreibung

Der Operator get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect liefert den Zeiger PixelPointerPixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer auf den Anfang der Bilddaten, die sich innerhalb des kleinsten umschließenden Rechtecks der Domäne von ImageImageImageImageimageimage befinden. VerticalPitchVerticalPitchVerticalPitchVerticalPitchverticalPitchvertical_pitch entspricht der Breite des Eingabebildes ImageImageImageImageimageimage mal der Anzahl der Bytes pro Pixel (HorizontalBitPitchHorizontalBitPitchHorizontalBitPitchHorizontalBitPitchhorizontalBitPitchhorizontal_bit_pitch / 8). WidthWidthWidthWidthwidthwidth und HeightHeightHeightHeightheightheight entsprechen der Größe des kleinsten umschließenden Rechtecks der Eingaberegion. HorizontalBitPitchHorizontalBitPitchHorizontalBitPitchHorizontalBitPitchhorizontalBitPitchhorizontal_bit_pitch ist der horizontale Abstand (in Bits) benachbarter Pixel. BitsPerPixelBitsPerPixelBitsPerPixelBitsPerPixelbitsPerPixelbits_per_pixel ist die Anzahl der verwendeten Bits pro Pixel. get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect ist symmetrisch zu gen_image1_rectgen_image1_rectGenImage1RectGenImage1RectGenImage1Rectgen_image1_rect.

Achtung

get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect sollte nur zum Eintragen in neu erzeugte Bilder verwendet werden, da sonst die Grauwerte von anderen Bildern überschrieben werden könnten (siehe relationale Struktur).

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

ImageImageImageImageimageimage (input_object) singlechannelimage → object (byte / uint2 / int4)

Eingabebild (Himage).

PixelPointerPixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer (output_control) pointer → (integer)

Zeiger auf die Bilddaten.

WidthWidthWidthWidthwidthwidth (output_control) extent.x → (integer)

Breite des Ausgabebildes.

HeightHeightHeightHeightheightheight (output_control) extent.y → (integer)

Höhe des Ausgabebildes.

VerticalPitchVerticalPitchVerticalPitchVerticalPitchverticalPitchvertical_pitch (output_control) integer → (integer)

Breite(Eingabebild)*(HorizontalBitPitch/8).

HorizontalBitPitchHorizontalBitPitchHorizontalBitPitchHorizontalBitPitchhorizontalBitPitchhorizontal_bit_pitch (output_control) integer → (integer)

Abstand benachbarter Pixel in Bits.

BitsPerPixelBitsPerPixelBitsPerPixelBitsPerPixelbitsPerPixelbits_per_pixel (output_control) integer → (integer)

Anzahl verwendeter Bits pro Pixel.

Beispiel (C)

Hobject       image,reg,imagereduced;
char          typ[128];
Hlong          width,height,vert_pitch,hori_bit_pitch,bits_per_pix, winID;
unsigned char *ptr;

open_window(0,0,512,512,"black",winID);
read_image(&image,"monkey");
draw_region(&reg,winID);
reduce_domain(image,reg,&imagereduced);
get_image_pointer1_rect(imagereduced,(Hlong*)&ptr,&width,&height,
                        &vert_pitch,&hori_bit_pitch,&bits_per_pix);

Ergebnis

get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect liefert den Wert 2 (H_MSG_TRUE), falls genau ein Bild übergeben wurde. Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageReadImageReadImageread_image, gen_image1_rectgen_image1_rectGenImage1RectGenImage1RectGenImage1Rectgen_image1_rect

Alternativen

set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval, get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayvalget_grayval, get_image_pointer3get_image_pointer3GetImagePointer3GetImagePointer3GetImagePointer3get_image_pointer3, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1

Siehe auch

paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region, paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray, gen_image1_rectgen_image1_rectGenImage1RectGenImage1RectGenImage1Rectgen_image1_rect

Modul

Foundation

Operatoren