Giriş
Aspose.OMR FOSS içinde Python için bir OMR formu oluşturmak, TemplateConfig kökünde bir öğe yapılandırma ağacı inşa etmek ve ardından bu ağacı OmrEngine.Generate()‘e teslim etmek anlamına gelir. Motor, daha sonraki tanıma aşaması tarafından geri okunan bir .omr tanımlayıcısının yanı sıra bir sayfa görüntüsü oluşturur. Bu gönderi, o ağacı oluşturan öğe yapılandırmalarını ve Python nesnelerini doğrudan oluşturmadan aynı ağacı inşa eden alternatif metin işaretleme DSL’sini adım adım inceler.
Kütüphane import omr olarak içe aktarılır, MIT lisanslıdır ve yalnızca numpy, opencv-python ve Pillow‘e bağımlıdır.
Neler Dahildir
Şablon Ağacı
TemplateConfig belgenin köküdür; bir veya daha fazla PageConfig nesnesi içerir, her fiziksel sayfa için bir tane. Bir sayfanın altındaki her öğe, en az bir Name ve bir Type ayırıcı (ConfigType) taşıyan BaseConfig sınıfının alt sınıfıdır.
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]
Soru Öğeleri
ChoiceBoxConfig tek bir soruyu tanımlar; sabit bir seçenek balonu kümesi (her biri bir ChoiceBoxAnswerConfig) ile ve çoklu seçim destekler; FormValidationLogic, her TemplateProcessor başına bir kez ayarlanır, Multiselect devre dışı bırakılmış bir soruya birden fazla işaret gelirse yükseltebilir. AnswerSheetConfig, sınav tarzı kağıtlar için numaralı bir yanıt balonu matrisi oluşturur, yapılandırılabilir bir BubbleType ve BubbleSize ile. CheckBoxConfig, herhangi bir işareti kabul eden etiketli bir boş kutu grubudur ve ayarlanabilir bir doldurma eşiğine sahiptir.
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
Izgaralar ve Bileşik Izgaralar
GridConfig bir rakam matrisini render eder — sabit sayıda bölüm, her biri 0–9 seçenek balonları — tek bir değere birleştirilir, genellikle kimlik numaraları için kullanılır. CompositeGridConfig daha esnek bir varyanttır: sütun başına özel bir sembol kümesi, sütunlar arasındaki işaretler tek bir değere birleştirilir.
Düzen Konteynerleri
BlockConfig kenarlıklı, iç dolgulu bir kutudur; ContainerConfig alt blokları sütunlara ya da sayfa altbilgisine düzenler; PositionedBlockConfig çocukları akış yerine mutlak XPosition/YPosition koordinatlarına yerleştirir. BlockConfig ve GlobalPageSettings ayrıca bir Overflow özelliği taşır (OverflowAction alt sınıfları Clip/NoClip/Wrap) ve LongWordHandling, ancak bu enum’lar doğru şekilde ayrıştırılıp doğrulanır, ancak bu sürümün render motoru tarafından henüz uygulanmaz — taşma davranışı henüz yapılandırılamaz ve üst akış yol haritasında izlenmektedir.
Markup DSL
Aynı ağaç, Python nesneleri yerine düz metin olarak yazılabilir. ?choicebox=... bir seçim kutusu sorusunu açar, sonraki satırlar seçeneklerini listeler ve &choicebox onu kapatır.
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)
Hızlı Başlangıç
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()
Açık Kaynak ve Lisanslama
Aspose.OMR FOSS for Python MIT lisanslıdır ve GitHub üzerinde barındırılmaktadır. Ticari kullanım, herhangi bir MIT lisanslı proje ile aynı şartlar altında izin verilir. Kurumsal özellikler ve üretim desteği için Aspose.OMR — Enterprise Product Family bölümüne bakın.