Next: Interacting with Plots, Previous: Use of the interpreter Property, Up: High-Level Plotting [Contents][Index]
The print command allows you to send plots to you printer and
to save plots in a variety of formats. For example,
print -dpsc
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.
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
paperorientation property.
The width and height of images are specified by the figure’s
paperpositon(3:4) property values.
The print command supports many options:
-fhSpecify the handle, h, of the figure to be printed. The default is the current figure.
-PprinterSet the printer name to which the plot is sent if no filename is specified.
-Gghostscript_commandSpecify the command for calling Ghostscript. For Unix and Windows
the defaults are "gs" and "gswin32c", respectively.
-color-monoColor or monochrome output.
-solid-dashedForce all lines to be solid or dashed, respectively.
-portrait-landscapeSpecify 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 "paperorientation" property.
-TextAlphaBits=n-GraphicsAlphaBits=nOctave 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.
-ddeviceThe available output format is specified by the option device, and is one of:
psps2pscpsc2PostScript (level 1 and 2, mono and color). The FLTK graphics toolkit generates PostScript level 3.0.
epseps2epscepsc2Encapsulated PostScript (level 1 and 2, mono and color). The FLTK graphic toolkit generates PostScript level 3.0.
texepslatexepslatexstandalonepstexpslatexpdflatexGenerate a LaTeX (or TeX) file for labels and eps/ps/pdf
for graphics. The file produced by epslatexstandalone can be
processed directly by LaTeX. The other formats are intended to
be included in a LaTeX (or TeX) document. The tex device
is the same as the epslatex device. The pdflatex device
is only available for the FLTK graphics toolkit.
tikzGenerate a LaTeX file using PGF/TikZ. For the FLTK toolkit the result is PGF.
illaifmAdobe Illustrator (Obsolete for Gnuplot versions > 4.2)
cdrcorelCorelDraw
dxfAutoCAD
emfmetaMicrosoft Enhanced Metafile
figXFig. 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)
hpglHP plotter language
mfMetafont
pngPortable network graphics
jpgjpegJPEG image
gifGIF image (only available for the Gnuplot graphics toolkit)
pbmPBMplus
svgScalable vector graphics
pdfPortable document format
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.
-dghostscript_deviceAdditional devices are supported by Ghostscript. Some examples are;
ljet2pHP LaserJet IIP
ljet3HP LaserJet III
deskjetHP DeskJet and DeskJet Plus
cdj550HP DeskJet 550C
paintjetHP PointJet
pcx24b24-bit color PCX file format
ppmPortable Pixel Map file format
pdfwriteProduces pdf output from eps
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 the figure’s "papersize" property. When the output
is sent to a file the size is determined by the plot box defined by
the figure’s "paperposition" property.
-appendAppend PostScript or PDF output to a pre-existing file of the same type.
-rNUMResolution 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 "-r0".
-loose-tightForce a tight or loose bounding box for eps files. The default is loose.
-previewAdd a preview to eps files. Supported formats are:
-interchangeProvide an interchange preview.
-metalfileProvide a metafile preview.
-pictProvide pict preview.
-tiffProvide a tiff preview.
-Sxsize,ysizePlot 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 with the "paperposition" property. When using the
command form of the print function you must quote the
xsize,ysize option. For example, by writing "-S640,480".
-Ffontname-Ffontname:size-F:sizeUse 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 svg device.
figure (1); clf (); surf (peaks); print -dsvg figure1.svg
Example: Print to an HP DeskJet 550C.
clf (); surf (peaks); print -dcdj550
Save graphic object h to the file filename in graphic format fmt.
fmt should be one of the following formats:
psPostScript
epsEncapsulated PostScript
jpgJPEG Image
pngPNG Image
emfEnhanced Meta File
pdfPortable Document Format
All device formats specified in print may also be used. If
fmt is omitted it is extracted from the extension of filename.
The default format is "pdf".
clf (); surf (peaks); saveas (1, "figure1.png");
Query or set the default print orientation.
Valid values for orientation are "landscape",
"portrait", and "tall".
The "tall" option sets the orientation to portrait and fills
the page with the plot, while leaving a 0.25 inch border.
When called with no arguments, return the default print orientation.
If the first argument hfig is a figure handle, then operate on this
figure rather than the current figure returned by gcf.
Next: Interacting with Plots, Previous: Use of the interpreter Property, Up: High-Level Plotting [Contents][Index]