Generating the template

To generate a printable form and a recognition pattern file, process the form’s source code with Generate method of OmrEngine class. The method automatically detects the source code format, thus it can be used with both text and JSON markup.

Aspose.OMR.Api.OmrEngine omrEngine = new Aspose.OMR.Api.OmrEngine();
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate("source.txt");

You can pass the template source code to the generator in a number of ways:

As a path to the file

The easiest way is to call the Generate method with a relative or absolute path to the file with the source code:

Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate("source.txt");

It will create a printable form for A4 (210 x 297 mm) paper in portrait (vertical) orientation using the default font and colors. Note, that if the form contains images, they will not be rendered through the basic call and you will get an error.

Optionally, you can customize the paper size, orientation, font, and other layout settings that apply to all template pages, as well as specify paths to images used in the form by passing GlobalPageSettings object to the method:

Aspose.OMR.Generation.GlobalPageSettings globalPageSettings = new Aspose.OMR.Generation.GlobalPageSettings();
globalPageSettings.PaperSize = Aspose.OMR.Generation.PaperSize.Letter;
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate("source.txt", globalPageSettings);

If your form contains images and you are fine with the default page settings, pass the absolute path to each image file in a string array:

string workingDirectory = System.IO.Directory.GetCurrentDirectory();
string[] images = {
	System.IO.Path.Combine(workingDirectory, "aspose-logo.png")
};
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate("source.txt", images);

You can also define the encoding of a text file. By default, the API treats the source file as UTF-8 encoded.

Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate("source.txt", Encoding.ASCII);

As an array of lines

Pass all lines of the source code as a string array to the Generate method:

string[] sourceCode = {
	"?grid=Phone number",
	"\tsections_count=7",
	"\torientation=vertical"
};
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate(sourceCode);

string workingDirectory = System.IO.Directory.GetCurrentDirectory();
Aspose.OMR.Generation.GlobalPageSettings globalPageSettings = new Aspose.OMR.Generation.GlobalPageSettings();
globalPageSettings.PaperSize = Aspose.OMR.Generation.PaperSize.Letter;
globalPageSettings.ImagesPaths = new string[] {
	System.IO.Path.Combine(workingDirectory, "aspose-logo.png")
};
string[] sourceCode = {
	"?grid=Phone number",
	"\tsections_count=7",
	"\torientation=vertical"
};
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate(sourceCode, globalPageSettings);

Alternatively, you can load images used in a form from memory through a special Aspose.OMR.Api.ImageCollection object - a collection of key-value pairs where the key contains the image file name and the value contains the binary content (System.IO.MemoryStream) of the image file. This parameter always takes precedence over page settings - if two images with the same file name are defined in both parameters, the one from the page settings will be ignored.

Aspose.OMR.Generation.GlobalPageSettings globalPageSettings = new Aspose.OMR.Generation.GlobalPageSettings();
globalPageSettings.PaperSize = Aspose.OMR.Generation.PaperSize.Letter;
string[] sourceCode = {
	"?grid=Phone number",
	"\tsections_count=7",
	"\torientation=vertical"
};
Aspose.OMR.Api.ImageCollection images = new Aspose.OMR.Api.ImageCollection();
images.Add("aspose-logo.png", new MemoryStream(File.ReadAllBytes(@"form\images\aspose-logo.png")));
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate(sourceCode, globalPageSettings, images);

As a memory stream

Pass the source code as a MemoryStream object to the Generate method:

Aspose.OMR.Generation.GenerationResult generationResult = null;
using(System.IO.FileStream fs = new System.IO.FileStream("source.txt", System.IO.FileMode.Open))
{
	System.IO.MemoryStream ms = new System.IO.MemoryStream();
	fs.CopyTo(ms);
	generationResult = omrEngine.Generate(ms);
};

string workingDirectory = System.IO.Directory.GetCurrentDirectory();
Aspose.OMR.Generation.GlobalPageSettings globalPageSettings = new Aspose.OMR.Generation.GlobalPageSettings();
globalPageSettings.PaperSize = Aspose.OMR.Generation.PaperSize.Letter;
globalPageSettings.ImagesPaths = new string[] {
	System.IO.Path.Combine(workingDirectory, "aspose-logo.png")
};
Aspose.OMR.Generation.GenerationResult generationResult = null;
using(System.IO.FileStream fs = new System.IO.FileStream("source.txt", System.IO.FileMode.Open))
{
	System.IO.MemoryStream ms = new System.IO.MemoryStream();
	fs.CopyTo(ms);
	generationResult = omrEngine.Generate(ms, globalPageSettings);
};

Aspose.OMR.Generation.GlobalPageSettings globalPageSettings = new Aspose.OMR.Generation.GlobalPageSettings();
globalPageSettings.PaperSize = Aspose.OMR.Generation.PaperSize.Letter;
Aspose.OMR.Api.ImageCollection images = new Aspose.OMR.Api.ImageCollection();
images.Add("aspose-logo.png", new MemoryStream(File.ReadAllBytes(@"form\images\aspose-logo.png")));
Aspose.OMR.Generation.GenerationResult generationResult = null;
using(System.IO.FileStream fs = new System.IO.FileStream("source.txt", System.IO.FileMode.Open))
{
	System.IO.MemoryStream ms = new System.IO.MemoryStream();
	fs.CopyTo(ms);
	generationResult = omrEngine.Generate(ms, globalPageSettings, images);
};

You can also define the encoding of a memory stream. By default, the API treats the stream as UTF-8 encoded text.

Aspose.OMR.Generation.GenerationResult generationResult = null;
using(System.IO.FileStream fs = new System.IO.FileStream("source.txt", System.IO.FileMode.Open))
{
	System.IO.MemoryStream ms = new System.IO.MemoryStream();
	fs.CopyTo(ms);
	generationResult = omrEngine.Generate(ms, Encoding.ASCII);
};

Building forms programmatically

The contents of an OMR form can be described directly in the application code.

To generate a printable form, pass the corresponding TemplateConfig object to the Generate method along with GlobalPageSettings object that defines the paper size, orientation, font, images, and other layout settings that apply to all template pages:

string workingDirectory = System.IO.Directory.GetCurrentDirectory();
Aspose.OMR.Generation.GlobalPageSettings globalPageSettings = new Aspose.OMR.Generation.GlobalPageSettings();
globalPageSettings.PaperSize = Aspose.OMR.Generation.PaperSize.Letter;
globalPageSettings.ImagesPaths = new string[] {
	System.IO.Path.Combine(workingDirectory, "aspose-logo.png")
};
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate(templateConfig, globalPageSettings);

Aspose.OMR.Generation.GlobalPageSettings globalPageSettings = new Aspose.OMR.Generation.GlobalPageSettings();
globalPageSettings.PaperSize = Aspose.OMR.Generation.PaperSize.Letter;
Aspose.OMR.Api.ImageCollection images = new Aspose.OMR.Api.ImageCollection();
images.Add("aspose-logo.png", new MemoryStream(File.ReadAllBytes(@"form\images\aspose-logo.png")));
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.Generate(templateConfig, globalPageSettings, images);

Page setup - customizing the paper size, orientation, font, images, and other layout settings of a printable form.
Adding images - including images in Aspose.OMR forms.
Error handling - debugging and identifying errors in the source code of the Aspose.OMR template during generation.
Saving to file - saving a generated printable form and a recognition pattern file on disk.

Designing machine-readable forms with Aspose.OMR for .NET Optical mark recognition (OMR)

Generating the template

As a path to the file

As an array of lines

As a memory stream

Building forms programmatically

Read more