CNSImage_Filter

Description

With this function, you can apply a filter to an image. CNS Image currently has filters available to Blur, Contrast, Edge, Emboss, Modulate, and Sharpen. Look for more filters to be added in the future.

Return Type

Container

Format

CNSImage_Filter ( Image ; Type ; ... )

Required Parameters

• Image
  

  A Container field that contains an Image or a Path and File Name to an Image you want to Filter.

• Type
  

  The Filter Type you want to apply.

Optional Parameters

• ...
  

  Any extra parameters the Filter Type needs.

  Blur
  CNSImage_Filter( Image ; "Blur" ; Radius ; Amount )

  Contrast
  CNSImage_Filter( Image ; "Contrast" ; Sharpen )

  Edge
  CNSImage_Filter( Image ; "Edge" ; Radius )

  Emboss
  CNSImage_Filter( Image ; "Emboss" ; Radius ; Amount )

  Modulate
  CNSImage_Filter( Image ; "Modulate" ; Brightness ; Saturation ; Hue )

  Sharpen
  CNSImage_Filter( Image ; "Sharpen" ; Radius ; Amount )

Examples

Example 1

Code:

CNSImage_Filter( Image ;"Blur"; 25 ; 10 )

Result:

Blurs the image in the Image field.

Example 2

Code:

CNSImage_Filter( Image ;"Contrast";"Yes")

Result:

Contrasts the image in the Image field.

Example 3

Code:

CNSImage_Filter( Image ;"Modulate"; 150 )

Result:

Brightens the image by 150%

Example 4

Code:

CNSImage_Filter( Image ;"Edge"; 2 )

Result:

Applies the Edge filter to the image in the Image field.

Example 5

Code:

CNSImage_Filter( Image ;"Emboss"; 1 ; 2 )

Result:

Embosses the image in the Image field.

Example 6

Code:

CNSImage_Filter( Image ;"Modulate"; 100 ; 100 ; 5 )

Result:

Rotates the Hue of the image by 5 degrees while keeping the Brightness and Saturation the same.

Example 7

Code:

CNSImage_Filter( Image ;"Sharpen"; 60 ; 30 )

Result:

Sharpens the image in the Image field.