用 Java 将 HTML 转换为图像 – 将 HTML 转换为 JPG、PNG、BMP、GIF 和 TIFF

将 HTML 转换为图像可帮助你创建可视化的网页内容，用于文档、报告、演示或发送电子邮件。例如，使用 HTML 图像转换功能，你可以快速获得基于 HTML 文档的图像，如报告、网页或图表的预览或缩略图。

Aspose.HTML for Java 库允许您将 HTML 文档转换为JPG、PNG、GIF、TIFF和BMP文件格式，并可完全控制各种转换参数。只需几个必要的步骤，即可完成任何 HTML 到图片的转换：

1. 从本地文件系统、URL、数据流中加载现有的 HTML 文件，或从头开始创建 HTML。
2. 创建一个 ImageSaveOptions 对象。您可以在此设置图像格式(JPG、PNG、BMP、GIF 或 TIFF)，并自定义渲染过程，以获得所需的效果。
3. 使用 Converter 类中的一个 convertHTML() 方法，并向其传递所需的参数。

本文将介绍如何将 HTML 转换为图像文件格式以及如何使用 ImageSaveOptions。让我们通过 Java 示例来了解 HTML 转换为图像的情况！

用几行 Java 代码将 HTML 转换为 JPG

只需几行代码，您就能在 Java 应用程序中将 HTML 转换为图片！下面的 Java 代码展示了 HTML 到 JPG 的转换：

// Convert HTML to JPG in one line using Java

// Invoke the convertHTML() method to convert HTML code to image
Converter.convertHTML(
        "<h1>Convert HTML to JPG!</h1>",
        ".",
        new ImageSaveOptions(ImageFormat.Jpeg),
        "convert-with-single-line.jpg"
);

在示例中，我们使用了 Converter 类中的convertHTML(content,baseUri,options,outputPath)方法，该方法需要四个参数：包含要转换的 HTML 代码的字符串、输入 HTML 文件的基本文件夹、定义输出图像选项(如图像格式)的 ImageSaveOptions 类实例，以及保存转换后图像的输出文件路径。

将 HTML 转换为 JPG

JPG 格式是常用的图像格式，因为它支持高压缩比，使您可以使用较小的文件而不会明显降低质量。这使它成为在线存储图像或通过电子邮件或其他数字媒体共享图像的理想选择。要将 HTML 转换为 JPG，应遵循以下几个步骤：

1. 加载 HTML 文件或使用 HTMLDocument 类从头开始创建 HTML。
2. 使用 ImageFormat.Jpeg 创建一个新的 ImageSaveOptions 对象。默认图像格式为 ImageFormat.Png。
3. 使用 Converter 类的 convertHTML(document, options, outputPath) 方法将 HTML 保存为 JPG 图像。

下面的 Java 代码片段展示了如何使用 Aspose.HTML 将 HTML 转换为 JPG：

// Convert HTML to JPG using Java

// Prepare HTML code and save it to a file
String code = "<span>Hello,</span> <span>World!!</span>";
try (java.io.FileWriter fileWriter = new java.io.FileWriter("jpg.html")) {
    fileWriter.write(code);
}

// Initialize an HTML document from the file
HTMLDocument document = new HTMLDocument("jpg.html");

// Create an instance of the ImageSaveOptions class
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg);

// Convert HTML to JPG
Converter.convertHTML(document, options, "jpg-output.jpg");

您可以从 GitHub 下载完整的示例和数据文件。

将 HTML 转换为 PNG

PNG 是一种流行的图像文件格式，支持无损图像压缩，因此被广泛使用。将 HTML 文件转换为 PNG 图像有多种用途，如将网页添加到 PowerPoint 演示文稿、插入博客或通过电子邮件发送。在下面的 Java 示例中，我们将逐步说明如何使用默认保存选项将 HTML 转换为 PNG：

1. 使用 HTMLDocument 类的 HTMLDocument() 构造函数加载 HTML 文件或从头开始创建 HTML。
2. 使用 ImageSaveOptions() 构造函数创建一个新的 ImageSaveOptions 对象。可以自定义 options 对象，以便为转换过程指定不同的设置。
3. 调用 Converter 类的 convertHTML(document, options, outputPath) 方法将 HTML 保存为 PNG 图像。您需要将 HTMLDocument、 ImageSaveOptions 和输出文件路径作为参数传递给 convertHTML() 方法。

// Convert HTML to PNG using Java

// Prepare HTML code and save it to a file
String code = "<span>Hello,</span> <span>World!!</span>";
try (java.io.FileWriter fileWriter = new java.io.FileWriter("png.html")) {
    fileWriter.write(code);
}

// Initialize an HTML document from the file
HTMLDocument document = new HTMLDocument("png.html");

// Initialize ImageSaveOptions
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Png);

// Convert HTML to PNG
Converter.convertHTML(document, options, "png-output.png");

将 HTML 转换为 BMP

下面的示例展示了如何使用 Aspose.HTML for Java 将 HTML 转换为 BMP。

