ImageCFC: Documentation: Method Description

imageCFC.rotate()

Description

rotates an image in 90 degree increments.

Returns

A structure containing the following fields:

keyvalue
errorCode0 for success, non-zero for failure. Always returned, but not really used if the throwOnError option is set to true.
errorMessageA description of the error. Always returned, but not really used if the throwOnError option is set to true.
imgA java BufferedImage object is returned if no output file is specified

Function Syntax

rotate(objImage,inputFile,outputFile,degrees,jpegCompression)

ParameterRequired?DefaultDescription
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.

Example

<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."/>


Please read this project's LICENSE

This is an open source project written by Rick Root. Please visit The Coldfusion Open Source Blog for more information.

Please report bugs, make suggestions, and send compliments to me via email.