psdriver.1grass - Man Page

PostScript DISPLAY DRIVER

PS display driver to create PostScript files.

Description

The PS driver generates a PostScript file from GRASS display commands.

Usage

Environment variables

The PS driver can be enabled by setting GRASS_RENDER_IMMEDIATE variable, eg.

export GRASS_RENDER_IMMEDIATE=ps

Several environment variables affect the operation of the PS driver:

  • GRASS_RENDER_WIDTH=xxx
    the width of the image map (default is 640).
  • GRASS_RENDER_HEIGHT=yyy
    the height of the image map (default is 480).
  • GRASS_RENDER_TRUECOLOR=[TRUE|FALSE]
    sets true-color support. Default is FALSE.
  • GRASS_RENDER_FILE
    name of output file. If it ends with ".eps" an EPS file will be created.
  • GRASS_RENDER_PS_PAPER
    sets the screen dimensions and margins to fit a standard paper size, see also GRASS_RENDER_WIDTH, GRASS_RENDER_HEIGHT.
  • GRASS_RENDER_PS_LANDSCAPE
    if TRUE, the screen is rotated 90 degrees counter-clockwise so that a "landscape" screen fits better on "portrait" paper.
  • GRASS_RENDER_PS_HEADER
    if FALSE, the output is appended to any existing file, and no prolog or setup sections are generated.
  • GRASS_RENDER_PS_TRAILER
    if FALSE, no trailer section is generated.

Example

export GRASS_RENDER_IMMEDIATE=ps
export GRASS_RENDER_TRUECOLOR=TRUE
g.region raster=elevation
d.rast elevation
d.vect roadsmajor color=red

This writes a file named map.ps in your current directory.

Notes

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

GRASS_RENDER_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).

Masked images (d.rast, d.rgb, d.his -n) require PostScript level 3.

See Also

Cairo driver, PNG driver, HTML driver, variables

d.rast, d.vect, d.mon, d.erase, d.redraw

Author

Glynn Clements, 2007

Source Code

Available at: PostScript DISPLAY DRIVER source code (history)

Accessed: Monday Sep 09 08:45:51 2024

Main index | Topics index | Keywords index | Graphical index | Full index

© 2003-2024 GRASS Development Team, GRASS GIS 8.4.0 Reference Manual

Info

GRASS 8.4.0 GRASS GIS User's Manual