Pendahuluan
Membuat formulir OMR di Aspose.OMR FOSS untuk Python berarti membangun pohon konfigurasi elemen yang berakar pada TemplateConfig, kemudian menyerahkan pohon itu ke OmrEngine.Generate(). Mesin merender gambar halaman plus deskriptor .omr yang dibaca kembali oleh proses pengenalan selanjutnya. Posting ini menelusuri konfigurasi elemen yang membentuk pohon tersebut, serta DSL markup teks alternatif yang membangun pohon yang sama tanpa secara langsung membuat objek Python.
Pustaka diimpor sebagai import omr, berlisensi MIT, dan hanya bergantung pada numpy, opencv-python, dan Pillow.
Apa yang Disertakan
Pohon Template
TemplateConfig adalah akar dokumen; ia berisi satu atau lebih objek PageConfig, satu per halaman fisik. Setiap elemen di bawah sebuah halaman adalah subclass dari BaseConfig, yang memuat setidaknya sebuah Name dan sebuah diskriminator 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]
Elemen Pertanyaan
ChoiceBoxConfig mendefinisikan satu pertanyaan dengan sekumpulan gelembung opsi tetap (masing-masing ChoiceBoxAnswerConfig) dan mendukung multi-select; FormValidationLogic, yang diatur sekali per TemplateProcessor, dapat menimbulkan kesalahan jika pertanyaan dengan Multiselect yang dinonaktifkan menerima lebih dari satu tanda. AnswerSheetConfig menyusun matriks bernomor dari gelembung jawaban untuk lembar gaya ujian, dengan BubbleType dan BubbleSize yang dapat dikonfigurasi. CheckBoxConfig adalah grup berlabel dari kotak kosong yang menerima tanda apa pun, dengan ambang pengisian yang dapat disetel.
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
Grid dan Grid Komposit
GridConfig menampilkan matriks digit — sejumlah bagian tetap, masing-masing dengan gelembung opsi 0–9 — yang digabung menjadi satu nilai, biasanya digunakan untuk nomor ID. CompositeGridConfig adalah varian yang lebih fleksibel: satu set simbol khusus per kolom, dengan tanda di seluruh kolom yang digabung menjadi satu nilai.
Kontainer Tata Letak
BlockConfig adalah kotak berbingkai, berpadding; ContainerConfig menyusun blok anak menjadi kolom atau footer halaman; PositionedBlockConfig menempatkan anak pada koordinat absolut XPosition/YPosition alih-alih mengalirkan mereka. BlockConfig dan GlobalPageSettings juga memiliki properti Overflow (OverflowAction subclass Clip/NoClip/Wrap) dan LongWordHandling, namun enum ini diparse dan divalidasi dengan benar meskipun belum dihormati oleh mesin render rilis ini — perilaku overflow belum dapat dikonfigurasi, dan sedang dilacak pada roadmap hulu.
DSL Markup
Pohon yang sama dapat ditulis sebagai teks biasa alih-alih objek Python. ?choicebox=... membuka pertanyaan kotak pilihan, baris-baris berikut mencantumkan opsinya, dan &choicebox menutupnya.
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)
Mulai Cepat
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()
Sumber Terbuka & Lisensi
Aspose.OMR FOSS untuk Python berlisensi MIT dan dihosting di GitHub. Penggunaan komersial diizinkan dengan syarat yang sama seperti proyek berlisensi MIT mana pun. Untuk fitur enterprise dan dukungan produksi, lihat Aspose.OMR — Enterprise Product Family.