
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 effect the operation
of the PS driver:
- GRASS_RENDER_IMMEDIATE=[FALSE|TRUE|PNG|PS|HTML|cairo]
tells the raster library which driver to use. If
TRUE, the cairo driver is used if it is enabled, otherwise the PNG driver is used.
- 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.
- GRASS_LINE_WIDTH
the default line width.
- GRASS_TEXT_SIZE
the default text size.
- GRASS_FRAME
contains 4 coordinates, top,bottom,left,right, defining the initial frame.
Example
# Define driver settings (here: bash shell syntax)
export GRASS_RENDER_IMMEDIATE=PS
export GRASS_TRUECOLOR=TRUE
# Display raster map and vector polygons
d.rast somerastermap
d.vect somevectormap color=red
This writes a file named map.ps in your current directory.
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
CAIRO driver,
PNG driver
d.rast,
d.vect
AUTHOR
Glynn Clements, 2007
Last changed: $Date: 2011-01-21 16:22:57 -0800 (Fri, 21 Jan 2011) $
Main index - psdriver index - Full index
© 2003-2011 GRASS Development Team