Introdução

Gerar um formulário OMR em Aspose.OMR FOSS para Python significa construir uma árvore de configurações de elementos com raiz em TemplateConfig, e então entregar essa árvore a OmrEngine.Generate(). O motor renderiza uma imagem de página mais um descritor .omr que uma passagem de reconhecimento posterior lê de volta. Este post percorre as configurações de elementos que compõem essa árvore e a DSL de marcação de texto alternativa que constrói a mesma árvore sem criar objetos Python diretamente.

A biblioteca é importada como import omr, tem licença MIT e depende apenas de numpy, opencv-python e Pillow.


O que está incluído

A Árvore de Modelo

TemplateConfig é a raiz do documento; contém um ou mais objetos PageConfig, um por página física. Cada elemento abaixo de uma página é uma subclasse de BaseConfig, contendo no mínimo um Name e um discriminador 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]

Elementos de Pergunta

ChoiceBoxConfig define uma única pergunta com um conjunto fixo de bolhas de opção (cada uma um ChoiceBoxAnswerConfig) e suporta seleção múltipla; FormValidationLogic, definido uma vez por TemplateProcessor, pode gerar erro se uma pergunta com Multiselect desativado receber mais de uma marcação. AnswerSheetConfig dispõe uma matriz numerada de bolhas de resposta para folhas no estilo de exame, com um BubbleType configurável e BubbleSize. CheckBoxConfig é um grupo rotulado de caixas vazias que aceita qualquer marcação, com um limiar de preenchimento ajustável.

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

Grades e Grades Compostas

GridConfig renderiza uma matriz de dígitos — um número fixo de seções, cada uma com bolhas de opção de 0–9 — fundidas em um único valor, comumente usado para números de identidade. CompositeGridConfig é a variante mais flexível: um conjunto de símbolos personalizado por coluna, com marcas entre colunas fundindo-se em um único valor.

Contêineres de Layout

BlockConfig é uma caixa com borda e preenchimento; ContainerConfig organiza blocos filhos em colunas ou em um rodapé de página; PositionedBlockConfig posiciona os filhos em coordenadas absolutas XPosition/YPosition em vez de fluí-los. BlockConfig e GlobalPageSettings também possuem uma propriedade Overflow (OverflowAction subclasses Clip/NoClip/Wrap) e LongWordHandling, mas esses enums são analisados e validados corretamente sem ainda serem respeitados pelo motor de renderização desta versão — o comportamento de overflow ainda não é configurável, e está rastreado no roadmap upstream.

A DSL de Marcação

A mesma árvore pode ser escrita como texto simples em vez de objetos Python. ?choicebox=... abre uma pergunta de caixa de escolha, as linhas seguintes listam suas opções, e &choicebox a fecha.

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)

Início Rápido

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()

Código Aberto & Licenciamento

Aspose.OMR FOSS para Python está licenciado sob MIT e hospedado em GitHub. O uso comercial é permitido sob os mesmos termos de qualquer projeto licenciado sob MIT. Para recursos empresariais e suporte de produção, consulte Aspose.OMR — Enterprise Product Family.


Começando

Recursos Relacionados