Конвертировать HTML в изображение на Java – PNG, JPG, BMP, GIF, TIFF

Преобразование HTML в изображения помогает создавать визуальные представления веб-контента для документации, отчетов, презентаций или отправки по электронной почте. Например, используя преобразование HTML в изображение, вы можете быстро получить изображения HTML-документов, таких как отчеты, веб-страницы или диаграммы, для предварительного просмотра или эскизов.

Библиотека Aspose.HTML для Java позволяет конвертировать HTML-документы в JPG, PNG, GIF, TIFF и BMP форматы файлов с полным контролем над широким диапазоном параметров преобразования. Любое преобразование HTML в изображение можно выполнить, выполнив несколько обязательных шагов:

Загрузите существующий HTML-файл из локальной файловой системы, URL-адреса, потока или создайте HTML-код с нуля.
Создайте объект ImageSaveOptions. Здесь вы можете установить формат изображения (JPG, PNG, BMP, GIF или TIFF) и настроить процесс рендеринга для получения желаемого результата.
Используйте один из методов convertHTML() класса Converter и передайте ему необходимые параметры.

В этой статье вы найдете информацию о том, как преобразовать HTML в форматы файлов изображений и как использовать ImageSaveOptions и параметры MemoryStreamProvider. Давайте посмотрим на сценарии преобразования HTML в изображение на примерах Java!

HTML в JPG одной строкой кода

Вы можете преобразовать HTML в изображение в своем Java-приложении буквально с помощью одной строки кода! Следующий код Java показывает преобразование HTML в JPG:

1    // Invoke the convertHTML() method to convert HTML to JPG
2    com.aspose.html.converters.Converter.convertHTML("<h1>Convert HTML to Image in Java</h1>", ".", new ImageSaveOptions(ImageFormat.Jpeg), Path.combine(getOutputDir(), "convert-with-single-line.jpg"));

В примере мы используем метод convertHTML(content, baseUri, options, outputPath) класса Converter. который принимает четыре параметра: строку с HTML-кодом, который нужно преобразовать, базовую папку для входного HTML-файла, экземпляр класса ImageSaveOptions, который определяет параметры выходного изображения, такие как формат изображения, и путь к выходному файлу, в котором будет сохранено преобразованное изображение.

Конвертировать HTML в JPG

Формат JPG обычно используется для изображений, поскольку он поддерживает высокую степень сжатия, что позволяет использовать файлы меньшего размера без существенной потери качества изображения. Это делает его идеальным для хранения изображений в Интернете или обмена ими по электронной почте или другим цифровым носителям. Чтобы преобразовать HTML в JPG, выполните несколько шагов:

Загрузите файл HTML с помощью класса HTMLDocument.
Создайте новый объект ImageSaveOptions с JPG ImageFormat. ImageFormat.Png будет использоваться как формат изображения по умолчанию.
Используйте метод convertHTML(document, options, outputPath) класса Converter, чтобы сохранить HTML как JPG-изображение.

В следующем фрагменте кода Java показано, как преобразовать HTML в JPG с помощью Aspose.HTML:

 1    // Prepare a path to a source HTML file
 2    String documentPath = Path.combine(getDataDir(), "file.html");
 3
 4    // Prepare a path for converted file saving 
 5    String outputPath = Path.combine(getOutputDir(), "file-output.jpg");
 6
 7    // Initialize an HTML document from the file
 8    HTMLDocument document = new HTMLDocument(documentPath);
 9    try {        }
10    finally { if (document != null) document.dispose(); }
11
12    // Initialize an ImageSaveOptions instance
13     ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg);
14
15    // Convert HTML to JPG
16    com.aspose.html.converters.Converter.convertHTML(document, options, outputPath);

Вы можете скачать полные примеры и файлы данных по адресу GitHub.

Конвертировать HTML в PNG

PNG – это популярный формат файлов изображений, который поддерживает сжатие изображений без потерь, что делает его широко используемым. Файлы HTML можно преобразовать в изображения PNG для различных целей, таких как добавление веб-страницы в презентацию PowerPoint, вставка ее в блог или отправка по электронной почте. В следующем примере Java мы рассмотрим пошаговые инструкции по преобразованию HTML в PNG с параметрами сохранения по умолчанию:

Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument.
Используйте конструктор ImageSaveOptions() для создания нового объекта ImageSaveOptions. Объект options можно настроить для указания различных параметров процесса преобразования.
Вызовите метод convertHTML(document, options, outputPath) класса Converter, чтобы сохранить HTML как PNG изображение. Вам необходимо передать HTMLDocument, ImageSaveOptions и путь к выходному файлу для метода convertHTML() в качестве параметров.

 1    // Prepare a path to a source HTML file
 2    String documentPath = Path.combine(getDataDir(), "nature.html");
 3
 4    // Prepare a path for converted file saving 
 5    String outputPath = Path.combine(getOutputDir(), "nature-output.png");
 6
 7    // Initialize an HTML document from the file
 8    HTMLDocument document = new HTMLDocument(documentPath);
 9    try {        }
10    finally { if (document != null) document.dispose(); }
11
12    // Initialize an ImageSaveOptions object
13    ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Png);
14
15    // Convert HTML to PNG
16    com.aspose.html.converters.Converter.convertHTML(document, options, outputPath);

Конвертировать HTML в BMP

В следующем примере показано, как преобразовать HTML в BMP с помощью Aspose.HTML для Java.

