Wprowadzenie

Generowanie formularza OMR w Aspose.OMR FOSS dla Python oznacza budowanie drzewa konfiguracji elementów z korzeniem w TemplateConfig, a następnie przekazanie tego drzewa do OmrEngine.Generate(). Silnik renderuje obraz strony oraz opis .omr, który późniejszy etap rozpoznawania odczytuje. Ten wpis przechodzi przez konfiguracje elementów tworzących to drzewo oraz alternatywny DSL tekstowo-markupowy, który buduje to samo drzewo bez bezpośredniego tworzenia obiektów Python bezpośrednio.

Biblioteka jest importowana jako import omr, ma licencję MIT i zależy wyłącznie od numpy, opencv-python oraz Pillow.


Co zawiera

Drzewo szablonu

TemplateConfig jest korzeniem dokumentu; zawiera jeden lub więcej obiektów PageConfig, po jednym na każdą fizyczną stronę. Każdy element poniżej strony jest podklasą BaseConfig, posiadającą co najmniej Name oraz dyskryminator Type (ConfigType).

from omr.generation.config import TemplateConfig
from omr.generation.config.elements.parents import PageConfig

tpl = TemplateConfig()
tpl.Name = "quiz"
page = PageConfig()
page.Children = []
tpl.Children = [page]

Elementy pytań

ChoiceBoxConfig definiuje pojedyncze pytanie z ustalonym zestawem bąbelków opcji (każdy to ChoiceBoxAnswerConfig) i obsługuje wielokrotny wybór; FormValidationLogic, ustawiany raz na TemplateProcessor, może się podnieść, jeśli pytanie z wyłączonym Multiselect otrzyma więcej niż jedną zaznaczoną opcję. AnswerSheetConfig układa numerowaną macierz bąbelków odpowiedzi dla arkuszy w stylu egzaminacyjnym, z konfigurowalnym BubbleType i BubbleSize. CheckBoxConfig jest oznaczoną grupą pustych pól akceptujących dowolny znak, z regulowanym progiem wypełnienia.

from omr.generation.config.elements import AnswerSheetConfig

sheet = AnswerSheetConfig()
sheet.Name = "answers"
sheet.AnswersCount = 4    # bubbles per question (e.g. A-D)
sheet.ElementsCount = 20  # number of questions

Siatki i Złożone Siatki

GridConfig renderuje macierz cyfr — stałą liczbę sekcji, każda z bąbelkami opcji 0–9 — łączonych w jedną wartość, powszechnie używaną dla numerów identyfikacyjnych. CompositeGridConfig jest bardziej elastyczną wariantą: niestandardowy zestaw symboli na kolumnę, z zaznaczeniami w kolumnach łączącymi się w jedną wartość.

Kontenery Układu

BlockConfig jest obramowanym, wyściełanym pudełkiem; ContainerConfig układa bloki podrzędne w kolumny lub stopkę strony; PositionedBlockConfig umieszcza elementy potomne w absolutnych współrzędnych XPosition/YPosition zamiast przepływać je. BlockConfig i GlobalPageSettings posiadają także właściwość Overflow (OverflowAction podklasy Clip/NoClip/Wrap) oraz LongWordHandling, ale te wyliczenia są prawidłowo parsowane i walidowane, choć nie są jeszcze respektowane przez silnik renderujący tej wersji — zachowanie przepełnienia nie jest jeszcze konfigurowalne i jest śledzone w upstream roadmap.

DSL znaczników

To samo drzewo można zapisać jako zwykły tekst zamiast obiektów Python. ?choicebox=... otwiera pytanie typu choice-box, kolejne linie wymieniają jego opcje, a &choicebox je zamyka.

import json
from omr.api import OmrEngine

markup = [
    "?choicebox=Rate it",
    "(1) Poor (2) Fair (3) Good",
    "&choicebox",
]
engine = OmrEngine()
result = engine.Generate(markup)
desc = json.loads(result.Template)

Szybki start

git clone https://github.com/aspose-omr-foss/Aspose.OMR-FOSS-for-Python.git
cd Aspose.OMR-FOSS-for-Python
pip install -e .
from omr.api import OmrEngine, FormValidationLogic

engine = OmrEngine()
gen = engine.Generate("final-exam.txt")          # or a code-first TemplateConfig
gen.Save("out", "final-exam")                    # -> out/final-exam.png + out/final-exam.omr
processor = engine.GetTemplateProcessor("out/final-exam.omr", FormValidationLogic.Ignore)
result = processor.Recognize("scan.png")         # -100 = auto-calibrated threshold
print(result.GetCsv())                           # also GetJson() / GetXml()

Open Source i licencjonowanie

Aspose.OMR FOSS dla Python jest licencjonowany na licencji MIT i hostowany na GitHub. Komercyjne użycie jest dozwolone na tych samych warunkach co każdy projekt na licencji MIT. Aby uzyskać informacje o funkcjach enterprise i wsparciu produkcyjnym, zobacz Aspose.OMR — Enterprise Product Family.


Rozpoczęcie

Powiązane zasoby