Table of Contents

Class LicensePlateRecognizerSettings

Namespace
VisioForge.Core.Types.X.AI
Assembly
VisioForge.Core.dll

Settings for the license plate recognizer (ANPR/LPR) block. The block runs a specialized two-stage pipeline: a dedicated license-plate detector (YOLO) locates plates in the frame, then a plate-specific OCR model reads the characters of each cropped plate.

public class LicensePlateRecognizerSettings

Inheritance

Inherited Members

Remarks

Both models come from the FastALPR family (MIT): a YOLOv9-T plate detector and a fast-plate-ocr recognition head. A global head covers the USA and 90+ countries; a European head is tuned for EU plates. The recognition model's geometry (RGB/grayscale, input size) and alphabet are read from the model itself, so selecting a region is simply a matter of pointing VisioForge.Core.Types.X.AI.LicensePlateRecognizerSettings.RecognitionModelPath at that head.

Constructors

LicensePlateRecognizerSettings()

Initializes a new instance of the VisioForge.Core.Types.X.AI.LicensePlateRecognizerSettings class.

public LicensePlateRecognizerSettings()

LicensePlateRecognizerSettings(string, string)

Initializes a new instance of the VisioForge.Core.Types.X.AI.LicensePlateRecognizerSettings class with model paths.

public LicensePlateRecognizerSettings(string detectorModelPath, string recognitionModelPath)

Parameters

detectorModelPath string

Path to the plate-detection model.

recognitionModelPath string

Path to the plate-OCR model.

Properties

BoxColor

Gets or sets the color used for plate boxes and text when VisioForge.Core.Types.X.AI.LicensePlateRecognizerSettings.DrawResults is enabled. Defaults to yellow.

public SKColor BoxColor { get; set; }

Property Value

SKColor

BoxThickness

Gets or sets the stroke thickness, in pixels, of the plate boxes. Defaults to 3.

public float BoxThickness { get; set; }

Property Value

float

DetectionConfidenceThreshold

Gets or sets the minimum detection score (0..1) a plate box must reach. Defaults to 0.35.

public float DetectionConfidenceThreshold { get; set; }

Property Value

float

DetectionInputSize

Gets or sets the square input size, in pixels, for the detection model (dynamic-shape models). Defaults to 640.

public int DetectionInputSize { get; set; }

Property Value

int

DetectorModelPath

Gets or sets the path to the license-plate detection ONNX model (FastALPR YOLOv9-T end-to-end). Required.

public string DetectorModelPath { get; set; }

Property Value

string

DeviceId

Gets or sets the hardware device id for CUDA / DirectML. Defaults to 0.

public int DeviceId { get; set; }

Property Value

int

DrawResults

Gets or sets a value indicating whether recognized plates are drawn into the video frame. Defaults to true.

public bool DrawResults { get; set; }

Property Value

bool

FramesToSkip

Gets or sets the number of frames to skip between recognitions on live video. 0 processes every frame.

public int FramesToSkip { get; set; }

Property Value

int

LabelFontSize

Gets or sets the label font size, in pixels. A value of 0 auto-scales the font to the frame height. Defaults to 0.

public float LabelFontSize { get; set; }

Property Value

float

MaxDetections

Gets or sets the maximum number of plates to detect per frame. Defaults to 10.

public int MaxDetections { get; set; }

Property Value

int

OcrConfidenceThreshold

Gets or sets the minimum mean OCR confidence (0..1) a recognized plate must reach to be reported. Defaults to 0.3.

public float OcrConfidenceThreshold { get; set; }

Property Value

float

Provider

Gets or sets the execution provider. Defaults to VisioForge.Core.Types.X.AI.OnnxExecutionProvider.Auto.

public OnnxExecutionProvider Provider { get; set; }

Property Value

OnnxExecutionProvider

RecognitionModelPath

Gets or sets the path to the plate-OCR ONNX model (FastALPR fast-plate-ocr head, global or EU). Required.

public string RecognitionModelPath { get; set; }

Property Value

string