Pasos para la conversión de STL a PDF en Java

1. Verificar archivo STL de entrada: Asegúrese de que el archivo STL fuente exista y sea legible.

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

2. Inicializar el Convertidor: Cree una instancia de Converter con la ruta del archivo STL.

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

3. (Opcional) Aplicar opciones de carga STL: Si necesita un comportamiento de carga personalizado, descomente las líneas de opciones de carga.

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

4. Configurar opciones de conversión a PDF: Establezca el tamaño de página, la orientación, la calidad y otras configuraciones 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);

5. Ejecutar la conversión y validar: Llama a convert y luego verifica que el PDF generado no esté vacío.

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 - Ejemplo de código completo

El siguiente ejemplo muestra todo el flujo de trabajo para la conversión de STL a 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 ejemplo de código muestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Requisitos y configuración

Agregue el repositorio Maven de Conholdate y la dependencia del SDK a su 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>

Descargue el paquete SDK más reciente desde la página de descarga. La biblioteca requiere Java 8 o superior.

Configuración de opciones de salida PDF

Conholdate.Total for Java ofrece varias configuraciones de PDF que puedes ajustar:

• Tamaño de página - Elija entre tamaños estándar como PdfPageSize.A4 o PdfPageSize.LETTER.
• Orientación de página - Establezca PdfPageOrientation.PORTRAIT o PdfPageOrientation.LANDSCAPE.
• Calidad - El método setQuality(int) acepta valores de 0 a 100; 100 brinda la mayor fidelidad visual.
• Incrustar fuentes - Activar setEmbedFonts(true) garantiza que todas las fuentes se conserven en el PDF de salida.
• Optimizar para impresión - setOptimizeForPrint(true) adapta el PDF para flujos de trabajo de impresión.
• Comprimir imágenes - setCompressImages(true) reduce el tamaño del archivo sin una pérdida de calidad perceptible.

Estas opciones se demuestran en el fragmento de código anterior y pueden combinarse para cumplir con requisitos específicos del proyecto.

Conclusión

Conholdate.Total for Java hace que la conversión de STL a PDF en Java sea simple y potente. Siguiendo los pasos, usando el ejemplo de código proporcionado y ajustando las opciones de PDF, puedes generar PDFs de alta calidad a partir de modelos 3D STL para aplicaciones de escritorio o servidor. Recuerda obtener una licencia adecuada para uso en producción; puedes consultar los precios en la página de precios o obtener una licencia temporal en la página de licencia temporal. Con este SDK, integrar la conversión de modelos 3D en tus proyectos Java es muy fácil.

Preguntas frecuentes

• ¿Cómo realizo la conversión de STL a PDF en Java con Conholdate.Total?
  Utilice la clase Converter, configure PdfConvertOptions y llame a convert() como se muestra en el ejemplo de código completo. El SDK se encarga de la parte más pesada de renderizar el modelo 3D en un PDF.

• ¿Qué formatos de página PDF son compatibles durante la conversión de STL a PDF?
  El SDK admite todos los tamaños de página PDF estándar definidos en PdfPageSize y tanto orientaciones verticales como horizontales mediante PdfPageOrientation.

• ¿Es posible incrustar fuentes personalizadas en el PDF generado?
  Sí. Establezca pdfOptions.setEmbedFonts(true) para incrustar cualquier fuente utilizada en la renderización STL, asegurando que el PDF se vea igual en cualquier visor.

• ¿Dónde puedo encontrar más información sobre licencias y soporte?
  Los detalles de licencias están disponibles en la página de precios y se puede solicitar una licencia temporal en la página de licencia temporal. Para ayuda técnica, visite el foro de soporte.

Leer más

• Agregar marca de agua a PDF en Java
• Conversión de MPP a PDF en Java
• Agregar texto a PDF en Java