Introducere
Generarea unui formular OMR în Aspose.OMR FOSS pentru Python înseamnă construirea unui arbore de configurații de elemente cu rădăcina la TemplateConfig, apoi predarea acelui arbore către OmrEngine.Generate(). Motorul redă o imagine de pagină plus un descriptor .omr pe care un pas ulterior de recunoaștere îl citește înapoi. Acest articol parcurge configurațiile de elemente care compun acel arbore și DSL-ul alternativ de marcare text care construiește același arbore fără a construi direct obiecte Python.
Biblioteca se importă ca import omr, are licență MIT și depinde doar de numpy, opencv-python și Pillow.
Ce este inclus
Arborele de șabloane
TemplateConfig este rădăcina documentului; conține unul sau mai multe obiecte PageConfig, câte unul pe pagină fizică. Fiecare element sub o pagină este o subclasă a BaseConfig, având cel puțin un Name și un discriminator 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]
Elemente de întrebare
ChoiceBoxConfig definește o singură întrebare cu un set fix de bule de opțiune (fiecare fiind un ChoiceBoxAnswerConfig) și suportă selecție multiplă; FormValidationLogic, setat o dată pe TemplateProcessor, poate genera o eroare dacă o întrebare cu Multiselect dezactivat primește mai mult de o bifă. AnswerSheetConfig afișează o matrice numerotată de bule de răspuns pentru foi de tip examen, cu un BubbleType configurabil și BubbleSize. CheckBoxConfig este un grup etichetat de casete goale care acceptă orice marcaj, cu un prag de umplere reglabil.
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
Grile și Grile compuse
GridConfig redă o matrice de cifre — un număr fix de secțiuni, fiecare cu bule de opțiune 0–9 — fuzionate într-o singură valoare, utilizată în mod obișnuit pentru numere de identificare. CompositeGridConfig este varianta mai flexibilă: un set de simboluri personalizat pe coloană, cu marcaje pe coloane care se combină într-o singură valoare.
Containere de aranjament
BlockConfig este o cutie cu margine și padding; ContainerConfig aranjează blocurile copil în coloane sau în subsolul paginii; PositionedBlockConfig poziționează copiii la coordonate absolute XPosition/YPosition în loc să le curgă. BlockConfig și GlobalPageSettings au, de asemenea, o proprietate Overflow (OverflowAction subclase Clip/NoClip/Wrap) și LongWordHandling, dar aceste enumerații sunt analizate și validate corect fără să fie încă respectate de motorul de randare al acestei versiuni — comportamentul de overflow nu este încă configurabil și este urmărit în foaia de parcurs a proiectului principal.
DSL-ul de marcare
Același arbore poate fi scris ca text simplu în loc de obiecte Python. ?choicebox=... deschide o întrebare de tip casetă de alegere, liniile următoare enumeră opțiunile sale, și &choicebox o închide.
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)
Începe rapid
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 Licențiere
Aspose.OMR FOSS pentru Python este licențiată sub MIT și găzduită pe GitHub. Utilizarea comercială este permisă sub aceleași condiții ca orice proiect licențiat MIT. Pentru funcționalități enterprise și suport în producție, vedeți Aspose.OMR — Enterprise Product Family.