Conversão de STL para PDF em Java

Mon, 12 Oct 2026 09:50:01 +0000

Converter modelos 3D em documentos visualizáveis universalmente é uma necessidade frequente para ferramentas de engenharia e visualização. O Conholdate.Total for Java fornece um SDK robusto que torna a conversão de STL para PDF em Java simples. Neste tutorial, você configurará a biblioteca, percorrerá um exemplo de código completo, ajustará as opções de PDF e aprenderá as melhores práticas para obter resultados confiáveis.

Etapas para Conversão de STL para PDF em Java

Verificar Arquivo STL de Entrada: Certifique‑se de que o arquivo STL de origem exista e seja legível.

String inputPath = "sample.stl";
if (!Files.isReadable(Paths.get(inputPath))) {
    System.err.println("Input STL file not found or not readable: " + inputPath);
    return;
}

Inicializar o Conversor: Crie uma instância Converter com o caminho do arquivo STL.

try (Converter converter = new Converter(inputPath)) {
    // conversion logic follows
}

(Opcional) Aplicar Opções de Carregamento STL: Se precisar de comportamento de carregamento personalizado, descomente as linhas de opções de carregamento.

// LoadOptions loadOptions = new StlLoadOptions();
// converter.setLoadOptions(loadOptions);

Configurar opções de conversão de PDF: Defina o tamanho da página, orientação, qualidade e outras configurações de PDF.

PdfConvertOptions pdfOptions = new PdfConvertOptions();
pdfOptions.setPageSize(PdfPageSize.A4);
pdfOptions.setPageOrientation(PdfPageOrientation.PORTRAIT);
pdfOptions.setQuality(100);
pdfOptions.setEmbedFonts(true);
pdfOptions.setOptimizeForPrint(true);
pdfOptions.setCompressImages(true);

Execute a Conversão e Valide: Chame convert e então verifique se o PDF gerado não está vazio.

converter.convert("sample.pdf", pdfOptions);
File pdfFile = new File("sample.pdf");
if (pdfFile.exists() && pdfFile.length() > 0) {
    System.out.println("Generated PDF is valid. Size: " + pdfFile.length() + " bytes.");
}

STL para PDF Java - Exemplo de Código Completo

O exemplo a seguir demonstra todo o fluxo de trabalho para a conversão de STL para PDF usando Conholdate.Total for Java.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.enums.PdfPageOrientation;
import com.groupdocs.conversion.enums.PdfPageSize;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.LoadOptions;
import com.groupdocs.conversion.options.load.StlLoadOptions;

import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class StlToPdfDemo {
    public static void main(String[] args) {
        // Input STL file and desired PDF output file
        String inputPath = "sample.stl";
        String outputPath = "sample.pdf";

// Verify that the input file exists and is readable
        if (!Files.isReadable(Paths.get(inputPath))) {
            System.err.println("Input STL file not found or not readable: " + inputPath);
            return;
        }

// Perform conversion inside a try‑with‑resources block to guarantee cleanup
        try (Converter converter = new Converter(inputPath)) {
            // If STL‑specific loading options are required, uncomment the following lines:
            // LoadOptions loadOptions = new StlLoadOptions();
            // converter.setLoadOptions(loadOptions);

// Configure PDF conversion options
            PdfConvertOptions pdfOptions = new PdfConvertOptions();
            pdfOptions.setPageSize(PdfPageSize.A4);
            pdfOptions.setPageOrientation(PdfPageOrientation.PORTRAIT);
            pdfOptions.setQuality(100);                 // Highest visual quality
            pdfOptions.setEmbedFonts(true);             // Ensure fonts are embedded
            pdfOptions.setOptimizeForPrint(true);       // Optimize PDF for printing
            pdfOptions.setCompressImages(true);         // Reduce PDF size without quality loss

// Execute the conversion
            converter.convert(outputPath, pdfOptions);
            System.out.println("STL to PDF conversion completed successfully: " + outputPath);
        } catch (Exception ex) {
            System.err.println("An error occurred during conversion:");
            ex.printStackTrace();
            return;
        }

// Simple validation of the generated PDF
        File pdfFile = new File(outputPath);
        if (pdfFile.exists() && pdfFile.length() > 0) {
            System.out.println("Generated PDF is valid. Size: " + pdfFile.length() + " bytes.");
        } else {
            System.err.println("PDF generation failed or resulted an empty file.");
        }
    }
}

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão instaladas corretamente e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Pré-requisitos e Configuração

Adicione o repositório Maven da Conholdate e a dependência do SDK ao seu pom.xml:


    
        conholdate-repo
        Conholdate Maven Repository
        https://repository.conholdate.com/repo/
    



    com.conholdate
    conholdate-total
    24.9
    pom

Baixe o pacote SDK mais recente na página de download. A biblioteca requer Java 8 ou superior.

Configurando Opções de Saída PDF

Conholdate.Total for Java oferece várias configurações de PDF que você pode ajustar:

Tamanho da Página - Escolha entre tamanhos padrão como PdfPageSize.A4 ou PdfPageSize.LETTER.
Orientação da Página - Defina como PdfPageOrientation.PORTRAIT ou PdfPageOrientation.LANDSCAPE.
Qualidade - O método setQuality(int) aceita valores de 0 a 100; 100 oferece a maior fidelidade visual.
Incorporar Fontes - Ativar setEmbedFonts(true) garante que todas as fontes sejam preservadas no PDF de saída.
Otimizar para Impressão - setOptimizeForPrint(true) adapta o PDF para fluxos de trabalho de impressão.
Compactar Imagens - setCompressImages(true) reduz o tamanho do arquivo sem perda de qualidade perceptível.

Essas opções são demonstradas no trecho de código acima e podem ser combinadas para atender a requisitos específicos do projeto.

Conclusão

Conholdate.Total for Java torna a conversão de STL para PDF em Java simples e poderosa. Seguindo as etapas, usando o exemplo de código fornecido e ajustando as opções de PDF, você pode gerar PDFs de alta qualidade a partir de modelos 3D STL para aplicações desktop ou servidor. Lembre‑se de adquirir uma licença adequada para uso em produção; você pode explorar os preços na página de preços ou obter uma licença temporária na página de licença temporária. Com este SDK, integrar a conversão de modelos 3D em seus projetos Java é muito fácil.

FAQs

Como faço a conversão de STL para PDF em Java com Conholdate.Total?
Use a classe Converter, configure PdfConvertOptions e chame convert() conforme mostrado no exemplo de código completo. O SDK cuida do trabalho pesado de renderizar o modelo 3D em um PDF.
Quais formatos de página PDF são suportados durante a conversão de STL para PDF?
O SDK suporta todos os tamanhos de página PDF padrão definidos em PdfPageSize e ambas as orientações retrato e paisagem via PdfPageOrientation.
É possível incorporar fontes personalizadas no PDF gerado?
Sim. Defina pdfOptions.setEmbedFonts(true) para incorporar quaisquer fontes usadas na renderização STL, garantindo que o PDF tenha a mesma aparência em qualquer visualizador.
Onde posso encontrar mais informações sobre licenciamento e suporte?
Detalhes de licenciamento estão disponíveis na página de preços e uma licença temporária pode ser solicitada na página de licença temporária. Para ajuda técnica, visite o fórum de suporte.

file conversion tutorial on Conholdate Blog