Lucee Function Reference

imagescaletofit()

Creates a resized image with the aspect ratio maintained.

Example

imagescaletofit(any image,string fitWidth,string fitHeight,[string interpolation,[number blurFactor]]):void

Category

image

Arguments

The arguments for this function are set. You can not use other arguments except the following ones.
Name Type Required Default Value Description
image any  Yes   The image on which this operation is performed.  
fitWidth string  Yes   The width of the bounding box in pixels. You can specify an integer, or an empty string ("") if the fitHeight is specified.  
fitHeight string  Yes   The height of the bounding box in pixels. You can specify an integer, or an empty string ("") if the fitWidth is specified.  
interpolation string  No automatic The interpolation method for resampling. You can specify a specific interpolation algorithm by name (for example, hamming), by image quality (for example, mediumQuality), or by performance (for example, highestPerformance). Valid values are:
  • automatic (default)
  • highestQuality
  • highQuality
  • mediumQuality
  • highestPerformance
  • highPerformance
  • mediumPerformance
  • nearest
  • bilinear
  • bicubic
  • bessel
  • blackman
  • hamming
  • hanning
  • hermite
  • lanczos
  • mitchell
  • quadratic  
  • blurFactor number  No 1 The blur factor used for resampling. The higher the blur factor, the more blurred the image (also, the longer it takes to resize the image). Valid values are 1-10.