Stata 15 help for eps_options

[G-3] 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-2] 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, for example, 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.


© Copyright 1996–2018 StataCorp LLC   |   Terms of use   |   Privacy   |   Contact us   |   What's new   |   Site index