EvoPdf Classic · HTML to Image

EVO HTML to Image Converter

EVO HTML to Image Converter can be used in any type of .NET application to convert HTML pages to images and to create thumbnails of HTML pages. The HTML to Image Converter is part of the HTML to PDF Converter Library. Using this tool you can easily convert HTML pages to BMP, JPEG, PNG or GIF images.

Classic v14.0 · Windows, .NET Framework 2.0+ and .NET 6–10 · Evaluate without registration — demo mode by default (watermarked) · Licensed with the HTML to PDF Converter license or EVO PDF Toolkit

$dotnet add package EvoPdf.HtmlToPdf

Windows · .NET Framework 2.0+ and .NET 6–10 (.NET Standard 2.0) · the EvoPdf metapackage bundles the Classic HTML to PDF library

Program.csC#
using EvoPdf;

var converter = new HtmlToImageConverter();
// the page as a set of PNG tiles
var tiles = converter.ConvertUrlToImageTiles(
    "https://www.evopdf.com");
Classic API: EvoPdf namespace, one converter class, synchronous calls. API reference →
  • Windows 10 / 11 / Server 2016–2025
  • .NET Framework 2.0 – 4.8.1
  • .NET 6 → 10, .NET Standard 2.0
  • Azure Cloud Services & Virtual Machines
  • Web, console and desktop applications
Features

What the HTML to Image component does

  • Convert HTML pages to raster images
  • Create thumbnails of the HTML pages
  • Create transparent PNG images
  • Convert HTML pages to images in memory or to image files in a folder
  • Save the HTML pages images in various image formats
  • Does not depend on any third party tools
  • Support for .NET 2.0, .NET 4.0 frameworks and later
  • Documentation and C# samples for all the features
Documented, with code

Every feature explained with its C# code

The product documentation walks through each capability with the exact C# code, from the converter options to bookmarks, forms and PDF editing. The evaluation package ships the same code as runnable demo projects.

  • Getting started with the converterC# code
  • HTML content destination and scalingC# code
  • Merge multiple HTML pages into one PDFC# code
  • Merge HTML with existing PDF documentsC# code
  • Convert only part of an HTML pageC# code
  • Repeat table header and footerC# code
  • Pages with authentication or through a proxyC# code
  • BookmarksC# code
  • PDF formsC# code
  • Internal links, file links and attachmentsC# code
  • HTML to raster image and SVGC# code
  • Merge, split, stamp and fill PDF documentsC# code
In detail

EVO HTML to Image Converter — how it works

EVO HTML to Image Converter can be used in any type of .NET application to convert HTML pages to raster images and to create thumbnails of the HTML pages. The HTML to Image Converter is not a standalone product, it is part of the HTML to PDF Converter Library and is represented by the HtmlToImageConverter class of that library.

Using this class you can convert HTML pages to any type of raster image supported by the .NET framework like BMP, JPEG, PNG or GIF. When converting to PNG you can also choose to produce an image with transparent background. The integration with existing .NET applications is extremely easy and no installation is necessary.

The downloaded archive contains the assembly for .NET and a demo application. The full C# source code for the demo application is available in the Samples folder.

The code below was taken from the HTML to Image Converter demo application available for download in the HTML to PDF Converter product package. In this sample an instance of the HtmlToImageConverter class is constructed and used to rasterize the HTML page to an image.

At a glance

Component
EvoPdf Classic · HTML to Image
NuGet package
EvoPdf.HtmlToPdf
Namespace
EvoPdf
Main class
HtmlToImageConverter
Runs on
Windows · .NET Framework 2.0+ · .NET 6–10 (.NET Standard 2.0)
Version
Classic v14.0
License
HTML to PDF Converter license or EVO PDF Toolkit; evaluation without registration
Documentation →
Sample.csC#
protected void convertToImageButton_Click(object sender, EventArgs e)
{
    // Create a HTML to Image converter object with default settings
    HtmlToImageConverter htmlToImageConverter = new HtmlToImageConverter();

    // Set license key received after purchase to use the converter in licensed mode
    // Leave it not set to use the converter in demo mode

    // Set HTML Viewer width in pixels which is the equivalent in converter of the browser window width
    htmlToImageConverter.HtmlViewerWidth = int.Parse(htmlViewerWidthTextBox.Text);

    // Set HTML viewer height in pixels to convert the top part of a HTML page 
    // Leave it not set to convert the entire HTML
    if (htmlViewerHeightTextBox.Text.Length > 0)
        htmlToImageConverter.HtmlViewerHeight = int.Parse(htmlViewerHeightTextBox.Text);

    // Set if the created image has a transparent background
    htmlToImageConverter.TransparentBackground = SelectedImageFormat() == System.Drawing.Imaging.ImageFormat.Png ? transparentBackgroundCheckBox.Checked : false;

    // Set the maximum time in seconds to wait for HTML page to be loaded 
    // Leave it not set for a default 60 seconds maximum wait time
    htmlToImageConverter.NavigationTimeout = int.Parse(navigationTimeoutTextBox.Text);

    // Set an adddional delay in seconds to wait for JavaScript or AJAX calls after page load completed
    // Set this property to 0 if you don't need to wait for such asynchcronous operations to finish
    if (conversionDelayTextBox.Text.Length > 0)
        htmlToImageConverter.ConversionDelay = int.Parse(conversionDelayTextBox.Text);

    System.Drawing.Image[] imageTiles = null;

    if (convertUrlRadioButton.Checked)
    {
        string url = urlTextBox.Text;

        // Convert the HTML page given by an URL to a set of Image objects
        imageTiles = htmlToImageConverter.ConvertUrlToImageTiles(url);
    }
    else
    {
        string htmlString = htmlStringTextBox.Text;
        string baseUrl = baseUrlTextBox.Text;

        // Convert a HTML string with a base URL to a set of Image objects
        imageTiles = htmlToImageConverter.ConvertHtmlToImageTiles(htmlString, baseUrl);
    }

    // Save the first image tile to a memory buffer

    System.Drawing.Image outImage = imageTiles[0];

    // Create a memory stream where to save the image
    System.IO.MemoryStream imageOutputStream = new System.IO.MemoryStream();

    // Save the image to memory stream
    outImage.Save(imageOutputStream, SelectedImageFormat());

    // Write the memory stream to a memory buffer
    imageOutputStream.Position = 0;
    byte[] outImageBuffer = imageOutputStream.ToArray();

    // Close the output memory stream
    imageOutputStream.Close();

    // Send the image as response to browser

    string imageFormatName = imageFormatComboBox.SelectedValue.ToLower();

    // Set response content type
    Response.AddHeader("Content-Type", "image/" + (imageFormatName == "jpg" ? "jpeg" : imageFormatName));

    // Instruct the browser to open the image file as an attachment or inline
    Response.AddHeader("Content-Disposition", String.Format("attachment; filename={0}; size={1}", "HTML_to_Image." + imageFormatName, outImageBuffer.Length.ToString()));

    // Write the image buffer to HTTP response
    Response.BinaryWrite(outImageBuffer);

    // End the HTTP response and stop the current page processing
    Response.End();
}
Licensing

Perpetual licenses, updates and support included for a year

The HTML to PDF Converter license (450 USD Deployment / 1200 USD Company) covers the Classic and the Next converter; the EVO PDF Toolkit (650 / 1400 USD) covers every component on this site, Classic tools included. The Company License includes redistribution.