Incorporando gráficos em documentos LaTeX usando Java

Incorpore imagens rasterizadas de alta resolução (PNG, JPEG, BMP) e figuras vetoriais (EPS, PDF) em documentos LaTeX usando o Aspose.TeX for Java. Ao utilizar pacotes LaTeX nativos, como graphicx, e configurar diretórios de trabalho de entrada, os desenvolvedores podem compilar perfeitamente documentos com gráficos, figuras, fotos e gráficos vetoriais incorporados, gerando saídas em PDF, XPS e imagens prontas para publicação.

Ao compilar documentos LaTeX que contêm elementos gráficos, o Aspose.TeX for Java resolve os arquivos de imagem referenciados em relação ao IInputWorkingDirectory configurado.

Para fotos, capturas de tela rasterizadas e gráficos da Web, escolha os formatos PNG/JPEG incorporados usando os comandos \usepackage{graphicx} - \includegraphics{figure.png}.
Para diagramas vetoriais de alta precisão e gráficos CAD/científicos, escolha o formato EPS incorporado usando os comandos \usepackage{graphicx} - \includegraphics{diagram.eps}.
Para incorporar imagens bitmap antigas, escolha o formato BMP/TIFF incorporado usando os comandos \usepackage{graphicx} - \includegraphics{image.bmp}.

Incorporando imagens rasterizadas (PNG/JPEG) no LaTeX

Para incorporar imagens rasterizadas padrão, inclua o pacote graphicx no preâmbulo do documento LaTeX e especifique o nome do arquivo de imagem de destino em \includegraphics{}.

import com.aspose.tex.*;
import java.io.ByteArrayInputStream;
import java.nio.charset.StandardCharsets;

public class EmbedRasterGraphicsInLaTeX {
    public static void main(String[] args) throws Exception {
        // Create LaTeX document string referencing an image file 'sample.png'
        String latexCode = "\\documentclass{article}\n" +
                           "\\usepackage{graphicx}\n" +
                           "\\begin{document}\n" +
                           "\\section{Graphics Rendering Demo}\n" +
                           "Here is an embedded raster image:\n\n" +
                           "\\begin{figure}[h]\n" +
                           "  \\centering\n" +
                           "  \\includegraphics[width=0.5\\textwidth]{sample.png}\n" +
                           "  \\caption{Sample PNG Image in LaTeX}\n" +
                           "\\end{figure}\n" +
                           "\\end{document}";

        ByteArrayInputStream inputStream = new ByteArrayInputStream(latexCode.getBytes(StandardCharsets.UTF_8));

        // Initialize conversion options for ObjectLaTeX
        TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());

        // Set input working directory where 'sample.png' is located
        options.setInputWorkingDirectory(new InputFileSystemDirectory("C:/TeXProject/Images/"));

        // Set output working directory for compiled PDF
        options.setOutputWorkingDirectory(new OutputFileSystemDirectory("C:/TeXProject/Output/"));

        // Execute TeX job
        TeXJob job = new TeXJob(inputStream, new PdfDevice(), options);
        job.run();

        System.out.println("LaTeX document with embedded PNG successfully compiled to PDF.");
    }
}

Incorporando gráficos vetoriais (EPS) no LaTeX

O Aspose.TeX processa nativamente gráficos Encapsulated PostScript (.eps) ao compilar por meio do mecanismo de formato ObjectLaTeX.

import com.aspose.tex.*;
import java.io.IOException;

public class EmbedEPSGraphicsInLaTeX {
    public static void main(String[] args) throws IOException {
        // Initialize options for LaTeX format engine
        TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());

        // Configure directory paths containing .tex source and .eps graphics
        options.setInputWorkingDirectory(new InputFileSystemDirectory("C:/TeXProject/SourceWithEPS/"));
        options.setOutputWorkingDirectory(new OutputFileSystemDirectory("C:/TeXProject/Output/"));

        // Run job for 'document_with_eps.tex' containing \includegraphics{vector_chart.eps}
        TeXJob job = new TeXJob("document_with_eps", new PdfDevice(), options);
        job.run();

        System.out.println("LaTeX document with vector EPS figure compiled successfully.");
    }
}

Carregando recursos gráficos de arquivos ZIP

Empacote arquivos de origem TeX, pacotes de macros e imagens dinâmicas juntos em um arquivo .zip e instrua o Aspose.TeX a resolver as dependências gráficas diretamente da memória ou do armazenamento compactado.

import com.aspose.tex.*;
import java.io.FileInputStream;

public class EmbedGraphicsFromZip {
    public static void main(String[] args) throws Exception {
        // Initialize LaTeX engine options
        TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());

        // Open input ZIP archive containing 'main.tex' and 'figure.png'
        FileInputStream zipStream = new FileInputStream("C:/TeXProject/ProjectWithAssets.zip");
        options.setInputWorkingDirectory(new InputZipDirectory(zipStream, "src"));

        // Define output destination
        options.setOutputWorkingDirectory(new OutputFileSystemDirectory("C:/TeXProject/Output/"));

        // Run compilation job
        TeXJob job = new TeXJob("main", new PdfDevice(), options);
        job.run();

        zipStream.close();
        System.out.println("Compiled LaTeX document with images embedded directly from ZIP file.");
    }
}

Instalação e configuração

Integre o Aspose.TeX for Java ao seu projeto usando o Maven:

Package Manager Console Command

<repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>https://repository.aspose.com/repo/</url>
</repository>

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-tex</artifactId>
    <version>Latest</version>
</dependency>

Próximas etapas

FAQ

1. O que acontece se eu não especificar um nome de job em TeXOptions?

Se um nome de job não for configurado explicitamente por meio de setJobName(), o Aspose.TeX usará como padrão o nome do arquivo de entrada principal (por exemplo, main.tex gera main.pdf e main.log).

2. Como desabilito completamente a criação do arquivo de compilação .log?

Defina options.setLogOutput(false) antes de criar e executar TeXJob. Isso impede que o mecanismo gere arquivos de log auxiliares no disco ou no diretório de trabalho de saída.

3. Posso capturar mensagens do terminal TeX em ambientes de servidor/headless?

Sim. Atribuir um OutputMemoryTerminal personalizado ou implementar IOutputTerminal permite encaminhar todas as mensagens stdout/stderr do terminal para o sistema de registro corporativo do seu servidor (por exemplo, Log4j ou SLF4J).