| Operatoren |
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!
Bilder, deren Grauwerttyp geändert werden sollen.
Ergebnisbild.
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
| Operatoren |