1 GPLOT GPLOT is a graphics utility program, designed for the processing of CGM metafiles produced by DI3000, DISSPLA, DRAWCGM and NCARGKS. Source code for GPLOT is avilable to other sites, so that graphics created at PSC can be processed locally. Note that the current version of GPLOT is able to recognize NCAR CGM metafiles created on the Cray, and automatically carry out the byte-swapping necessary to properly interpret such files. In other words, you should no longer have to worry about running the NCARFIX program on your file before using GPLOT. Graphics images produced by GPLOT can be combined with TEX formatted text by the GTEX program. See PSCDOC:GTEX.DOC and TEX.DOC. To report problems with GPLOT, or to request new output capabilities, please contact PSC User Services. Version: 4.23 VMS help: HELP GPLOT BULLETIN GPLOT to read bulletin board announcements. VMS examples: DOC$ROOT1:[EXAMPLES.GPLOT] CGM.DAT, CGM.PS, CGMTOPS.COM, CGMTOTEK.COM VMS document: PSCDOC:GPLOT.DOC VMS source: Source code for the individual C modules, the executable code, and COM files for installation and testing are available in TEX$ROOT:[GPLOT]. VMS usage: GPLOT metafile/qualifiers GPLOT/DEV=PS MYFILE.CGM for PostScript output, or GPLOT/SCREEN=4010 MYFILE.CGM for Tektronix. COS document: ATTACH,DN=INPUT,PDN=GPLOT,ID=PSCDOC. COS usage: none UNICOS document: /usr/local/doc/gplot.doc UNICOS examples: /usr/local/examples/gplot/ cgm.dat, cgmtops, screen.inst UNICOS usage: gplot -dps myfile.cgm > myfile.ps (for PostScript output) gplot -s myfile.cgm (for Tektronix output) gplot -stek4010 myfile.cgm (To specify Tektronix 4010) Supplier: Phil Andrews, PSC PSC contact: Phil Andrews or Joel Welling Command Format: GPLOT metafile/qualifiers GPLOT will try the default extension .CGM fora binary format metafile name and .CGMC for a clear text metafile if no extension is given for the metafile name. The qualifiers can be used to select other than default values for the graph size, number of copies, particular pages, etc. 2 Local_information GPLOT is available on the VMS front ends, and on UNICOS. Users have the following options: Create a metafile on COS, transfer it to VMS and view it. Create a metafile on UNICOS, view it there. Create a metafile on UNICOS, transfer if to VMS, and view it. Create a metafile on VMS, view it there. Create a metafile on COS/UNICOS/VMS, transfer it to the user's home site, and use a local copy of GPLOT to view it. Contact PSC User Services for information on getting a copy of GPLOT. There is a bulletin board for GPLOT. Announcements, bug reports and so on will often appear there. To access this information once, type "BULLETIN", "SELECT GPLOT" and then "READ". Type "EXIT" when you are done. To find out how to be automatically notified when new information is put into the GPLOT bulletin board, refer to PSCDOC:BULLETIN.DOC. 2 /CLEAR_TEXT Tells GPLOT to expect a clear text metafile rather than binary format. 2 /COPIES Format: GPLOT metafile_name/COPIES=number If the output device supports a hardware multiple copies command, this will be invoked. 2 /DEBUG Tells GPLOT to display informational messages, most useful if you are reporting a bug. 2 /DEGREES Format: GPLOT metafile_name/DEGREES=number Tells GPLOT to rotate the image the specified number of degrees counter clockwise from its default orientation. If /DEGREES is not specified GPLOT will try to guess the best orientation based on the aspect ratios of the metafile bounding box and the output page. You may wish to override this. Also, if firmware fonts are used, they may not be available in the orientation chosen by GPLOT (or by you, for that matter). 2 /DEVICE Format: GPLOT metafile_name/DEVICE=device_name The present possible devices are: CGMB (outputs a CGM binary file) CGMC (outputs a clear text CGM file) GKS (make Graphical Kernel System calls) PERITEK (A color frame buffer device) PS (PostScript) SV (SUN SPARCSTATION - Sunview driver) SUN (SUN workstation) SUNBW (Monochrome SUN workstation) tek4010 (Tektronix 4010 format) tek4014 (Tektronix 4014 format) tek4207 (Tektronix 4207 format) UIS (DEC's windowing system for VaxStations) XL (XLib driver - Beta test version) XWS (X11 window workstation) 2 /DIAQUEST Format: GPLOT metafile_name/DIAQUEST=device_name Tells GPLOT that it is feeding images to a remotely controlled editing VCR (VTR) using a Diaquest controller connected to the specified device. 2 /FONT_TYPE Format: GPLOT metafile_name/FONT_TYPE=number The number can be 0 (use all device fonts), 1 (use Hersehy vector fonts, if loaded), or 2 (use PK raster fonts, if loaded). 2 /INCLUDED Tells GPLOT that its ouput is being included in another file. This option is normally only used by GTEX when it is calling GPLOT to include a frame in the output. 2 /INDEX If indexing blocks are present in the CGM file GPLOT will print out a short table of contents with the position of each picture and its title (if any). 2 /LIST GPLOT will create a listing file showing its interpretation of the CGM metafile. This is most useful if you are reporting a bug. /LIST will cause the debug output to go to the listing file. 2 /NINDEX Tells GPLOT to ignore any indexing blocks on input and not to produce any on output. 2 /PAGES Tells GPLOT to select individual pages (no re-ordering), e.g., GPLOT FOO/PAGES="-1,2,5,7_9,-10_-5" or GPLOT FOO/PAGES=(-1,2,5,7_9,-10_-5) The above page string means do pages -1, 2, 5, 7 thru 9 and -10 thru -5. Negative pages are normally only allowed in TeX output DVI files. 2 /PXL_PER_IN Format: GPLOT metafile_name/PXL_PER_IN=number Tells GPLOT the resolution of the output device in pixels per inch. GPLOT has a table of values for each output device, but this option allows you to override the default. 2 /TITLE_STRING Format: GPLOT metafile_name/TITLE="Page Title" When the CGM file included indexing blocks this will allow GPLOT to pick out only those pictures that contain the string argument to /TITLE in their title. No reordering is done. 2 /SCALE Format: GPLOT metafile_name/SCALE Ignore any metric scaling mode elements and alwyas scale to fit the output device. 2 /SCREEN Format: GPLOT metafile_name/SCREEN=screen_type The difference between /dev and /scre for similar devices is that /screen implies /tty, that is, that GPLOT is running interactively, and output will go to the screen. 2 /START Format: GPLOT metafile_name/START=number Will begin the output at that number frame on an editing VTR. Useful for combining sequences of images on a VTR. 2 /TEXT_MAG Format: GPLOT metafile_name/TEXT_MAG=number GPLOT will magnify any text size by this (real) number. 2 /TTY Tells GPLOT that the controlling device is a terminal. GPLOT will beep the terminal at the end of a page and wait for some response before proceeding. This is the default behavior when /SCREEN in specified. Informations messages are also diverted to a file with extension .LIS. 2 /X_OFFSET Format: GPLOT metafile_name/X_OFFSET=number Moves the origin in the x direction by the specified amount in inches. 2 /X_SIZE Format: GPLOT metafile_name/X_SIZE=number Overides the default page width (in inches) for the output device used. 2 /Y_OFFSET Format: GPLOT metafile_name/Y_OFFSET=number Moves the origin in the y direction by the specified amount in inches. 2 /Y_SIZE Format: GPLOT metafile_name/Y_SIZE=number Overides the default page height (in inches) for the output device used. 2 UNIX The following is a UNIX man page for GPLOT gplot(1) NAME gplot - graphics utility for the processing of CGM metafiles SYNTAX gplot [options] metafile [outfile] DESCRIPTION The gplot command translates a CGM metafile into input for a graphics device. The input is placed into the outfile and in the absence of an outfile, it is sent to the stdout. OPTIONS The following flags are interpreted by gplot. -bn Specifies the starting frame to be number n for addressable output media like videotape. -cn If the output device supports a hardware multiple copies command, gplot will produce n copies. -dd Specifies that the output is for device, d. See Restrictions section for a list of acceptable devices. -C Specifies the input to be a clear text format CGM file, default is a binary format. -fn Use font type n, (0 device fonts) (1 Hershey fonts) (2 PK raster fonts) -i The output is to be used in another file. This option is normally only used by GTEX when it is calling gplot to include a frame in the output. -l Creates a listing file showing its interpretation of the CGM metafile. -mn Magnify the text by n. -pn Tells gplot to select individual pages, n. n can be individual pages, multiple page numbers separated by commas or a range, e.g. 79. -rn Rotate the image the specified number of degrees, n, counter clockwise from its default orientation. -sd Synonymous with -dd -t See Restrictions section for a list of acceptable dev- ices. -t Specifies that the controlling device is a terminal. Gplot will beep at the end of a page and pause awaiting a response. This option is implied by the -s option. -xn Moves the origin in the x direction by the specified amount, n, in inches. n is a real number. -yn Moves the origin in the y direction by the specified amount, n, in inches. n is a real number. -D Displays informational messages. Useful for debugging purposes. -I If indexing blocks are present gplot will display a short table of contents. -N Tells GPLOT to ignore indexing blocks on input, not to produce them on output. -Pn Overrides the default pixels per inch settings. The resolution of the output device is set to n pixels per inch. -S Ignore metric scaling and scale image to fit device. -Tt Where t is a string displays only those pictures which have t in the title. -Xn Overrides the default page width in inches for the out- put device. The new page width is set to n which is a real number. -Yn Overrides the default page height in inches for the output device. The new page height is set to n which is a real number. RESTRICTIONS The present devices currently recognized by gplot are: tek4010 Tektronix 4010 (Default) tek4014 Tektronix 4014 tek4107 Tektronix 4107 tek4207 Tektronix 4207 PERITEK A color frame buffer device PS PostScript xl Xlib driver - Beta test version XWS X11 sv Sun Sparcstation - Sunview driver sun Color Sun sunbw Monochrome Sun cgmb Binary format CGM file cgmc Clear Text CGM file qms QMS laser printer excl EXCL based laser printer igl Iris GL display The Athena Widget library, the X Toolkit and the Xlib needs to be present to install Gplot. KNOWN BUGS Gplot currently does not handle pattern fills on most devices. X switches like -display are parsed but must not be the last option specified. FILES metafile metafile outfile output file COPYRIGHT gplot is copyrighted by the Pittsburgh Supercomputing Center.