Browse our Products

Latest release (May 2024)

This article contains a summary of recent changes, enhancements and bug fixes in Aspose.OMR for Java 24.5.0 (May 2024) release.

What was changed

This is the major release of Aspose.OMR for Java which delivers significant new features, enhancements to existing features, performance improvements, and fixes. The list below contains the most important features that are supported in this release:

Key	Summary	Category
OMRJAVA-85	Added the ability to specify color for the text elements	New feature
OMRJAVA-87	Added the ability to specify horizontal alignment for the text elements	New feature
OMRJAVA-88	Added the ability to specify color of all text on a page.	New feature
OMRJAVA-29	Fixed issue with incorrect drawing of image elements with default Height	Fix

Public API changes and backwards compatibility

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

Added public APIs:

The following public APIs have been added in this release:

`align` markup property

Specify the horizontal alignment for text elements. In case of multiline text elements calculate each line individually. Supported values:

Value	Example
`left`	Align text to the left side of template(default)
`right`	Align text to the right side of template
`center`	Align text to the center of template
text

`font_color` markup property

Specify the style for text elements. Overrides the font color specified in the page settings. Supports same colors as GlobalPageSettings.

`GlobalPageSettings`

GlobalPageSettings class allows you to customize the design and layout of the generated OMR form. Starting with Aspose.OMR for Java 24.5.0, you can configure the following parameters:

`GlobalPageSettings.FontColor`

The new setting GlobalPageSettings.FontColor allows you to configure default font color of all elements for the generated OMR form. This setting takes one of the following values:

