<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 2008 (1.71)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Postscript</TITLE>
<META NAME="description" CONTENT="Postscript">
<META NAME="keywords" CONTENT="gnuplot">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="gnuplot.css">
<LINK REL="next" HREF="node426.html">
<LINK REL="previous" HREF="node420.html">
<LINK REL="up" HREF="node349.html">
<LINK REL="next" HREF="node422.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html7431"
HREF="node422.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html7425"
HREF="node349.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html7419"
HREF="node420.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html7427"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html7429"
HREF="node467.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html7432"
HREF="node422.html">Editing postscript</A>
<B> Up:</B> <A NAME="tex2html7426"
HREF="node349.html">Complete list of terminals</A>
<B> Previous:</B> <A NAME="tex2html7420"
HREF="node420.html">Pngcairo</A>
<B> <A NAME="tex2html7428"
HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html7430"
HREF="node467.html">Index</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION050155000000000000000"></A>
<A NAME="commands_set_terminal_postscript"></A><A NAME="set_terminal_postscript"></A><A NAME="set_term_postscript"></A><A NAME="terminal_postscript"></A><A NAME="term_postscript"></A><A NAME="postscript"></A><A NAME="9582"></A>
<BR>
Postscript
</H2>
Several options may be set in the <B>postscript</B> driver.
<P>
Syntax:
<BR>
<PRE>
set terminal postscript {default}
set terminal postscript {landscape | portrait | eps}
{enhanced | noenhanced}
{defaultplex | simplex | duplex}
{fontfile [add | delete] "<filename>"
| nofontfiles} {{no}adobeglyphnames}
{level1 | leveldefault}
{color | colour | monochrome}
{solid | dashed}
{dashlength | dl <DL>}
{linewidth | lw <LW>}
{rounded | butt}
{clip | noclip}
{palfuncparam <samples>{,<maxdeviation>}}
{size <XX>{unit},<YY>{unit}}
{blacktext | colortext | colourtext}
{{font} "fontname{,fontsize}" {<fontsize>}}
</PRE>
<BR>
If you see the error message
<BR>
<PRE>
"Can't find PostScript prologue file ... "
</PRE>
<BR>
Please see and follow the instructions in <B>postscript prologue (p. <A HREF="node424.html#postscript_prologue"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)<A NAME="9589"></A></B>.
<P>
<B>landscape</B> and <B>portrait</B> choose the plot orientation.
<B>eps</B> mode generates EPS (Encapsulated PostScript) output, which is just
regular PostScript with some additional lines that allow the file to be
imported into a variety of other applications. (The added lines are
PostScript comment lines, so the file may still be printed by itself.) To
get EPS output, use the <B>eps</B> mode and make only one plot per file. In <B>eps</B>
mode the whole plot, including the fonts, is reduced to half of the default
size.
<P>
<B>enhanced</B> enables enhanced text mode features (subscripts,
superscripts and mixed fonts). See <B>enhanced (p. <A HREF="node20.html#enhanced"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)<A NAME="9597"></A></B> for more information.
<B>blacktext</B> forces all text to be written in black even in color mode;
<P>
Duplexing in PostScript is the ability of the printer to print on both
sides of the same sheet of paper. With <B>defaultplex</B>, the default setting
of the printer is used; with <B>simplex</B> only one side is printed; <B>duplex</B>
prints on both sides (ignored if your printer can't do it).
<P>
<B><TT>"</TT>4#4fontname5#5<TT>"</TT></B> is the name of a valid PostScript font; and <B>4#4fontsize5#5</B> is
the size of the font in PostScript points.
In addition to the standard postscript fonts, an oblique version of the
Symbol font, useful for mathematics, is defined. It is called
<TT>"</TT>Symbol-Oblique<TT>"</TT>.
<P>
<B>default</B> sets all options to their defaults: <B>landscape</B>, <B>monochrome</B>,
<B>dashed</B>, <B>dl 1.0</B>, <B>lw 1.0</B>, <B>defaultplex</B>, <B>noenhanced</B>, <TT>"</TT>Helvetica<TT>"</TT> and
14pt. Default size of a PostScript plot is 10 inches wide and 7 inches high.
The option <B>color</B> enables color, while <B>monochrome</B> prefers black and white
drawing elements. Further, <B>monochrome</B> uses gray <B>palette</B> but it does not
change color of objects specified with an explicit <B>colorspec</B>.
<B>solid</B> draws all plots with solid lines, overriding any dashed patterns.
<B>dashlength</B> or <B>dl</B> scales the length of the dashed-line segments by 4#4DL5#5,
which is a floating-point number greater than zero.
<B>linewidth</B> or <B>lw</B> scales all linewidths by 4#4LW5#5.
<P>
By default the generated PostScript code uses language features that were
introduced in PostScript Level 2, notably filters and pattern-fill of
irregular objects such as filledcurves. PostScript Level 2 features are
conditionally protected so that PostScript Level 1 interpreters do not issue
errors but, rather, display a message or a PostScript Level 1 approximation.
The <B>level1</B> option substitutes PostScript Level 1 approximations of these
features and uses no PostScript Level 2 code. This may be required by some
old printers and old versions of Adobe Illustrator. The flag <B>level1</B> can be
toggled later by editing a single line in the PostScript output file to force
PostScript Level 1 interpretation. In the case of files containing level 2
code, the above features will not appear or will be replaced by a note when
this flag is set or when the interpreting program does not indicate that it
understands level 2 PostScript or higher.
<P>
<B>rounded</B> sets line caps and line joins to be rounded; <B>butt</B> is the
default, butt caps and mitered joins.
<P>
<B>clip</B> tells PostScript to clip all output to the bounding box;
<B>noclip</B> is the default.
<P>
<B>palfuncparam</B> controls how <B>set palette functions</B> are encoded as gradients
in the output. Analytic color component functions (set via
<B>set palette functions</B>) are encoded as linear interpolated gradients in the
postscript output: The color component functions are sampled at 4#4samples5#5
points and all points are removed from this gradient which can be removed
without changing the resulting colors by more than 4#4maxdeviation5#5. For
almost every useful palette you may savely leave the defaults of
4#4samples5#5=2000 and 4#4maxdeviation5#5=0.003 untouched.
<P>
The default size for postscript output is 10 inches x 7 inches. The default
for eps output is 5 x 3.5 inches. The <B>size</B> option changes this to
whatever the user requests. By default the X and Y sizes are taken to be in
inches, but other units are possibly (currently only cm). The BoundingBox
of the plot is correctly adjusted to contain the resized image.
Screen coordinates always run from 0.0 to 1.0 along the full length of the
plot edges as specified by the <B>size</B> option.
NB: <B>this is a change from the previously recommended method of using the
set size command prior to setting the terminal type</B>. The old method left
the BoundingBox unchanged and screen coordinates did not correspond to the
actual limits of the plot.
<P>
Fonts listed by <B>fontfile</B> or <B>fontfile add</B> encapsulate the font
definitions of the listed font from a postscript Type 1 or TrueType font
file directly into the gnuplot output postscript file. Thus, the enclosed
font can be used in labels, titles, etc. See the section
<B>postscript fontfile (p. <A HREF="node423.html#postscript_fontfile"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)<A NAME="9642"></A></B> for more details. With <B>fontfile delete</B>, a fontfile
is deleted from the list of embedded files. <B>nofontfiles</B> cleans the list
of embedded fonts.
<P>
Examples:
<BR>
<PRE>
set terminal postscript default # old postscript
set terminal postscript enhanced # old enhpost
set terminal postscript landscape 22 # old psbig
set terminal postscript eps 14 # old epsf1
set terminal postscript eps 22 # old epsf2
set size 0.7,1.4; set term post portrait color "Times-Roman" 14
set term post "VAGRoundedBT_Regular" 14 fontfile "bvrr8a.pfa"
</PRE>
<BR>
<P>
Linewidths and pointsizes may be changed with <B>set style line</B>.
<P>
The <B>postscript</B> driver supports about 70 distinct pointtypes, selectable
through the <B>pointtype</B> option on <B>plot</B> and <B>set style line</B>.
<P>
Several possibly useful files about <B>gnuplot</B>'s PostScript are included
in the /docs/psdoc subdirectory of the <B>gnuplot</B> distribution and at the
distribution sites. These are <TT>"</TT>ps_symbols.gpi<TT>"</TT> (a <B>gnuplot</B> command file
that, when executed, creates the file <TT>"</TT>ps_symbols.ps<TT>"</TT> which shows all the
symbols available through the <B>postscript</B> terminal), <TT>"</TT>ps_guide.ps<TT>"</TT> (a
PostScript file that contains a summary of the enhanced syntax and a page
showing what the octal codes produce with text and symbol fonts),
<TT>"</TT>ps_file.doc<TT>"</TT> (a text file that contains a discussion of the organization
of a PostScript file written by <B>gnuplot</B>), and <TT>"</TT>ps_fontfile_doc.tex<TT>"</TT>
(a LaTeX file which contains a short documentation concerning the
encapsulation of LaTeX fonts with a glyph table of the math fonts).
<P>
A PostScript file is editable, so once <B>gnuplot</B> has created one, you are
free to modify it to your heart's desire. See the <B>editing postscript (p. <A HREF="node422.html#editing_postscript"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)<A NAME="9669"></A></B>
section for some hints.
<BR><HR>
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
<LI><A NAME="tex2html7433"
HREF="node422.html">Editing postscript</A>
<LI><A NAME="tex2html7434"
HREF="node423.html">Postscript fontfile</A>
<LI><A NAME="tex2html7435"
HREF="node424.html">Postscript prologue</A>
<LI><A NAME="tex2html7436"
HREF="node425.html">Postscript adobeglyphnames</A>
</UL>
<!--End of Table of Child-Links-->
<HR>
<!--Navigation Panel-->
<A NAME="tex2html7431"
HREF="node422.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html7425"
HREF="node349.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html7419"
HREF="node420.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html7427"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html7429"
HREF="node467.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html7432"
HREF="node422.html">Editing postscript</A>
<B> Up:</B> <A NAME="tex2html7426"
HREF="node349.html">Complete list of terminals</A>
<B> Previous:</B> <A NAME="tex2html7420"
HREF="node420.html">Pngcairo</A>
<B> <A NAME="tex2html7428"
HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html7430"
HREF="node467.html">Index</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
2010-08-17
</ADDRESS>
</BODY>
</HTML>
