CogOCVMaxPoseHelper.InitialPoseEstimate Method

CogOCVMaxPoseHelper InitialPoseEstimate Method

Cognex VisionPro 9.5

Compute an initial estimate of the desired pose using the currently set Font, FontRenderParams, and Text. This estimated pose will size and position the current text to fit easily within the center of the supplied image. The computed pose will be cached internally as well as returned by this method.

Namespace: Cognex.VisionPro.OCVMax
Assembly: Cognex.VisionPro.OCVMax (in Cognex.VisionPro.OCVMax.dll) Version: 69.0.0.0

Syntax

C++

Copy to Clipboard Print

public CogTransform2DLinear InitialPoseEstimate(
	CogImage8Grey pImage
)

public CogTransform2DLinear InitialPoseEstimate(
	CogImage8Grey pImage
)

Public Function InitialPoseEstimate ( 
	pImage As CogImage8Grey
) As CogTransform2DLinear

Public Function InitialPoseEstimate ( 
	pImage As CogImage8Grey
) As CogTransform2DLinear

public:
CogTransform2DLinear^ InitialPoseEstimate(
	CogImage8Grey^ pImage
)

public:
CogTransform2DLinear^ InitialPoseEstimate(
	CogImage8Grey^ pImage
)

Parameters

pImage: Type: Cognex.VisionPro CogImage8Grey
The image used to compute this pose. This should be the CogImage8Grey upon which you will display the interactive graphic created by FinalPosePrepare or FinalPosePrepareRectangleAffine.

Return Value

Type: CogTransform2DLinear
A CogTransform2DLinear that will size and position the graphic created by either FinalPosePrepare or FinalPosePrepareRectangleAffine in the center of the supplied image.

Events

Event Type	Reason
ICogChangedEvent Changed	Fires when this method changes the InitialPose and/or FinalPosePrepared properties.

Exceptions

Exception	Condition
InvalidOperationException	If the Text property has not yet been set.
ArgumentNullException	If the supplied image argument is NULL.