Rendering Image Attachments from MHTML to PDF

During MHTML-to-PDF conversion, Aspose.HTML for Java renders supported image attachments as additional PDF pages. The attachments appear after the pages generated from the main HTML content and retain their order from the MHTML document.

MHTML documents may contain image attachments in addition to the HTML content that is displayed by a browser. These attachments are stored within the MHTML document but are not necessarily referenced by the main HTML page. During MHTML-to-PDF conversion, Aspose.HTML for Java detects such image attachments and includes them in the generated PDF as additional pages.

Currently, the following image formats are supported:

• JPEG
• PNG
• GIF
• BMP
• WebP
• TIFF

If an MHTML document contains multiple supported image attachments, all of them are rendered. There is no predefined limit on the number of attachments that can be processed. Each supported attachment is added as a separate page after the pages generated from the main HTML content.

Attachments are rendered in the order in which they appear in the MHTML document. This order is preserved in the generated PDF.

Current limitations

Attachment rendering is currently automatic. There is no option to disable it, limit the number of rendered attachments, or choose specific attachments to include in the output.

As a result, every supported image attachment contained in the MHTML document is rendered, even if it is not required for a particular scenario. Documents with a large number of attachments or high-resolution images may therefore require additional processing time, consume more memory during conversion, and produce larger PDF files.

FAQ

Are MHTML image attachments embedded as files in the output PDF?

No. Supported image attachments are rendered as additional PDF pages; they are not added as downloadable file attachments inside the PDF.

Can I disable or filter MHTML attachment rendering?

No. Attachment rendering is automatic, and the current Java API does not provide an option to disable it, limit the number of rendered attachments, or select individual attachments.

Related Articles

• MHTML Converter in Java – explore supported MHTML conversion workflows and output formats.
• Convert MHTML to PDF in Java – convert an MHTML file or stream to PDF and configure PdfSaveOptions.
• Fine-Tuning Converters in Java – configure rendering options, output devices, page setup, and timeouts.