Applies an Posterize filter to an image.
A structure containing the following fields:
| key | value |
|---|---|
| errorCode | 0 for success, non-zero for failure. Always returned, but not really used if the throwOnError option is set to true. |
| errorMessage | A description of the error. Always returned, but not really used if the throwOnError option is set to true. |
| img | A java BufferedImage object is returned if no output file is specified |
Added to image.cfc version 2.10
filterPosterize(objImage,inputFile,outputFile,amount,jpegCompression)
| Parameter | Required? | Default | Description |
|---|---|---|---|
| objImage | YES | - | A java image object, or a blank string. |
| inputFile | YES | - | File path or URL to an image, or a blank string. |
| outputFile | YES | - | File path to write the output, or a blank string. |
| amount | YES | - | A number that determines the number of colors in the final image. The number of colors is (256/amount)^3, so if amount=32, then the final number of colors will be 512, evenly distributed. |
| jpegCompression | NO | defaultJpegCompression | jpeg compression quality to use if writing a jpeg file. 0-100. 100 is the highest quality. |
You must supply either an image object or a file path to a source image.
<cfset imageCFC = createObject("component","image")>
<cfset imgInfo = imageCFC.filterPosterize("", "C:\Inetpub\wwwroot\myimage.jpg", "C:\Inetpub\wwwroot\myimage2.jpg",32)>
<img src="myimage2.jpg" alt="filtered image"/>