TTERM(1x) COMMAND REFERENCE TTERM(1x) NAME tterm - Tektronix 4107 terminal emulator for the X window system For 4310, 4320, and 4330 series UTek products only. SYNOPSIS tterm -t [ 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. In the X Window System version X10, color cells must be allocated before they can be defined. Color cells are Printed 5/12/88 1
TTERM(1x) COMMAND REFERENCE TTERM(1x) 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 allocated by the dialog area as dialog character color; the dialog area has two colors; the background color is always black; the foreground color can be modified; since only one bit plane is allocated for dialog, you will see only one color in dialog characters 4107 Color Indices to X Color Pixel Map Here is a color map convention used in tterm for mapping colors from Tektronix 4107 color indices to X color pixels. Printed 5/12/88 2
TTERM(1x) COMMAND REFERENCE TTERM(1x) When the surface is defined with 4 bit planes and the dialog area is invisible or disabled, this is the resultant color map convention: 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, this is the resultant color map convention: 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 When the surface is defined with 3 or less bit planes, this is the resultant color map convention: 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 Available within tterm are ansi commands and tek commands. Only tek command options are listed here. See xterm(1x) for Printed 5/12/88 3
TTERM(1x) COMMAND REFERENCE TTERM(1x) all ansi command options. If the option begins with a plus sign ( + ) instead of a minus sign ( - ) the option 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. -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). 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. Printed 5/12/88 4
TTERM(1x) COMMAND REFERENCE TTERM(1x) -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(1x) for details of this specification. host:display Specify the host name and display number. The host specifies which machine to create the window on, and the display argument 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 the manual pages xhost(1px)and X(8x) for more information. X DEFAULTS You can preset defaults in a customization file .ttermc in your home directory. The format of the file is programname.keyword:string For 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. 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.) BorderWidth Printed 5/12/88 5
TTERM(1x) COMMAND REFERENCE TTERM(1x) 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 is the same font used for the title bar. 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. 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 Pellucida Typewriter 10 font with a ratio of 4:3 between X and Y, respectively); 4107 windows have title bars but no scroll bars; the borders are fixed width. 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 simultaneously supports graphics input (GIN) both for the mouse and the joydisk, however, since the GIN cursor is drawn on the current graphic surface it does not have a separate color index and therefore it is painted Printed 5/12/88 6
TTERM(1x) COMMAND REFERENCE TTERM(1x) 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 in tterm deletes the file .Tterm from your home directory and initializes itself to factory set values. 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. 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 Printed 5/12/88 7
TTERM(1x) COMMAND REFERENCE TTERM(1x) 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 four different menus, named tterm, Modes, GIN, 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 listed here. Auto Raise Deiconify Warp Logging The command portion of the tterm menu is Redraw Continue Suspend Interrupt 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 listed here. Auto Wraparound toggles the Auto Wraparound attribute for the emulator window Application Pad toggles the Application Pad attribute for both tek and ansi Printed 5/12/88 8
TTERM(1x) COMMAND REFERENCE TTERM(1x) 4107 Setup Mode enters Setup mode; works for both ansi and tek Menu items available in the command portion of the Modes are listed here: Toggle tek/ansi Mode toggles between tek and ansi modes GIN Menu: If the GIN (Graphics Input) menu is enabled with the mouse as the GIN-device, and you press any of the three mouse buttons, the GIN report is sent to the host. 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 Pellucida Typewriter 10 is used as the font for dialog planes. KEYMAPPING The functional keymapping for the Tektronix 4316 and 4317 workstations is presented here. 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 Printed 5/12/88 9
TTERM(1x) COMMAND REFERENCE TTERM(1x) 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. When the mouse cursor enters a tterm window while another window is the keyboard focus, the tterm window is highlighted; the tterm window highlighting cannot be turned off in this state. 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; there is support only for the North American keyboard; the text will not support any attributes (like blinking, etc.); 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. 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. For 4107 emulation usage 3 planes are reserved for graphics and 1 plane is reserved for dialog; this structure allows allocation of 8 graphic and 2 dialog colors. The default graphic colors are the same as the first 8 colors of the 4107 FACTORY setting. Dialog colors are black and white. PLOT and PORT ASSIGN commands are not supported. Key macros for shift-control of ASCII keys are not supported. If you bind normal-mouse buttons then mouse-GIN Printed 5/12/88 10
TTERM(1x) COMMAND REFERENCE TTERM(1x) may not work. VT52 is not supported. SEE ALSO resize(1px), X(1x), X(8x), xhost(1px), xterm(1x), pty(4), tty(4). See the tterm control sequences information in the 4106/4107/4109/CX Programmer's Reference manual, Tektronix part number 070-4893-01. Printed 5/12/88 11
%%index%% na:288,179; sy:467,189; de:656,2709;3725,3307;7392,2048; op:9440,292;10092,3242;13694,2943;16997,3390;20747,3557;24664,3425;28449,2231; fi:31040,340; ca:31380,2270;34010,49; se:34059,540; %%index%%000000000221