Class LicensePlateTrackerOptions

Namespace

CapCognition.Maui.LPR.CapCognitionLicensePlateTracking

Assembly

CapCognition.Maui.LPR.dll

Configuration for LicensePlateTemporalTracker. The defaults are starting values and should be tuned with real recognition logs.

public sealed class LicensePlateTrackerOptions

Inheritance

object

LicensePlateTrackerOptions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Properties

ConfirmationEvidence

Required accumulated evidence for normal confirmation.

public double ConfirmationEvidence { get; set; }

Property Value

double

EmitCandidates

Emit candidate updates before confirmation. Normally false for production UI.

public bool EmitCandidates { get; set; }

Property Value

bool

EvidenceHalfLife

Old observations decay exponentially. An observation has half its original weight after this period.

public TimeSpan EvidenceHalfLife { get; set; }

Property Value

TimeSpan

EvidenceWindow

Observations older than this value are discarded completely.

public TimeSpan EvidenceWindow { get; set; }

Property Value

TimeSpan

ForceBestCandidateAtDeadline

If true, emit the best candidate when MaximumDecisionTime expires, even if ConfirmationEvidence was not reached.

public bool ForceBestCandidateAtDeadline { get; set; }

Property Value

bool

KeepBestBitmaps

Keep copies of the best source and license plate bitmap in emitted stable results.

public bool KeepBestBitmaps { get; set; }

Property Value

bool

MaximumDecisionTime

Maximum time in candidate state before a decision should be made.

public TimeSpan MaximumDecisionTime { get; set; }

Property Value

TimeSpan

MaximumPlateBitmapSize

Independent bounding size of retained plate images, including two-row plates. Aspect ratio is preserved and smaller images are never enlarged.

public Size MaximumPlateBitmapSize { get; set; }

Property Value

Size

MaximumRetainedBitmapBytes

Maximum internal source/plate pixel-buffer bytes, counted as row bytes times height. Zero disables image retention. Input images, emitted copies, scaling scratch space and object overhead are outside this budget. A pair that does not fit is omitted without discarding its OCR evidence.

public long MaximumRetainedBitmapBytes { get; set; }

Property Value

long

MaximumRetainedBitmapObservations

Maximum number of observations retaining a source/plate bitmap pair. Temporal text evidence is unaffected. If the selected result observation was evicted, its bitmap properties are null. The default bounds full-frame memory use.

public int MaximumRetainedBitmapObservations { get; set; }

Property Value

int

MaximumSourceBitmapSize

Bounding size of retained source images. Aspect ratio is preserved and smaller images are never enlarged. Recognition inputs and original bounds are unchanged.

public Size MaximumSourceBitmapSize { get; set; }

Property Value

Size

MinimumObservations

Minimum number of matching observations before normal confirmation.

public int MinimumObservations { get; set; }

Property Value

int

MinimumStringSimilarity

Minimum normalized Levenshtein similarity at which an observation is counted as supporting the final consensus plate.

public double MinimumStringSimilarity { get; set; }

Property Value

double

MissingTimeout

Time without a usable license plate detection before the currently published plate is removed. null disables automatic removal.

public TimeSpan? MissingTimeout { get; set; }

Property Value

TimeSpan?

Mode

Tracking mode whose lifecycle and recommended thresholds this options instance represents.

public LicensePlateTrackingMode Mode { get; set; }

Property Value

LicensePlateTrackingMode

ReplacementEvidence

Required evidence for replacing a plate that has already been confirmed. Should normally be higher than ConfirmationEvidence.

public double ReplacementEvidence { get; set; }

Property Value

double

SamePlateRefinementEvidence

Minimum evidence required for correcting an already published plate within the same plate family.

Used in Barrier and CarDetection modes. ParkingOfficer stays locked.

public double SamePlateRefinementEvidence { get; set; }

Property Value

double

SamePlateRefinementMinimumExactObservations

Minimum number of exact matching observations required for a same-plate refinement.

public int SamePlateRefinementMinimumExactObservations { get; set; }

Property Value

int

SamePlateRefinementMinimumObservations

Minimum number of supporting observations required for a same-plate refinement.

public int SamePlateRefinementMinimumObservations { get; set; }

Property Value

int

SamePlateRefinementScoreRatio

Minimum ratio of the best candidate's score to the current published plate's score

public double SamePlateRefinementScoreRatio { get; set; }

Property Value

double

SamePlateRefinementSimilarity

Minimum similarity for considering two plate texts to belong to the same physical plate family.

public double SamePlateRefinementSimilarity { get; set; }

Property Value

double

TextMode

Selects whether the tracker prefers country-validated or raw OCR plate text.

public LicensePlateTextMode TextMode { get; set; }

Property Value

LicensePlateTextMode

ValidatedResultBonus

Additional evidence multiplier for country-validated results.

public double ValidatedResultBonus { get; set; }

Property Value

double

VotingStringSimilarity

Minimum similarity at which an observation participates in consensus/character voting.

public double VotingStringSimilarity { get; set; }

Property Value

double

Methods

Create(LicensePlateTrackingMode)

Creates recommended starting values for the selected tracking mode.

public static LicensePlateTrackerOptions Create(LicensePlateTrackingMode mode)

Parameters

mode LicensePlateTrackingMode

Tracking mode for which to create options.

Returns

LicensePlateTrackerOptions

A new options instance with mode-specific defaults.