CogOCVMaxFont.GetCharacterFullBounds Method (String, CogTransform2DLinear, CogOCVMaxFontRenderParams)

CogOCVMaxFont GetCharacterFullBounds Method (String, CogTransform2DLinear, CogOCVMaxFontRenderParams)

Cognex VisionPro

Create a System::Array of CogRectangleAffine that correspond to the individual selected space bounds of each character in the supplied text. These full bounds are determined using this font and the supplied parameters.

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

Syntax

C++

Copy to Clipboard Print

public CogRectangleAffine[] GetCharacterFullBounds(
	string srcText,
	CogTransform2DLinear selectedFromFont,
	CogOCVMaxFontRenderParams renderParams
)

public CogRectangleAffine[] GetCharacterFullBounds(
	string srcText,
	CogTransform2DLinear selectedFromFont,
	CogOCVMaxFontRenderParams renderParams
)

Public Function GetCharacterFullBounds ( 
	srcText As String,
	selectedFromFont As CogTransform2DLinear,
	renderParams As CogOCVMaxFontRenderParams
) As CogRectangleAffine()

Public Function GetCharacterFullBounds ( 
	srcText As String,
	selectedFromFont As CogTransform2DLinear,
	renderParams As CogOCVMaxFontRenderParams
) As CogRectangleAffine()

public:
array<CogRectangleAffine^>^ GetCharacterFullBounds(
	String^ srcText, 
	CogTransform2DLinear^ selectedFromFont, 
	CogOCVMaxFontRenderParams^ renderParams
)

public:
array<CogRectangleAffine^>^ GetCharacterFullBounds(
	String^ srcText, 
	CogTransform2DLinear^ selectedFromFont, 
	CogOCVMaxFontRenderParams^ renderParams
)

Parameters

srcText: Type: System String
The text to be evaluated. This string is interpreted as a single line within a single paragraph.

selectedFromFont: Type: Cognex.VisionPro CogTransform2DLinear
A linear mapping from the imported font description to the selected space. Typically used to specify scaling.

renderParams: Type: Cognex.VisionPro.OCVMax CogOCVMaxFontRenderParams
The CogOCVMaxFontRenderParams to use in evaluating this text.

Return Value

Type: CogRectangleAffine
A System::Array of CogTransform2DLinear, each of which corresponds to the individual selected space bounds of a character in the supplied text.

Exceptions

Exception	Condition
InvalidOperationException	If a font has not yet been imported, or if an internal error occurs.
ObjectDisposedException	If this CogOCVMaxFont object has already been disposed.
ArgumentNullException	If any of the arguments are NULL.
ArgumentOutOfRangeException	If the srcText argument does not describe at least one character.