Passaggi per la conversione da STL a PDF in Java

1. Verifica file STL di input: Assicurati che il file STL di origine esista e sia leggibile.

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

2. Inizializzare il Converter: Creare un’istanza Converter con il percorso del file STL.

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

3. (Facoltativo) Applica le opzioni di caricamento STL: Se hai bisogno di un comportamento di caricamento personalizzato, decommenta le righe delle opzioni di caricamento.

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

4. Configura le opzioni di conversione PDF: Imposta la dimensione della pagina, l’orientamento, la qualità e altre impostazioni 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);

5. Esegui la conversione e valida: chiama convert e quindi verifica che il PDF generato non sia vuoto.

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 a PDF Java - Esempio di Codice Completo

Il seguente esempio dimostra l’intero flusso di lavoro per la conversione da STL a PDF utilizzando 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 in an empty file.");
        }
    }
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Prerequisiti e Configurazione

Aggiungi il repository Maven di Conholdate e la dipendenza SDK al tuo pom.xml:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

Scarica l’ultimo pacchetto SDK dalla pagina di download. La libreria richiede Java 8 o versioni successive.

Configurazione delle opzioni di output PDF

Conholdate.Total for Java offre diverse impostazioni PDF che è possibile regolare:

• Dimensione pagina - Scegli tra le dimensioni standard come PdfPageSize.A4 o PdfPageSize.LETTER.
• Orientamento pagina - Imposta su PdfPageOrientation.PORTRAIT o PdfPageOrientation.LANDSCAPE.
• Qualità - Il metodo setQuality(int) accetta valori da 0 a 100; 100 fornisce la massima fedeltà visiva.
• Incorpora caratteri - Abilitare setEmbedFonts(true) garantisce che tutti i caratteri siano conservati nel PDF di output.
• Ottimizza per stampa - setOptimizeForPrint(true) adatta il PDF ai flussi di lavoro di stampa.
• Comprimi immagini - setCompressImages(true) riduce le dimensioni del file senza una perdita di qualità evidente.

Queste opzioni sono dimostrate nello snippet di codice sopra e possono essere combinate per soddisfare requisiti specifici del progetto.

Conclusione

Conholdate.Total for Java rende la conversione da STL a PDF in Java sia semplice che potente. Seguendo i passaggi, utilizzando l’esempio di codice fornito e regolando le opzioni PDF, è possibile generare PDF di alta qualità da modelli 3D STL per applicazioni desktop o server. Ricorda di acquisire una licenza adeguata per l’uso in produzione; puoi consultare i prezzi nella pagina dei prezzi o ottenere una licenza temporanea dalla pagina della licenza temporanea. Con questo SDK a disposizione, integrare la conversione di modelli 3D nei tuoi progetti Java è un gioco da ragazzi.

FAQ

• Come eseguire la conversione da STL a PDF in Java con Conholdate.Total?
  Utilizza la classe Converter, configura PdfConvertOptions e chiama convert() come mostrato nell’esempio di codice completo. L’SDK si occupa della parte più complessa del rendering del modello 3D in un PDF.

• Quali formati di pagina PDF sono supportati durante la conversione da STL a PDF?
  L’SDK supporta tutte le dimensioni di pagina PDF standard definite in PdfPageSize e sia le orientazioni verticale che orizzontale tramite PdfPageOrientation.

• È possibile incorporare caratteri personalizzati nel PDF generato?
  Sì. Imposta pdfOptions.setEmbedFonts(true) per incorporare tutti i caratteri utilizzati nel rendering STL, garantendo che il PDF abbia lo stesso aspetto su qualsiasi visualizzatore.

• Dove posso trovare maggiori informazioni su licenze e supporto?
  I dettagli sulla licenza sono disponibili nella pagina dei prezzi e una licenza temporanea può essere richiesta dalla pagina di licenza temporanea. Per assistenza tecnica, visita il forum di supporto.

Leggi di più

• Aggiungi filigrana a PDF in Java
• Conversione da MPP a PDF in Java
• Aggiungi testo a PDF in Java