epswrite

Save figure as an EPS image

Contents

Syntax

epswrite(filename)
epswrite(H, filename)
epsewrite(..., 'Param1', Value1, 'Param2', Value2,...)

Description

epswrite(filename) saves the current figure as a EPS image file specified by the string filename.

epswrite(H, filename) outputs an EPS file of the figure specified by the handle H.

epswrite(...,'Param1', Value1, 'Param2', Value2,...) creates an EPS file with the specific parameters (Param) have specified values. Any unspecified parameters are set to use the default value for that parameter.

Options

The following table lists the available option parameters.

Option

Value

Description

Related print arguments

Units

'inches' | 'centimeters' | 'points'

Units for Size parameter. The figure's PaperUnits property is used as the default.

n/a

Size

[X Y] | 'screen' | {'default'}

The EPS image size. X and Y must be positive values, and Units property specifies the units of X and Y. 'screen' prints the figure the same size as it appears on the computer screen. 'default' uses the value from figure's PaperPosition property.

n/a

Resolution

positive scalar

Resolution in dots per inch. The default is 864 dpi if Renderer option is 'painter'; otherwise, it is 150 dpi. If 0, the resolution is set to MATLAB root's ScreenPixelsPerInch property. In Renderer is set to 'painter', Resolution changes the accuracy of object placement. For other Renderer options, it defines the raster dot resolution.

-rnumber

BgColor

'figure' | 'none' | 3-element RGB vector

Figure background fill color. The default value is [1 1 1] (white). 'figure' uses the figure's Color property value, and 'none' removes the fill (i.e., transparent background).

n/a

ColorSpace

'mono' | {'rgb'} | 'cmyk'

Output color space. 'mono' prints in monochrome. 'rgb' and 'cmyk' both outputs color image, but in different color space: RGB (red-green-blue) vs. CMYK (cyan-magenta-yellow-black).

-deps, -depsc, -deps2, -depsc2, -cmyk

PSDriver

'level1' | {'level2'}

PostScript level.

-deps, -depsc, -deps2, -depsc2

TiffPreview

'on' | {'off'}

'on' to add a 72-dpi TIFF preview. For different resolution, use epspreview function instead.

-tiff

BoundingBox

'tight' | {'loose'}

Figure cropping mode. 'loose' outputs the figure as is. 'tight' crops the unused figure edge space.

-loose

ShowUI

{'on'} | 'off'

UI control display mode. 'on' to display; 'off' to hide.

-noui

Renderer

{'painters'} | 'opengl' | 'zbuffer'

Output rendering mode. 'painter' renders with Painter's algorihtm, opengl renders with OpenGL algorithm, and 'zbuffer' renders with the Z-buffer algorithm. Only 'painter' creates a vector image. Both opengl and zbuffer rasterizes the figure.

-painter, -opengl, -zbuffer

EmbedFonts

'none' | {'default'} | 'addsymbol' | 'all'

Font embedding mode. 'none' de-embeds all fonts. 'default' keeps the MATLAB default (only embeds LaTeX fonts). 'addsymbol' also includes Symbol font. 'all' embeds all the fonts. By default, embed fonts are subsetted with encryption. For alternate embedding scheme, use epsembedfont.

n/a

Example

See Also

eps2raster, epsembedfont, epssetlinestyle, epsembedfont, epssetbbox, epssetbgcolor

Copyright 2012. Takeshi Ikuma. All rights reserved.