imageRotate

Rotates a ColdFusion image at a specified point by a specified angle.

imageRotate(name [, x] [, y] , angle [, interpolation]) → returns void

Member Function Syntax

someImage.rotate([, x] [, y] , angle [, interpolation])

  1. CFDocs
  2. Functions
  3. ColdFusion 8 New Functions and Tags
  4. imageRotate
  5. CF8+
  6. Lucee4.5+
  7. BL 1.0.0+
  8. 0 Issue
  9. Edit
See Also:   imageFlip

Argument Reference

name string
Required

The image on which this operation is performed.

angle numeric
Required

The rotation angle in degrees.

x numeric
Default: 2

The x coordinate for the point of rotation

y numeric
Default: 2

The y coordinate for the point of rotation

interpolation string
Default: nearest

Type of interpolation

nearest: Applies the nearest neighbor method of interpolation. Image quality is lower than the other interpolation methods, but processing is fastest.
bilinear: Applies the bilinear method of interpolation. The quality of the image is less pixelated than the default, but processing is slower.
bicubic: Applies the bicubic method of interpolation. Generally, the quality of image is highest with this method and processing is slowest.
Values:
  • nearest
  • bilinear
  • bicubic

Compatibility

BoxLang:

Version 1.0.0+ Requires the bx-image module.

Examples
Sample code invoking the imageRotate function

This example shows how to rotate an image by 10 degrees. 

<cfset myImage=imageRead("http://cfdocs.org/apple-touch-icon.png")><!--- Rotate the image by 10 degrees. ---> 
 <cfset imageRotate(myImage,10)> 
 <cfimage source="#myImage#" action="writeToBrowser">

CF 11+ Rotate an image

imgObj = imageRead("http://cfdocs.org/apple-touch-icon.png");
imgObj.rotate(90);
cfimage(action="writeToBrowser", source=imgObj);

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub