home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / Converter / PTC-AEAO.LZX / AddOn.lha / POST / GPlot / gplot.hlp < prev    next >
Encoding:
Text File  |  1996-07-06  |  12.4 KB  |  424 lines
  1. 1 GPLOT
  2.  
  3.  
  4. GPLOT is a graphics utility program, designed for the processing of CGM
  5. metafiles produced by DI3000, DISSPLA, DRAWCGM and NCARGKS.  Source code
  6. for GPLOT is avilable to other sites, so that graphics created at
  7. PSC can be processed locally.
  8.  
  9. Note that the current version of GPLOT is able to recognize NCAR CGM
  10. metafiles created on the Cray, and automatically carry out the byte-swapping 
  11. necessary to properly interpret such files.  In other words, you should no 
  12. longer have to worry about running the NCARFIX program on your file before
  13. using GPLOT.
  14.  
  15. Graphics images produced by GPLOT can be combined with TEX formatted
  16. text by the GTEX program.  See PSCDOC:GTEX.DOC and TEX.DOC.
  17.  
  18. To report problems with GPLOT, or to request new output capabilities,
  19. please contact PSC User Services.
  20.  
  21. Version:         4.3
  22.  
  23. VMS help:        HELP GPLOT
  24.                  BULLETIN GPLOT to read bulletin board announcements.
  25.  
  26. VMS examples:    DOC$ROOT1:[EXAMPLES.GPLOT]
  27.                  CGM.DAT, CGM.PS, CGMTOPS.COM, CGMTOTEK.COM
  28.  
  29. VMS document:    PSCDOC:GPLOT.DOC 
  30.  
  31. VMS source:      Source code for the individual C modules, the executable
  32.                  code, and COM files for installation and testing are
  33.                  available in TEX$ROOT:[GPLOT].
  34.  
  35. VMS usage:       GPLOT metafile/qualifiers
  36.                  GPLOT/DEV=PS MYFILE.CGM  for PostScript output, or
  37.                  GPLOT/SCREEN=4010 MYFILE.CGM for Tektronix.
  38.  
  39. COS document:    ATTACH,DN=INPUT,PDN=GPLOT,ID=PSCDOC.
  40.  
  41. COS usage:       none
  42.  
  43. UNICOS document: /usr/local/doc/gplot.doc
  44.  
  45. UNICOS examples: /usr/local/examples/gplot/
  46.                  cgm.dat, cgmtops, screen.inst
  47.  
  48. UNICOS usage:    gplot -dps myfile.cgm > myfile.ps    (for PostScript output)
  49.                  gplot -s myfile.cgm                  (for Tektronix output)
  50.                  gplot -stek4010 myfile.cgm      (To specify Tektronix 4010)
  51.  
  52. Supplier:        Phil Andrews, PSC
  53.  
  54. PSC contact:     Phil Andrews or Anjana Kar
  55.  
  56.  
  57. Command Format:
  58.   GPLOT metafile/qualifiers
  59.  
  60.  
  61. GPLOT will try the default extension .CGM for a binary format metafile 
  62. name and .CGMC for a clear text metafile if no extension is given for 
  63. the metafile name.
  64.  
  65. The qualifiers can be used to select other than default values for the
  66. graph size, number of copies, particular pages, etc.
  67.  
  68.  
  69. 2 Local_information
  70.  
  71.  
  72. GPLOT is available on the VMS front ends, and on UNICOS.  Users have the
  73. following options:
  74.  
  75.   Create a metafile on UNICOS, view it there.
  76.   Create a metafile on UNICOS, transfer if to VMS, and view it.
  77.   Create a metafile on VMS, view it there.
  78.  
  79.   Create a metafile on UNICOS/VMS, transfer it to the user's home
  80.   site, and use a local copy of GPLOT to view it.  Contact PSC User
  81.   Services for information on getting a copy of GPLOT.
  82.  
  83. There is a bulletin board for GPLOT.  Announcements, bug reports and
  84. so on will often appear there.  To access this information once,
  85. type "BULLETIN", "SELECT GPLOT" and then "READ".  Type "EXIT"
  86. when you are done.  To find out how to be automatically notified
  87. when new information is put into the GPLOT bulletin board, refer
  88. to PSCDOC:BULLETIN.DOC.
  89.  
  90. 2 /CLEAR_TEXT
  91.   Tells GPLOT to expect a clear text metafile rather than binary format.
  92.  
  93. 2 /COPIES
  94.  
  95.   Format:
  96.     GPLOT metafile_name/COPIES=number
  97.  
  98.   If the output device supports a hardware multiple copies command, this
  99.   will be invoked.
  100.  
  101. 2 /DEBUG
  102.  
  103.   Tells GPLOT to display informational messages, most useful if you are
  104.   reporting a bug.
  105.  
  106. 2 /DEGREES
  107.  
  108.   Format:
  109.     GPLOT metafile_name/DEGREES=number
  110.  
  111.   Tells GPLOT to rotate the image the specified number of degrees
  112.   counter clockwise from its default orientation. If /DEGREES is not
  113.   specified GPLOT will try to guess the best orientation based on the
  114.   aspect ratios of the metafile bounding box and the output page. You
  115.   may wish to override this. Also, if firmware fonts are
  116.   used, they may not be available in the orientation chosen by GPLOT (or
  117.   by you, for that matter).
  118.  
  119. 2 /DEVICE 
  120.  
  121.   Format:
  122.     GPLOT metafile_name/DEVICE=device_name 
  123.  
  124.   The present possible devices are:
  125.  
  126.     CGMB           (outputs a CGM binary file)
  127.     CGMC           (outputs a clear text CGM file)
  128.     GKS                (make Graphical Kernel System calls)
  129.     PERITEK            (A color frame buffer device) 
  130.     PS                 (PostScript)
  131.     PSC                (Color Postscript)
  132.     SV               (SUN SPARCSTATION - Sunview driver)
  133.     SUN               (SUN workstation)
  134.     SUNBW           (Monochrome SUN workstation)
  135.     tek4010            (Tektronix 4010 format) 
  136.     tek4014            (Tektronix 4014 format) 
  137.     tek4207            (Tektronix 4207 format) 
  138.     UIS                (DEC's windowing system for VaxStations)
  139.     XL                 (XLib driver - Beta test version)
  140.     XWS               (X11 window workstation)  
  141.  
  142.  
  143. 2 /DIAQUEST
  144.  
  145.   Format:
  146.     GPLOT metafile_name/DIAQUEST=device_name
  147.  
  148.   Tells GPLOT that it is feeding images to a remotely controlled editing
  149.   VCR (VTR) using a Diaquest controller connected to the specified
  150.   device.
  151.  
  152. 2 /LVR
  153.  
  154.   Format:
  155.     GPLOT metafile_name/LVR=device_name
  156.  
  157.   Tells GPLOT that it is feeding images to a Laser Videodisk Recorder
  158.   connected to the specified device.
  159.  
  160. 2 /FONT_TYPE
  161.  
  162.   Format:
  163.     GPLOT metafile_name/FONT_TYPE=number
  164.  
  165.   The number can be 0 (use all device fonts), 1 (use Hersehy vector
  166.   fonts, if loaded), or 2 (use PK raster fonts, if loaded).  
  167.  
  168.  
  169. 2 /INCLUDED
  170.  
  171.   Tells GPLOT that its ouput is being included in another file. This 
  172.   option is normally only used by GTEX when it is calling GPLOT to include 
  173.   a frame in the output.
  174.  
  175. 2 /INDEX
  176.  
  177.   If indexing blocks are present in the CGM file GPLOT will print out a
  178.   short table of contents with the position of each picture and its
  179.   title (if any).
  180.  
  181. 2 /LIST 
  182.  
  183.   GPLOT will create a listing file showing its interpretation of the CGM
  184.   metafile. This is most useful if you are reporting a bug.   /LIST will
  185.   cause the debug output to go to the listing file. 
  186.  
  187. 2 /NINDEX
  188.  
  189.   Tells GPLOT to ignore any indexing blocks on input and not to produce
  190.   any on output.
  191.  
  192. 2 /PAGES
  193.  
  194.   Tells GPLOT to select individual pages (no re-ordering), e.g.,
  195.  
  196.     GPLOT FOO/PAGES="-1,2,5,7_9,-10_-5" 
  197.     or
  198.     GPLOT FOO/PAGES=(-1,2,5,7_9,-10_-5)
  199.  
  200.   The above page string means do pages -1, 2, 5, 7 thru 9 and -10 thru -5.
  201.   Negative pages are normally only allowed in TeX output DVI files.
  202.  
  203. 2 /PXL_PER_IN
  204.  
  205.   Format:
  206.     GPLOT metafile_name/PXL_PER_IN=number
  207.  
  208.   Tells GPLOT the resolution of the output device in pixels per inch.
  209.   GPLOT has a table of values for each output device, but this option
  210.   allows you to override the default.
  211.  
  212. 2 /TITLE_STRING
  213.  
  214.   Format:
  215.     GPLOT metafile_name/TITLE="Page Title"
  216.  
  217.   When the CGM file included indexing blocks this will allow GPLOT to 
  218.   pick out only those pictures that contain the string argument to
  219.   /TITLE in their title. No reordering is done.
  220.  
  221. 2 /SCALE
  222.  
  223.   Format:
  224.     GPLOT metafile_name/SCALE
  225.  
  226.   Ignore any metric scaling mode elements and alwyas scale to fit the
  227.   output device.
  228.  
  229. 2 /SCREEN
  230.  
  231.   Format:
  232.     GPLOT metafile_name/SCREEN=screen_type
  233.  
  234.   The difference between /dev and /scre for similar devices is that
  235.   /screen implies /tty, that is, that GPLOT is running interactively,
  236.   and output will go to the screen.
  237.  
  238. 2 /START
  239.  
  240.   Format:
  241.     GPLOT metafile_name/START=number
  242.  
  243.   Will begin the output at that number frame on an editing VTR. Useful
  244.   for combining sequences of images on a VTR.
  245.  
  246. 2 /TEXT_MAG
  247.  
  248.   Format:
  249.     GPLOT metafile_name/TEXT_MAG=number
  250.  
  251.   GPLOT will magnify any text size by this (real) number.
  252.     
  253. 2 /TTY
  254.  
  255.   Tells GPLOT that the controlling device is a terminal. GPLOT will beep
  256.   the terminal at the end of a page and wait for some response before
  257.   proceeding. This is the default behavior when /SCREEN in specified. 
  258.   Informations messages are also diverted to a file with extension .LIS.
  259.  
  260. 2 /X_OFFSET
  261.  
  262.   Format:
  263.     GPLOT metafile_name/X_OFFSET=number
  264.  
  265.   Moves the origin in the x direction by the specified amount in inches.
  266.  
  267. 2 /X_SIZE
  268.  
  269.   Format:
  270.     GPLOT metafile_name/X_SIZE=number
  271.  
  272.   Overides the default page width (in inches) for the output device
  273.   used.
  274.  
  275. 2 /Y_OFFSET
  276.  
  277.   Format:
  278.     GPLOT metafile_name/Y_OFFSET=number
  279.  
  280.   Moves the origin in the y direction by the specified amount in inches.
  281.  
  282. 2 /Y_SIZE
  283.  
  284.   Format:
  285.     GPLOT metafile_name/Y_SIZE=number
  286.  
  287.   Overides the default page height (in inches) for the output device used.
  288.  
  289. 2 UNIX
  290.  
  291.  The following is a UNIX man page for GPLOT
  292.  
  293.  
  294.                                                          gplot(1)
  295.  
  296.  
  297.  
  298. NAME
  299.      gplot - graphics utility for the processing of CGM metafiles
  300.  
  301. SYNTAX
  302.      gplot [options] metafile [outfile]
  303.  
  304. DESCRIPTION
  305.      The gplot command translates a CGM metafile into input for a
  306.      graphics device.  The input is placed into the outfile and
  307.      in the absence of an outfile, it is sent to the stdout.
  308.  
  309. OPTIONS
  310.      The following flags are interpreted by gplot.
  311.  
  312.      -bn  Specifies the starting frame to be number n for
  313.           addressable output media like videotape.
  314.  
  315.      -cn  If the output device supports a hardware multiple
  316.           copies command, gplot will produce n copies.
  317.  
  318.      -dd  Specifies that the output is for device, d.  
  319.       See Restrictions section for a list of acceptable devices.
  320.  
  321.      -C   Specifies the input to be a clear text format CGM file,
  322.           default is a binary format.
  323.  
  324.      -fn  Use font type n, (0 device fonts) (1 Hershey fonts)
  325.           (2 PK raster fonts)
  326.  
  327.      -i   The output is to be used in another file.  This option
  328.           is normally only used by GTEX when it is calling gplot
  329.           to include a frame in the output.
  330.  
  331.      -l   Creates a listing file showing its interpretation of
  332.           the CGM metafile.
  333.  
  334.      -mn  Magnify the text by n.
  335.  
  336.      -pn  Tells gplot to select individual pages, n.  n can be
  337.           individual pages, multiple page numbers separated by
  338.           commas or a range, e.g. 79.
  339.  
  340.      -rn  Rotate the image the specified number of degrees, n,
  341.           counter clockwise from its default orientation.
  342.  
  343.      -sd  Synonymous with -dd -t
  344.           See Restrictions section for a list of acceptable dev-
  345.           ices.
  346.  
  347.      -t   Specifies that the controlling device is a terminal.
  348.           Gplot will beep at the end of a page and pause awaiting
  349.           a response.  This option is implied by the -s option.
  350.  
  351.      -xn  Moves the origin in the x direction by the specified
  352.           amount, n, in inches.  n is a real number.
  353.  
  354.      -yn  Moves the origin in the y direction by the specified
  355.           amount, n, in inches.  n is a real number.
  356.  
  357.      -D   Displays informational messages.  Useful for debugging
  358.           purposes.
  359.  
  360.      -I   If indexing blocks are present gplot will display a short
  361.           table of contents.
  362.  
  363.      -N   Tells GPLOT to ignore indexing blocks on input, not to
  364.           produce them on output.
  365.  
  366.      -Pn  Overrides the default pixels per inch settings.  The
  367.           resolution of the output device is set to n pixels per
  368.           inch.
  369.  
  370.      -S      Ignore metric scaling and scale image to fit device.
  371.  
  372.      -Tt  Where t is a string displays only those pictures which have 
  373.           t in the title.
  374.  
  375.      -Xn  Overrides the default page width in inches for the out-
  376.           put device.  The new page width is set to n which is a
  377.           real number.
  378.  
  379.      -Yn  Overrides the default page height in inches for the
  380.           output device.  The new page height is set to n which
  381.           is a real number.
  382.  
  383. RESTRICTIONS
  384.      The present devices currently recognized by gplot are:
  385.  
  386.           tek4010        Tektronix 4010 (Default)
  387.           tek4014        Tektronix 4014
  388.           tek4107        Tektronix 4107
  389.           tek4207        Tektronix 4207
  390.           PERITEK        A color frame buffer device
  391.           PS             PostScript
  392.           psc            Color Postscript
  393.           xl             Xlib driver 
  394.           XWS            X11
  395.           sv             Sun Sparcstation - Sunview driver
  396.           sun            Color Sun
  397.           sunbw          Monochrome Sun
  398.           cgmb           Binary format CGM file
  399.           cgmc           Clear Text CGM file
  400.       qms         QMS laser printer
  401.       excl         EXCL based laser printer
  402.       igl         Iris GL display
  403.  
  404.      The Athena Widget library, the X Toolkit and the Xlib needs
  405.      to be present to install the xws and xl drivers.
  406.  
  407.  
  408. KNOWN BUGS
  409.      Gplot currently does not handle pattern fills on
  410.      most devices.
  411.  
  412.      X switches like -display are parsed but must not be the last
  413.      option specified.
  414.  
  415.  
  416. FILES
  417.           metafile       metafile
  418.           outfile        output file
  419.  
  420.  
  421. COPYRIGHT
  422.      gplot is copyrighted by the Pittsburgh Supercomputing
  423.      Center.
  424.