gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1 (Operator)

Name

gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1 — Erzeugen eines Bildes aus einem Zeiger auf die Pixel.

Signatur

gen_image1( : Image : Type, Width, Height, PixelPointer : )

Beschreibung

gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1 erzeugt ein Bild in der Größe WidthWidthWidthWidthWidthwidth * HeightHeightHeightHeightHeightheight. Die Pixel in PixelPointerPixelPointerPixelPointerPixelPointerPixelPointerpixelPointer sind zeilensequentiell abgelegt. Der Typ der übergebenen Pixel (PixelPointerPixelPointerPixelPointerPixelPointerPixelPointerpixelPointer) 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. Der Speicherplatz auf den PixelPointerPixelPointerPixelPointerPixelPointerPixelPointerpixelPointer 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

ImageImageImageImageImageimage (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

Restriktion: Width >= 1

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

Restriktion: Height >= 1

PixelPointerPixelPointerPixelPointerPixelPointerPixelPointerpixelPointer (input_control) pointer → (integer)

Zeiger auf den ersten Grauwert.

Beispiel (C)

void NewImage(Hobject *new)
{
  unsigned char  image[768*525];
  int            r,c;
  for (r=0; r<525; r++)
    for (c=0; c<768; c++)
      image[r*768+c] = c % 255;
  gen_image1(new,"byte",768,525,(Hlong)image);
}

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1 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

Alternativen

gen_image3gen_image3GenImage3gen_image3GenImage3GenImage3, gen_image1_externgen_image1_externGenImage1Externgen_image1_externGenImage1ExternGenImage1Extern, gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst, get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1

Siehe auch

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval

Modul

Foundation

Operatoren