pixelate

pixelate ( integer Input, integer Output, integer Width, integer Height )

Use this function create a mosaic effect. The filter works by dividing an image or selection into small rectangles and averaging intensity within each rectangle.

Parameters

Input

An integer between 0 and 116 specifying the input image frame number. A value of 0 represents the DMA memory buffer of the video device. Values in the range of 100-116 correspond to hidden frames.

Output

An integer between 1 and 116 specifying the output image frame number. Values in the range of 100-116 correspond to hidden frames.

Width

An integer between 1 and 2*Overscan+1 specifying the width of the rectangular blocks composing the mosaic image. The Overscan setting is defined in ImageWarp Preferences.

Height

A positive integer specifying the height of the rectangular blocks composing the mosaic image.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This set of statements continuously captures and pixelates an image. The width and height of the mosaic can be adjusted in real time with custom controls:

Control(0).SetTitle("Mosaic Width")

Control(0).SetRange(1,128)

Control(0).value=8

Control(1).SetTitle("Mosaic Height")

Control(1).SetRange(1,128)

Control(1).value=8

do

grabIm (0)

pixelate (0, 1, Control(0).value, Control(1).value)

loop while getError()=ERR_OK