rotates an image in 90 degree increments.
A structure containing the following fields:
| key | value |
|---|---|
| errorCode | 0 for success, non-zero for failure. Always returned, but not really used if the throwOnError option is set to true. |
| errorMessage | A description of the error. Always returned, but not really used if the throwOnError option is set to true. |
| img | A java BufferedImage object is returned if no output file is specified |
rotate(objImage,inputFile,outputFile,degrees,jpegCompression)
| Parameter | Required? | Default | Description |
|---|---|---|---|
| objImage | YES | - | A java image object, or a blank string. |
| inputFile | YES | - | File path or URL to an image, or a blank string. |
| outputFile | YES | - | File path to write the output, or a blank string. |
| degrees | YES | - | Number of degrees to rotate the image. Can be positive or negative values of 90, 180, or 270. |
| jpegCompression | NO | defaultJpegCompression | jpeg compression quality to use if writing a jpeg file. 0-100. 100 is the highest quality. |
You must supply either an image object or a file path to a source image.
<cfset imageCFC = createObject("component","image")>
<cfset imgInfo = imageCFC.rotate("", "C:\Inetpub\wwwroot\myimage.jpg", "C:\Inetpub\wwwroot\myimage2.jpg",90)>
<img src="myimage2.jpg" alt="image rotated 90 degrees clockwise."/>
<cfset imgInfo = imageCFC.rotate("", "C:\Inetpub\wwwroot\myimage.jpg", "C:\Inetpub\wwwroot\myimage3.jpg",-90)>
<img src="myimage3.jpg" alt="image rotated 90 degrees counter-clockwise."/>