RONCC
/
Geografic-Information-System


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110
							<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
 <title>PS driver</title>
 <meta http-equiv=Content-Type content="text/html; charset=iso-8859-1">
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgColor=white>

<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>

<h2>NAME</h2>
<em><b>PS driver</b></em> - display driver to create PostScript files.

<h2>DESCRIPTION</h2>

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

<h2>USAGE</h2>

<h3>Environment variables</h3>

The PS driver can be enabled by setting <b>GRASS_RENDER_IMMEDIATE</b>
variable, eg.

<div class="code"><pre>
export GRASS_RENDER_IMMEDIATE=ps
</pre></div>

Several environment variables affect the operation of the PS driver:

<ul>
  <li><b>GRASS_WIDTH=xxx</b><br>
     the width of the image map (default is 640).
  </li>
  <li><b>GRASS_HEIGHT=yyy</b><br>
    the height of the image map (default is 480).
  </li>
  <li><b>GRASS_TRUECOLOR=[TRUE|FALSE]</b><br>
    sets true-color support. Default is FALSE.
  </li>
  <li><b>GRASS_PSFILE</b><br>
    name of output file. If it ends with ".eps" an EPS file
    will be created.
  </li>
  <li><b>GRASS_PAPER</b><br>
    sets the screen dimensions and margins to
    fit a standard paper size, see also GRASS_WIDTH, GRASS_HEIGHT.
  </li>
  <li><b>GRASS_LANDSCAPE</b><br>
    if <tt>TRUE</tt>, the screen is rotated 90 degrees
    counter-clockwise so that a "landscape" screen fits better on
    "portrait" paper.
  </li>
  <li><b>GRASS_PS_HEADER</b><br>
    if <tt>FALSE</tt>, the output is appended to any existing file,
    and no prolog or setup sections are generated.
  </li>
  <li><b>GRASS_PS_TRAILER</b><br>
    if <tt>FALSE</tt>, no trailer section is generated.
  </li>
</ul>

<h3>Example</h3>

<div class="code"><pre>
export GRASS_RENDER_IMMEDIATE=ps
export GRASS_TRUECOLOR=TRUE

g.region rast=elevation
d.rast elevation
d.vect roadsmajor color=red
</pre></div>
This writes a file named <tt>map.ps</tt> in your current directory.

<h2>NOTES</h2> 

The resolution of the output files is defined by current region
extents. Use <tt>g.region -p</tt> 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.

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

<p>Masked images (<tt>d.rast</tt>, <tt>d.rgb</tt>, <tt>d.his -n</tt>)
require PostScript level 3.

<h2>SEE ALSO</h2>
<em>
  <a href="cairodriver.html">Cairo driver</a>,
  <a href="pngdriver.html">PNG driver</a>,
  <a href="htmldriver.html">HTML driver</a>,
  <a href="variables.html">variables</a>
  <br><br>
  <a href="d.rast.html">d.rast</a>,
  <a href="d.vect.html">d.vect</a>,
  <a href="d.mon.html">d.mon</a>,
  <a href="d.erase.html">d.erase</a>,
  <a href="d.redraw.html">d.redraw</a>
</em>

<h2>AUTHOR</h2>

Glynn Clements, 2007

<p><i>Last changed: $Date$</i>