imageCrop
Description
Crops a ColdFusion image to a specified rectangular area.
Categories
Related
History
ColdFusion
8: Added this function.
Syntax
ImageCrop(name, x, y, width, height)
Attributes
| Attribute | Description | Required | Default |
|---|---|---|---|
| height | Required. The height of the crop area. | ||
| name | Required. The ColdFusion image on which this operation is performed. | ||
| width | Required. The width of the crop area. | ||
| x | Required. The x origin of the crop area. | ||
| y | Required. The y origin of the crop area. |
Returns
Nothing.
Usage
The rectangular area cannot be empty, and must be fully contained within the source image bounds.
Example
<!--- This example shows how to crop an image. ---> <!--- Create a ColdFusion image from an existing JPEG file. ---> <cfimage source="../cfdocs/images/artgallery/lori05.jpg" name="myImage"> <!--- Crop myImage to 100x100 pixels starting at the coordinates (10,10). ---> <cfset ImageCrop(myImage,10,10,100,100)> <!--- Write the result to a file. ---> <cfimage source="#myImage#" action="write" destination="test_myImage.jpg" overwrite="yes"> <!--- Display the source image and the new image. ---> <img src="../cfdocs/images/artgallery/lori05.jpg"/> <img src="test_myImage.jpg"/>