You are here: Start » DLInvoke.DL_ReadCharacters
DLInvoke.DL_ReadCharacters
Performs optical character recognition using a pretrained deep learning model.
| Namespace: | Avl |
|---|---|
| Assembly: | AvlNet.DL.Cpu.dll |
Syntax
C++
C#
public static void DL_ReadCharacters ( Avl.Image inImage, Optional<Avl.Rectangle2D> inRoi, Optional<Avl.CoordinateSystem2D> inRoiAlignment, Avl.ReadCharactersModelId inModelId, int inCharHeight, float inWidthScale, float inCharSpacing, Optional<string> inCharRange, float inMinScore, float inMinQuality, Avl.Polarity inPolarization, float inContrastThreshold, bool inCalculateCandidates, bool inRemoveBoundaryCharacters, List<Avl.OcrResult> outCharacters, List<List<Avl.OcrCandidate>> outCandidates, List<Avl.Region> outMasks, Optional<Avl.Rectangle2D> outAlignedRoi, Diagnostic<Avl.Image> diagInputImage )
Parameters
| Name | Type | Range | Default | Description | |
|---|---|---|---|---|---|
 | inImage | Avl.Image | Input image. | ||
| inRoi | Atl.Optional<Avl.Rectangle2D> | Limits the area where recognized characters are located. Default value: atl::NIL. | ||
| inRoiAlignment | Atl.Optional<Avl.CoordinateSystem2D> | |||
| inModelId | Avl.ReadCharactersModelId | Identifier of a Read Characters model. Default value: (). | ||
| inCharHeight | int | Average height of characters in pixels. Default value: 35. | ||
| inWidthScale | float | Scales image width by the given factor. Default value: 1.0f. | ||
| inCharSpacing | float | Distance between characters denoted as fraction of inCharHeight. Default value: 0.0f. | ||
| inCharRange | Atl.Optional<string> | Limits the set of wanted characters. Default value: "A-Z,a-z,0-9,\\\\,/,-". | ||
| inMinScore | float | Sets a minimum required score for a character to be returned. Default value: 0.5f. | ||
| inMinQuality | float | Specifies the minimum quality threshold a character must meet to be returned. Default value: 0.0f. | ||
| inPolarization | Avl.Polarity | Sets a required polarity for a character to be returned. Default value: Any. | ||
| inContrastThreshold | float | Sets a threshold for a contrast of found characters. Default value: 0.0f. | ||
| inCalculateCandidates | bool | If set to true then outCandidates is calculated. Default value: True. | ||
| inRemoveBoundaryCharacters | bool | If set to true characters that are not entirely contained in the ROI are filtered out. Default value: False. | ||
 | outCharacters | System.Collections.Generic.List<Avl.OcrResult> | |||
| outCandidates | System.Collections.Generic.List<System.Collections.Generic.List<Avl.OcrCandidate>> | Array of the most likely characters. The first element is the character from outCharacters. | ||
| outMasks | System.Collections.Generic.List<Avl.Region> | Masks of found characters (in Extended model). Contains empty regions in case of using model not supporting masks (in Fast and Balanced model). | ||
| outAlignedRoi | Atl.Optional<Avl.Rectangle2D> | Input roi after transformation. | ||
 | diagInputImage | Avl.Diagnostic<Avl.Image> | Analyzed area of the input image. |
