ploticus: making web-based graphs

## making web-based graphs | Welcome Gallery Handbook |
| Manual page for making_web-based_graphs(PL)

## Web-based graphs (PNG, GIF, JPEG, WBMP images)

This page contains notes related to use of ploticus to produce data displays that are viewable on web pages.`` There are a number of web sites that are using ploticus .``

## On-the-fly graphs

This is now discussed here.``

## Web graphics formats

Ploticus can generate the following types of graphics that web browsers can display: PNG, JPEG, WBMP, pseudo-GIF, and SVG.`` Some of these types are more compact than others (smaller is faster). Here's a comparison, done on gallery example `stock`:

      PNG         2978 bytes
      SVGZ        3918 bytes
      pseudo-GIF 14874 bytes
      SVG        17743 bytes
      JPEG       27006 bytes

Ploticus can also generate clickmaps to accompany graphics.`` PNG, JPEG, WBMP, and pseudo-GIFs are generated using the GD image generation library from boutell.com . Ploticus is bundled with portions of GD 1.3 (pseudo-GIF) and GD 1.6 (PNG images). Of, if you prefer, ploticus may be built by linking it with your own copy of GD 1.8.4 or higher, for PNG, PJEG, WBMP, and FreeType2 support (see GD18 in the Makefile).``

## Pixels

Graphics using these image formats are rendered at 100 pixels per inch.`` If you need results of a particular size in pixels you can use the -crop command line option (which uses inches). For example, `-crop 1,1,4,3` would force cropping to be done so that the result would be a rectangle having lower-left at absolute location (1,1) (inches) and upper-right at (4,3). This would be 3 inches (300 pixels) wide, and 2 inches (200 pixels) tall.``

## Creating PNG

To create a PNG image, use pl with the `-png` option.``

To incorporate a PNG image into an HTML web page, use the HTML construct: `<img src="mygraph.png">`

PNG is a newer image format that has superior compression (hence the images are smaller and faster to transmit). The images can be viewed using the newer versions of web browsers (Netscape 4.04 or higher, Explorer 4.0 or higher) and image viewing tools such as xv. To see if your current web browser can display PNG, try this page. See also the PNG home page

## Creating pseudo-GIF

To create pseudo-GIF, use pl with the `-gif` option.``

To incorporate a GIF image into an HTML web page, use the HTML construct: `<img src="mygraph.gif">`

GIF format has been around for a long while, is fairly universal, and can be viewed on any graphical web browser or image viewing tool.`` The RLE GIF images that ploticus produces are viewable via any graphical web browser or image viewer that supports GIF.`` You may remember the GIF / Unisys controversy from many years ago.``

## Creating SVG

This is discussed here.``

SVG is a relatively new XML vector format that looks good. Browsers display SVG via a plug-in.`` Clickmaps are supported.``

## Transparent background

Images may be created with 'transparent' background by setting the background color to `transparent`. This allows the ploticus graphs to be "overlayed" against the existing background color of the web page.``

## Web page example

Here is an example HTML page that is viewable using any web browser:

    <html>
    <center>
    Here is an image.
    <img src="lineplot1.gif">
    </html>

Suppose the above is in a file called `/home/steve/firsttry.html`. If you don't have a web server running, you can view the file by entering the following URL into your web browser: file:///home/steve/firsttry.html
This assumes that your web browser is running on the same computer that the HTML file is located upon.``

## Clickmap support

Ploticus also can generate clickmaps to accompany images.``

## Image import

Ploticus includes the capability to import PNG images into graphs, and can use small images as scatterplot points and symbols.`` GIF import is not supported.``

## Thumbnail and button images

Thumbnail images (tiny renditions of a plot for icon or selection uses) may be rendered using the -scale command line option. For example: `-scale 0.15`.`` Very small text is rendered as lines.

Ploticus can also be used to make simple buttons for web pages.`` See the gallery example button

data display engine
Copyright Steve Grubb

Markup created by unroff 1.0, `` `` December 10, 2002.