gen_image3gen_image3GenImage3gen_image3GenImage3GenImage3 (Operator)

Name

gen_image3gen_image3GenImage3gen_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_image3GenImage3gen_image3GenImage3GenImage3 erzeugt ein dreikanaliges Bild in der Größe WidthWidthWidthWidthWidthwidth * HeightHeightHeightHeightHeightheight. Die Pixel in PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed, PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreen und PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBlue sind zeilensequentiell abgelegt. Der Typ der übergebenen Pixel (PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed etc.) muss mit TypeTypeTypeTypeTypetype übereinstimmen (siehe gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst 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.

Parallelisierung

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

Parameter

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

Erzeugtes Bild mit neuer Bildmatrix.

TypeTypeTypeTypeTypetype (input_control) string → (string)

Pixeltyp.

Defaultwert: 'byte' "byte" "byte" "byte" "byte" "byte"

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

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed (input_control) pointer → (integer)

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

PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreen (input_control) pointer → (integer)

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

PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBlue (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);
  clear_obj(rgb);
}

Ergebnis

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

Vorgänger

gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst, get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1

Nachfolger

disp_colordisp_colorDispColordisp_colorDispColorDispColor

Alternativen

gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1, compose3compose3Compose3compose3Compose3Compose3, gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst

Siehe auch

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval, get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1, decompose3decompose3Decompose3decompose3Decompose3Decompose3

Modul

Foundation

Operatoren