Aspose.Page.Convert 24.12.0

Aspose.Page Micro Apps

Aspose.Page for .NET Micro Applications provides high-level APIs for processing PS, EPS, and XPS documents, facilitating easy integration into .NET applications.

Explore more about Aspose.Page .NET API.

Aspose.Page Convert Micro Application

This application lets you efficiently convert PS/EPS/XPS documents into various formats.

Competitive features

Key Features

• Supported Input Formats: PS, XPS, EPS.
• Supported Output Formats:
  • PDF (Portable Document Format);
  • JPEG/JPG (Joint Photographic Experts Group);
  • PNG (Portable Network Graphics);
  • BMP (Bitmap Image File);
  • TIFF/TIF (Tagged Image File Format);
  • EMF (Enhanced Metafile Format);
  • WMF (Windows Metafile Format);
• Can be used via the command line or integrated into your C# projects as a .NET 6.0/7.0 compatible API.

Licensing

While the Aspose.Page Convert application itself is free to use, converting documents requires a valid Aspose.Page license. You can purchase a license or use Aspose.Page in trial mode for evaluation purposes.

System Requirements

• .NET 6.0/7.0 on Windows, Linux, MacOs;
• Aspose.Page Convert application installed.

Installation

The Aspose.Page Convert application can be installed either globally or locally, depending on your project's needs. Using the local installation for project-specific use is recommended to avoid version conflicts.

Global Installation:

To install Aspose.Page Convert globally on your machine, use the following command:

dotnet tool install --global Aspose.Page.Convert

Specify the --version option if you need a specific version of the tool.

Local Installation:

For local installation within a specific project, first, navigate to your project's root directory. Then, execute the following commands:

1. Create a tool manifest if not already present:

dotnet new tool-manifest

2. Install Aspose.Page Convert locally:

dotnet tool install Aspose.Page.Convert --local

Again, you can specify the --version option for a specific version.

Updating the Tool:

To update the Aspose.Page Convert tool to the latest version, use the dotnet tool update command with either --global or --local, matching your installation type.

Uninstalling the Tool:

If you need to uninstall the tool, use the dotnet tool uninstall command with either --global or --local, depending on how the tool was installed.

Usage

Use from the command line:

To convert documents using the command line, you can use the following parameters:

• -i, --input [Required]: Path to the input document.
  • Example: --input input.xps
• -o, --output [Required]: Path for the converted document.
  • Example: --output output.pdf
• -f, --format [Optional]: Output document format.
  • Supported formats: PDF, JPEG, PNG, BMP, TIFF, EMF, WMF.
  • Example: --format pdf
• -w, --width [Optional]: Width of the converted document (for image formats).
  • Example: --width 1920
• -h, --height [Optional]: Height of the converted document (for image formats).
  • Example: --height 1080
• -r, --resolution [Optional]: Resolution of the converted document (for image formats).
  • Example: --resolution 300
• -l, --license [Optional]: Path to the Aspose.Page .NET license file.
  • Example: --license path_to_license.lic
• -v, --verbose [Optional]: Enable verbose output.
  • Example: --verbose

Aspose.Page.Convert --input input.xps --output output.pdf --format pdf

Use from code:

using Aspose.Page.MicroApps.Convert;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // Initialize convert options
        var options = new ConvertOptions
        {
            // Required: Specify the input document path
            InputDocument = "input.xps",
            
            // Required: Specify the output document path
            OutputFilePath = "output.png",
            
            // Optional: Specify the output format
            ToFormat = "png",
            
            // Optional: Specify the width of the converted document (applicable for image formats)
            Width = 1920, 
            
            // Optional: Specify the height of the converted document (applicable for image formats)
            Height = 1080,
            
            // Optional: Specify the resolution of the converted document (applicable for image formats)
            Resolution = 300
        };

        // Conditional: Apply the license if you have one
        if (isLicensed)
        {
            options.LicenseFile = "path_to_license.lic";
        }

        // Execute the conversion task
        await ConvertTasks.Create(options).Execute();
    }
}

Documentation and Support

Comprehensive documentation is available on the Aspose.Page Documentation page.
For answers to your questions, getting support, or feedback, please visit Aspose Forums.