TTERM(1X10) COMMAND REFERENCE TTERM(1X10) NAME tterm - Tektronix 4107 terminal emulator for the X window system tterm is a supported client. SYNOPSIS tterm [ option ] ... DESCRIPTION When the command tterm -t is typed the Tektronix emulation of tterm is invoked, setting the environment variables TERM and TERMCAP to 4107, thus emulating a Tektronix 4107 color graphics terminal. When the command tterm is typed the ANSI emulation of tterm is invoked, setting the environment variables TERM and TERMCAP to 4107. The ANSI emulation is the same as the ansi mode of a Tektronix 4107 color graphics terminal. The tterm command list and syntax is specified by the 4107/4109 Programmer's Reference manual (Tektronix part number 070-4893-00). Control sequences for tterm are the same as those of the Tektronix 4107 except where noted; see the CAVEATS section. If you are loading tterm for the first time, use the -ac switch with xinit. Type: xinit tterm -ac -- -0 black -1 white This enables tterm to allocate color cells. These color definitions can be later redefined with application programs by sending appropriate color map definitions. Or, you can load tterm, X, xterm, and uwm without any color cells allocated. Type: tterm -ac If tterm is already running and you want another copy of tterm loaded, type: tterm When you run tterm without the -ac switch, you may not see the proper colors; tterm uses the existing color map but it can't change the color cell definition. Only one tterm at a time can allocate color cells. An attempt to allocate the dialog color cell whill fail if more than 15 color cells (7 cells in the case of a 4-bit plane system) are already used. If the allocation does succeed, the dialog characters are Printed 3/22/89 1
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) displayed in white, the default color. In the X Window System version X10, color cells must be allocated before they can be defined. Color cells are shared, therefore if tterm uses all the color cells then other application programs won't have any colors for allocation. If any of your application programs have already defined a color and you try to invoke tterm with the -ac switch, you will get the system message: tterm: No color cells to allocate If this happens, you can either invoke tterm without color allocation or remove the applications which define color cells and then invoke tterm with the -ac switch. Color Cell Allocation for Graphics and Dialog The last fourteen color cells are allocated by tterm for graphics and dialog. The first 2 color cells are allocated and defined by X as black and white. Color pixel 8 is used by the dialog area. The first three bit planes are used by graphics and the last one is used by the dialog area. If the graphics surface is initialized with 4 bit planes, then the graphics area will use the dialog bit plane only if the dialog is invisible or disabled. The side effect of this is that you may see the graphics area scrolling along with the dialog area. Normally, the graphics area can use 0 to 7 color pixels. If the dialog bit plane is also used, then graphics can have 0 to 15 color pixels (except color pixel 8, which is used by the dialog bit plane). Therefore, at any given instant, the following color pixels can't be modified by tterm graphics commands: pixel 0 Allocated by X as black 1 Allocated by X as white 8 On a system with 4 bit planes, this is allocated by the dialog area as the dialog character color. The dialog area has two colors: the background color is always black and the foreground color can be modified. Since only one bit plane is allocated for dialog, you will see only one color in dialog characters. Printed 3/22/89 2
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) On a system with 8 bit planes, 3 bit planes are allocated for dialog which allows 8 different colors in the dialog area. 4107 Color Indices to X Color Pixel Map Listed below are color map conventions used in tterm for mapping colors from Tektronix 4107 color indices to X color pixels. On a system with 8 bit planes, 4 bit planes are used for graphics, 3 for dialog and 1 for the gin cursor. The color map convention is: 4107 Color Index X Color Pixel What you see 0 0 Always black 1 1 Always white 2 - 15 2 - 15 Whatever you have defined On a system with 4 bit planes, 3 bit planes are used for graphics and 1 for dialog. The GIN cursor is written in XOR mode. When the surface is defined with 4 bit planes and the dialog area is disabled or invisible, the color map convention is: 4107 Color Index X Color Pixel What you see 0 0 Always black 1 1 Always white 2 - 7 2 - 7 Whatever you have defined 8 8 Dialog character color 9 - 15 9 - 15 Whatever you have defined When the surface is defined with 4 bit planes and the dialog area is enabled and visible, the color map convention is: 4107 Color Index X Color Pixel What you see 0 0 Always black 1 1 Always white 2 - 7 2 - 7 Whatever you have defined 8 8 Dialog character color 9 1 White 10 2 Color defined for pixel 2 11 3 Color defined for pixel 3 12 4 Color defined for pixel 4 13 5 Color defined for pixel 5 14 6 Color defined for pixel 6 15 7 Color defined for pixel 7 Printed 3/22/89 3
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) When the surface is defined with 3 or less bit planes, the color map convention is: 4107 Color Index X Color Pixel What you see 0 0 Always black 1 1 Always white 2 - 7 2 - 7 Whatever you have defined 8 - 15 1 White OPTIONS If the option begins with a plus sign ( + ) instead of a minus sign ( - ) it is restored to its default value. These options override those set in the .Xdefaults file (see the X Defaults section in this document). -ac Allocates the color cell. It is suggested that you use this option when you are loading tterm for the first time. These color definitions can be redefined later with application programs, sending appropriate color map definitions. -ar Turn on the auto-raise mode of tterm, automatically raising the window when the mouse cursor enters the window. -bw width Sets the border width. -e command arguments The specified command is executed in the window, rather than starting a shell. The command and the optional arguments must appear last on the tterm command line. -fn font_name tterm selects the specified font name for displaying characters in the dialog area. This option overrides any font specified in the .Xdefaults file. -i Enables icon startup. -l Turn on logging; all input from the pseudo tty is placed in the logfile. -lf file Write the log to file, rather than the default TtermLog.XXXXX where XXXXX is the process id of tterm (the file is created in the directory where tterm is started, or in the home directory for a login tterm). Printed 3/22/89 4
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) If file begins with a bar or pipe ( | ) the remainder of the string is assumed to be a command executed by the shell, and a pipe is opened to the process. -ls Use the shell run under tterm as a login shell (the user's .login file is read and the initial directory is the home directory). -n name Specifies the window name; default name is tterm. -t Set the initial tterm window to a Tektronix 4107 window, rather than the default VT102 window. -ti Display normally in the icon; the window name is to the right of the bitmap. This option displays the text under the icon. =geometry Specify =widthxheight[+-xoff[+-yoff]] for the emulator window. See X(1x10) for details of this specification. host : display Specify the host name and display number. host specifies which machine to create the window on, and display specifies the display number. For example, orpheus:1 creates a shell window on display one on the machine orpheus. Note that you must have the file /etc/X*.hosts set up prior to using the host : display command. See xhost(1x10)and X(8x10) for more information. X Defaults You can preset defaults in the customization file .Xdefaults in your home directory. The format of the file is: programname.keyword:string Example: tterm.AutoRaise:off If the program name is missing, the default keyword is set to the value for all programs. You must include a colon after the keyword, otherwise the command will not execute. Case is not significant in keywords and white space before the string is ignored. Any global defaults must precede program defaults in the file. Printed 3/22/89 5
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) Options referenced by each keyword are listed as the last part in the keyword description. The keywords have no meaning if the corresponding options are not set. Keywords recognized by tterm are listed here: AutoRaise If on, tterm windows are automatically raised when the mouse enters them. (Option -ar.) BodyFont Specify the font used in the dialog area. The default font is PellucidaTypewriter10. BorderWidth Set border width of the window. (Option -bw.) DeiconifyWarp If on, move (warp) the mouse to the center of the window after deiconification. (Option -dw.) IconStartup If on, initially display the icon rather than the normal window. (Option -i.) LoginShell If on, execute the shell as a login shell. (Option -ls.) MenuBorder Specify the border width for the menus. The default is 2. MenuPad Specify the extra padding above and below the menu title. The default is 3. MenuFont Specify the font used within the menus. The default font is PellucidaTypewriter10. SignalInhibit Inhibit the sending of signals from the tterm menu. Emulations Tektronix 4107 Emulation: The current version of tterm emulates the 4107 firmware version 7, level 2 with all the mouse-related features of firmware version 10.5. Windows are created with a 4:3 aspect ratio, with priority given to the X axis. Default window size is 724 x 543 (80 columns of PellucidaTypewriter10 font with a ratio of 4:3 between X and Y, respectively). Printed 3/22/89 6
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) The interior of the window corresponds to the screen of a 4107. Graphics and/or dialog planes are displayed in the emulator window in tek mode. Text is displayed in the window in alphatext mode and when tterm is in ansi mode. Switching between ansi and tek modes may be done by selecting the 4107 Setup Mode option in the modes menu, or you may toggle between the states using escape sequences under program control. The tterm emulator only supports graphics input (GIN) for the joydisk. However, since the GIN cursor is drawn on the current graphic surface it does not have a separate color index and therefore is painted in the current line index. The GIN cursor is also clipped by the current viewport window. This version of tterm also supports 4010 GIN and related reports. All keyboard macros are supported, including volatile and nonvolatile SAVE. All pixel commands are supported but there is no scaling between the source and the destination. ANSI Emulation: ANSI emulation is exactly the same as the Tektronix 4107 ansi mode. The emulator window cannot be resized. Settings and Modes NVRAM: All nonvolatile information is stored in a file in your home directory; the file is called .Tterm. During the power-on process, if tterm fails to find the .Tterm file, tterm sets itself to factory default values. The .Tterm file is created only if tterm receives NSAVE, NVLEARN or NVDEFINE commands in setup, or if it encounters corresponding escape sequences from the host. RESET / FACTORY Command: The RESET command in tterm reads the information from the .Tterm file and initializes itself; if .Tterm doesn't exist in your home directory an implicit FACTORY command is performed. The FACTORY command saves the factory-set values in the file .Tterm in your home directory and initializes itself. SETUP Mode: Toggle between setup mode and host mode by pressing the Set Up key on the keyboard (press the F2 key on the Tektronix 4316 and 4317 workstation keyboards), or select the 4107 Setup Mode option in the modes menu. Printed 3/22/89 7
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) The Menu option is not provided in the 4107 Setup Mode. Creating a Window When using the mouse to create the emulator window, a cursor and a rubber banding box outline the area on the display where the window will be created. If the left mouse button is pressed, a HEIGHT x WIDTH (default 32 x 80) size window is created at the position where the button is released. If the right mouse button is pressed, a window the HEIGHT of the display and WIDTH (default 80) characters wide is created. If the center mouse button is pressed and held down, the upper left hand corner of the window is defined at this position. An outline of the minimum size window is shown, and a pop up window in the upper left hand corner of the display shows the size in characters of the window. Moving the mouse (while still holding the button down) enlarges the window; the sizes in the pop up window update accordingly. Releasing the button defines the lower right hand corner of the window. Menus The tterm emulator has three different menus, named tterm, Modes, and Windows. Each menu pops up under the correct combinations of key and button presses. Most menus are divided into two sections, separated by a horizontal line; the top portion contains various alterable modes. A check mark appears next to a mode that is currently active; selecting one of these modes toggles its state. The bottom portion of the menu shows command entries; selecting one of these entries performs the indicated function. tterm Menu: The tterm menu pops up when the Ctrl key and the left mouse button are pressed in a window or it can be accessed by pressing the left mouse button when the cursor is in the title bar. Available menu items are: Active Icon Allow Icon input Auto Raise Deiconify Warp Logging The command portion of the tterm menu is: Redraw Continue Suspend Interrupt Printed 3/22/89 8
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) Hangup Terminate Kill Modes Menu: The Modes menu is popped up with the Ctrl and middle mouse button combination in the window or it can be accessed by pressing the middle mouse button when the cursor is in the title bar. Available menu items are: Auto Wraparound Toggles the Auto Wraparound attribute for the emulator window Auto Linefeed Toggles 4107 CRLF mode Application Pad Toggles the Application Pad attribute for both tek and ansi Auto Repeat Toggles auto repeat on keys 4107 Setup Mode Enters Setup mode; works for both ansi and tek Alternate Screen Toggles ansi alternate screen mode Menu items available in the command portion of the Modes are: Toggle tek/ansi Mode Toggles between tek and ansi modes Windows Menu: The Windows menu is popped up when the Ctrl key and right mouse button are pressed or it can be accessed by pressing the right mouse button when the cursor is in the title bar. Fonts tterm first checks for the option -fn. If this option is not specified in the command line, it checks for a font name specified in the .Xdefaults file. If the option tterm.BodyFont: font_name is not in the .Xdefaults file the default font is PellucidaTypewriter10. This font is used for displaying characters in alpha text and the dialog area. Keymapping The functional keymapping for the Tektronix 4316 and 4317 workstations is: Printed 3/22/89 9
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) 4107 4316/17 equivalent Dialog F1 GEras Shift F1 Set Up F2 Cancel Shift F2 SCopy - DCopy - Menu F4 SEras F3 DEras Shift F3 F1 F5 F2 F6 F3 F7 F4 F8 F5 F9 F6 F10 F7 F11 F8 F12 FILES .Tterm A file in the home directory having nonvolatile information. If this files is not present while loading tterm, the emulator sets itself to factory default values. CAVEATS When making the .ttermc file in your home directory you must include the colon ( : ) after the keyword, otherwise the command will not execute; an error message is not given. You can toggle between ansi mode and tek mode manually or under program control but the environment variables remain the same: they are set only at the invocation of tterm. No user-defined graphtext is supported. Text cannot support the blinking attribute. Segment highlighting will not be supported. All communication commands are ignored. Only Tektronix 4107 line styles are supported; dithered pattern fills are available; tablet support is not provided. All hard copy and related color commands are ignored; GIN cursor color may be modified to pixel from the current surface color map line index. Zoom and Pan functions are not supported in setup mode. Printed 3/22/89 10
TTERM(1X10) COMMAND REFERENCE TTERM(1X10) 4107 windows cannot be resized using the window manager. Scaling is not supported in pixel copying operations. The 4315 workstation is not supported in tterm. PLOT and PORT ASSIGN commands are not supported. Key macros for shift-control of ASCII keys are not supported. VT52 is not supported. Mouse macros that are defined for the keys control_mouse_button_1, control_mouse_button_2, and control_mouse_button_3 send the corresponding macro definitions to the host and display the corresponding menus. tterm emulates the Tek 4107 firmware version 7.2 with all the mouse-related features of firmware version 10.5. When queried for the firmware version tterm returns firmware version 10.5 to enable applications like TekniCAD to use the mouse as a GIN device. Segment editing and related features are not supported. SEE ALSO X(1x10), X(8x10), xhost(1x10), xterm(1x10), pty(4), tty(4). REFERENCES See the tterm control sequences information in the 4106/4107/4109/CX Programmer's Reference manual, Tektronix part number 070-4893-01. Printed 3/22/89 11
%%index%% na:336,206; sy:542,166; de:708,2912;4028,2932;7368,2841;10617,429; op:11046,2641;14095,2742;17245,3336;20989,3462;24859,3465;28732,3697;32837,718; fi:33555,340; ca:33895,1090;35393,1170; se:36563,217; re:36780,401; %%index%%000000000248