Convert HTML to JPEG in Python

The JPEG format is popular primarily due to its efficient compression algorithm, which allows high-quality images to be stored in relatively small file sizes. This makes JPEG ideal for sharing and displaying images on the web, where loading speed is critical. Converting HTML to JPEG becomes necessary in scenarios where web content needs to be embedded into documents like presentations or emails, preserving the visual fidelity of the web page in a widely supported image format. This conversion ensures that complex web layouts, graphics, and text accurately represent a static image suitable for various applications and devices. Using Converter.convert_html() methods is the most common way to convert HTML into various formats.

This article provides information on converting HTML to JPEG using the convert_html() methods of the Converter class and applying ImageSaveOptions. Also, you can try an Online HTML Converter to test the Aspose.HTML functionality and convert HTML on the fly.

To continue following this tutorial, install and configure the Aspose.HTML for Python via .NET in your Python project. Our code examples help you to convert HTML to JPEG and generate JPEG files using the Python library.

Online HTML Converter

You can check the Aspose.HTML for Python via .NET API functionality and convert HTML in real-time. Please load HTML from your local file system or a URL, select the output format and run the example. The example uses the default save options, allowing for a simple conversion process. You will immediately receive the result as a separate file.

Convert HTML to JPEG – Python Code Example

The following example shows how to use ImageSaveOptions and create the output JPEG image with custom save options such as an image format, page size, resolution, and css media_type:

1. Load an HTML file using the HTMLDocument class.
2. Create a new ImageSaveOptions object with JPEG ImageFormat. By default, the format property is PNG. The ImageSaveOptions() constructor initializes an instance of the ImageSaveOptions class that is passed to convert_html() method. Here, you can set the required save options, such as page setup or resolution.
3. Use the convert_html() method of the Converter class to save HTML as a JPEG image. The method takes the document, options, output file path save_path and performs the conversion operation.

# Convert HTML to JPEG using Python with custom settings

import os
import aspose.html as ah
import aspose.html.converters as conv
import aspose.html.saving as sav
import aspose.html.rendering.image as rim
import aspose.html.drawing as dr
import aspose.pydrawing as pd


# Setup directories and define paths
output_dir = "output/"
input_dir = "data/"
if not os.path.exists(output_dir):
    os.makedirs(output_dir)
document_path = os.path.join(input_dir, "document.html")
save_path = os.path.join(output_dir, "convert-html-with-options.jpg")

# Load an HTML document from a file or URL
document = ah.HTMLDocument(document_path)

# Initialize saving options
options = sav.ImageSaveOptions(rim.ImageFormat.JPEG)
options.horizontal_resolution = dr.Resolution.from_dots_per_inch(50.0)
options.vertical_resolution = dr.Resolution.from_dots_per_inch(50.0)
options.background_color = pd.Color.bisque
options.page_setup.any_page = dr.Page(dr.Size(600, 500), dr.Margin(10, 10, 10, 10))

options.use_antialiasing = True
options.text.use_hinting = True
options.css.media_type.SCREEN

# Convert HTML to JPEG
conv.Converter.convert_html(document, options, save_path)

Save Options – ImageSaveOptions Class

The JPEG images creation functionality can be enhanced with save options per your needs. Aspose.HTML for Python via .NET allows converting HTML to JPEG using default or custom save options. The ImageSaveOptions class offers extensive customization for converting HTML content into image formats. Here’s a more detailed description of each property of ImageSaveOptions:

• page_setup – You can configure the page layout settings for the output image. This includes specifying the page size and margins (top, bottom, left, right) to control the placement and display of HTML content within the image.
• horizontal_resolution – This property sets or gets the horizontal resolution (in pixels per inch) for both output and internal images used during processing. Higher resolution usually results in a sharper image but can also increase file size. By default, it is 300 dpi.
• vertical_resolution – This property sets or gets the vertical resolution for internal images in pixels per inch. By default, it is 300 dpi.
• background_color – This property allows you to set the background color for the rendered output. If not set, the default background is transparent.
• css – This property, represented by CssOptions, allows configuring how CSS properties are processed during the HTML to image conversion.
• format – This property determines the format of the output image. The supported formats include common image formats like PNG, JPEG, BMP, GIF, and TIFF. The default format is PNG, but you can specify others based on your requirements.
• use_antialiasing – This property controls the quality of graphics rendering during conversion. It affects how images are rendered, which is especially useful for anti-aliasing and achieving smooth and visually appealing output. Options typically include settings for high-quality rendering, which can be critical for professional and presentation-grade images.
• compression – The compression option allows you to set the compression method for TIFF output. Supported options: LZW, CCITT3, CCITT4, RLE, and NONE. Compression helps reduce file size while maintaining image quality, which is especially important for TIFF files used for high-quality archiving and printing of images.
• text – This property provides configurations for text rendering during HTML to image conversion.

How to Convert HTML to Images

Aspose.HTML for Python via .NET allows you to convert HTML to various image formats such as PNG, JPG, JPEG, BMP, TIFF, and GIF. You can use the provided Python code for these conversions. To specify the desired image format, set the format property in the save options object and include the corresponding file extension in the output file name.

For example, to convert HTML to TIFF:

• Set the format property: options = sav.ImageSaveOptions(rim.ImageFormat.TIFF).
• Include the .tiff extension in the output image file name: save_path = os.path.join(output_dir, "html-to-image.tiff").

Download the Aspose.HTML for Python via .NET library to successfully, quickly, and easily convert your HTML, MHTML, EPUB, SVG, and Markdown documents to the most popular formats.

You can download the complete examples and data files from GitHub.

Aspose.HTML offers a free online HTML to JPG Converter that converts HTML to JPG image with high quality, easy and fast. Just upload, convert your files and get results in a few seconds!