gen_image_constgen_image_constGenImageConstGenImageConst (Operator)

Name

gen_image_constgen_image_constGenImageConstGenImageConst — Erzeugen eines Bildes mit konstantem Grauwert.

Signatur

gen_image_const( : Image : Type, Width, Height : )

Beschreibung

gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst erzeugt ein Bild in der angegebenen Größe. Die Breite und Höhe des Bildes wird mit WidthWidthWidthWidthwidth und HeightHeightHeightHeightheight festgelegt. HALCON unterstützt folgende Bildtypen:

'byte'

1 Byte pro Pixel, ohne Vorzeichen

Wertebereich: (0..255)

'int1'

1 Byte pro Pixel, mit Vorzeichen

Wertebereich: (-128..127)

'uint2'

2 Byte pro Pixel, ohne Vorzeichen

Wertebereich: (0..65535)

'int2'

2 Byte pro Pixel, mit Vorzeichen

Wertebereich: (-32768..32767)

'int4'

4 Byte pro Pixel, mit Vorzeichen

Wertebereich: (-2147483648..2147483647)

'int8'

8 Byte pro Pixel, mit Vorzeichen (nur auf 64-Bit-Systemen verfügbar)

Wertebereich: (-9223372036854775808..9223372036854775807)

'real'

4 Byte pro Pixel, Fließkomma

Wertebereich: (-3.4e38..3.4e38)

Genauigkeit: 6 Stellen

'complex'

zwei Matrizen vom Typ 'real'"real""real""real""real"

'vector_field_relative'

zwei Matrizen vom Typ 'real'"real""real""real""real"

Interpretation: Vektoren

'vector_field_absolute'

zwei Matrizen vom Typ 'real'"real""real""real""real"

Interpretation: Absolute Koordinaten

'direction'

1 Byte pro Pixel, ohne Vorzeichen

Wertebereich: (0..179)

Interpretation: Halber Winkel

Achtung: Die Werte 180..254 werden auf den Wert 255 gesetzt, der als undefinierter Winkel interpretiert wird.

'cyclic'

1 Byte pro Pixel, ohne Vorzeichen, zyklische Arithmetik

Wertebereich: (0..255)

Ob das erzeugte Bild mit 0 initialisiert wird oder nicht, wird mit set_system('init_new_image',<'true'/'false'>)set_system("init_new_image",<"true"/"false">)SetSystem("init_new_image",<"true"/"false">)SetSystem("init_new_image",<"true"/"false">)SetSystem("init_new_image",<"true"/"false">) festgelegt.

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 / int8 / real / complex / vector_field)

Erzeugtes Bild mit neuer Bildmatrix.

TypeTypeTypeTypetype (input_control) string → (string)

Pixeltyp.

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

Werteliste: 'byte'"byte""byte""byte""byte", 'complex'"complex""complex""complex""complex", '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", 'int8'"int8""int8""int8""int8", 'real'"real""real""real""real", 'uint2'"uint2""uint2""uint2""uint2", 'vector_field_absolute'"vector_field_absolute""vector_field_absolute""vector_field_absolute""vector_field_absolute", 'vector_field_relative'"vector_field_relative""vector_field_relative""vector_field_relative""vector_field_relative"

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

Restriktion: Width >= 1

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

Restriktion: Height >= 1

Beispiel (C)

gen_image_const(&New,"byte",width,height);
get_image_pointer1(New,(Hlong*)&pointer,type,&width,&height);
for (row=0; row<height-1; row++)
{
  for (col=0; col<width-1; col++)
  {
    pointer[row*width+col] = (row + col) % 256;
  }
}

Ergebnis

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

Nachfolger

paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1, copy_objcopy_objCopyObjCopyObjCopyObj

Alternativen

gen_image1gen_image1GenImage1GenImage1GenImage1, gen_image3gen_image3GenImage3GenImage3GenImage3

Siehe auch

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, paint_graypaint_grayPaintGrayPaintGrayPaintGray, paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayval, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1

Modul

Foundation

Operatoren