ImageScaleToFit()

edit

Creates a resized image with the aspect ratio maintained.

Requires Extension: Image Extension for Jakarta EE (Lucee 7+)

ImageScaleToFit( image=any, fitWidth=string, fitHeight=string, interpolation=string, blurFactor=number );

Returns: void

Argument Description Default
image
any, required 		edit

The image on which this operation is performed.

Alias: name
fitWidth
string, required 		edit

The width of the bounding box in pixels. You can specify an integer, or an empty string ("") if the fitHeight is specified.
fitHeight
string, required 		edit

The height of the bounding box in pixels. You can specify an integer, or an empty string ("") if the fitWidth is specified.
interpolation
string, optional 		edit

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:

  • highestQuality (default)
  • highQuality
  • mediumQuality
  • highestPerformance
  • highPerformance
  • mediumPerformance
  • nearest
  • bilinear
  • bicubic
  • bessel
  • blackman
  • hamming
  • hanning
  • hermite
  • lanczos
  • mitchell
  • quadratic

automatic
blurFactor
number, optional 		edit

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.

1

Examples

edit 
myImg = imageNew("",400,400,"rgb","70a1ff");
imageScaleToFit(myImg,80,"","hamming");
cfimage(action="writeToBrowser", source=myImg);

See also