convert_image_type__ ( Image : ImageConverted : NewType : )

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.


Attention

If the source and destination image type are identical, no new image matrix is allocated.


Parameters

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'


Result

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.


Possible Predecessors

scale__


See also

scale__, abs1__



Copyright © 1996-1997 MVTec Software GmbH