You are here: Start » FIL.NET » FIL.CheckPresence_EdgeAmount

FIL.CheckPresence_EdgeAmount

Verifies object presence by analysing the amount of edges in the specified region.

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void CheckPresence_EdgeAmount
(
	FilNet.Image inImage,
	FilNet.ShapeRegion inRoi,
	FilNet.CoordinateSystem2D? inRoiAlignment,
	FilNet.GradientMaskOperator inEdgeOperator,
	FilNet.MagnitudeMeasure inEdgeMeasure,
	int inEdgeScale,
	int inMinStrength,
	float inMinAmount,
	float inMaxAmount,
	out bool outIsPresent,
	out float outAmount,
	FilNet.Region outForeground,
	out FilNet.ShapeRegion outAlignedRoi
)

Parameters

Name Type Range Default Description
inImageFilNet.ImageInput image.
inRoiFilNet.ShapeRegionLocation at which object presence is being checked.
inRoiAlignmentFilNet.CoordinateSystem2D?Adjusts the region of interest to the position of the inspected object. Default value: ftl::NIL.
inEdgeOperatorFilNet.GradientMaskOperatorSelected gradient operator.
inEdgeMeasureFilNet.MagnitudeMeasureSumSelected method of gradient magnitude computation. Default value: Sum.
inEdgeScaleint<1, 16>1Scales the resulting gradient magnitudes. Default value: 1.
inMinStrengthint<0, 255>15Lowest acceptable edge magnitude. Default value: 15.
inMinAmountfloat<0.0f, 1.0f>0.2fLowest acceptable fraction of pixels meeting the criteria. Default value: 0.2f.
inMaxAmountfloat<0.0f, 1.0f>1.0fHighest acceptable fraction of pixels meeting the criteria. Default value: 1.0f.
outIsPresentboolFlag indicating whether the object is present or not.
outAmountfloatFraction of pixels from meeting the criteria.
outForegroundFilNet.RegionRegion of pixels meeting the criteria.
outAlignedRoiFilNet.ShapeRegionInput ROI after transformation (in the image coordinates).

Description

The filter extracts foreground pixels and checks if their number comparing to the area of the whole ROI fits the range (inMinAmount, inMaxAmount). The pixel is considered a foreground pixel if and only if its gradient magnitude is at least inMinStrength.

Examples

CheckPresence_EdgeAmount performed on sample images with inMinAmount = 0.2. In the left image the object is present, while in the right image it is not. Green pixels are foreground pixels.

Function Overrides

See also