# java-html2image **Repository Path**: chqj2208/java-html2image ## Basic Information - **Project Name**: java-html2image - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-11-30 - **Last Updated**: 2021-11-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # java-html2image Automatically exported from code.google.com/p/java-html2image ## Html2Image This simple Java library converts plain HTML markup to image and provides client-side image-map using HTML element. ####What Can I Do With It: Use Cases * Programmatically compose images - Use case: You need to compose images from other images and texts. - Solution - Create a web page using plain HTML, CSS and image and use Html2Image to convert it to an image. * Improve your spam - Use case: You need to send decorative HTML email. - You craft your HTML using CSS, images and links. - Alas, your clients open their Outlook, Gmail or any other mail client mailbox, and find your mail all scrambled up (merely resembles the presentation of the same HTML in a browser). - That's because Outlook and other clients only support limited functionality of HTML and have different implementations and bugs. - Solution - Use Html2Image to convert your original mail's HTML to a new HTML containing only image () and client-side image-map () for the links in the original HTML. - This also allow you to easily use unique fonts in your mail. * Prevent spamming - Use case: Your website has a list of contacts and their email addresses. - The email addresses are in plain text, allowing robots and spiders to harvest these addresses and spam your team with Viagra ads. - Solution - Use Html2Image to convert those email addresses to images. ####What Do I Give and What Do I Get Html2Image allows you to transform this HTML markup: ```html Hello World! Please goto Google. ``` To this visually equivalent HTML markup: ```html ``` Supported Images Formats Html2Image allows you to save your HTML as GIF, PNG or JPEG image. API Html2Image as only one useful Java class, HtmlImageGenerator. Common usage is this: HtmlImageGenerator imageGenerator = new HtmlImageGenerator(); imageGenerator.loadHtml("Hello World! Please goto Google."); imageGenerator.saveAsImage("hello-world.png"); imageGenerator.saveAsHtmlWithMap("hello-world.html", "hello-world.png"); Which will generate hello-world.png image of the HTML and hello-world.html file containing client-side image-map (as in the example above). ####HtmlImageGenerator Methods * loadUrl(url) - Loads HTML from URL object or URL string. * loadHtml(html) - Loads HTML source. * saveAsImage(file) - Save loaded HTML as image. * saveAsHtmlWithMap(file, imageUrl) - Creates an HTML file containing client-side image-map generated from HTML's links. * getLinks() - List all links in the HTML document and their corresponding href, target, title, position and dimension. * getBufferedImage() - Get AWT buffered image of the HTML. * getLinksMapMarkup(mapName) - Get HTML snippet of the client-side image-map generated from the links. * get/setOrientation(orientation) - Get/Set document orientation (left-to-right or right-to-left). * get/setSize(dimension) - Get/Set size of the generated image. ####Download You can download Html2Image from the download page or use it as Maven dependency: ```xml gui.ava html2image 0.9 yoava AOL yoava http://yoava.artifactoryonline.com/yoava/repo ``` License: GNU Lesser GPL