Преобразование HTML в PNG – примеры C# и онлайн-конвертер
PNG – один из наиболее часто используемых форматов файлов изображений. Он поддерживает сжатие изображений без потерь, что делает его популярным среди пользователей. Преобразование файлов HTML в изображения PNG может потребоваться, например, если вы хотите добавить веб-страницу в презентацию PowerPoint, вставить ее в блог для своих читателей или отправить по электронной почте. С помощью Aspose.HTML вы можете программно конвертировать HTML в формат PNG с полным контролем над широким диапазоном параметров конвертации.
В этой статье вы найдете информацию о том, как преобразовать HTML в PNG с помощью ConvertHTML() методов класса Converter и как применять ImageSaveOptions и ICreateStreamProvider.
Онлайн HTML Конвертер
Вы можете проверить функциональность Aspose.HTML API и конвертировать HTML в режиме реального времени. Пожалуйста, загрузите HTML из локальной файловой системы, выберите выходной формат и запустите пример. В примере параметры сохранения установлены по умолчанию. Вы сразу получите результат в виде отдельного файла.
Если вы хотите программно преобразовать HTML в PNG, давайте рассмотрим следующие примеры кода C#.
HTML в PNG одной строкой кода
Статические методы класса Converter в основном используются как самый простой способ преобразования HTML-кода в различные форматы. Вы можете преобразовать HTML в PNG в своем приложении C# буквально с помощью одной строки кода!
1using System.IO;
2using Aspose.Html.Converters;
3using Aspose.Html.Rendering.Image;
4using Aspose.Html.Saving;
5...
6 // Invoke the ConvertHTML() method to convert the HTML code to PNG image
7 Converter.ConvertHTML(@"<h1>Convert HTML to PNG!</h1>", ".", new ImageSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.png"));
Конвертировать HTML в PNG
Преобразование файла в другой формат методом ConvertHTML() представляет собой последовательность операций, среди которых загрузка и сохранение документа:
- Загрузите файл HTML с помощью класса HTMLDocument.
- Создайте новый объект ImageSaveOptions. По умолчанию свойство Format имеет значение PNG.
- Используйте метод ConvertHTML() класса Converter, чтобы сохранить HTML как изображение PNG. Вам необходимо передать HTMLDocument, ImageSaveOptions и путь к выходному файлу для метода ConvertHTML() для преобразования HTML в PNG.
Взгляните на следующий фрагмент кода C#, в котором показан процесс преобразования HTML в PNG с использованием Aspose.HTML для .NET.
1using System.IO;
2using Aspose.Html;
3using Aspose.Html.Converters;
4using Aspose.Html.Rendering.Image;
5using Aspose.Html.Saving;
6...
7 // Prepare a path to a source HTML file
8 string documentPath = Path.Combine(DataDir, "nature.html");
9
10 // Prepare a path for converted file saving
11 string savePath = Path.Combine(OutputDir, "nature-output.png");
12
13 // Initialize an HTML document from the file
14 using var document = new HTMLDocument(documentPath);
15
16 // Initialize ImageSaveOptions
17 var options = new ImageSaveOptions(ImageFormat.Png);
18
19 // Convert HTML to PNG
20 Converter.ConvertHTML(document, options, savePath);
Вы можете скачать полные примеры и файлы данных с GitHub.
Параметры Сохранения
Aspose.HTML позволяет конвертировать HTML в PNG, используя стандартные или пользовательские параметры сохранения. Использование ImageSaveOptions позволяет настроить процесс рендеринга; вы можете указать формат изображения, размер страницы, поля, CSS media-тип и т. д.
Property | Description |
---|---|
Compression | Sets Tagged Image File Format (TIFF) Compression. By default, this property is LZW. |
CSS | Gets a CssOptions object which is used for configuration of CSS properties processing. |
Format | Sets the ImageFormat (JPG, PNG, BMP, TIFF, or GIF). By default, this property is PNG. |
BackgroundColor | This property sets the color that will fill the background. By default, this property is Transparent. |
PageSetup | This property gets a page setup object and uses it for configuration output page-set. |
HorizontalResolution | Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi. |
VerticalResolution | Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi. |
SmoothingMode | This property sets the rendering quality for this image. Available values are Invalid, Default, HighSpeed, HighQuality, None, and AntiAlias. |
Text | Gets a TextOptions object which is used for configuration of text rendering. |
Чтобы узнать больше о классе ImageSaveOptions, прочитайте статьи раздела Конвертеры тонкой настройки.
Конвертировать HTML в PNG с использованием ImageSaveOptions
Чтобы преобразовать HTML в PNG с указанием ImageSaveOptions, вы должны выполнить несколько шагов:
- Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument.
- Создайте новый объект ImageSaveOptions и укажите параметры сохранения. По умолчанию свойство Format имеет значение PNG.
- Используйте метод ConvertHTML() класса Converter, чтобы сохранить HTML как изображение JPG. Вам нужно передать HTMLDocument, ImageSaveOptions и путь к выходному файлу методу ConvertHTML() для преобразования HTML в PNG.
В следующем фрагменте кода C# показано, как преобразовать HTML в PNG с помощью настраиваемых параметров сохранения:
1using System.IO;
2using Aspose.Html;
3using Aspose.Html.Converters;
4using Aspose.Html.Rendering.Image;
5using Aspose.Html.Saving;
6using System.Drawing;
7using System.Drawing.Drawing2D;
8...
9 // Prepare a path to a source HTML file
10 string documentPath = Path.Combine(DataDir, "nature.html");
11
12 // Prepare a path for converted file saving
13 string savePath = Path.Combine(OutputDir, "nature-output-options.png");
14
15 // Initialize an HTML document from the file
16 using var document = new HTMLDocument(documentPath);
17
18 // Initialize ImageSaveOptions
19 var options = new ImageSaveOptions()
20 {
21 SmoothingMode = SmoothingMode.Default,
22 HorizontalResolution = 100,
23 VerticalResolution = 100,
24 BackgroundColor = System.Drawing.Color.Beige
25 };
26
27 // Convert HTML to PNG
28 Converter.ConvertHTML(document, options, savePath);
Конструктор ImageSaveOptions() инициализирует экземпляр класса ImageSaveOptions, который передается методу ConvertHTML(). Метод ConvertHTML() принимает «документ», «параметры», путь к выходному файлу «savePath» и выполняет операцию преобразования.
В приведенном выше примере мы добавляем:
- Свойство
BackgroundColor
, задающее цвет, которым будет заполняться фон. По умолчанию BackgroundColor имеет значение Transparent; - Свойства
HorizontalResolution
иVerticalResolution
, которые устанавливают горизонтальное/вертикальное разрешение для выходных изображений в пикселях на дюйм. По умолчанию эти свойства равны 300 dpi; - Свойство
SmoothingMode
, задающее качество рендеринга для этого изображения.
Класс ImageSaveOptions предоставляет множество свойств, которые дают вам полный контроль над широким спектром параметров и улучшают процесс преобразования HTML в форматы изображений. Среди этих свойств SmoothingMode, который позволяет вам установить качество рендеринга для изображения. Доступные значения: Invalid, Default, HighSpeed, HighQuality, None и AntiAlias. Вы можете выбрать любое значение, учитывая преимущества и недостатки каждого из них.
Output Stream Providers
Если требуется сохранить файлы в удаленном хранилище (например, в облаке, базе данных и т. д.), вы можете реализовать ICreateStreamProvider для ручного управления процессом создания файла. Этот интерфейс разработан как объект обратного вызова для создания потока в начале документа/страницы (в зависимости от выходного формата) и освобождения ранее созданного потока после рендеринга документа/страницы.
Aspose.HTML для .NET предоставляет различные типы выходных форматов для операций рендеринга. Некоторые из этих форматов создают один выходной файл (например, PDF, XPS), другие создают несколько файлов (форматы изображений – JPG, PNG и т. д.).
В приведенном ниже примере показано, как реализовать и использовать собственный MemoryStreamProvider в приложении:
1using System.IO;
2using System.Collections.Generic;
3...
4 class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
5 {
6 // List of MemoryStream objects created during the document rendering
7 public List<MemoryStream> Streams { get; } = new List<MemoryStream>();
8
9 public Stream GetStream(string name, string extension)
10 {
11 // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats.
12 MemoryStream result = new MemoryStream();
13 Streams.Add(result);
14 return result;
15 }
16
17 public Stream GetStream(string name, string extension, int page)
18 {
19 // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
20 MemoryStream result = new MemoryStream();
21 Streams.Add(result);
22 return result;
23 }
24
25 public void ReleaseStream(Stream stream)
26 {
27 // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
28 }
29
30 public void Dispose()
31 {
32 // Releasing resources
33 foreach (var stream in Streams)
34 stream.Dispose();
35 }
36 }
1using System.IO;
2using Aspose.Html;
3using System.Linq;
4using Aspose.Html.Converters;
5using Aspose.Html.Rendering.Image;
6using Aspose.Html.Saving;
7...
8 // Create an instance of MemoryStreamProvider
9 using var streamProvider = new MemoryStreamProvider();
10
11 // Initialize an HTML document
12 using var document = new HTMLDocument(@"<h1>Convert HTML to PNG File Format!</h1>", ".");
13
14 // Convert HTML to PNG using the MemoryStreamProvider
15 Converter.ConvertHTML(document, new ImageSaveOptions(ImageFormat.Png), streamProvider);
16
17 // Get access to the memory stream that contains the result data
18 var memory = streamProvider.Streams.First();
19 memory.Seek(0, SeekOrigin.Begin);
20
21 // Flush the result data to the output file
22 using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.png")))
23 {
24 memory.CopyTo(fs);
25 }
Вы можете скачать полные примеры и файлы данных с GitHub.
Aspose.HTML предлагает бесплатный онлайн-конвертер HTML to PNG Converter, который конвертирует HTML в изображение PNG качественно, легко и быстро. Просто загрузите, конвертируйте свои файлы и получите результат за несколько секунд!