crops an image.
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 |
crop(objImage,inputFile,outputFile,startX,startY,newWidth,newHeight,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. |
| fromX | YES | - | X coordinate of the upper left corner of the cropped image. |
| fromY | YES | - | Y coordinate of the upper left corner of the cropped image. |
| newWidth | YES | - | Width in pixels of the resulting image. |
| newHeight | YES | - | Height in pixels of the resulting image. |
| 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.crop("", "C:\Inetpub\wwwroot\myimage.jpg", "C:\Inetpub\wwwroot\myimage2.jpg",1,1,100,200)>
<img src="myimage2.jpg" width="100" height="200" alt="cropped image to 100x200 starting at the upper left corner."/>