GrayEdge Method

NI Vision for Visual Basic

GrayEdge Method

Syntax

CWIMAQVision.GrayEdge SourceImage, DestImage, EdgeMethod [, Threshold = 0] [, MaskImage]

Return Type

Long

On success, this method returns 0. On failure, this method returns a negative number.

Purpose

Obsolete—Use EdgeFilter instead. Applies a nonlinear filter to highlight edges.

Remarks

Use this function with U8, I16, and SGL images. MaskImage must be a U8 image.

SourceImage and DestImage must be the same type of image. SourceImage must have a minimum border width of 1 pixel. The border size of DestImage is not important.

This function is optimized for MMX.

Parameters

SourceImage As CWIMAQImage

The input image.

DestImage As CWIMAQImage

The resulting image.

EdgeMethod As CWIMAQGrayEdgeMethods

The method to use when outlining the edges. For more information about filtering, refer to the NI Vision Concepts Manual.

Threshold As Variant

[Optional] The minimum pixel value to appear in the resulting image. Setting this parameter to a value greater than 0 may produce very dark images with low dynamic ranges.

This parameter has a default value of 0.

MaskImage As Variant

[Optional] A CWIMAQImage object that contains the mask applied to the source image. The method processes only those pixels in the image whose corresponding pixels in the mask are non-zero. Do not set this parameter if you want to apply the filter to the entire image.

See Also

EdgeFilter