Aspose.Page Convert Micro App 25.12 Release Notes – Introduction

Aspose.Page Convert Micro Application v25.12 is released as a technical maintenance update with improved stability and refreshed dependencies.

Aspose.Page Convert Micro Application


This application enables efficient conversion of PS/EPS/XPS documents into various formats.

What’s New

  • Updated Aspose.Page library to version 25.11.

Breaking Changes in Aspose.Page 25.11.0

XPS Image Export API Changes

Issue: Tests for XPS-to-image conversion were failing after updating to Aspose.Page 25.11.0.

Root Cause: The XpsDocument.SaveAsImage() method behavior changed:

  • Before (v<25.11): Returned byte[][][] (3D array of image bytes in memory).
  • After (v25.11+): Returns void and writes files directly to disk, requiring outDir and fileNameTemplate parameters.

New Method: A new XpsDocument.SaveAsImageBytes() method was introduced, which returns byte[][][] and replicates the old behavior of SaveAsImage().

How We Fixed It

Updated PageProcessor.GetImagesBytesFromDocument() to:

  1. Prioritize SaveAsImageBytes(options) — calls the new method first, which directly returns byte[][][].
  2. Fallback to SaveAsImage(options) — but only if it doesn’t return void (for backward compatibility with older versions).
  3. Check return types at runtime — uses reflection to verify method signatures before invocation.

Impact on MicroApp

  • XPS-to-JPEG, XPS-to-PNG, XPS-to-BMP, and other image format conversions now work correctly with Aspose.Page 25.11.0.
  • The application remains compatible with both old and new versions of the library through runtime API detection.
  • No changes required to public API; conversion behavior is identical.

Migration for Users

If you’re using this MicroApp: No action required. Update to the latest version of this application and Aspose.Page 25.11.0.

If you’re using Aspose.Page 25.11.0 directly: When converting XPS to images:

  • Use SaveAsImageBytes(options) to get bytes in memory (old behavior of SaveAsImage()).
  • Use SaveAsImage(options, outDir, fileNameTemplate) to write directly to disk (new behavior).

Got a Query?

Have any questions or queries about the application? Please feel free to reach us on Aspose.Page Apps Free support forum, where our technical team will do their best to assist you further.