gen_image3gen_image3GenImage3GenImage3 (Operator)

Name

gen_image3gen_image3GenImage3GenImage3 — Erzeugen eines Bildes aus drei Zeigern auf die Pixel (rot/grün/blau).

Signatur

gen_image3( : ImageRGB : Type, Width, Height, PixelPointerRed, PixelPointerGreen, PixelPointerBlue : )

Beschreibung

gen_image3gen_image3GenImage3GenImage3GenImage3 erzeugt ein dreikanaliges Bild in der Größe WidthWidthWidthWidthwidth * HeightHeightHeightHeightheight. Die Pixel in PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed, PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreen und PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBlue sind zeilensequentiell abgelegt. Der Typ der übergebenen Pixel (PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed etc.) muss mit TypeTypeTypeTypetype übereinstimmen (siehe gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst für eine detailliertere Beschreibung der Pixeltypen). Der Speicher für das neue Bild wird von HALCON neu angelegt. Er kann also nach dem Aufruf freigegeben werden. 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.

Achtung

gen_image3_externgen_image3_externGenImage3ExternGenImage3ExternGenImage3Extern überprüft nicht, ob die Pixel in PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed, PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreen und PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBlue einen gültigen Wert haben oder nicht. Es muss also darauf geachtet werden, dass diese Werte gültig sind, 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

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

Erzeugtes Bild mit neuer Bildmatrix.

TypeTypeTypeTypetype (input_control) string → (string)

Pixeltyp.

Defaultwert: '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.

Defaultwert: 512

Wertevorschläge: 128, 256, 512, 1024

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

HeightHeightHeightHeightheight (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 ≤ 512 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed (input_control) pointer → (integer)

Zeiger auf den ersten Rot-Wert (Kanal 1).

PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreen (input_control) pointer → (integer)

Zeiger auf den ersten Grün-Wert (Kanal 2).

PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBlue (input_control) pointer → (integer)

Zeiger auf den ersten Blau-Wert (Kanal 3).

Beispiel (C)

void NewRGBImage(Hobject *new)
{
  unsigned char  red[768*525];
  unsigned char  green[768*525];
  unsigned char  blue[768*525];
  int            r,c;
  for (r=0; r<525; r++)
    for (c=0; c<768; c++)
    {
      red[r*768+c]   = c % 255;
      green[r*768+c] = (767 - c) % 255;
      blue[r*768+c]  = r % 255;
    }
    gen_image3(new,"byte",768,525,(Hlong)red,(long)green,(long)blue);
}

main()
{
  Hobject  rgb;
  open_window(0,0,768,525,0,"","",&WindowHandle);
  NewRGBImage(&rgb);
  disp_color(rgb,WindowHandle);
}

Ergebnis

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

Vorgänger

gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1

Nachfolger

disp_colordisp_colorDispColorDispColorDispColor

Alternativen

gen_image1gen_image1GenImage1GenImage1GenImage1, compose3compose3Compose3Compose3Compose3, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst

Siehe auch

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, paint_graypaint_grayPaintGrayPaintGrayPaintGray, paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayval, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1, decompose3decompose3Decompose3Decompose3Decompose3

Modul

Foundation

Operatoren