Преобразование STL в PDF на Java

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

Преобразование 3D‑моделей в документы, доступные для просмотра на любых устройствах, часто требуется в инженерных и визуализационных инструментах. Conholdate.Total for Java предоставляет мощный SDK, который упрощает конвертацию STL в PDF в Java. В этом руководстве вы настроите библиотеку, пройдёте через полный пример кода, настроите параметры PDF и изучите лучшие практики для получения надёжных результатов.

Шаги конвертации STL в PDF на Java

Проверьте входной файл STL: Убедитесь, что исходный файл STL существует и доступен для чтения.

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

Инициализировать конвертер: Создайте экземпляр Converter с путем к файлу STL.

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

(Необязательно) Применить параметры загрузки STL: Если вам требуется пользовательское поведение загрузки, раскомментируйте строки параметров загрузки.

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

Настройте параметры конвертации PDF: Установите размер страницы, ориентацию, качество и другие параметры 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);

Выполнить конвертацию и проверить: Вызовите convert и затем проверьте, что сгенерированный PDF не пустой.

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 в PDF Java - Полный пример кода

Следующий пример демонстрирует весь процесс преобразования STL в PDF с использованием 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.");
        }
    }
}

Примечание: Этот пример кода демонстрирует базовый функционал. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации в соответствии с вашей реальной средой, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если вы столкнётесь с какими‑либо проблемами, обратитесь к официальной документации или свяжитесь с службой поддержки для получения помощи.

Требования и настройка

Добавьте репозиторий Conholdate Maven и зависимость SDK в ваш pom.xml:


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



    com.conholdate
    conholdate-total
    24.9
    pom

Скачайте последнюю версию SDK с страницы загрузки. Библиотека требует Java 8 или выше.

Настройка параметров вывода PDF

Conholdate.Total for Java предлагает несколько параметров PDF, которые вы можете настроить:

Page Size - Выберите из стандартных размеров, таких как PdfPageSize.A4 или PdfPageSize.LETTER.
Page Orientation - Установите PdfPageOrientation.PORTRAIT или PdfPageOrientation.LANDSCAPE.
Quality - Метод setQuality(int) принимает значения от 0 до 100; 100 обеспечивает наивысшую визуальную точность.
Embed Fonts - Включение setEmbedFonts(true) гарантирует сохранение всех шрифтов в результирующем PDF.
Optimize for Print - setOptimizeForPrint(true) адаптирует PDF для печатных процессов.
Compress Images - setCompressImages(true) уменьшает размер файла без заметной потери качества.

Эти параметры продемонстрированы в приведённом выше фрагменте кода и могут быть объединены для удовлетворения конкретных требований проекта.

Заключение

Conholdate.Total for Java делает преобразование STL в PDF в Java простым и мощным. Следуя инструкциям, используя предоставленный пример кода и настраивая параметры PDF, вы можете создавать PDF высокого качества из 3D‑моделей STL для настольных или серверных приложений. Не забудьте получить соответствующую лицензию для использования в продакшене; вы можете ознакомиться с ценами на странице цен или получить временную лицензию на странице временной лицензии. С этим SDK интеграция конвертации 3D‑моделей в ваши Java‑проекты становится простой задачей.

Часто задаваемые вопросы

Как выполнить конвертацию STL в PDF в Java с помощью Conholdate.Total?
Используйте класс Converter, настройте PdfConvertOptions и вызовите convert(), как показано в полном примере кода. SDK берет на себя всю тяжелую работу по рендерингу 3D‑модели в PDF.
Какие форматы страниц PDF поддерживаются при конвертации STL в PDF?
SDK поддерживает все стандартные размеры страниц PDF, определённые в PdfPageSize, а также обе ориентации — портретную и альбомную — через PdfPageOrientation.
Можно ли встроить пользовательские шрифты в сгенерированный PDF?
Да. Установите pdfOptions.setEmbedFonts(true), чтобы встроить любые шрифты, используемые при рендеринге STL, гарантируя, что PDF будет выглядеть одинаково во всех просмотрщиках.
Где я могу найти более подробную информацию о лицензировании и поддержке?
Подробности о лицензировании доступны на странице страница с ценами и временную лицензию можно запросить на странице страница временной лицензии. Для технической помощи посетите форум поддержки.

file conversion tutorial on Conholdate Blog