gauss

gauss ( integer Input, integer Output, integer Size, floating Sigma )

Use this function to apply the discrete Gaussian filter to an image or selection. The filter's kernel is based on the discrete approximation of the isotropic 2D Gaussian distribution:

The effect is similar to the one of the lowpass filter, but it degrades the image less while reducing the noise.

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 odd integer between 1 and 2*Overscan+1 specifying the size of the Gaussian kernel. This value determines the standard deviation (sigma) of the Gaussian distribution, so that the kernel is effectively truncated at the point of three sigma.. The Overscan setting is defined in ImageWarp Preferences.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This statement performs the lowpass filtration of the image 1 using the window of size 7:

gauss (1, 1, 7)