Content-type: text/html Man page of PSRENDER

PSRENDER

Section: User Commands (1)
Updated: 1 February 1999
Index Return to Main Contents
 

NAME

psrender - render Mathematica PostScript output  

SYNOPSIS

psrender -format device [option ...] inputfile

 

DESCRIPTION

psrender is invoked automatically from within Mathematica by $Display. psrender can also be executed independently from the command line, but a more general way to render PostScript is by using the Export command in Mathematica.

psrender accepts Mathematica PostScript output from inputfile and converts it for display on device. If no filename argument is given, psrender reads from standard input. The device argument can be any of the following:

illustrator Adobe Illustrator Version 3.0
eps
Encapsulated PostScript
epsonfx
Epson FX series printer at 72 dpi
epsonlq
Epson LQ series printer at 180 dpi
ibmpro
IBM ProPrinter series printer at 60x72 dpi
ibmpro24
IBM ProPrinter24 series printer at 180 dpi
mgf
Mathematica raster graphics format
mgfcell
Mathematica raster graphics notebook cell
pbm
Portable bitmap RAWBITS file
pcl
HP PCL Printer Language
pdf
Adobe Portable Document Format
psimage
PostScript image/colorimage
psimask
PostScript imagemask format
pspreview
PostScript EPSI Screen Preview
tektronix
Tektronix 4014 graphics terminal
tiff
Tagged Image File Format
tty
Teletype
xbitmap
X bitmap file
gif
Compuserve Graphics Interchange Format
 

OPTIONS

-outputfile file
Send output to file.
-inputfile file
Read input from file.
-mono
Display monochrome output.
-gray
Display grayscale output.
-rgb
Display RGB output.
-width n
Set image width to n points.
-height n
Set image height to n points.
-xoff n
Set x offset of origin to n points.
-yoff n
Set y offset of origin to n points.
-dpi n
Set x and y resolution to n dots per inch.
-xdpi n
Set x resolution to n dots per inch.
-ydpi n
Set y resolution to n dots per inch.
-landscape
Display in landscape mode.
-stretch
Use non-square aspect ratio.
-preview
Include a bitmap preview image.
-pspath s
Set PostScript resource path to s.
-psinit s
Set PostScript initialization string to s.
-procset s
Preload PostScript ProcSet resource s.
-epsinput
Use for EPS input files.
-transparent
Use transparent background.

If device corresponds to a printer, the height, width, and x and y resolutions are set by default to reasonable values for full-page printing. Any of the options -h, -w, -height, -width, -xdpi, or -ydpi will override the default value, whether or not they make any sense for the device in question. The -xdpi and -ydpi settings do not affect the dpi of the output device, but only the transformation of the input PostScript into its raster representation.

If a resolution is specified that does not match the device's actual resolution, the actual image size will not agree with the default full-page size or the dimensions specified by the -height or -width options. For example,

psrender -format epsonfx -xdpi 144 -ydpi 144 inputfile

will produce raster output with twice as many pixels in each direction as are needed for a full-sheet image at 72dpi; as a result the upper-left quarter of the PostScript image will occupy the full printed sheet on an Epson FX printer at 72 dpi, and the rest of the image will be lost. On the other hand,

psrender -format epsonfx -xdpi 36 -ydpi 36 inputfile

will produce a raster image that will only occupy a quarter sheet when printed on an Epson FX printer at 72 dpi.

 

ADDENDUM

The -h, -w, -xdpi, and -ydpi options have no effect for raw PostScript (-format eps) output since no rasterization is done; the input is simply filtered to define the Mathematica graphics operators for the PostScript interpreter.

 

AUTHOR

Wolfram Research, Inc.

 

NOTES

Mathematica and MathLink are registered trademarks of Wolfram Research.

Copyright (c) 1988-1999 Wolfram Research, Inc. All rights reserved.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ADDENDUM
AUTHOR
NOTES

This document was created by man2html, using the manual pages.
Time: 02:43:01 GMT, October 02, 2010