HARDCOPY

##
HARDCOPY

            [GTVL\]HARDCOPY  [File]  [/DEVICE Name [Attributes]] [/PRINT [Print-
        er]] [/DIRECTORY DirName] [/GEOMETRY Sizex[Unitx]  Sizey[Unity]]  [/FIT-
        PAGE] [/EXACT] [/OVERWRITE]

        Create a "hardcopy" of the current plot.

        There are 3 possible outputs:
          -  a  file:  if  a  file name is provided, or if GTV%STDOUT is NO (de-
            fault). In this latter case, the file name defaults to "gregplot.*".
          - the terminal: if no file name is provided and GTV%STDOUT is YES.
          - the printer: if /PRINT is used, see below.
        Sending hardcopies to the terminal can be useful to avoid  using  tempo-
        rary files on the disk. The calling process can read it instead directly
        from STDOUT. In case of PostScript or SVG hardcopies, their  ASCII  con-
        tent is directly dumped in the terminal. In case of PNG, the binary data
        is encoded using the Base64 algorithm (portable ASCII sequence),  and  a
        header and a footer are added as description.

        The  default  behaviour  of  the  command is to scale the GreG PLOT_PAGE
        (centimeters) into the output physical page. This can be overriden  with
        the two options:
          - /EXACT:  1  cm  on  the  GreG PLOT_PAGE will be 1 cm on the hardcopy
            physical page, for devices for which it makes sense,
          - /FITPAGE: the plot will be automatically rotated and scaled to  make
            the  best  use  of the hardcopy physical page. The option /PRINT im-
            plicitely enables this feature. See subtopic for details.
        These two options are exclusive.

        The /DEVICE option argument specifies which  type  of  plotter  will  be
        used.  See  the  subtopic /DEVICE for a list of the allowed devices. The
        other arguments passed to this option can modify the attributes  of  the
        hardcopy.  If the option is not used, the harcopy device defaults to the
        content of the SIC logical GAG_HARDCOPY.

        The /DIRECTORY option allows to specify which GTV  directory  should  be
        sent to the hardcopy. Without this option, default is current directory.

        The  /PRINT  option is used to force immediate printing and, optionally,
        to control which printer should be used. Printer is  the  printer  name,
        which defaults to the content of the SIC logical GAG_PRINTER. The print-
        ing command is ruled by the SIC logical GAG_LPR. If  no  file  name  was
        specified  for an immediate printing, the metacode file is deleted after
        print completion, otherwise it is kept.

Subsections

- HARDCOPY /DEVICE
- HARDCOPY /FITPAGE
- HARDCOPY /GEOMETRY
- HARDCOPY /OVERWRITE