Geografic-Information-System/lib/psdriver/psdriver.html

<!-- meta page description: PostScript DISPLAY DRIVER -->

<em>PS display driver</em> 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_RENDER_WIDTH=xxx</b><br>
     the width of the image map (default is 640).
  </li>
  <li><b>GRASS_RENDER_HEIGHT=yyy</b><br>
    the height of the image map (default is 480).
  </li>
  <li><b>GRASS_RENDER_TRUECOLOR=[TRUE|FALSE]</b><br>
    sets true-color support. Default is FALSE.
  </li>
  <li><b>GRASS_RENDER_FILE</b><br>
    name of output file. If it ends with ".eps" an EPS file
    will be created.
  </li>
  <li><b>GRASS_RENDER_PS_PAPER</b><br>
    sets the screen dimensions and margins to
    fit a standard paper size, see also GRASS_RENDER_WIDTH, GRASS_RENDER_HEIGHT.
  </li>
  <li><b>GRASS_RENDER_PS_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_RENDER_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_RENDER_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_RENDER_TRUECOLOR=TRUE

g.region raster=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_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).

<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>