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
       Start up the driver
       d.mon start=PS
        Display raster map and vector polygons
       d.rast somerastermap
       d.vect map=somevectormap color=red
        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) $

       Full index

       © 2003-2013 GRASS Development Team