PS driver

## NAME

PS driver - driver to create PostScript files.
(drivers)

## DESCRIPTION

The PS driver generates a PostScript file from GRASS display commands. The driver is started as 'pseudo' monitor (PS file instead) and when stopped, all output from previously used display commands are written to the PostScript file.

## USAGE

### Environment variables

Several environment variables affect the operation of the PS driver:

- GRASS_PSFILE
  name of output file. If it ends with ".eps" an EPS file will be created.
- GRASS_PAPER
  sets the screen dimensions and margins to fit a standard paper size, see also GRASS_WIDTH, GRASS_HEIGHT.
- GRASS_WIDTH
  defines the width of the screen, see also GRASS_HEIGHT
- GRASS_HEIGHT
  defines the height of the screen, see also GRASS_WIDTH
- GRASS_TRUECOLOR
  if `TRUE`, the PS driver generates color output, otherwise monochrome.
- GRASS_LANDSCAPE
  if `TRUE`, the screen is rotated 90 degrees counter-clockwise so that a "landscape" screen fits better on "portrait" paper.
- GRASS_PS_HEADER
  if `FALSE`, the output is appended to any existing file, and no prolog or setup sections are generated.
- GRASS_PS_TRAILER
  if `FALSE`, no trailer section is generated.

### Example

1. Start up the driver

       d.mon start=PS

2. Display raster map and vector polygons

       d.rast somerastermap
       d.vect map=somevectormap color=red

3. Stop the driver subsequently. This will write a file named `map.ps` to be created in your current directory:

       d.mon stop=PS

## NOTES

The resolution of the PS raster map is defined by the map extents. Use g.region -p to get the number of rows and cols and use the environment variables to set the PS size. If you would like a larger image, multiply both rows and cols by the same whole number to preserve the aspect ratio.

GRASS_TRUECOLOR requires either PostScript level 2 or level 1 plus the colorimage and setrgbcolor operators (this is the case for colour printers which pre-date level 2 PostScript).

Only masked images (`d.rast -o`, `d.rgb -o`, `d.his -n`) require PostScript level 3.

## SEE ALSO

Display drivers
HTMLMAP driver, PNG driver, XDRIVER
d.frame, d.out.file, d.mon, d.rast, d.vect

## AUTHOR

Glynn Clements, 2007

Last changed: $Date: 2012-03-02 21:22:34 -0800 (Fri, 02 Mar 2012) $