.chapter Generating Presentation Viewgraphs Using TVG .IF NBI .RM70 .LM0 .NOJUSTIFY .ENDIF NBI .IFNOT NBI .RM72 .LM5 .ENDIF NBI .NO HEADER .HEADERS ON .STHL ,0 .AP TVG (Tektronix Viewgraph Generator) may be used to generate presentation quality viewgraphs on Tektronix 4014 terminals. TVG may be used both on Tektronix 4014 terminals and Digital VT240 terminals in 4014 emulation mode. Unfortunately, VT240 graphics in Tek 4014 emulation mode is rather slow, so serious use of TVG (picking and moving text around) is more easily done on a real 4014. Also, the Tektronix 4014 resolution is significantly higher than the VT240, so 4014's should be used for producing the final viewgraph copies. To simplify the creation of simple viewgraphs for processing by TVG, the Graphics Workstation Viewgraph option provides a subsequent "Design" choice which allows users to very rapidly generate a series of proto-type viewgraphs on VT100 compatible terminals. This facility (TVG Maker) will be discussed later. TVG is accessed either by defining it as a foreign command .lit $ TVG:=$SYS$UTILITY:TVG .END LIT or activating it via the UTL command (UTL TVG), or it is available from the VPW Graphics Workstation menu by selecting Viewgraph as the choice. If the terminal is a Tektronix 4014 terminal, TVG is directly invoked. However, if the terminal is a VT240 (or VT100 compatible), the Viewgraph Menu appears. If you are using a VT240 terminal, selecting the Generate choice, invokes TVG interactively. When TVG is invoked, it tries to determine the type of terminal on which it is running. If the terminal is a VT240, TVG first issues a command for it to emulate a Tektronix 4014 terminal. Then when TVG exits normally, it returns the terminal to normal VT100-like behavior. It is also possible to force an exit from TVG via a Ctrl-Y. In this event, a VT240 is not automatically restored to VT100 mode unless TVG was invoked from the Graphics Workstation menu (which traps the ctrl-Y, and resets the terminal). In the event the terminal is left in 4014 emulation mode the command .lit $ @SYS$SYSVPWFILES:GRAPHDEV VT240 .end lit will restore the VT240 to VT100 mode of operation. This chapter will document the commands to use with TVG to create viewgraphs. .hl 1 Starting Out TVG is designed to allow a user sitting at a Tektronix 4014 terminal to interactively create a viewgraph. Straight line shapes can be drawn, and text can be entered and displayed in a variety of text fonts, sizes, and orientations. The viewgraphs can be saved for later use in ASCII text files. These files can be edited to make minor changes in the text or size (without having to use TVG) but the exact format of the file must be preserved because TVG is very intolerant of errors encountered when reading in a saved viewgraph file. Viewgraphs are assumed to have an extension .TVG although this can be overridden by providing an explicit extension. Each TVG object (text string, line segment, shape) has a tag letter associated with it (A-Z, a-z, 0-9). Most TVG commands require the tag to be used to identify the object on which the command acts. After an object is created, by referencing its tag, its character size, character font, orientation, and location may be changed with commands. If you wish to use character size and fonts other than the default it is easiest to change them before creating tagged object. If you are creating an object (via the E command), the tag letter is automatically assigned starting with the letter A and incrementing each time a new object is created. These tag letters stay with the viewgraph when it is saved as an ASCII file, and restored when the file is unsaved. Some care should be taken to avoid conflicting tag values. If you have an object with a tag "A", and then restore a viewgraph file with an object having a tag "A", your original tag is overwritten. However, if the viewgraph file has unique tags, its objects are added to those objects you have already created. After invoking TVG, the screen will erase, axes will be drawn and the TVG> prompt will appear. A message reminding the user that the default file extension is .TVG also appears. If you are generating a standard presentation viewgraph, your first command should be to place the title line and logo on the viewgraph. A standard KMS title/Logo template can be included by typing U#SYS$SYSVPWFILES:KMSLOGO.TVG. Your next command should be "R" to display the logo/title line. Next, set the default character type and size for the viewgraph (its easier to do now than later). Character style 17 (Triplex Roman), produces the best presentation viewgraphs but take longer to draw than the default style 3 (Simplex Roman). To change the default character set, type MC 17 at the TVG> prompt. You should also use the MS command (Modify Size) to set the default size for your characters. The sizes are specified in inches (relative to 8.5 x 11 page) with the default size of .25 inches. You create TVG viewgraph objects either with the .lit E to enter a line of text, or MB to enter a box or line segment shape .end lit An identifying tag letter (beginning with capital A) will be assigned for entry by the E command but must be explicitly specified with the MB command. This tag identifier will be used in subsequent commands to refer to the entry. After either of these commands, the cross-hairs will become visible. For entry of text, position the cross-hairs where you would like the text, and type either L, R, or C (for Left, Right, or Center justified text). If you wish to see this entry, use the R command to re-draw the screen and all existing text string and shapes entered will then be plotted. For entry of boxes or lines, position the cross-hairs at each point in the line or box, and set that point by typing any character except A, C or E. (The space bar is useful here). Line segments will be produced between these points. Use A, C or E (draw Arrow, Close box, or End point) to terminate the entry. To enter additional text strings or figures, use the E or MB commands. You can change the default size, orientation, character set, or alignment by using the commands MS, MO, MC, or MA without specifying an identifying tag. All subsequent entries will have these characteristics. .hl 1 TVG Commands Each text string or object created during a TVG session has a tag letter (or number) associated with it. In the command list to follow, the tag is referenced by the letter "l". Uppercase and lowercase letter tags are considered to refer to different objects. The commands to create or modify a view-graph are: .lit BYE Exits TVG (same as Ctrl-Z) CLEAR Clears all text and box definitions; the default values are unchanged. E Enter new text to be associated with the next available identifier. F Plot final viewgraph on your terminal MA [l] d Modify the alignment of TEXT l to d, where D = 0. (LEFT) AND D = 1. (RIGHT). Default: d=0. MB l Make Box. Draw up to 32 connected line segments. MC [l] n Modify the character set of TEXT l to n. Default n=3. MO [l] d Modify the orientation of TEXT l to d degrees. Default: d=0. MP l Modify the position of TEXT l to that of the crosshair input. The alignment can also be chosen if either an L, C or R is typed to set point. MS [l] d Modify the size of TEXT l to d inches. Default: d=.25. MT l Replace TEXT l with new text. N n Place n ticks on right side during REDRAW. R Redraw with identifiers. S t Save as file named t. U t Unsave from file named t. *** where [l] is the tag letter identifier (A-Z,a-z,0-9) .end lit To generate a final viewgraph and copy (if TVG is a foreign command, type: .lit $TVG filename.ext[/switches] .end lit Where "filename.ext" is the name of the file in which the viewgraph description is saved. (The default extension type is .TVG). TVG can specify an indirect command file on its command line of the form .lit TVG @filename or TVG filename[/-FI/MG:N.] where /-FI supresses the filename identifier at bottom right of figure /TE:n means plot on terminal n (*** DOES NOT YET WORK ON VAX) /MG:n.nn is magnification factor .end literal .hl 2 BYE The BYE command (or Ctrl-Z) is used to terminate TVG. Before TVG exits, the question "Have you saved this? [Y,n]" will appear. To exit, type Y. To continue in TVG, type N. This question is designed to remind you to save your new or modified TVG file. .hl 2 CLEAR The CLEAR command is used to wipe all text and box definitions, while remaining in TVG. Any default definitions that have been reset remain reset. .hl 2 E To enter new text user the E command .lit E .end lit The next available tag identifier (beginning with capital A through lower-case z) will be assigned; and is used to reference that text in subsequent commands. (i.e., the MT B command is used to modify the text string tagged 'B'.) The default characteristics for entry are character set #3, orientation of 0 degrees with the X axis, left-justified alignment, and letter size of 0.25 inches. To change these characteristics, see the MC, MO, MA, and MS commands. .hl 2 F The F command is used to draw the viewgraph in final form (without tags or axes). After the F command is used, typing a will cause the screen to blank, and the TVG> prompt to re-appear. .hl 2 MA The command MA is used to modify the alignment of text strings. Alignment is defined as either 0 (left-justified) or 1 (right-justified). If the command is used with a specific tag identifier (eg. MA#B#1), only that string is re-aligned. If the command is used without an identifier (eg. MA#1), the default alignment is changed. The initial default alignment is 0 (left justified) .hl 2 MB The command, MB#l, is used to enter or modify an existing box with the tag identifier l. The tag letter must be specified. After the MB command is used, the cross-hairs will appear on the screen. Position these at the first point of the box or line, and type any character except A, C or E (the space bar is useful here). Re-position the cross-hairs to the next point and type another character. The first line segment will appear on the screen. To terminate entry, type A (draw arrow to point), E (end of shape), or C (close box). If a C is typed, a line will be drawn between the current point and the initial point of the box or shape. .hl 2 MC The command, MC#n, is used to change the current default character set to set n. The command, MC#l#n, is used to modify the character set of an entry specific text string. .hl 2 MO The command, MO#a, is used to modify the default orientation of text. The command, MO#l#a, is used to modify the orientation of the specified text string. The initial default orientation is 0 degrees with respect to the X-axis. .hl 2 MP The command, MP#l, is used to modify the position of a string or box. When the MP command is used, the cross-hairs will become visible. Position the crosshairs and type .lit L to use this point as the lower left-hand corner of the text R to use this point as the lower right-hand corner of the text C to use this point as the center point of the text .end lit Each tag has a tic mark associated with it which can be used for reference purposes with the cross hair when moving objects. .hl 2 MS The command, MS#s, is used to modify the default lettering size. The command MS#l#s, is used to modify the lettering size for the specific text string. The size s is entered in floating point inches. The initial default lettering size is 0.25 inches. .hl 2 MT The command, MT#l, is used to modify (replace) the text string specified by tag l with the new text. If MT#l is used, that string is eliminated and the tag identifier released for re-use. .hl 2 N The command, N#m, is used to generate m tic marks along the right side of the graph when it is next re-drawn. .hl 2 R The R command is used to re-draw the graph with the latest modifications and additions included. The tic'ed axes are included, as well as the identifying tag letters associated with each string or figure. .hl 2 S The save command, S#fnam, is used to save the current set of TVG commands as a file. The extension .TVG is automatically appended to the file name if an extension is not specified. TVG does not update the version number of the file, so if you are planning to use both the unmodified and modified versions of a file, make a copy before entering TVG. Once the file is saved, it may be recalled for modification by using the unsave command, U#fnam. .hl 2 U The unsave command, U#fnam, is used to read in a previously saved file of TVG commands. The extension .TVG is assumed if no extension is specified. TVG's parsing of a saved viewgraph file is far from robust. If you have edited the file to make modifications, and the format is changed, TVG will probably abort while the file is being read in. .hl 1 TVG Maker The Graphics Workstation Viewgraph Menu provides a option to design a TVG viewgraph file using TVG Maker. This option may be used by anyone using a VT100 compatible terminal. Rather than engaging in an interactive TVG session to create the viewgraph, the assumption is made that the user desires to rapidly create a prototype viewgraph with a Logo, title, and 13 equally spaced, left-justified lines. Once the viewgraph is created, TVG may be used to recall the viewgraph, modify text, text size, orientation, or position as appropriate. TVG#Maker is designed to be very easy to use. First one is prompted for a viewgraph file name. The extension will default to .TVG so it may be omitted. At the filname prompt, both the TVG Window key and the TVG Help key is active. Control-Z at any input will terminate processing of this procedure. TVG will warn you if you try and use the name of an existing viewgraph file and give you the chance to select a new name. If you forget what viewgraph files are present, you also can elect to display a list of all .TVG files present on your current directory. Next you are prompted for a title for the viewgraph which may be up to 35 characters long. If your title must be longer, create your viewgraph with a shorter title, and modify it (and the character size) afterwards. Next you are prompted for 13 text strings (up to 55 characters long each). If any strings do not exist, simply type return. If you make a mistake entering a text string, press up-arrow to back up to the previous entry. To create a "Bullet" in front of each text line, precede the text you enter with a "$.#" or a "$_*#". When the last text string is entered, TVG#Maker, merges your data with a template TVG file, to create prototype TVG file. It may then be necessary to use TVG directly to position text strings (space them out if do not need all 13), change character size (smaller size -> more text on line), create shapes, change character fonts or orientation. .hl 1 Embedded Text Commands Entered text strings can contain both textual and control information. A "$" indicates that the following character is a control character. In addition the "_>" and the "_<" are taken to mean "shift to upper case", and "shift to lower case" respectively. When preceeded with the "$" control character, the following characters produce the following results. .lit A Shift above the division line ($/). B Shift below the division line ($/). C Advance to the next line, single spacing. D Shift down to the first level subscript. E Shift up to exponent level. G Change to Gothic text. I Shift down to index level. J Jump back to last level command position. L Shift down to second level subscript. M Change to Math character set. N Shift to normal level. O Advance to next line, one and a half spacing. R Restore position S Save Position T Advance to next line, double spacing. U Shift up to superscript level. V Generate a vector/mean bar between occurrences ($V......$V). W Change to script character set. X Return to entry character set. Generate a half-space 3-17 Change to character set 3-29 . Generate a "Bullet". * Generate a five pointed star "Bullet". / Generate a division line between occurrences, ($/....$/). - Underline between occurrences, ($-....$-). = Double underline between occurrences, ($=....$=). < < > > $ $ .end literal Entry conditions are always set to the last font used at the normal level with upper case letters displayed in upper case fonts. However, if lower case text is entered, it is displayed in a lower case font. If no character sets are activated, the terminal character set is used and none of the control characters are interpretted. Also, when character set 9 is activated within a line, only one character is used from that set before TVG returns automatically to the entry character set. Hence to produce and integral sign, on need only type "$9I" not "$9I$X". .hl 1 Character Sets Some 17 different character sets can be drawn by TVG. A program called SETS can be used to generate a complete display of the specified character sets with the exception of the character. The is a space in all sets except in character set 9 where it is a half-. The available character sets are designated by a set number which runs from 3-20. The sets are. .lit Set Number Style 0 All sets deactivated 3 Simplex Roman 4 Simplex Greek 5 Duplex Roman 6 Complex Roman 7 Complex Greek 8 Complex Italic 9 Special and math characters 10(M) Math and special characters 11(G) Gothic English 12(W) Simplex Script 13 Complex Script 14 Gothic Italian 15 Gothic German 16 Cyrillic 17 Triplex Roman 18 Triplex Italic 20 Miscellaneous characters .end literal When using character set 9, as $9 (in a text command), only one character is accessed before the style automatically returns to the entry character set.