Back to FabImage Library website

You are here: Start » Function Reference » Computer Vision » Template Matching » CreateEdgeModel_Elastic

CreateEdgeModel_Elastic


Header: FIL.h
Namespace: fil
Module: MatchingPro

Creates a model for edge-based template matching.

Applications: Dynamic creation of models in the runtime environment (normally they are created interactively in Studio).

Syntax

C++
C#
 
void fil::CreateEdgeModel_Elastic
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inTemplateRegion,
	ftl::Optional<const fil::Rectangle2D&> inReferenceFrame,
	fil::AngleDifferenceTolerance::Type inGradientDifferenceTolerance,
	float inSmoothingStdDev,
	float inEdgeThreshold,
	float inEdgeHysteresis,
	float inMinAngle,
	float inMaxAngle,
	float inMinScale,
	float inMaxScale,
	ftl::Conditional<fil::EdgeModel_Elastic>& outEdgeModel,
	ftl::Optional<ftl::Conditional<fil::Point2D>&> outEdgeModelPoint = ftl::NIL,
	ftl::Optional<ftl::Conditional<ftl::Array<fil::Path>>&> outEdges = ftl::NIL
)

Parameters

Name Type Range Default Description
Input value inImage const Image& Image from which model will be extracted
Input value inTemplateRegion Optional<const Region&> NIL Region of the image from which model will be extracted
Input value inReferenceFrame Optional<const Rectangle2D&> NIL Exact position of the model object in the image
Input value inGradientDifferenceTolerance AngleDifferenceTolerance::Type Standard Determines what gradient angles are considered to be similar
Input value inSmoothingStdDev float 0.0 - 0.0f Standard deviation of the gaussian smoothing applied before edge extraction
Input value inEdgeThreshold float 0.0 - 35.0f Higher threshold for edge magnitude
Input value inEdgeHysteresis float 0.0 - 15.0f Threshold hysteresis value for edge magnitude
Input value inMinAngle float -180.0f Start of range of possible rotations
Input value inMaxAngle float 180.0f End of range of possible rotations
Input value inMinScale float 0.0 - 1.0f Start of range of possible scales
Input value inMaxScale float 0.0 - 1.0f End of range of possible scales
Output value outEdgeModel Conditional<EdgeModel_Elastic>& Created model that can be used by Locate filter
Output value outEdgeModelPoint Optional<Conditional<Point2D>&> NIL The middle point of the created model
Output value outEdges Optional<Conditional<Array<Path>>&> NIL Visualization of the model edges found at the original resolution

Optional Outputs

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

Read more about Optional Outputs.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.