You are here: Start » AVL.NET » Invoke.MergeCharactersIntoLines

Invoke.MergeCharactersIntoLines

Converts a output of Deep Learning filter DL_ReadCharacters to lines of text.

Namespace:Avl
Assembly:AvlNet.dll

Syntax

C++
C#
 
public static void MergeCharactersIntoLines
(
	List<Avl.OcrResult> inCharacters,
	float inMaxGap,
	float inMaxShift,
	float inMargin,
	int inMinLength,
	bool inFlatten,
	string inPattern,
	Optional<List<List<Avl.OcrCandidate>>> inCandidates,
	float inMinScore,
	List<Avl.Rectangle2D> outLines,
	List<string> outStrings,
	List<Conditional<int>> outMapping,
	List<float> outScores,
	List<Avl.OcrResult> outProcessedCharacters
)

Parameters

Name Type Range Default Description
inCharactersSystem.Collections.Generic.List<Avl.OcrResult>Output of DL_ReadCharacters.
inMaxGapfloat<0.0f, 10.0f>0.25fMaximum horizontal gap between joint characters' boxes, denoted as fraction of 'A' char height. Default value: 0.25f.
inMaxShiftfloat<0.0f, 1.0f>0.25fMaximum vertical misalignment between joint character's boxes, denoted as fraction of 'A' char height. Default value: 0.25f.
inMarginfloat<0.0f, 10.0f>Additional margin added to result, denoted as fraction of 'A' char height.
inMinLengthint<1, 200>1Minimal number of chars to create line. Default value: 1.
inFlattenboolFalseIf True, it concatenates the words on the line into a single result string, otherwise each word is a separate result string. Default value: False.
inPatternstringPattern used in Grammar rules filtering.
inCandidatesAtl.Optional<System.Collections.Generic.List<System.Collections.Generic.List<Avl.OcrCandidate>>>Candidates - optional output of DL_ReadCharacters, Required when using grammar rules (when inPattern is not empty). Default value: atl::NIL.
inMinScorefloat<0.0f, 1.0f>0.2fMinimum score for filtering the line of text. Default value: 0.2f.
outLinesSystem.Collections.Generic.List<Avl.Rectangle2D>Minimal Box which cover all selected character boxes.
outStringsSystem.Collections.Generic.List<string>Text of merged characters.
outMappingSystem.Collections.Generic.List<Atl.Conditional<int>>Mapping between input characters and output lines, outMapping[i] stores the index line to which inCharacters[i] belongs. If outMapping[i] is NIL it means that inCharacters[i] has not been added to any line.
outScoresSystem.Collections.Generic.List<float>Calculated the score for the line.
outProcessedCharactersSystem.Collections.Generic.List<Avl.OcrResult>Contains the full set of character results after grammar rule processing. Maintains a one-to-one correspondence with inCharacters, preserving original positions but possibly with modified values, scores, or other attributes based on grammar rule application.

See also