1 GTEX GTEX is a text processing/graphics utility, primarily designed for the processing of DVI files produced by TeX and the manipulation of CGM metafiles produced by NCAR, DI3000, DISSPLA, etc. For information on the production of these metafiles or to report problems with GPLOT call User Services or send mail to REMARKS. Please also contact User Services with any suggestions for increased capabilities or extra supported devices. Format: GTEX dvifile_name/qualifiers GTEX will try the default extension .DVI for the dvifile name if you have not specified the extension. The qualifiers can be used to select other than default values for the page size, number of copies, particular pages, etc. 2 Local_Information GTEX is available only on the VMS front ends at the Pittsburgh Supercomputing Center. Users who would like to see GTEX installed on their own local systems may request a copy of the GTEX source. However, GTEX requires that TeX be installed as well. TeX is freely available, but requires a knowledgeable person to install properly. Information on GTEX is available in the file PSCDOC:GTEX.DOC, and will soon be available via the VMS command "HELP GTEX". There is also a bulletin board for GTEX which contains announcements, bug reports and so on. To read through this bulletin board, type "BULLETIN", "SELECT GTEX", "READ", and then when you are done type "EXIT". Read the document PSCDOC:BULLETIN.DOC if you wish to be automatically informed when new items are placed on the GTEX bulletin board. 2 /COPIES Format: GTEX dvifile_name/COPIES=number If the output device supports a hardware multiple copies command, this will be invoked. 2 /DEBUG Tells GTEX to display informational messages, most useful if you are reporting a bug. 2 /DEGREES Format: GTEX dvifile_name/DEGREES=number Tells GTEX to rotate the image the specified number of degrees counter clockwise from its default orientation. If /DEGREES is not specified GTEX will try to guess the best orientation based on the aspect ratios of the dvifile bounding box and the output page. You may wish to override this, e.g, when driving a Tektronix screen you may not wish the image to be on its side. Also, if firmware fonts are used, they may not be available in the orientation chosen by GTEX (or by you, for that matter). 2 /DEVICE Format: GTEX dvifile_name/DEVICE=device_name The present possible devices are: 4010 (Tektronix 4010 format) 4014 (Tektronix 4014 format) 4207 (Tektronix 4207 format) 4510 (Tektronix 4510 format) APS (APS phototypesetter) GKS (make Graphical Kernel System calls) IMPRESS (impress commands for an IMAGEN device) PERITEK (A color frame buffer device) PS (PostScript) QMS800 (quic commands for a QMS800) QMS1200 (quic commands for a QMS1200) QMS2400 (quic commands for a QMS2400) 2 /DIAQUEST Format: GTEX dvifile_name/DIAQUEST=device_name Tells GTEX that it is feeding images to a remotely controlled editing VCR (VTR) using a Diaquest controller connected to the specified device. 2 /PAGES Tells GTEX to select individual pages (no re-ordering), e.g., GTEX FOO/PAGES="-1,2,5,7_9,-10_-5" or GTEX 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: GTEX dvifile_name/PXL_PER_IN=number Tells GTEX the resolution of the output device in pixels per inch. GTEX has a table of values for each output device, but this option allows you to override the default. 2 /SCREEN Format: GTEX dvifile_name/SCREEN=screen_type The present possible screen types are: 4010 (Tektronix 4010, default) 4014 (Tektronix 4014) 4207 (Tektronix 4207) GKS (GKS system) The difference between /dev and /scre for similar devices is that /screen implies /tty, that is, interactive usage of GTEX. 2 /START Format: GTEX dvifile_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 /TTY Tells GTEX that the controlling device is a terminal. GTEX 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. Informational messages are also diverted to a .lis file. 2 /X_OFFSET Format: GTEX dvifile_name/X_OFFSET=number Moves the origin in the x direction by the specified amount in inches. 2 /X_SIZE Format: GTEX dvifile_name/X_SIZE=number Overides the default page width (in inches) for the output device used. 2 /Y_OFFSET Format: GTEX dvifile_name/Y_OFFSET=number Moves the origin in the y direction by the specified amount in inches. 2 /Y_SIZE Format: GTEX dvifile_name/Y_SIZE=number Overides the default page height (in inches) for the output device used. 2 Special_Commands GTEX supports several special commands. These commands are extensions to the normal TeX syntax and are very device driver dependent. Easily the most interesting one involves the inclusion of externally generated graphics. 3 GPLOT Format \special{gplot gplot_directives} Gplot is a CGM file processor. Any graphics images encoded in a CGM file can be included in the output stream. For example, \special{gplot foo/page=3/x_size=3/y_size=3} will include the third frame from the computer graphics metafile foo.cgm, scale it to fit within a 3 inch by 3 inch square and position it with the location of the \special command at the origin. There are a plethora of GPLOT commands. Consult the GPLOT help file or the hardcopy PSCDOC:GPLOT.DOC for more information. 3 include-string Format \special{include-string string_to_be_included} Everything inside the \special command after the include-string plus one space is included in the output string. 3 escape-string Format \special{escape-string string_to_be_included} Everything inside the \special command after the escape-string plus one space is included in the output string, and is preceded by an escape character (octal code 33).