Browse our Products
Aspose.OMR for .NET 23.4.0 - Release Notes
What was changed
| Key | Summary | Category |
|---|---|---|
| OMRNET‑807 | Added form generation setting which configures how to render very long words that do not fit the width of the parent element. This setting changes the existing error handling. For more information, see Added Public APIs. | New feature |
Known issues and limitations
| Key | Summary | Workaround |
|---|---|---|
| OMRNET‑462 | Recognition of multi-page PDF and TIFF files causes an error. | Scan each page of the filled form into a separate file and recognize them one-by-one. |
| OMRNET‑555 | Recalculate method results in incorrect processing of ScoreGroup elements (text markup / JSON markup) and CustomAnswerSheet elements (text markup / JSON markup). | Use RecognizeImage method with different threshold setting instead of run-time adjustments of recognition accuracy. |
| n/a | Generating a form under .NET 5 and .NET 6 may occasionally fail with TypeLoadException exception. | If you encounter that error, use .NET Standard 2.0 or .NET Framework 4.x. |
Public API changes and backwards compatibility
This section lists all public API changes introduced in Aspose.OMR for .NET 23.4.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.4.0:
Aspose.OMR.Generation.GlobalPageSettings.LongWordHandling property
Compatibility: partial backwards compatibility.
The default behavior has been changed from throwing an exception when the word cannot fit the parent width to rendering long words on top of other elements, even if this results in overlapping content. If you want to return the original behavior, change this setting to Aspose.OMR.Generation.LongWordHandling.ThrowException.
This form generation setting controls how Aspose.OMR for .NET works when it encounters very long words that do not fit the parent element’s width and cannot be wrapped. By default, long words continue to appear outside the bounds of an element until a space or end of line is encountered, even if this results in overlap with other form’s elements.
See the description of Aspose.OMR.Generation.LongWordHandling enumeration for a list of supported values.
This property applies to texts in the following elements:
- CheckBox (label and content)
- ChoiceBox (question text)
- Content
- CustomAnswerSheet (rows)
- Table (header, title, question, answer)
- InputGroup
- ScoreAnswer
- ScoreQuestion
Aspose.OMR.Generation.LongWordHandling enumeration
This enumeration is used to specify a value of Aspose.OMR.Generation.GlobalPageSettings.LongWordHandling property.
| Value | Rendering behavior |
|---|---|
DrawOver | Draw long words until a space or end of line is encountered, even outside the bounds of an element. To prevent the word from overlapping other elements, enable content clipping with the Aspose.OMR.Generation.GlobalPageSettings.Overflow property. |
ThrowException | Throw an exception when rendering the form if the long word does not fit the width of the parent element. The form will not be generated. This is the default form rendering behavior in previous versions of Aspose.OMR for .NET. |
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:
Throw an exception when a word does not fit parent
Aspose.OMR.Generation.GlobalPageSettings globalPageSettings = new Aspose.OMR.Generation.GlobalPageSettings();
globalPageSettings.LongWordHandling = Aspose.OMR.Generation.LongWordHandling.ThrowException;
try {
Aspose.OMR.Generation.GenerationResult generationResult = omrEngine.GenerateTemplate("source.txt", globalPageSettings);
} catch(Exception e) {
Console.WriteLine(e);
}