Aspose.TeX.Convert 24.12.0

Aspose.TeX Micro Apps

Aspose.TeX for .NET Micro Applications provides high-level APIs for converting TeX/LaTeX documents into various formats, facilitating easy integration into .NET applications.

Explore more about Aspose.TeX .NET API.

Aspose.TeX Convert Micro Application

This application enables efficient conversion of TeX/LaTeX documents into different formats.

Key Features

• Supported Input Formats: TeX, LaTeX.
• Supported Output Formats:
  • PDF (Portable Document Format);
  • XPS (XML Paper Specification);
  • PNG (Portable Network Graphics);
  • JPEG/JPG (Joint Photographic Experts Group);
  • BMP (Bitmap Image File);
  • TIFF/TIF (Tagged Image File Format);
  • SVG (Scalable Vector Graphics).
• 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.TeX Convert application itself is free to use, converting documents requires a valid Aspose.TeX license. You can purchase a license or use Aspose.TeX in trial mode for evaluation purposes.

System Requirements

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

Installation

The Aspose.TeX 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.TeX Convert globally on your machine, use the following command:

dotnet tool install --global Aspose.TeX.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.TeX Convert locally:

dotnet tool install Aspose.TeX.Convert --local

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

Updating the Tool:

To update the Aspose.TeX 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 TeX or LaTeX document.
  • Example: --input input.tex
• -o, --output [Required]: Path for the converted document.
  • Example: --output output.pdf
• -f, --format [Optional]: Output document format.
  • Supported formats: PDF, XPS, PNG, JPEG, BMP, TIFF, SVG.
  • Example: --format pdf
• -l, --license [Optional]: Path to the Aspose.TeX .NET license file.
  • Example: --license path_to_license.lic
• -v, --verbose [Optional]: Enable verbose output.
  • Example: --verbose

Aspose.TeX.Convert --input input.tex --output output.pdf --format pdf

Integration into C# Projects

The Aspose.TeX Convert application can also be integrated directly into your .NET projects using the command line, enabling programmatic access to TeX conversion capabilities within your C# code.

Adding the Converter to Your Project:

To add the Aspose.TeX Convert tool to your Visual Studio project, navigate to your project's root directory and execute the following command:

dotnet Aspose.TeX.Convert add

This command adds the Aspose.TeX Convert functionality directly into your project, allowing you to use the library's methods and properties through your code. This is particularly useful for developers who are looking to implement customized TeX conversion processes directly within their applications.

Use from code:

Once added, you can easily call the TeX conversion methods in your project. Here is a simple example of how to use the Aspose.TeX Convert in your code:

using Aspose.TeX.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.tex",
            
            // Required: Specify the output document path
            OutputFilePath = "output.pdf",
            
            // Optional: Specify the output format
            ToFormat = "pdf"
        };

        // 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.TeX Documentation page.
For answers to your questions, getting support, or feedback, please visit Aspose Forums.