Загрузите файл HTML с помощью класса HTMLDocument.
Создайте новый объект ImageSaveOptions с BMP ImageFormat. По умолчанию свойство Format имеет значение PNG.
Используйте метод convertHTML(document, options, outputPath) класса Converter, чтобы сохранить HTML как BMP-изображение. Метод требует передачи HTMLDocument, ImageSaveOptions и путь к выходному файлу в качестве параметров.

 1    // Prepare a path to a source HTML file
 2    String documentPath = Path.combine(getDataDir(), "bmp.html");
 3
 4    // Prepare a path for converted file saving 
 5    String outputPath = Path.combine(getOutputDir(), "bmp-output.bmp");
 6
 7    // Initialize an HTML document from the file
 8    HTMLDocument document = new HTMLDocument(documentPath);
 9    try {        }
10    finally { if (document != null) document.dispose(); }
11
12    // Initialize ImageSaveOptions 
13    ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Bmp);
14
15    // Convert HTML to BMP
16    com.aspose.html.converters.Converter.convertHTML(document, options, outputPath);

Конвертировать HTML в GIF

В следующем фрагменте кода Java показано, как преобразовать HTML в GIF с помощью Aspose.HTML.

Загрузите файл HTML с помощью класса HTMLDocument.
Создайте новый объект ImageSaveOptions с GIF ImageFormat.
Используйте метод convertHTML() класса Converter, чтобы сохранить HTML как изображение GIF.

 1    // Prepare a path to a source HTML file
 2    String documentPath = Path.combine(getDataDir(), "spring.html");
 3
 4    // Prepare a path for converted file saving 
 5    String outputPath = Path.combine(getOutputDir(), "spring-output.gif");
 6
 7    // Initialize an HTML document from the file
 8    HTMLDocument document = new HTMLDocument(documentPath);
 9    try {        }
10    finally { if (document != null) document.dispose(); }
11
12    // Initialize ImageSaveOptions 
13    ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Gif);
14
15    // Convert HTML to GIF
16    com.aspose.html.converters.Converter.convertHTML(document, options, outputPath);

Конвертировать HTML в TIFF

В следующем фрагменте кода Java показано, как преобразовать HTML в TIFF с помощью Aspose.HTML.

Загрузите файл HTML с помощью класса HTMLDocument.
Создайте новый объект ImageSaveOptions в формате TIFF ImageFormat.
Используйте метод convertHTML() класса Converter, чтобы сохранить HTML как изображение TIFF. Вам необходимо передать HTMLDocument, ImageSaveOptions и путь к выходному файлу для метода convertHTML() в качестве параметров.

 1    // Prepare a path to a source HTML file
 2    String documentPath = Path.combine(getDataDir(), "nature.html");
 3
 4    // Prepare a path for converted file saving 
 5    String outputPath = Path.combine(getOutputDir(), "nature-output.tiff");
 6
 7    // Initialize an HTML document from the file
 8    HTMLDocument document = new HTMLDocument(documentPath);
 9    try {        }
10    finally { if (document != null) document.dispose(); }
11
12    // Initialize ImageSaveOptions 
13    ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Tiff);
14
15    // Convert HTML to TIFF
16    com.aspose.html.converters.Converter.convertHTML(document, options, outputPath);

Параметры сохранения

Aspose.HTML для Java позволяет конвертировать HTML в изображения, используя стандартные или пользовательские параметры сохранения. ImageSaveOptions позволяет настроить процесс рендеринга. Вы можете указать формат изображения, размер страницы, поля, уровень сжатия, тип мультимедиа CSS и т. д.

Method	Description
setCompression(value)	Sets the Tagged Image File Format (TIFF) Compression. By default this property is `Compression.LZW`.
getCss	Gets a CssOptions object which is used for configuration of CSS properties processing.
setFormat(value)	Sets ImageFormat (JPG, PNG, BMP, TIFF, or GIF). By default this property is `ImageFormat.Png`.
setBackgroundColor(value)	Sets Color which will fill background of every page. Default value is `Color.Transparent(Color.getTransparent())`.
setPageSetup(value)	Gets a page setup object is used for configuration output page-set.
setHorizontalResolution(value)	Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
setVerticalResolution(value)	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
setSmoothingMode(value)	Sets the rendering quality for this image.
getText()	Gets a TextOptions object which is used for configuration of text rendering.

В следующем примере Java показано, как использовать ImageSaveOptions и создавать выходное изображение с пользовательскими разрешениями, размером страницы и цветом фона:

 1    // Prepare a path to a source HTML file
 2    String documentPath = Path.combine(getDataDir(), "color.html");
 3
 4    // Prepare a path for converted file saving 
 5    String savePath = Path.combine(getOutputDir(), "color-output.jpg");
 6
 7    // Initialize an HTML document from the file
 8    HTMLDocument document = new HTMLDocument(documentPath);
 9    try {        }
10    finally { if (document != null) document.dispose(); }
11
12    // Initialize an ImageSaveOptions object and customize save options
13    ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg);
14    options.setHorizontalResolution(new Resolution(200, UnitType.AUTO));
15    options.setVerticalResolution(new Resolution(200, UnitType.AUTO));
16    com.aspose.html.drawing.Color.getAliceBlue().CloneTo(options.getBackgroundColor());
17    options.getPageSetup().setAnyPage(new Page(new com.aspose.html.drawing.Size(500, 500), new Margin(30, 20, 10, 10)));
18
19    // Convert HTML to JPG
20    com.aspose.html.converters.Converter.convertHTML(document, options, savePath);

Чтобы узнать больше о ImageOptions, прочитайте статью Конвертеры тонкой настройки.

Вы можете скачать полные примеры и файлы данных по адресу GitHub.

Aspose.HTML предлагает бесплатный онлайн HTML to Image Converter, который конвертирует HTML в изображения с высоким качеством, легко и быстро. Просто загрузите, конвертируйте ваши файлы и получите результат за несколько секунд!

Конвертировать HTML в PDF Конвертировать HTML в DOCX