Convert the type of an image.
convert_image_type converts images of an arbitrary type into an arbitrary new image type. If the conversion is done from a larger to a smaller gray value range (e.g., from 'int4' to 'byte'), too large or too small values are simply ``clipped.'' It is therefore advisable to adapt the range of gray values by calling scale_image before calling this operator.
If the source and destination image type are identical, no new image matrix is allocated.
|
Image (input_object) |
(multichannel-)image(-array) -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real |
| Image whose image type is to be changed. | |
|
ImageConverted (output_object) |
(multichannel-)image(-array) -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex |
| Converted image. | |
|
NewType (input_control) |
string -> string |
| Desired image type (i.e., type of the gray values). | |
| Default value: 'byte' | |
| List of values: 'int1', 'int2', 'uint2', 'int4', 'byte', 'real', 'direction', 'cyclic', 'complex' | |
convert_image_type returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behaviour can be set via set_system('no_object_result',<Result>). If necessary, an exception is raised.
convert_image_type is reentrant and automatically parallelized (on tuple level, channel level, domain level).
Image / region / XLD management
