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
- Rozpoczęcie
- Przewodnik programisty
- Artykuły bazy wiedzy
- API Reference
- Aspose.OMR FOSS dla Python na GitHub