Settings for Omr. Values fall back through three levels: document → SDK → built-in default. Writes target the document only when set on a document’s settings, otherwise the SDK globally when set on SdkSettings.
using Nutrient;The SDK creates this class through factory methods or other SDK objects.
Properties
AdaptiveCharacterLevel
public float AdaptiveCharacterLevel { get; set; }Fraction of the paper level below which ink is as dark as the printed character.
Type: float
AdaptiveCharacterVisibleCoverage
public float AdaptiveCharacterVisibleCoverage { get; set; }Portion of the bubble holding character-dark ink above which the printed character counts as still visible — the signature of an erased mark rather than a deliberate one.
Type: float
AdaptiveDeepShadeLevel
public float AdaptiveDeepShadeLevel { get; set; }Fraction of the paper level below which ink counts as deliberate shading.
Type: float
AdaptiveDiscRadius
public float AdaptiveDiscRadius { get; set; }Radius of the analyzed bubble interior, as a fraction of the field size, chosen to sit inside the printed ring.
Type: float
AdaptiveFieldPaperSanity
public float AdaptiveFieldPaperSanity { get; set; }A field whose own paper reads darker than this fraction of the page’s paper is overfilled past its margins; its paper estimate is untrustworthy, so the page’s is used instead.
Type: float
AdaptiveInkMargin
public float AdaptiveInkMargin { get; set; }Fraction below a field’s paper level at which ink starts counting as a mark.
Type: float
AdaptiveMarkDeepCoverage
public float AdaptiveMarkDeepCoverage { get; set; }Portion of the bubble that deliberate shading must cover for the field to be a mark.
Type: float
AdaptiveMarkShadeCoverage
public float AdaptiveMarkShadeCoverage { get; set; }Portion of the bubble that light shading must cover for the field to be a mark, provided the printed character is also covered.
Type: float
AdaptiveMinimumPaper
public int AdaptiveMinimumPaper { get; set; }Paper darker than this absolute level is not believed to be paper; the page-wide level is used for that field instead.
Type: int
AdaptivePaperPercentile
public int AdaptivePaperPercentile { get; set; }Percentile of a field’s pixels taken to represent its paper level. A field is mostly paper even when marked, so a high percentile lands on the paper rather than on the mark.
Type: int
EnableAdaptiveBinarization
public bool EnableAdaptiveBinarization { get; set; }Indicates whether the black and white reduction threshold applied before mark detection is derived from the image, rather than using a fixed value. Mark detection operates on black and white data, so a color or grayscale image is reduced first. The fixed threshold treats anything lighter than itself as blank, which discards marks made with light ink — for example gray shading or a soft pencil — before detection runs. The resulting field is reported as empty rather than as a low-confidence mark. When enabled, each OMR field is instead measured against the paper level found within that same field, so ink appreciably darker than its surrounding paper is preserved however light it is. Because every field is judged on its own, this also holds up on tinted or aged stock and on pages that are lit unevenly, where no single threshold would suit the whole image. Enable this for forms whose marks are not reliably solid black. If the fields cannot be measured, the fixed threshold is used, so enabling this cannot give a worse result than leaving it off. Erased marks are recognized and reported as not filled: an erased bubble keeps light residue with the printed character showing through it, which differs measurably from a deliberate mark — shading a bubble either darkens it deeply or covers its character. Marks cancelled by other means, such as crossing out or blotting, are not distinguished from deliberate marks; resolving those requires knowing which fields belong to the same question, which this method does not. This setting has no effect when the supplied image is already black and white, because no reduction is performed in that case.
Type: bool
Resource management
public void Dispose()OmrSettings implements IDisposable. Call Dispose() or use a C# using declaration to release its native handle right away. If you don’t, the handle is released when the object is garbage collected.