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__ before calling this operator.
If the source and destination image type are identical, no new image matrix is allocated.
Image (input_object) |
image(-array) -> object : any |
Image whose image type is to be changed. |
ImageConverted (output_object) |
image(-array) -> object : any |
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', 'int4', 'byte', 'real', 'direction', 'cyclic', 'complex', 'dvf', 'lut' |
convert_image_type__ returns 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.