emboss

emboss ( integer Input, integer Output [, integer Invert =0 ] )

Use this function create a 3D-effect by making different levels of intensity appear at different heights.

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.

Size

An integer between 1 and 2*Overscan+1 specifying the size of the square neighborhood in which the variance is calculated. The Overscan setting is defined in ImageWarp Preferences.

Invert

A boolean integer that describes the relationship between the intensity in the input image and appearance of the relief in the output image. Must be one of the following values:

FALSE – the direct mode. "Dents" in the output image will correspond to dark areas in the input image.

TRUE – the inverse mode. "Dents" in the output image will correspond to bright areas in the input image.

Default: FALSE

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This set of statements continuously captures an image and applies the emboss filter to it:

do

grabIm (0)

emboss (0, 1)

loop while getError()=ERR_OK