## printim

The `printim` command will produce a PNG or GIF formatted image file based on the current contents of the metabuffer, which is usually the stuff displayed on the screen, minus any widgets. The syntax is:

`printim filename options`

where:

`filename:` The name of the output file. If this file exists, it will be replaced.

`options:` `gif` - produce gif output (default is png)
`` `black` - use black background (default is current display setting)
`` `white` - use white background (default is current display setting)
`` `xNNN` - horizontal size in NNN pixels
`` `yNNN` - vertical size in NNN pixels
`` `-t NN` - color number NN is transparent
`` `-b bgImage` - Image file `bgImage` is included in the background of the output.
`` `-f fgImage` - Image file `fgImage` is included in the foreground of the output.

One or more `options` may be given in any order. `bgImage` and `fgImage` must be PNG format.

### Usage Notes

1. `printim` works with GrADS version 1.8 (or higher).
2. `printim` can be used while in batch mode.

### Examples

The following command produces a 1000x800 PNG image into file out.png:

`printim out.png x1000 y800`

This command produces a 800x600 GIF image, with a white background, into file gifimage.out:

`printim gifimage.out gif x800 y600 white`

This command produces a GIF image with transparent color 0 and a background image mybkg.png. This means that in image.gif, the background image mybkg.png will be seen wherever the color 0 (background) appeared in the current display.

`printim image.gif -b mybkg.png -t 0`