home *** CD-ROM | disk | FTP | other *** search
/ Freelog 121 / FreelogMagazineJuilletAout2014-No121.iso / Bureautique / Scribus / GhostscriptPortable_9.14.paf.exe / doc / gs-vms.hlp < prev    next >
Text File  |  2014-03-26  |  11KB  |  293 lines
  1. 1 gs
  2.  gs - GPL Ghostscript interpreter/previewer
  3. ! Ghostscript version 9.14, 26 March 2014
  4.   Usage:
  5.    $ gs [options] [file ...]
  6.  
  7.  Ghostscript is an implementation of Adobe Systems' PostScript (tm)
  8.  and Portable Document Format (PDF) languages. Gs reads files in sequence
  9.  and executes them as Ghostscript programs. After doing this, it reads
  10.  further input from the standard input stream (normally the keyboard).
  11.  Each line is interpreted separately. To exit from the interpreter,
  12.  enter the `quit' command. The interpreter also exits gracefully if it
  13.  encounters end-of-file. Typing the interrupt character (e.g. Control-C)
  14.  is also safe.
  15.  
  16. 2 Description
  17.  The interpreter recognizes several switches described below, which
  18.  may appear anywhere in the command line and apply to all files
  19.  thereafter.
  20.  
  21.  You can get a help message by invoking Ghostscript with the -h
  22.  or -? option. This message also lists the available devices.
  23.  
  24.  Ghostscript may be built with multiple output devices. Ghostscript
  25.  normally opens the first one and directs output to it. To use
  26.  device xyz as the initial output device, include the switch
  27.      "-sDEVICE=xyz"
  28.  in the command line.  Note that this switch must precede the first
  29.  .ps file, and only its first invocation has any effect. For example,
  30.  for printer output in a normal configuration that includes an Epson
  31.  printer driver, you might use the command
  32.       gs "-sDEVICE=epson" myfile.ps
  33.  instead of just
  34.       gs myfile.ps
  35.  Alternatively, you can type
  36.       (epson) selectdevice
  37.       (myfile.ps) run
  38.  All output then goes to the printer instead of the display until
  39.  further notice. You can switch devices at any time by using the
  40.  selectdevice procedure, e.g.,
  41.       (vga) selectdevice
  42.  or
  43.       (epson) selectdevice
  44.  As yet a third alternative, you can define a logical name GS_DEVICE
  45.  as the desired default device name.  The order of precedence for these
  46.  alternatives, highest to lowest, is:
  47.       selectdevice
  48.       (command line)
  49.       GS_DEVICE
  50.       (first device in build list)
  51.  
  52.  To select the density on a printer, use
  53.       gs "-sDEVICE=<device>" -r<xres>x<yres>
  54.  For example, on a 9-pin Epson-compatible printer, you can get the
  55.  lowest-density (fastest) mode with
  56.       gs "-sDEVICE=epson" -r60x72
  57.  and the highest-density mode with
  58.       gs "-sDEVICE=epson" -r240x72.
  59.  
  60.  If you select a printer as the output device, Ghostscript also
  61.  allows you to control where the device sends its output.  Normally,
  62.  output goes directly to a scratch file on Unix and VMS systems. To
  63.  send the output to a series of files foo1.xyz, foo2.xyz, ..., use
  64.  the switch
  65.       "-sOutputFile=foo%d.xyz"
  66.  The %d is a printf format specification; you can use other formats
  67.  like %02d.  Each file will receive one page of output. Alternatively,
  68.  to send the output to a single file foo.xyz, with all the pages con-
  69.  catenated, use the switch
  70.       "-sOutputFile=foo.xyz"
  71.  
  72.  To find out what devices are available, type
  73.       devicenames ==
  74.  after starting up Ghostscript. Alternatively, you can use the -h or -?
  75.  switch in the command line; the help message also lists the available
  76.  devices.
  77.  
  78.  To select a different paper size, use the command line switch
  79.       "-sPAPERSIZE=a_known_paper_size"
  80.  e.g.,
  81.       "-sPAPERSIZE=a4"
  82.  or
  83.       "-sPAPERSIZE=legal"
  84.  
  85.   As of this printing, the known paper sizes, defined in gs_statd.ps, are:
  86.  
  87.   PAPERSIZE    X"         Y"         X cm      Y cm
  88.   ____________________________________________________
  89.   11x17        11"        17"        27.94     43.18
  90.   a0           33.0556"   46.7778"   83.9611   118.816
  91.   a10          1.02778"   1.45833"   2.61056   3.70417
  92.   a1           23.3889"   33.0556"   59.4078   83.9611
  93.   a2           16.5278"   23.3889"   41.9806   59.4078
  94.   a3           11.6944"   16.5278"   29.7039   41.9806
  95.   a4           8.26389"   11.6944"   20.9903   29.7039
  96.   a5           5.84722"   8.26389"   14.8519   20.9903
  97.   a6           4.125"     5.84722"   10.4775   14.8519
  98.   a7           2.91667"   4.125"     7.40833   10.4775
  99.   a8           2.05556"   2.91667"   5.22111   7.40833
  100.   a9           1.45833"   2.05556"   3.70417   5.22111
  101.   archA        9"         12"        22.86     30.48
  102.   archB        12"        18"        30.48     45.72
  103.   archC        18"        24"        45.72     60.96
  104.   archD        24"        36"        60.96     91.44
  105.   archE        36"        48"        91.44     121.92
  106.   b0           39.3889"   55.6667"   100.048   141.393
  107.   b1           27.8333"   39.3889"   70.6967   100.048
  108.   b2           19.6944"   27.8333"   50.0239   70.6967
  109.   b3           13.9167"   19.6944"   35.3483   50.0239
  110.   b4           9.84722"   13.9167"   25.0119   35.3483
  111.   b5           6.95833"   9.84722"   17.6742   25.0119
  112.   flsa         8.5"       13"        21.59     33.02
  113.   flse         8.5"       13"        21.59     33.02
  114.   halfletter   5.5"       8.5"       13.97     21.59
  115.   ledger       17"        11"        43.18     27.94
  116.   legal        8.5"       14"        21.59     35.56
  117.   letter       8.5"       11"        21.59     27.94
  118.   note         7.5"       10"        19.05     25.4
  119.  
  120.   Note that the B paper sizes are ISO sizes: for information about using
  121.   JIS B sizes, see `Use.htm'.
  122.  
  123. 2 Initialization_files
  124.  When looking for the initialization files (gs_*.ps), the files related
  125.  to fonts, or the file for the `run' operator, Ghostscript first tries
  126.  opening the file with the name as given (i.e., using the current
  127.  working directory if none is specified).  If this fails, and the file
  128.  name doesn't specify an explicit directory or drive, Ghostscript will
  129.  try directories in the following order:
  130.  
  131.  1. The directory/ies specified by the -I switch(es) in the command
  132.     line (see below), if any;
  133.  2. The directory/ies specified by the GS_LIB logical, if any;
  134.  3. The directory/ies specified by the GS_LIB_DEFAULT macro in the
  135.     Ghostscript makefile.
  136.  
  137.  Each of these (GS_LIB_DEFAULT, GS_LIB, and -I parameter) may be either
  138.  a single directory, or a list of directories separated by a `:'.
  139.  
  140. 2 X_resources
  141.  Ghostscript looks for the following resources under the program name
  142.  `Ghostscript':
  143.  
  144.  borderWidth
  145.   The border width in pixels (default = 1).
  146.  
  147.  borderColor
  148.   The name of the border color (default = black).
  149.  
  150.  geometry 
  151.   The window size and placement, WxH+X+Y (default is NULL).
  152.  
  153.  xResolution 
  154.   The number of x pixels per inch (default is computed from
  155.   WidthOfScreen and WidthMMOfScreen).
  156.  
  157.  yResolution
  158.   The number of y pixels per inch (default is computed from
  159.   HeightOfScreen and HeightMMOfScreen).
  160.  
  161.  useBackingPixmap
  162.   Determines whether backing store is to be used for saving display
  163.   window (default = true).
  164.  
  165.  See the file `Use.htm' for a more complete list of resources.
  166.  
  167.  To set these resources, put them in a file (such as
  168.  SYS$Login:ghostscript.dat) in the following form:
  169.  
  170.       Ghostscript*geometry:    612x792-0+0
  171.       Ghostscript*xResolution: 72
  172.       Ghostscript*yResolution: 72
  173.  
  174. 2 Options
  175.  Note that VMS will convert all command line arguments to lower case
  176.  if they are not within quotes. Therefore, if a certain command does
  177.  not work, try again but with quotes around it.
  178.  
  179.   --  filename arg1 ...
  180.  Takes the next argument as a file name as usual, but takes all
  181.  remaining arguments (even if they have the syntactic form of switches)
  182.  and defines the name ARGUMENTS in userdict (not systemdict) as an
  183.  array of those strings, before running the file.  When Ghostscript
  184.  finishes executing the file, it exits.
  185.  
  186.   -Dname=token
  187.   -dname=token
  188.  Define a name in systemdict with the given definition.  The token must
  189.  be exactly one token (as defined by the `token' operator) and must not
  190.  contain any whitespace.
  191.  
  192.   -Dname
  193.   -dname 
  194.  Define a name in systemdict with value=null.
  195.  
  196.   -Sname=string
  197.   -sname=string
  198.  Define a name in systemdict with a given string as value.  This is
  199.  different from -d.  For example, -dname=35 is equivalent to the
  200.  program fragment
  201.       /name 35 def 
  202.  whereas -sname=35 is equivalent to
  203.       /name (35) def
  204.  
  205.   -q
  206.  Quiet startup - suppress normal startup messages, and also do the
  207.  equivalent of -dQUIET.
  208.  
  209.   -gnumber1Xnumber2
  210.  Equivalent to -dDEVICEWIDTH=number1 and -dDEVICEHEIGHT=number2. This is
  211.  for the benefit of devices (such as X11 windows) that require (or allow)
  212.  width and height to be specified.
  213.  
  214.   -rnumber
  215.   -rnumber1Xnumber2
  216.  Equivalent to -dDEVICEXRESOLUTION=number1 and -dDEVICEYRESOLUTION=number2
  217.  This is for the benefit of devices (such as printers) that support
  218.  multiple X and Y resolutions. (If only one number is given, it is used
  219.  for both X and Y resolutions.)
  220.  
  221.   -Idirectories
  222.  Adds the designated list of directories at the head of the search path
  223.  for library files.
  224.  
  225.  Note that gs_init.ps makes systemdict read-only, so the values of names
  226.  defined with -D/d/S/s cannot be changed (although, of course, they can
  227.  be superseded by definitions in userdict or other dictionaries.)
  228.  
  229. 2 Special_names
  230.  
  231.   -dDISKFONTS
  232.  Causes individual character outlines to be loaded from the disk the
  233.  first time they are encountered.  (Normally Ghostscript loads all the
  234.  character outlines when it loads a font.)  This may allow loading more
  235.  fonts into RAM, at the expense of slower rendering.
  236.  
  237.   -dNOCACHE
  238.  Disables character caching.  Only useful for debugging.
  239.  
  240.   -dNOBIND
  241.  Disables the `bind' operator.  Only useful for debugging.
  242.  
  243.   -dNODISPLAY
  244.  Suppresses the normal initialization of the output device. This may be
  245.  useful when debugging.
  246.  
  247.   -dNOPAUSE
  248.  Disables the prompt and pause at the end of each page. This may be
  249.  desirable for applications where another program is `driving'
  250.  Ghostscript.
  251.  
  252.   -dNOPLATFONTS
  253.  Disables the use of fonts supplied by the underlying platform (e.g.
  254.  X Windows).  This may be needed if the platform fonts look undesirably
  255.  different from the scalable fonts.
  256.  
  257.   -dSAFER
  258.  Disables the deletefile and renamefile operators, and the ability to
  259.  open files in any mode other than read-only.  This may be desirable
  260.  for spoolers or other sensitive environments.
  261.  
  262.   -dWRITESYSTEMDICT
  263.  Leaves systemdict writable.  This is necessary when running special
  264.  utility programs such as font2c and pcharstr, which must bypass normal
  265.  PostScript access protection.
  266.  
  267.   -sDEVICE=device
  268.  Selects an alternate initial output device, as described above.
  269.  
  270.   -sOutputFile=filename
  271.  Selects an alternate output file for the initial output device, as
  272.  described above.
  273.  
  274. 2 Files
  275. !!! Change
  276.  GS_Root:[Ghostscript.gs4_0]
  277.  Startup-files, utilities, and basic font definitions.
  278.  
  279.  GS_Root:[Ghostscript.Fonts4_0]
  280.  Additional font definitions.
  281.  
  282.  GS_Root:[Ghostscript.gs4_0.Examples]
  283.  Demo Ghostscript files.
  284.  
  285.  GS_Root:[Ghostscript.gs4_0.Doc]
  286.  Assorted document files.
  287. !!! Change
  288. 2 See_also
  289.  The various Ghostscript document files (above).
  290.  
  291. 2 Bugs
  292.  See the network news group comp.lang.postscript.
  293.