help eps_options
-------------------------------------------------------------------------------
Title
[G] eps_options -- Options for exporting to Encapsulated PostScript
Syntax
eps_options description
---------------------------------------------------------------------
logo(on|off) whether to include Stata logo
cmyk(on|off) whether to use CMYK rather than RGB colors
preview(on|off) whether to include TIFF preview
mag(#) magnification/shrinkage factor; default is
100
fontface(fontname) default font to use
fontfacesans(fontname) font to use for text in {stSans} "font"
fontfaceserif(fontname) font to use for text in {stSerif} "font"
fontfacemono(fontname) font to use for text in {stMono} "font"
fontfacesymbol(fontname) font to use for text in {stSymbol} "font"
fontdir(directory) (Unix only) directory in which TrueType
fonts are stored
orientation(portrait|
landscape) whether vertical or horizontal
---------------------------------------------------------------------
where fontname may be a valid font name or default to restore the default
setting and directory may be a valid directory or default to restore
the default setting.
Current default values may be listed by typing
. graph set eps
and default values may be set by typing
. graph set eps name value
where name is the name of an eps_option, omitting the parentheses.
Description
These eps_options are used with graph export when creating an
Encapsulated PostScript file; see [G] graph export.
Options
logo(on) and logo(off) specify whether the Stata logo should be included
at the bottom of the graph.
cmyk(on) and cmyk(off) specify whether colors in the output file should
be specified as CMYK values rather than RGB values.
preview(on) and preview(off) specify whether a TIFF preview of the graph
should be included in the Encapsulated PostScript file. This option
allows word processors that cannot interpret PostScript to display a
preview of the file. The preview is often substituted for the
Encapsulated PostScript file when printing to a non-PostScript
printer. This option is not available in Stata console and requires
the Graph window to be visible.
mag(#) specifies that the graph be drawn smaller or larger than the
default. mag(100) is the default, meaning ordinary size. mag(110)
would make the graph 10% larger than usual, and mag(90) would make
the graph 10% smaller than usual. # must be an integer.
fontface(fontname) specifies the name of the PostScript font to be used
to render text for which no other font has been specified. The
default is Helvetica, which may be restored by specifying fontname as
default. If fontname contains spaces, it must be enclosed in double
quotes.
fontfacesans(fontname) specifies the name of the PostScript font to be
used to render text for which the {stSans} "font" has been specified.
The default is Helvetica, which may be restored by specifying
fontname as default. If fontname contains spaces, it must be
enclosed in double quotes.
fontfaceserif(fontname) specifies the name of the PostScript font to be
used to render text for which the {stSerif} "font" has been
specified. The default is Times, which may be restored by specifying
fontname as default. If fontname contains spaces, it must be
enclosed in double quotes.
fontfacemono(fontname) specifies the name of the PostScript font to be
used to render text for which the {stMono} "font" has been specified.
The default is Courier, which may be restored by specifying fontname
as default. If fontname contains spaces, it must be enclosed in
double quotes.
fontfacesymbol(fontname) specifies the name of the PostScript font to be
used to render text for which the {stSymbol} "font" has been
specified. The default is Symbol, which may be restored by
specifying fontname as default. If fontname contains spaces, it must
be enclosed in double quotes.
fontdir(directory) specifies the directory that Stata for Unix uses to
find TrueType fonts (if you specified any) for conversion to
PostScript fonts when you export a graph to Encapsulated PostScript.
You may specify directory as default to restore the default setting.
If directory contains spaces, it must be enclosed in double quotes.
orientation(portrait) and orientation(landscape) specify whether the
graph is to be presented vertically or horizontally.
Remarks
Remarks are presented under the following headings:
Using the eps_options
Setting defaults
Note about PostScript fonts
Using the eps_options
You have drawn a graph and wish to create an Encapsulated PostScript file
for including the file in a document. You wish, however, to change text
for which no other font has been specified from the default of Helvetica
to Roman, which is "Times" in PostScript jargon:
. graph ... (draw a graph)
. graph export myfile.eps, fontface(Times)
Setting defaults
If you always wanted graph export to use Times when exporting to
Encapsulated PostScript files, you could type
. graph set eps fontface Times
Later, you could type
. graph set eps fontface Helvetica
to change it back. You can list the current eps_option settings for
Encapsulated PostScript by typing
. graph set eps
Note about PostScript fonts
Graphs exported to Encapsulated PostScript format by Stata conform to
what is known as PostScript Level 2. There are 10 built-in font faces,
known as the Core Font Set, some of which are available in modified
forms, e.g., bold or italic (a listing of the original 10 font faces in
the Core Font Set is shown at
http://en.wikipedia.org/wiki/Type_1_and_Type_3_fonts#Core_Font_Set). If
you change any of the fontface*() settings, we recommend that you use one
of those 10 font faces. We do not recommend changing fontfacesymbol(),
because doing so can lead to incorrect characters being printed.
If you specify a font face other than one that is part of the Core Font
Set, Stata will first attempt to map it to the closest matching font in
the Core Font Set. For example, if you specify fontfaceserif("Times New
Roman"), Stata will map it to fontfaceserif("Times").
If Stata is unable to map the font face to the Core Font Set, Stata will
look in the fontdir() directory for a TrueType font on your system
matching the font you specified. If it finds one, it will attempt to
convert it to a PostScript font and, if successful, will embed the
converted font in the exported Encapsulated PostScript graph. Because of
the wide variety of TrueType fonts available on different systems, this
conversion can be problematic, which is why we recommend that you use
fonts found in the Core Font Set.
Also see
Manual: [G] eps_options
Help: [G] graph export, [G] graph set, [G] ps_options
