HTML to JPG Conversion with the Java API
Aspose.HTML for Java
renders HTML files, strings, and webpages as JPG images. Load the source with HTMLDocument, select ImageFormat.Jpeg in ImageSaveOptions, and call
Converter.convertHTML()
. The rendering engine processes the page layout, CSS, fonts, and images.
Save a Webpage as a JPG Image
The example loads document.html, selects JPEG output, and writes the rendered result to output.jpg.
Convert HTML to JPG in Java
import com.aspose.html.HTMLDocument;
import com.aspose.html.converters.Converter;
import com.aspose.html.rendering.image.ImageFormat;
import com.aspose.html.saving.ImageSaveOptions;
// Load the HTML document
try (HTMLDocument document = new HTMLDocument("document.html")) {
// Select JPEG output
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg);
// Convert HTML to JPG
Converter.convertHTML(document, options, "output.jpg");
}
Preview HTML to JPG Conversion Online
Upload an HTML file or enter a public webpage URL to inspect the JPG result before implementing the same conversion in Java.
HTML to JPG API Workflow
- Add Aspose.HTML for Java to the project.
- Load the source with
HTMLDocument. - Create
ImageSaveOptionswithImageFormat.Jpeg. - Call
Converter.convertHTML()with the document, options, and destination path.
Adjust JPG Resolution and Layout
Configure ImageSaveOptions to control horizontal and vertical resolution, page size, margins, background color, smoothing, CSS processing, and text rendering. JPG uses lossy compression and does not support transparency. Use
HTML to PNG
when sharp text edges or transparent output is more important.
See
Convert HTML to Image in Java
and the
ImageSaveOptions API Reference
.
Install Aspose.HTML for Java
Add Aspose.HTML for Java from the official Aspose repository. Replace ASPOSE_HTML_VERSION with an exact version from the
Aspose.HTML for Java releases
page, then reload or rebuild the project so the dependency is resolved.
Add the repository and dependency to the Maven project:
Maven – pom.xml
<repositories>
<repository>
<id>AsposeJavaAPI</id>
<url>https://releases.aspose.com/java/repo/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-html</artifactId>
<version>ASPOSE_HTML_VERSION</version>
</dependency>
</dependencies>Add the repository and dependency to the Gradle project:
Gradle – build.gradle
repositories {
maven {
url = uri('https://releases.aspose.com/java/repo/')
}
}
dependencies {
implementation 'com.aspose:aspose-html:ASPOSE_HTML_VERSION'
}Use a JDK compatible with the selected release. For manual JAR installation, Kotlin DSL, updates, and dependency troubleshooting, see Install Aspose.HTML for Java .
HTML to JPG Conversion FAQ
1. Does a JPG created from HTML keep links or selectable text?
No. The converter renders the page as pixels. Links, text selection, forms, scripts, and other browser behavior are not preserved in JPG output.
2. Should I use JPG or PNG for a webpage screenshot?
JPG is useful for photographic pages and smaller files. Use HTML to PNG for lossless detail, transparent backgrounds, diagrams, or text-heavy layouts.
3. Can Java convert an HTML URL directly to JPG?
Yes. HTMLDocument can load a supported URL, after which the same ImageSaveOptions and Converter.convertHTML() workflow renders the page to JPG.
4. Can I convert HTML to JPG online for free?
Yes. Use the free online HTML to JPG converter for a manual conversion. Use Aspose.HTML for Java for repeatable server-side conversion.
Related Java Conversions
Choose another output format for the same HTML source.