gen_image1_rectgen_image1_rectGenImage1RectGenImage1Rectgen_image1_rect (Operator)

Name

gen_image1_rectgen_image1_rectGenImage1RectGenImage1Rectgen_image1_rect — Erzeugen eines Bildes mit rechteckiger Domäne aus einem Zeiger auf Pixel (mit Speicherverwaltung).

Signatur

gen_image1_rect( : Image : PixelPointer, Width, Height, VerticalPitch, HorizontalBitPitch, BitsPerPixel, DoCopy, ClearProc : )

Beschreibung

Der Operator gen_image1_rectgen_image1_rectGenImage1RectGenImage1RectGenImage1Rectgen_image1_rect erzeugt ein Bild in der Größe (VerticalPitchVerticalPitchVerticalPitchVerticalPitchverticalPitchvertical_pitch / (HorizontalBitPitchHorizontalBitPitchHorizontalBitPitchHorizontalBitPitchhorizontalBitPitchhorizontal_bit_pitch/8)) * HeightHeightHeightHeightheightheight. Die Pixel in PixelPointerPixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer werden zeilensequentiell abgelegt. Wie ein Zeigerwert übergeben wird hängt von der benutzten Operatorsignatur und der Programmierumgebung ab. Es ist sicherzustellen, dass die tatsächliche Speicheradresse unter der die Bilddaten gespeichert sind übergeben wird und nicht die Adresse der Zeigervariablen. Es ist darauf zu achten, dass 64-Bit-Zeiger auf 64-Bit-Architekturen nicht beschnitten werden. VerticalPitchVerticalPitchVerticalPitchVerticalPitchverticalPitchvertical_pitch entspricht dem Abstand (in Bytes) des m-ten Bildpunktes in Zeile n und des m-ten Bildpunktes in Zeile n+1 innerhalb des Speichers und ist für alle Zeilen des 'Eingabebildes' identisch. Die Breite des Ausgabebildes ist VerticalPitchVerticalPitchVerticalPitchVerticalPitchverticalPitchvertical_pitch / (HorizontalBitPitchHorizontalBitPitchHorizontalBitPitchHorizontalBitPitchhorizontalBitPitchhorizontal_bit_pitch / 8), seine Höhe ist HeightHeightHeightHeightheightheight. Die Domäne des Ausgabebildes ImageImageImageImageimageimage ist ein Rechteck der Größe WidthWidthWidthWidthwidthwidth * HeightHeightHeightHeightheightheight. Der Parameter HorizontalBitPitchHorizontalBitPitchHorizontalBitPitchHorizontalBitPitchhorizontalBitPitchhorizontal_bit_pitch ist der horizontale Abstand (in Bits) benachbarter Pixel. BitsPerPixelBitsPerPixelBitsPerPixelBitsPerPixelbitsPerPixelbits_per_pixel ist die Anzahl der verwendeten Bits pro Pixel.

Ist DoCopyDoCopyDoCopyDoCopydoCopydo_copy auf 'true'"true""true""true""true""true" gesetzt, werden die von PixelPointerPixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer referenzierten Bilddaten kopiert und Speicher für das neue Bild wird von HALCON neu angelegt. Andernfalls muss der Speicherbereich auf den PixelPointerPixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer zeigt wieder freigegeben werden. Dies geschieht durch die vom Aufrufer zur Verfügung gestellte Prozedur ClearProcClearProcClearProcClearProcclearProcclear_proc. Diese Prozedur muss folgende Signatur haben void ClearProc(void* ptr); und wird beim Löschen von ImageImageImageImageimageimage mit der __cdecl Aufrufkonvention aufgerufen. Falls der Speicher nicht freigegeben werden soll (im Fall von Framegrabbern oder statischem Speicher) kann eine Prozedur “ohne Rumpf“ oder der NULL-Pointer übergeben werden. Analog zum Parameter PixelPointerPixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer muss der Zeiger auf die Prozedur abhängig von der benutzten Operatorsignatur und der Programmierumgebung übergeben werden. Ist DoCopyDoCopyDoCopyDoCopydoCopydo_copy gleich 'true'"true""true""true""true""true" so ist ClearProcClearProcClearProcClearProcclearProcclear_proc irrelevant. Der Operator gen_image1_rectgen_image1_rectGenImage1RectGenImage1RectGenImage1Rectgen_image1_rect ist symmetrisch zu get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect.

