Home > freetb4matlab > plot > print.m

print

PURPOSE ^

% Print a graph, or save it to a file

SYNOPSIS ^

function print (varargin)

DESCRIPTION ^

% -*- texinfo -*-
% @deftypefn {Function File} {} print (@var{filename}, @var{options})
% @deftypefnx {Function File} {} print (@var{h}, @var{filename}, @var{options})
% Print a graph, or save it to a file
%
% @var{filename} defines the file name of the output file.  If no
% filename is specified, output is sent to the printer.
%
% @var{h} specifies the figure handle.  If no handle is specified
% the handle for the current figure is used.
%
% @var{options}:
% @table @code
% @item -P@var{printer}
%   Set the @var{printer} name to which the graph is sent if no
%   @var{filename} is specified.
% @item -G@var{ghostscript_command}
%   Specify the command for calling Ghostscript.  For Unix and Windows,
% the defaults are 'gs' and 'gswin32c', respectively.
% @item -color
% @itemx -mono
%   Monochrome or color lines.
% @item -solid
% @itemx -dashed
%   Solid or dashed lines.
% @item -portrait
% @itemx -landscape
%   Plot orientation, as returned by 'orient'.
% @item -d@var{device}
%   Output device, where @var{device} is one of:
%   @table @code
%   @item ps
%   @itemx ps2
%   @itemx psc
%   @itemx psc2
%     Postscript (level 1 and 2, mono and color)
%   @item eps
%   @itemx eps2
%   @itemx epsc
%   @itemx epsc2
%     Encapsulated postscript (level 1 and 2, mono and color)
%   @item tex
%   @itemx epslatex
%   @itemx epslatexstandalone
%   @itemx pstex
%   @itemx pslatex
%     Generate a @LaTeX{} (or @TeX{}) file for labels, and eps/ps for
% graphics.  The file produced by @code{epslatexstandalone} can be
% processed directly by @LaTeX{}.  The other formats are intended to
% be included in a @LaTeX{} (or @TeX{}) document.  The @code{tex} device
% is the same as the @code{epslatex} device.
%   @item ill
%   @itemx aifm
%     Adobe Illustrator
%   @item cdr
%   @itemx corel
%     CorelDraw
%   @item dxf
%     AutoCAD
%   @item emf
%   @itemx meta
%     Microsoft Enhanced Metafile
%   @item fig
%     XFig.  If this format is selected the additional options
%     @code{-textspecial} or @code{-textnormal} can be used to control
%     whether the special flag should be set for the text in
%     the figure (default is @code{-textnormal}). 
%   @item hpgl
%     HP plotter language
%   @item mf
%     Metafont
%   @item png
%     Portable network graphics
%   @item jpg
%   @itemx jpeg
%     JPEG image
%   @item gif
%     GIF image
%   @item pbm
%     PBMplus
%   @item svg
%     Scalable vector graphics
%   @item pdf
%     Portable document format
%   @end table
%
%   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.
%
% @item -d@var{gs_device}
%   Additional devices are supported by Ghostscript.
% Some examples are;
%
%   @table @code
%   @item ljet2p 
%     HP LaserJet IIP
%   @item ljet3 
%     HP LaserJet III
%   @item deskjet
%     HP DeskJet and DeskJet Plus
%   @item cdj550
%     HP DeskJet 550C
%   @item paintjet
%     HP PointJet
%   @item pcx24b
%     24-bit color PCX file format
%   @item ppm
%     Portable Pixel Map file format
%   @end table
%
%   For a complete list, type `system ('gs -h')' to see what formats
% and devices are available.
%
%   For output sent to a printer, the size is determined by the
% figure's "papersize" property.  For output to a file the, size
% is determined by the 'paperposition' property.
%
% @itemx -r@var{NUM}
%   Resolution of bitmaps in pixels per inch.  For both metafiles and 
% SVG the default is the screen resolution, for other it is 150 dpi.
% To specify screen resolution, use '-r0'.
%
% @item -tight
%   Forces a tight bounding box for eps-files.  Since the ghostscript
% devices are conversion of an eps-file, this option works the those
% devices as well.
%
% @itemx -S@var{xsize},@var{ysize}
%   Plot size in pixels for EMF, GIF, JPEG, PBM, PNG and SVG.  If
% using the command form of the print function, you must quote the
% @var{xsize},@var{ysize} option.  For example, by writing
% @w{@code{'-S640,480'}}.  The size defaults to that specified by the
% figure's paperposition property.
%
% @item -F@var{fontname}
% @itemx -F@var{fontname}:@var{size}
% @itemx -F:@var{size}
%   @var{fontname} set the postscript font (for use with postscript,
% aifm, corel and fig).  By default, 'Helvetica' is set for PS/Aifm,
% and 'SwitzerlandLight' for Corel.  It can also be 'Times-Roman'.
% @var{size} is given in points.  @var{fontname} is ignored for the
% fig device.
% @end table
%
% The filename and options can be given in any order.
% @end deftypefn

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Fri 22-May-2009 15:13:00 by m2html © 2003