convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeconvert_image_type (Operator)

Name

convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeconvert_image_type — Umwandeln des Bildtyps.

Signatur

convert_image_type(Image : ImageConverted : NewType : )

Beschreibung

convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeconvert_image_type konvertiert Bilder eines beliebigen Bildtyps in einen beliebigen Bildtyp. Erfolgt die Konvertierung von einem größeren in einen kleineren Grauwertbereich (z.B. von 'int4' nach 'byte') werden zu große oder zu kleine Werte einfach „geclippt“. Sind die Ergebnisbilder vom Typ 'direction', werden Grauwerte, die nicht innerhalb des für 'direction'-Bilder erlaubten Wertebereichs liegen, auf den Wert 255 gesetzt, um sie als ungültig zu kennzeichnen. Es empfiehlt sich daher, vor Aufruf der Routine den Wertebereich der Grauwerte im Eingabebild mittels scale_imagescale_imageScaleImageScaleImagescale_image entsprechend anzupassen. Bei der Konversion von Bildern vom Typ complex wird nur der Realteil konvertiert. Der Imaginärteil wird ignoriert. Dies erlaubt eine effiziente Konversion von Bildern, die mit fft_genericfft_genericFftGenericFftGenericfft_generic aus dem Frequenzraum zurücktransformiert worden sind. Solche Bilder haben immer einen Imaginärteil von 0.

Achtung

Stimmen der Ziel- und der Quelltyp überein, dann wird keine neue Bildmatrix angelegt. Die Konvertierung in 'int8' Bilder ist nur auf 64-Bit-Systemen möglich!

Ausführungsinformationen

Unterstützt OpenCL Compute Devices.
Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.
Automatisch parallelisiert auf Kanalebene.
Automatisch parallelisiert auf Domainebene.

Parameter

ImageImageImageimageimage (input_object) (multichannel-)image(-array) → object (byte* / direction* / cyclic* / int1* / int2* / uint2* / int4* / int8 / real* / complex*) *erlaubt für Compute Devices

Bilder, deren Grauwerttyp geändert werden sollen.

ImageConvertedImageConvertedImageConvertedimageConvertedimage_converted (output_object) (multichannel-)image(-array) → object (byte* / direction* / cyclic* / int1* / int2* / uint2* / int4* / int8 / real* / complex*) *erlaubt für Compute Devices

Ergebnisbild.

NewTypeNewTypeNewTypenewTypenew_type (input_control) string → (string)

Gewünschter Bildtyp (i.e. Typ der Grauwerte).

Default: '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"

Werteliste (für Compute Devices): 'int1'"int1""int1""int1""int1", 'int2'"int2""int2""int2""int2", 'uint2'"uint2""uint2""uint2""uint2", 'int4'"int4""int4""int4""int4", 'byte'"byte""byte""byte""byte", 'real'"real""real""real""real", 'direction'"direction""direction""direction""direction", 'cyclic'"cyclic""cyclic""cyclic""cyclic", 'complex'"complex""complex""complex""complex"

Ergebnis

convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeconvert_image_type liefert den Wert 2 ( H_MSG_TRUE) , falls die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

scale_imagescale_imageScaleImageScaleImagescale_image

Siehe auch

scale_imagescale_imageScaleImageScaleImagescale_image, abs_imageabs_imageAbsImageAbsImageabs_image

Modul

Foundation

Operatoren