You are here: Start » Function Reference » Computer Vision » Image Analysis » CheckPresence_Intensity_Deprecated

CheckPresence_Intensity_Deprecated

Header:	FIL.h
Namespace:	fil
Module:	FoundationPro

Verifies object presence by analysing pixel intensities in the specified region.

Applications: Quick and easy presence verification, e.g. for missing caps, screws, labels.

Syntax

void fil::CheckPresence_Intensity_Deprecated
(
	const fil::Image& inImage,
	const fil::ShapeRegionDeprecated& inRoi,
	ftl::Optional<const fil::CoordinateSystem2D&> inRoiAlignment,
	ftl::Optional<float> inMinIntensity,
	ftl::Optional<float> inMaxIntensity,
	float inMinContrast,
	ftl::Optional<float> inMaxContrast,
	bool& outIsPresent,
	ftl::Optional<float&> outIntensity = ftl::NIL,
	ftl::Optional<float&> outContrast = ftl::NIL,
	ftl::Optional<fil::ShapeRegionDeprecated&> outAlignedRoi = ftl::NIL
)

Parameters

Name	Type	Range	Default	Description
inImage	const Image&			Input image
inRoi	const ShapeRegionDeprecated&			Location at which object presence is being checked
inRoiAlignment	Optional<const CoordinateSystem2D&>		NIL	Adjusts the region of interest to the position of the inspected object
inMinIntensity	Optional<float>		NIL	Lowest acceptable value for the average pixel value
inMaxIntensity	Optional<float>		NIL	Highest acceptable value for the average pixel value
inMinContrast	float	0.0 -		Lowest acceptable value for the standard deviation of the pixel values
inMaxContrast	Optional<float>	0.0 -	NIL	Highest acceptable value for the standard deviation of the pixel values
outIsPresent	bool&			Flag indicating whether the object is present or not
outIntensity	Optional<float&>		NIL	Average pixel value
outContrast	Optional<float&>		NIL	Standard deviation of the pixel values
outAlignedRoi	Optional<ShapeRegionDeprecated&>		NIL	Input ROI after transformation (in the image coordinates)

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outIntensity, outContrast, outAlignedRoi.