gen_image1_externgen_image1_externGenImage1ExternGenImage1Externgen_image1_extern (Operator)

Name

gen_image1_externgen_image1_externGenImage1ExternGenImage1Externgen_image1_extern — Erzeugen eines Bildes aus einem Zeiger auf Pixel (mit Speicherverwaltung).

Signatur

gen_image1_extern( : Image : Type, Width, Height, PixelPointer, ClearProc : )

Beschreibung

gen_image1_externgen_image1_externGenImage1ExternGenImage1Externgen_image1_extern erzeugt ein Bild in der Größe WidthWidthWidthwidthwidth * HeightHeightHeightheightheight. Die Pixel in PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer sind zeilensequentiell abgelegt. Der Typ der übergebenen Pixel (PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer) muss mit TypeTypeTypetypetype übereinstimmen (siehe gen_image_constgen_image_constGenImageConstGenImageConstgen_image_const für eine detailliertere Beschreibung der Pixeltypen). 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.

Der Speicher für das neue Bild wird von HALCON im Gegensatz zu gen_image1gen_image1GenImage1GenImage1gen_image1 nicht neu angelegt und damit auch nicht kopiert. Der Speicherplatz auf den PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer zeigt, muss also beim Löschen des Objektes ImageImageImageimageimage freigegeben werden. Dies geschieht durch die, vom Aufrufer zur Verfügung gestellte, Prozedur ClearProcClearProcClearProcclearProcclear_proc. Diese Prozedur muss folgende Signatur haben

    void ClearProc(void* ptr);

und wird beim Löschen von ImageImageImageimageimage 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 PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer muss der Zeiger auf die Prozedur abhängig von der benutzten Operatorsignatur und der Programmierumgebung übergeben werden.

Achtung

gen_image1_externgen_image1_externGenImage1ExternGenImage1Externgen_image1_extern überprüft nicht, ob in PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer genug Speicher für ein Bild der Größe WidthWidthWidthwidthwidth * HeightHeightHeightheightheight allokiert wurde.

Ebenso überprüft gen_image1_externgen_image1_externGenImage1ExternGenImage1Externgen_image1_extern nicht, ob PixelPointerPixelPointerPixelPointerpixelPointerpixel_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

ImageImageImageimageimage (output_object) image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Erzeugtes HALCON-Bild.

TypeTypeTypetypetype (input_control) string → (string)

Pixeltyp.

Default: 'byte' "byte" "byte" "byte" "byte"

Werteliste: 'byte'"byte""byte""byte""byte", 'cyclic'"cyclic""cyclic""cyclic""cyclic", 'direction'"direction""direction""direction""direction", 'int1'"int1""int1""int1""int1", 'int2'"int2""int2""int2""int2", 'int4'"int4""int4""int4""int4", 'real'"real""real""real""real", 'uint2'"uint2""uint2""uint2""uint2"

WidthWidthWidthwidthwidth (input_control) extent.x → (integer)

Breite des Bildes.

Default: 512

Wertevorschläge: 128, 256, 512, 1024

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

HeightHeightHeightheightheight (input_control) extent.y → (integer)

Höhe des Bildes.

Default: 512

Wertevorschläge: 128, 256, 512, 1024

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer (input_control) pointer → (integer)

Zeiger auf den ersten Grauwert.

ClearProcClearProcClearProcclearProcclear_proc (input_control) pointer → (integer)

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

Default: 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_extern(new,"byte",640,480,(Hlong)image,(Hlong)free);
}

Ergebnis

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

Alternativen

gen_image1gen_image1GenImage1GenImage1gen_image1, gen_image_constgen_image_constGenImageConstGenImageConstgen_image_const, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1get_image_pointer1, gen_image3_externgen_image3_externGenImage3ExternGenImage3Externgen_image3_extern

Siehe auch

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, paint_graypaint_grayPaintGrayPaintGraypaint_gray, paint_regionpaint_regionPaintRegionPaintRegionpaint_region, set_grayvalset_grayvalSetGrayvalSetGrayvalset_grayval

Modul

Foundation

Operatoren