rotate_image — Rotate an image about its center.
rotate_image rotates the Image counterclockwise by Phi degrees about its center and stores the result in the output image ImageRotate. The output image has the same size as the input image. The only exception are rotations by 90 and 270 degrees where width and height will be exchanged. The domain of the input image is ignored, i.e., assumed to be the full rectangle of the image. The domain of the output image is the intersection of the transformed rectangle and the rectangle of the ouput image.
If Phi is a multiple of 90 degrees, this operator is much faster, especially than the general operator affine_trans_image. The effect of the parameter Interpolation is the same as in affine_trans_image. It is ignored for rotations by 90, 180, and 270 degrees. If it is necessary to rotate the domain, too, the operator projective_trans_image has to be used.
The domain of the input image is ingnored, i.e., assumed to be the full rectangle of the image. The domain of the output image is the intersection of the transformed rectangle and the rectangle of the output image. The angle Phi is given in degrees, not in radians. For rotations by 90, 180, and 270 degrees rotate_image is not parallelized internally!
rotate_image can be executed on OpenCL devices if the input image does not exceed the maximum size of image objects of the selected device. Due to numerical reasons, there can be slight differences in the output compared to the execution on the CPU.
Default value: 90
Suggested values: 90, 180, 270
Typical range of values: 0 ≤ Phi ≤ 360
Minimum increment: 0.001
Recommended increment: 0.2
Type of interpolation.
Default value: 'constant'
List of values: 'bilinear', 'constant', 'nearest_neighbor', 'weighted'
read_image(Image,'monkey') dev_display (Image) rotate_image(Image,RotImage,270,'constant') dev_display (RotImage)