Achtung

gen_image1_rectgen_image1_rectGenImage1RectGenImage1RectGenImage1Rectgen_image1_rect überprüft nicht, ob PixelPointerPixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer einen gültigen Wert hat oder nicht. Es muss also darauf geachtet werden, dass der Wert gültig ist, da es sonst zum Programmabsturz kommen kann!

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 (output_object) image → object (byte / uint2 / int4)

Erzeugtes HALCON-Bild.

PixelPointerPixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer (input_control) pointer → (integer)

Zeiger auf das erste Pixel.

WidthWidthWidthWidthwidthwidth (input_control) extent.x → (integer)

Breite des Bildes.

Defaultwert: 512

Wertevorschläge: 128, 256, 512, 1024

Typischer Wertebereich: 1 ≤ Width Width Width Width width width (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

HeightHeightHeightHeightheightheight (input_control) extent.y → (integer)

Höhe des Bildes.

Defaultwert: 512

Wertevorschläge: 128, 256, 512, 1024

Typischer Wertebereich: 1 ≤ Height Height Height Height height height (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

VerticalPitchVerticalPitchVerticalPitchVerticalPitchverticalPitchvertical_pitch (input_control) integer → (integer)

Abstand (in Bytes) zwischen Pixel m in Zeile n und Pixel m in Zeile n+1 des 'Eingabebildes'.

Restriktion: VerticalPitch >= Width * HorizontalBitPitch / 8

HorizontalBitPitchHorizontalBitPitchHorizontalBitPitchHorizontalBitPitchhorizontalBitPitchhorizontal_bit_pitch (input_control) integer → (integer)

Abstand benachbarter Pixel in Bits.

Defaultwert: 8

Werteliste: 8, 16, 32

BitsPerPixelBitsPerPixelBitsPerPixelBitsPerPixelbitsPerPixelbits_per_pixel (input_control) integer → (integer)

Anzahl verwendeter Bits pro Pixel.

Defaultwert: 8

Werteliste: 8, 9, 10, 11, 12, 13, 14, 15, 16, 32

Restriktion: BitsPerPixel <= HorizontalBitPitch

DoCopyDoCopyDoCopyDoCopydoCopydo_copy (input_control) string → (string)

Bilddaten kopieren.

Defaultwert: 'false' "false" "false" "false" "false" "false"

Wertevorschläge: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"

ClearProcClearProcClearProcClearProcclearProcclear_proc (input_control) pointer → (integer)

Zeiger auf die Prozedur, die den Speicher des Bildes beim Löschen des Objektes wieder freigibt.

Defaultwert: 0

Beispiel (C)

void NewImage(Hobject *new)
{
  unsigned char       *image;
  int                 r,c;

  image = malloc(640*480);
  for (r=0; r<480; r++)
    for (c=0; c<640; c++)
      image[r*640+c] = c % 255;
  gen_image1_rect(new,(Hlong)image,400,480,640,8,8,'false',(long)free);
}

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_image1_rectgen_image1_rectGenImage1RectGenImage1RectGenImage1Rectgen_image1_rect den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect

Alternativen

gen_image1gen_image1GenImage1GenImage1GenImage1gen_image1, gen_image1_externgen_image1_externGenImage1ExternGenImage1ExternGenImage1Externgen_image1_extern, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const

Siehe auch

get_image_pointer1_rectget_image_pointer1_rectGetImagePointer1RectGetImagePointer1RectGetImagePointer1Rectget_image_pointer1_rect

Modul

Foundation

Operatoren