next up previous contents index
Next: HARDCOPY /DEVICE Up: GTVL Language Internal Help Previous: GTV   Contents   Index


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

Gildas manager 2020-09-28