ColdFusion 9.0 Resources |
ImageScaleToFitParameters
UsageUse this operation to resize images or create thumbnail images while maintaining the aspect ratio. Specify the fitWidth and FitHeight parameters; either the fitWidth or the fitHeight can be an empty string: <cfset ImageScaleToFit(myImage,100,"")> In this example, the ImageScaleToFit function resizes the image so that it fits in a 100x100-pixel square; the width of the resulting image is 100 pixels and the height is less than or equal to 100 pixels. For example, if the source image is 400x200 pixels, the resulting image is 100x50 pixels. Likewise, if you specify the fitHeight parameter and an empty string for the fitWidth parameter, the ImageScaleToFit function resizes the image so that the height equals the fitHeight parameter and the width of the image is scaled proportionately: <cfset ImageScaleToFit(myImage,"",100)> In this example, a 400x200-pixel source image is resized to 200x100 pixels, and a 200x400-pixel image is resized to 50x100 pixels. If you set both the fitWidth and the fitHeight parameters, the ImageScaleToFit function resizes the image proportionately so that both conditions are true: the width of the resulting image is less than or equal to the fitWidth, and the height is less than or equal to the fitHeight: <cfset ImageScaleToFit(myImage,100,200)> In this example, a 400x200-pixel source image is resized to 100x50 pixels, and a 200x400-pixel source image is resized to 100x200 pixels. Use the ImageSetAntialiasing function to improve the quality of the rendered image. Example<!--- This example shows how to resize an image to fit a 100x100-pixel square while maintaining the aspect ratio. ---> <!--- Create a ColdFusion image from an existing JPEG file. ---> <cfimage source="../cfdocs/images/artgallery/jeff05.jpg" name="myImage"> <!--- Turn on antialiasing to improve image quality. ---> <cfset ImageSetAntialiasing(myImage,"on")> <cfset ImageScaleToFit(myImage,100,"","lanczos")> <!--- Display the modified image in a browser. ---> <cfimage source="#myImage#" action="writeToBrowser"> |