1. 使用 HTMLDocument 类加载 HTML 文件。
2. 创建一个新的 ImageSaveOptions 对象，其属性为 ImageFormat.Bmp。默认情况下，格式属性为 PNG。
3. 使用 Converter 类的 convertHTML(document, options, outputPath) 方法将 HTML 保存为 BMP 图像。该方法需要传递 HTMLDocument、 ImageSaveOptions 和输出文件路径作为参数。

// Convert HTML to BMP using Java

// Prepare HTML code and save it to a file
String code = "<span>Hello,</span> <span>World!!</span>";
try (java.io.FileWriter fileWriter = new java.io.FileWriter("bmp.html")) {
    fileWriter.write(code);
}

// Initialize an HTML document from the file
HTMLDocument document = new HTMLDocument("bmp.html");

// Initialize ImageSaveOptions
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Bmp);

// Convert HTML to BMP
Converter.convertHTML(document, options, "bmp-output.bmp");

将 HTML 转换为 GIF

下面的 Java 代码片段展示了如何使用 Aspose.HTML for Java 将 HTML 转换为 GIF。

1. 使用 HTMLDocument 类加载 HTML 文件。
2. 创建一个带有 GIF 图像格式的新 ImageSaveOptions 对象。
3. 使用 Converter 类的 convertHTML() 方法将 HTML 保存为 GIF 图像。

// Convert HTML to GIF using Java

// Prepare HTML code and save it to a file
String code = "<span>Hello,</span> <span>World!!</span>";
try (java.io.FileWriter fileWriter = new java.io.FileWriter("gif.html")) {
    fileWriter.write(code);
}

// Initialize an HTML document from the file
HTMLDocument document = new HTMLDocument("gif.html");

// Initialize ImageSaveOptions
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Gif);

// Convert HTML to GIF
Converter.convertHTML(document, options, "gif-output.gif");

将 HTML 转换为 TIFF

下面的 Java 代码片段展示了如何使用 Aspose.HTML for Java 将 HTML 转换为 TIFF。

1. 使用 HTMLDocument 类加载 HTML 文件。
2. 创建一个具有 TIFF 图像格式的新 ImageSaveOptions 对象。
3. 使用 Converter 类的 convertHTML(document, options, outputPath) 方法将 HTML 保存为 TIFF 图像。您需要将 HTMLDocument、 ImageSaveOptions 和输出文件路径作为参数传递给 convertHTML() 方法。

// Convert HTML to TIFF using Java

// Prepare HTML code and save it to a file
String code = "<span>Hello,</span> <span>World!!</span>";
try (java.io.FileWriter fileWriter = new java.io.FileWriter("tiff.html")) {
    fileWriter.write(code);
}

// Initialize an HTML document from the file
HTMLDocument document = new HTMLDocument("tiff.html");

// Initialize ImageSaveOptions
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Tiff);

// Convert HTML to TIFF
Converter.convertHTML(document, options, "tiff-output.bmp");

保存选项 – ImageSaveOptions 类

Aspose.HTML for Java 允许使用默认或自定义保存选项将 HTML 转换为图像。通过 ImageSaveOptions 可以自定义渲染过程。您可以指定 image format、页面大小、页边距、 compression level、 media type等。

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 并创建具有自定义分辨率、页面大小和背景颜色的输出图像：

// Convert HTML to JPG in Java with with custom background, resolution, and page size settings

// Prepare HTML code and save it to a file
String code = "<h1>  Image SaveOptions </h1> " +
        "<p>Using ImageSaveOptions Class, you can programmatically apply a wide range of " +
        "conversion parameters such as BackgroundColor, Format, Compression, PageSetup, etc.</p>";

FileHelper.writeAllText("save-options.html", code);

// Initialize an HTML Document from the HTML file
HTMLDocument document = new HTMLDocument("save-options.html");

// Initialize an ImageSaveOptions object and customize save options
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg);
options.setHorizontalResolution(new Resolution(200, UnitType.AUTO));
options.setVerticalResolution(new Resolution(200, UnitType.AUTO));
options.setBackgroundColor(Color.getAntiqueWhite());
options.getPageSetup().setAnyPage(new Page(new Size(500, 250), new Margin(40, 40, 20, 20)));

// Convert HTML to JPG
Converter.convertHTML(document, options, "save-options-output.jpg");

要了解有关 ImageSaveOptions 的更多信息，请阅读 Fine-Tuning Converters 一文。

结论

将 HTML 转换为图像是一种强大的解决方案，可用于创建可视化的网页内容，用于文档、演示、预览、缩略图等。

Aspose.HTML for Java 简化了这一过程，允许您将 HTML 转换为多种图像格式，包括 JPG、PNG、BMP、GIF 和 TIFF。使用 ImageSaveOptions类，您可以自定义转换过程的关键方面，如图像分辨率、格式、背景颜色、压缩等。

本文中的 Java 示例展示了使用 Aspose.HTML for Java 以最少的代码将 HTML 转换为图像的简便性和灵活性。从快速的单行转换到更复杂的自定义场景，Java 库提供了将 HTML 高效转换为图像的所有工具。

您可以从 GitHub 下载完整的示例和数据文件。

Aspose.HTML 提供免费的在线 HTML 到图片转换器，可将 HTML 转换为高质量图片，简单快捷。只需上传、转换您的文件，几秒钟就能得到结果！