# Render images as HTML, PDF, PNG, and JPEG files Convert images to HTML, PDF, PNG, or JPEG using the GroupDocs.Viewer Python API. Learn how to render files effectively. [GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) allows you to load images in various formats and convert them to HTML, PDF, PNG, and JPEG. Incorporate this library into your Python application (web or desktop) to build your own image viewer. To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass an image you want to view to the class constructor. You can load the image from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. For multipage images (such as TIFF, CDR, DICOM, WebP, and so on), you can specify the pages to render. {{< button style="primary" link="https://products.groupdocs.app/viewer/image" >}} {{< icon "gdoc_person" >}} View image files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-Python" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}} ## Supported image file formats GroupDocs.Viewer supports the following image file formats: * [.AI (Adobe Illustrator Artwork)](https://docs.fileformat.com/image/ai/) * [.APNG (Animated Portable Network Graphic)](https://docs.fileformat.com/image/apng/) * [.BMP (Bitmap Image)](https://docs.fileformat.com/image/bmp) * [.CDR (CorelDRAW Image File)](https://docs.fileformat.com/image/cdr) * [.CGM (Computer Graphics Metafile)](https://docs.fileformat.com/page-description-language/cgm) * [.CMX (Corel Presentation Exchange Image)](https://docs.fileformat.com/image/cmx) * [.DCM (DICOM Image)](https://docs.fileformat.com/image/dicom) * [.DIB (Device Independent Bitmap File)](https://docs.fileformat.com/image/dib) * [.DJVU (DjVu Image)](https://docs.fileformat.com/image/djvu) * [.DNG (Digital Negative Image)](https://docs.fileformat.com/image/dng) * [.EMF (Enhanced Windows Metafile)](https://docs.fileformat.com/image/emf) * [.EMZ (Windows Compressed Enhanced Metafile)](https://docs.fileformat.com/image/emz/) * [.EPS (Encapsulated PostScript File)](https://docs.fileformat.com/page-description-language/eps) * [.FODG (OpenDocument Flat XML Graphics)](https://docs.fileformat.com/image/fodg/) * [.GIF (Graphical Interchange Format)](https://docs.fileformat.com/image/gif) * [.ICO (Icon File)](https://docs.fileformat.com/image/ico) * [.J2C (JPEG 2000 Code Stream)](https://docs.fileformat.com/image/j2c/) * [.J2K (JPEG 2000 Image)](https://docs.fileformat.com/image/j2k/) * [.JP2 (JPEG 2000 Core Image File)](https://docs.fileformat.com/image/jp2/) * [.JPC (JPEG 2000 Code Stream File)](https://docs.fileformat.com/image/jpc/) * [.JPEG / .JPG (JPEG Image)](https://docs.fileformat.com/image/jpeg) * [.JPF (JPEG 2000 Image)](https://docs.fileformat.com/image/jpf/) * [.JPM (JPEG 2000 Multi-layer Image Format)](https://docs.fileformat.com/image/jpm/) * [.JPX (JPEG 2000 Image File)](https://docs.fileformat.com/image/jpx/) * [.JLS (JPEG-LS Image)](https://docs.fileformat.com/) * [.ODG (OpenDocument Graphics File)](https://docs.fileformat.com/image/odg) * [.OTG (OpenDocument Graphic Template)](https://docs.fileformat.com/image/otg/) * [.PCL (Printer Command Language Document)](https://docs.fileformat.com/page-description-language/pcl) * [.PNG (Portable Network Graphics)](https://docs.fileformat.com/image/png) * [.PS (PostScript File)](https://docs.fileformat.com/page-description-language/ps) * [.PSB (Photoshop Large Document Format)](https://docs.fileformat.com/image/psb) * [.PSD (Adobe Photoshop Document)](https://docs.fileformat.com/image/psd) * [.SVG (Scalable Vector Graphics File)](https://docs.fileformat.com/page-description-language/svg) * [.SVGZ (Compressed SVG File)](https://docs.fileformat.com/image/svgz/) * [.TGA (TARGA Graphics)](https://docs.fileformat.com/image/tga/) * [.TIF / .TIFF (Tagged Image File Format)](https://docs.fileformat.com/image/tiff) * [.WEBP (WebP Image)](https://docs.fileformat.com/image/webp) * [.WMF (Windows Metafile)](https://docs.fileformat.com/image/wmf) * [.WMZ (Compressed Windows Metafile)](https://docs.fileformat.com/image/wmz/) ## Render images as HTML Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an image to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). ### Create an HTML file with embedded resources To embed an image in an HTML page, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) method and specify the output file name. {{< tabs "example1">}} {{< tab "Python" >}} ```python from groupdocs.viewer import Viewer from groupdocs.viewer.options import HtmlViewOptions def render_image_to_html(): # Load image with Viewer("vector-image.svg") as viewer: # Specify the HTML file name. viewOptions = HtmlViewOptions.for_embedded_resources("render_image_to_html/pdf_page_{0}.html") viewer.view(viewOptions) if __name__ == "__main__": render_image_to_html() ``` {{< /tab >}} {{< tab "vector-image.svg" >}} {{< tab-text >}} `vector-image.svg` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "pdf_page_1.html" >}} ```text Page-1
}} {{< tab "Python" >}} ```python from groupdocs.viewer import Viewer from groupdocs.viewer.options import HtmlViewOptions def render_image_to_html_external(): # Load image with Viewer("vector-image.svg") as viewer: # Specify the HTML file name and location of external resources. # {0} is replaced with the resource name in the output file name. viewOptions = HtmlViewOptions.for_external_resources("render_image_to_html_external/pdf_page_{0}.html", "render_image_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_image_to_html_external/pdf_page_{0}/resource_{0}_{1}") viewer.view(viewOptions) if __name__ == "__main__": render_image_to_html_external() ``` {{< /tab >}} {{< tab "vector-image.svg" >}} {{< tab-text >}} `vector-image.svg` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "render-image-to-html-external-outputs.zip" >}} ```text render_image_to_html_external/pdf_page_1.html (309 bytes) render_image_to_html_external/pdf_page_1/resource_1_g.svg (129 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/python-net/_output_files/rendering-basics/render-images/render_image_to_html_external/render-image-to-html-external-outputs.zip) {{< /tab >}} {{< /tabs >}} The result is shown below. The image is placed in a separate folder. ![Place HTML resources in a separate folder](https://docs.groupdocs.com/viewer/python-net/images/rendering-basics/render-images/render-image-to-html-external-resources.png) ## Render images as PDF Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an image to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}). {{< tabs "example3">}} {{< tab "Python" >}} ```python from groupdocs.viewer import Viewer from groupdocs.viewer.options import PdfViewOptions def render_image_to_pdf(): # Load image with Viewer("vector-image.svg") as viewer: # Create a PDF file. viewOptions = PdfViewOptions("render_image_to_pdf/pdf_document.pdf") viewer.view(viewOptions) if __name__ == "__main__": render_image_to_pdf() ``` {{< /tab >}} {{< tab "vector-image.svg" >}} {{< tab-text >}} `vector-image.svg` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "pdf_document.pdf" >}} ```text Binary file (PDF, 45 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/python-net/_output_files/rendering-basics/render-images/render_image_to_pdf/pdf_document.pdf) {{< /tab >}} {{< /tabs >}} The following image demonstrates the result: ![Render an image to PDF](https://docs.groupdocs.com/viewer/python-net/images/rendering-basics/render-images/render-image-to-pdf.png) ## Convert images to PNG Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an image to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties)) methods to specify the output image size in pixels. {{< tabs "example4">}} {{< tab "Python" >}} ```python from groupdocs.viewer import Viewer from groupdocs.viewer.options import PngViewOptions def render_image_to_png(): # Load image with Viewer("vector-image.svg") as viewer: # Create a PNG image. viewOptions = PngViewOptions("render_image_to_png/image.png") # Set width and height. viewOptions.width = 950 viewOptions.height = 550 viewer.view(viewOptions) if __name__ == "__main__": render_image_to_png() ``` {{< /tab >}} {{< tab "vector-image.svg" >}} {{< tab-text >}} `vector-image.svg` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "image.png" >}} ```text Binary file (PNG, 179 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/python-net/_output_files/rendering-basics/render-images/render_image_to_png/image.png) {{< /tab >}} {{< /tabs >}} The following image demonstrates the result: ![Render an image to PNG](https://docs.groupdocs.com/viewer/python-net/images/rendering-basics/render-images/render-image-to-png.png) ## Convert images to JPEG Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an image to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) methods to specify the output image size in pixels. {{< tabs "example5">}} {{< tab "Python" >}} ```python from groupdocs.viewer import Viewer from groupdocs.viewer.options import JpgViewOptions def render_image_to_jpg(): # Load image with Viewer("vector-image.svg") as viewer: # Create a JPG image. viewOptions = JpgViewOptions("render_image_to_jpg/image_to_jpg.jpg") # Set width and height. viewOptions.width = 950 viewOptions.height = 550 viewer.view(viewOptions) if __name__ == "__main__": render_image_to_jpg() ``` {{< /tab >}} {{< tab "vector-image.svg" >}} {{< tab-text >}} `vector-image.svg` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "image_to_jpg.jpg" >}} ```text Binary file (JPG, 93 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/python-net/_output_files/rendering-basics/render-images/render_image_to_jpg/image_to_jpg.jpg) {{< /tab >}} {{< /tabs >}} ## Render a PSD file with custom fonts When you render a PSD file with custom fonts, you can specify a folder that contains necessary fonts to prevent font substitution during rendering. To do this, follow the steps below: 1. Create a [FolderFontSource](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.fonts/folderfontsource/) class instance and specify a path to the folder that stores custom fonts. Pass a [SearchOption](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.fonts/folderfontsource/#properties) enumeration member to the class constructor to define the search scope. The following options are available: * `TOP_FOLDER_ONLY`---Searches for the fonts only in the current folder. * `ALL_FOLDERS`---Searches for the fonts in the current folder and its subfolders. 2. Call the [FontSettings.set_font_sources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.fonts/fontsettings/#methods) static method and pass the specified font source to this method as a parameter. This method allows you to specify multiple font sources. You can also use the [ViewOptions.default_font_name](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewoptions/) method to specify the default font that should be used when a particular font is not found. {{< tabs "example6">}} {{< tab "Python" >}} ```python import os from groupdocs.viewer import Viewer from groupdocs.viewer.fonts import FolderFontSource, SearchOption, FontSettings from groupdocs.viewer.options import JpgViewOptions def render_psd_with_custom_fonts(): # Create font sources. os.makedirs("./custom_fonts_folder", exist_ok=True) os.makedirs("./custom_additional_fonts_folder", exist_ok=True) # Add custom fonts folder to look for fonts recursively. (look into subfolders too). folderFontSource = [FolderFontSource("./custom_fonts_folder", SearchOption.ALL_FOLDERS)] # Add custom fonts folder to look for fonts only in this folder (without subfolders). additionalFontSource = [FolderFontSource("./custom_additional_fonts_folder", SearchOption.TOP_FOLDER_ONLY)] # Call SetFontSources method and supply font sources as arguments. FontSettings.set_font_sources(folderFontSource, additionalFontSource) try: # Load PSD file with Viewer("sample.psd") as viewer: # Create a JPG image. viewOptions = JpgViewOptions("render_psd_with_custom_fonts/psd_with_custom_fonts.jpg") viewOptions.default_font_name = "Arial" viewer.view(viewOptions) finally: # Reset FontSettings so the registered folders don't leak into # subsequent rendering calls in the same process. FontSettings.reset_font_sources() if __name__ == "__main__": render_psd_with_custom_fonts() ``` {{< /tab >}} {{< tab "sample.psd" >}} {{< tab-text >}} `sample.psd` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/python-net/_sample_files/rendering-basics/render-images/sample.psd) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "psd_with_custom_fonts.jpg" >}} ```text Binary file (JPG, 25 KB) ``` [Download full output](https://docs.groupdocs.com/viewer/python-net/_output_files/rendering-basics/render-images/render_psd_with_custom_fonts/psd_with_custom_fonts.jpg) {{< /tab >}} {{< /tabs >}}