Creates a resized image with the aspect ratio maintained.
Requires Extension: Image extension
ImageScaleToFit( image=any, fitWidth=string, fitHeight=string, interpolation=string, blurFactor=number );
Argument |
Description |
Default |
image
any,
required
|
The image on which this operation is performed.
Alias:
name
|
|
fitWidth
string,
required
|
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
|
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
|
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
|
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
myImg = imageNew("",400,400,"rgb","70a1ff");
imageScaleToFit(myImg,80,"","hamming");
cfimage(action="writeToBrowser", source=myImg);
See also