convert_image_type
— Umwandeln des Bildtyps.
convert_image_type(Image : ImageConverted : NewType : )
convert_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_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_generic
aus dem
Frequenzraum zurücktransformiert worden sind. Solche Bilder haben
immer einen Imaginärteil von 0.
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!
Image
(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.
ImageConverted
(output_object) (multichannel-)image(-array) →
object (byte* / direction* / cyclic* / int1* / int2* / uint2* / int4* / int8 / real* / complex*) *erlaubt für Compute Devices
Ergebnisbild.
NewType
(input_control) string →
(string)
Gewünschter Bildtyp (i.e. Typ der Grauwerte).
Defaultwert: 'byte'
Werteliste: 'byte' , 'complex' , 'cyclic' , 'direction' , 'int1' , 'int2' , 'int4' , 'int8' , 'real' , 'uint2'
Werteliste (für Compute Devices): 'int1' , 'int2' , 'uint2' , 'int4' , 'byte' , 'real' , 'direction' , 'cyclic' , 'complex'
convert_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>)
festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Foundation