Color	Value
	`DrawingColor.undefined`
	`DrawingColor.AliceBlue`
	`DrawingColor.AntiqueWhite`
	`DrawingColor.Aqua`
	`DrawingColor.Aquamarine`
	`DrawingColor.Azure`
	`DrawingColor.Beige`
	`DrawingColor.Bisque`
	`DrawingColor.Black`
	`DrawingColor.BlanchedAlmond`
	`DrawingColor.Blue`
	`DrawingColor.BlueViolet`
	`DrawingColor.Brown`
	`DrawingColor.BurlyWood`
	`DrawingColor.CadetBlue`
	`DrawingColor.Chartreuse`
	`DrawingColor.Chocolate`
	`DrawingColor.Coral`
	`DrawingColor.CornflowerBlue`
	`DrawingColor.Cornsilk`
	`DrawingColor.Crimson`
	`DrawingColor.Cyan`
	`DrawingColor.DarkBlue`
	`DrawingColor.DarkCyan`
	`DrawingColor.DarkGoldenrod`
	`DrawingColor.DarkGray`
	`DrawingColor.DarkGreen`
	`DrawingColor.DarkKhaki`
	`DrawingColor.DarkMagenta`
	`DrawingColor.DarkOliveGreen`
	`DrawingColor.DarkOrange`
	`DrawingColor.DarkOrchid`
	`DrawingColor.DarkRed`
	`DrawingColor.DarkSalmon`
	`DrawingColor.DarkSeaGreen`
	`DrawingColor.DarkSlateBlue`
	`DrawingColor.DarkSlateGray`
	`DrawingColor.DarkTurquoise`
	`DrawingColor.DarkViolet`
	`DrawingColor.DeepPink`
	`DrawingColor.DeepSkyBlue`
	`DrawingColor.DimGray`
	`DrawingColor.DodgerBlue`
	`DrawingColor.Firebrick`
	`DrawingColor.FloralWhite`
	`DrawingColor.ForestGreen`
	`DrawingColor.Fuchsia`
	`DrawingColor.Gainsboro`
	`DrawingColor.GhostWhite`
	`DrawingColor.Gold`
	`DrawingColor.Goldenrod`
	`DrawingColor.Gray`
	`DrawingColor.Green`
	`DrawingColor.GreenYellow`
	`DrawingColor.Honeydew`
	`DrawingColor.HotPink`
	`DrawingColor.IndianRed`
	`DrawingColor.Indigo`
	`DrawingColor.Ivory`
	`DrawingColor.Khaki`
	`DrawingColor.Lavender`
	`DrawingColor.LavenderBlush`
	`DrawingColor.LawnGreen`
	`DrawingColor.LemonChiffon`
	`DrawingColor.LightBlue`
	`DrawingColor.LightCoral`
	`DrawingColor.LightCyan`
	`DrawingColor.LightGoldenrodYellow`
	`DrawingColor.LightGray`
	`DrawingColor.LightGreen`
	`DrawingColor.LightPink`
	`DrawingColor.LightSalmon`
	`DrawingColor.LightSeaGreen`
	`DrawingColor.LightSkyBlue`
	`DrawingColor.LightSlateGray`
	`DrawingColor.LightSteelBlue`
	`DrawingColor.LightYellow`
	`DrawingColor.Lime`
	`DrawingColor.LimeGreen`
	`DrawingColor.Linen`
	`DrawingColor.Magenta`
	`DrawingColor.Maroon`
	`DrawingColor.MediumAquamarine`
	`DrawingColor.MediumBlue`
	`DrawingColor.MediumOrchid`
	`DrawingColor.MediumPurple`
	`DrawingColor.MediumSeaGreen`
	`DrawingColor.MediumSlateBlue`
	`DrawingColor.MediumSpringGreen`
	`DrawingColor.MediumTurquoise`
	`DrawingColor.MediumVioletRed`
	`DrawingColor.MidnightBlue`
	`DrawingColor.MintCream`
	`DrawingColor.MistyRose`
	`DrawingColor.Moccasin`
	`DrawingColor.NavajoWhite`
	`DrawingColor.Navy`
	`DrawingColor.OldLace`
	`DrawingColor.Olive`
	`DrawingColor.OliveDrab`
	`DrawingColor.Orange`
	`DrawingColor.OrangeRed`
	`DrawingColor.Orchid`
	`DrawingColor.PaleGoldenrod`
	`DrawingColor.PaleGreen`
	`DrawingColor.PaleTurquoise`
	`DrawingColor.PaleVioletRed`
	`DrawingColor.PapayaWhip`
	`DrawingColor.PeachPuff`
	`DrawingColor.Peru`
	`DrawingColor.Pink`
	`DrawingColor.Plum`
	`DrawingColor.PowderBlue`
	`DrawingColor.Purple`
	`DrawingColor.Red`
	`DrawingColor.RosyBrown`
	`DrawingColor.RoyalBlue`
	`DrawingColor.SaddleBrown`
	`DrawingColor.Salmon`
	`DrawingColor.SandyBrown`
	`DrawingColor.SeaGreen`
	`DrawingColor.SeaShell`
	`DrawingColor.Sienna`
	`DrawingColor.Silver`
	`DrawingColor.SkyBlue`
	`DrawingColor.SlateBlue`
	`DrawingColor.SlateGray`
	`DrawingColor.Snow`
	`DrawingColor.SpringGreen`
	`DrawingColor.SteelBlue`
	`DrawingColor.Tan`
	`DrawingColor.Teal`
	`DrawingColor.Thistle`
	`DrawingColor.Tomato`
	`DrawingColor.Turquoise`
	`DrawingColor.Violet`
	`DrawingColor.Wheat`
	`DrawingColor.White`
	`DrawingColor.WhiteSmoke`
	`DrawingColor.Yellow`
	`DrawingColor.YellowGreen`

Updated public APIs:

No changes.

Removed public APIs:

No changes.

Usage examples

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

Configure default font color of the OMR form

OmrEngine engine = new OmrEngine();
GlobalPageSettings pageSettings = new GlobalPageSettings();
pageSettings.FontColor = DrawingColor.Red;
GenerationResult res = engine.generateTemplate("source.txt", pageSettings);
res.Save("target", "omr_form");

Set color for the text element

Configure the style of text elements

?text=Once upon a midnight dreary, while I pondered, weak and weary,
Over many a quaint and curious volume of forgotten lore-
While I nodded, nearly napping, suddenly there came a tapping,
As of some one gently rapping, rapping at my chamber door.
	font_family=Courier New
	font_style=bold, italic
	font_size=16
	font_color=Red
	align=right

Custom font color