Browse our Products

Aspose.OMR for .NET 23.8.0 - Release Notes

This article contains a summary of recent changes, enhancements and bug fixes in Aspose.OMR for .NET 23.8.0 (August 2023) release.

Deprecation warning

Release 23.6.1 introduces a straightforward and easier API that can greatly simplify code and enhance the capabilities of your OMR applications. Unfortunately, the major reorganization of methods and modifications of internal logic result in “breaking changes”.

To make it easier to upgrade your code, we have kept existing methods fully functional, but marked them as deprecated. Your existing code will continue to work and you can even make minor updates to it, but be aware that all deprecated methods are scheduled to be removed in the release 24.1.0 (January 2024) in favor of the new API.

Time to deprecation: 4 months left.

What was changed

Key	Summary	Category
OMRNET‑462	Recognition of multi-page TIFF images.	New feature
OMRNET‑855	Added the ability to customize the layout of individual pages in multi-page forms. See Added public APIs for details.	New feature
OMRNET‑863	Bubbles that are completely hidden using the `overflow=clip` property (text markup / JSON markup) are no longer returned in recognition results.	Enhancement
OMRNET‑874	Added support for MailMark barcode.	Enhancement
OMRNET‑874	Optimized the structure of recognition pattern (.OMR) files. The changes are fully backward compatible.	Enhancement
OMRNET‑850	Page identifier is no longer returned as a separate QR code in recognition results.	Fix
OMRNET‑555	`Recalculate` method now correctly processes ScoreGroup, CompositeGrid, CheckBox, ReplaceTrigger, and ClipArea elements.	Fix
OMRNET‑890	Removed unnecessary commas when saving grid (text markup / JSON markup) recognition results to CSV.	Fix
OMRNET‑890	Multiple grid (text markup / JSON markup) elements with the same name are no longer merged into one result during recognition.	Fix
n/a	Changed text direction for Bengali from RTL to LTR.	Fix

Public API changes and backwards compatibility

This section lists all public API changes introduced in Aspose.OMR for .NET 23.8.0 that may affect the code of existing applications.

Added public APIs:

The following public APIs have been added to Aspose.OMR for .NET 23.8.0:

Page orientation

Allows you to specify the orientation of the individual page in a multipage form. Overrides global layout settings.

Markup	Property	Values
Text	orientation	`horizontal` (landscape) `vertical` (portrait)
JSON	orientation	`horizontal` (landscape) `vertical` (portrait)
Programmatic	Orientation	`Orientation.Horizontal` (landscape) `Orientation.Vertical` (portrait)

Page size

Allows you to specify the size of the individual page in a multipage form. Overrides global layout settings.

Markup	Property	Values
Text	paper_size	`Letter` `A4` `Legal` `Tabloid` `p8519` `p8521` `A3`
JSON	paper_size	`Letter` `A4` `Legal` `Tabloid` `p8519` `p8521` `A3`
Programmatic	PaperSize	`PaperSize.Letter` `PaperSize.A4` `PaperSize.Legal` `PaperSize.Tabloid` `PaperSize.p8519` `PaperSize.p8521` `PaperSize.A3`

Page left margin

Allows you to specify the left margin (in pixels) for the individual page in a multipage form. Overrides global layout settings.

Markup	Property	Values
Text	left_margin
JSON	left_margin
Programmatic	PageMarginLeft

Page right margin

Allows you to specify the right margin (in pixels) for the individual page in a multipage form. Overrides global layout settings.

Markup	Property	Values
Text	right_margin
JSON	right_margin
Programmatic	PageMarginRight

Placement of the rectangular positioning marker

Allows you to specify the placement of the rectangular positioning marker for the individual page in a multipage form. Overrides global layout settings.

Markup	Property	Values
Text	rotation_point_position	`TopLeft1` `TopLeft2` `TopRight1` `TopRight2` `BottomLeft1` `BottomLeft2` `BottomRight1` `BottomRight2`
JSON	rotation_point_position	`TopLeft1` `TopLeft2` `TopRight1` `TopRight2` `BottomLeft1` `BottomLeft2` `BottomRight1` `BottomRight2`
Programmatic	RotationPointPosition	`RotationPointPosition.TopLeft1` `RotationPointPosition.TopLeft2` `RotationPointPosition.TopRight1` `RotationPointPosition.TopRight2` `RotationPointPosition.BottomLeft1` `RotationPointPosition.BottomLeft2` `RotationPointPosition.BottomRight1` `RotationPointPosition.BottomRight2`

Updated public APIs:

The following public APIs have been changed in Aspose.OMR for .NET 23.8.0:

`MailMark` barcode type

Compatibility: fully backward compatible.

This change will not affect existing code, print forms, or recognition results.

Added support for MailMark barcode type (text markup / JSON markup).

Removed public APIs:

No changes.

Usage examples

See the examples below to learn more about the changes introduced in this release:

Customize the layout of the second page of a multi-page form

?page=first_page
?text=Biology Quiz: Plants
	font_size=16
	font_style=bold
?empty_line=
?answer_sheet=Plants
	columns_count=3
	elements_count=90
	answers_count=5
&page
?page=second_page
	orientation=Horizontal
	paper_size=Letter
	left_margin=120
	right_margin=120
	rotation_point_position=BottomRight1
?text=Biology Quiz: Animals
	font_size=16
	font_style=bold
?empty_line=
?answer_sheet=Animals
	columns_count=3
	elements_count=90
	answers_count=5
&page

Add MailMark barcode

?barcode=MailMark barcode
	value=MailMark
	barcode_type=MailMark
	height=300