The API will auto crop your image to the height/width of the outermost HTML element. For example, the following will generate a screenshot that is 400px wide and 400px tall.
<div style="height: '400px'; width: '400px'"><h1>Hello, world</h1></div>
Margins are respected by the API. To add padding around your image, you can do the following.
<div style="height: '400px'; width: '400px'; margin: 10px; border: 5px solid #03B875;"><h1>Hello, world</h1></div>
For best performance, we recommend a maximum of 2000x2000 pixels in your HTML. This will result in a 4000x4000 pixel image.
Once an image is generated, use our API to adjust the image to any size you need with the width and height params. When only one param is passed, the API will maintain the aspect ratio of the original image.
This is useful for displaying images at different resolutions without having to setup your own CDN.
Calculating the perfect height and width for print requires knowing the correct formula.
(DPI * (size in inches)) / 2 = pixels
DPI = Dots Per Inch. For high quality print, you will want 300 DPI.
For a 300 DPI print on A4 (8.27 x 11.69 inches) paper, you would do the following:
(300 * 8.27) / 2 = 1240 pixels
(300 * 11.69) / 2 = 1754 pixels
For a 300 DPI business card (3.5 x 2 inches).
(300 * 3.5) / 2 = 525 pixels
(300 * 2) / 2 = 300 pixels
Once you have determined your height and width in pixels, you can then set your HTML to render the exact size you need. We recommend doing this by adding
width style parameters to the outermost HTML element in your code.
Send us an email: firstname.lastname@example.org. We're happy to help!