prints the current figure to a color PostScript printer. And,
print -deps foo.eps
saves the current figure to an encapsulated PostScript file called foo.eps.
The different graphic toolkits have different print capabilities. In
particular, the OpenGL based toolkits such as
fltk do not support
"interpreter" property of text objects. This means special
symbols drawn with the
"tex" interpreter will appear correctly
on-screen but will be rendered with interpreter
"none" when printing.
Switch graphics toolkits for printing if this is a concern.
Print a plot, or save it to a file.
Both output formatted for printing (PDF and PostScript), and many bitmapped and vector image formats are supported.
filename defines the name of the output file. If the file name has no suffix, one is inferred from the specified device and appended to the file name. If no filename is specified, the output is sent to the printer.
h specifies the handle of the figure to print. If no handle is specified the current figure is used.
For output to a printer, PostScript file, or PDF file, the paper size is
specified by the figure’s
papersize property. The location and
size of the image on the page are specified by the figure’s
paperposition property. The orientation of the page is specified
by the figure’s
The width and height of images are specified by the figure’s
paperpositon(3:4) property values.
Specify the handle, h, of the figure to be printed. The default is the current figure.
Set the printer name to which the plot is sent if no filename is specified.
Specify the command for calling Ghostscript. For Unix and Windows the
Color or monochrome output.
Force all lines to be solid or dashed, respectively.
Specify the orientation of the plot for printed output.
For non-printed output the aspect ratio of the output corresponds to the
plot area defined by the
"paperposition" property in the
orientation specified. This option is equivalent to changing the figure’s
Octave is able to produce output for various printers, bitmaps, and vector formats by using Ghostscript. For bitmap and printer output anti-aliasing is applied using Ghostscript’s TextAlphaBits and GraphicsAlphaBits options. The default number of bits for each is 4. Allowed values for N are 1, 2, or 4.
The available output format is specified by the option device, and is one of:
PostScript (level 1 and 2, mono and color). The FLTK graphics toolkit generates PostScript level 3.0.
Encapsulated PostScript (level 1 and 2, mono and color). The FLTK graphic toolkit generates PostScript level 3.0.
Generate a LaTeX file filename.tex for the text
portions of a plot and a file filename.(ps|eps|pdf) for the
remaining graphics. The graphics file suffix .ps|eps|pdf is determined
by the specified device type. The LaTeX file produced by the
‘standalone’ option can be processed directly by LaTeX. The file
generated without the ‘standalone’ option is intended to be included
from another LaTeX document. In either case, the LaTeX file
\includegraphics command so that the generated graphics
file is automatically included when the LaTeX file is processed. The
text that is written to the LaTeX file contains the strings
exactly as they were specified in the plot. If any special
characters of the TeX mode interpreter were used, the file must be
edited before LaTeX processing. Specifically, the special characters
must be enclosed with dollar signs (
$ … $), and other
characters that are recognized by LaTeX may also need editing (.e.g.,
braces). The ‘pdflatex’ device, and any of the ‘standalone’
formats, are not available with the Gnuplot toolkit.
Generate a LaTeX file using PGF/TikZ. For the FLTK toolkit the result is PGF.
Adobe Illustrator (Obsolete for Gnuplot versions > 4.2)
Microsoft Enhanced Metafile
XFig. For the Gnuplot graphics toolkit, the additional options -textspecial or -textnormal can be used to control whether the special flag should be set for the text in the figure. (default is -textnormal)
HP plotter language
Portable network graphics
GIF image (only available for the Gnuplot graphics toolkit)
Scalable vector graphics
Portable document format
NOTE: The gnuplot binary as shipped by Debian cannot create PDF files, see http://bugs.debian.org/478677
If the device is omitted, it is inferred from the file extension, or if there is no filename it is sent to the printer as PostScript.
Additional devices are supported by Ghostscript. Some examples are;
Produces pdf output from eps
HP LaserJet IIP
24-bit color PCX file format
Portable Pixel Map file format
For a complete list, type
system ("gs -h") to see what formats
and devices are available.
When Ghostscript output is sent to a printer the size is determined by
"papersize" property. When the output is sent to a
file the size is determined by the plot box defined by the figure’s
Append PostScript or PDF output to a pre-existing file of the same type.
Resolution of bitmaps in pixels per inch. For both metafiles and SVG
the default is the screen resolution; for other formats it is 150 dpi. To
specify screen resolution, use
Force a tight or loose bounding box for eps files. The default is loose.
Add a preview to eps files. Supported formats are:
Provide an interchange preview.
Provide a metafile preview.
Provide pict preview.
Provide a tiff preview.
Plot size in pixels for EMF, GIF, JPEG, PBM, PNG, and SVG.
For PS, EPS, PDF, and other vector formats the plot size is in points.
This option is equivalent to changing the size of the plot box associated
"paperposition" property. When using the command form of
the print function you must quote the xsize,ysize option. For
example, by writing "-S640,480".
Use fontname and/or fontsize for all text. fontname is ignored for some devices: dxf, fig, hpgl, etc.
The filename and options can be given in any order.
Example: Print to a file using the pdf device.
figure (1); clf (); surf (peaks); print figure1.pdf
Example: Print to a file using jpg device.
clf (); surf (peaks); print -djpg figure2.jpg
Example: Print to printer named PS_printer using ps format.
clf (); surf (peaks); print -dpswrite -PPS_printer
See also: saveas, hgsave, orient, figure.
Save graphic object h to the file filename in graphic format fmt.
fmt should be one of the following formats:
Enhanced Meta File
Portable Document Format
All device formats specified in
clf (); surf (peaks); saveas (1, "figure1.png");
See also: print, hgsave, orient.
Query or set the print orientation for figure hfig.
Valid values for orientation are
"landscape" option changes the orientation so the plot width
is larger than the plot height. The
"paperposition" is also
modified so that the plot fills the page, while leaving a 0.25 inch border.
"tall" option sets the orientation to
fills the page with the plot, while leaving a 0.25 inch border.
"portrait" option (default) changes the orientation so the plot
height is larger than the plot width. It also restores the default
When called with no arguments, return the current print orientation.
If the argument hfig is omitted, then operate on the current figure
See also: print, saveas.
saveas are used when work on a plot has finished
and the output must be in a publication-ready format. During intermediate
stages it is often better to save the graphics object and all of its
associated information so that changes—to colors, axis limits, marker styles,
etc.—can be made easily from within Octave. The
commands can be used to save and re-create a graphics object.
Save the graphics handle h to the file filename in the format fmt.
If unspecified, h is the current figure as returned by
When filename does not have an extension the default filename extension .ofig will be appended.
If present, fmt should be one of the following:
When producing graphics for final publication use
saveas. When it is important to be able to continue to edit a
figure as an Octave object, use
See also: hgload, hdl2struct, saveas, print.
Load the graphics object in filename into the graphics handle h.
If filename has no extension, Octave will try to find the file with and without the standard extension of .ofig.
See also: hgsave, struct2hdl.