       USERS' GUIDE      VT-241 Color Management Software     Version 3.1      April, 1987       H Having a VT-241 (or other color REGIS terminal) is much more fun if you G use color combinations other than Red-Blue-Green.  These programs make  H it easy for the user to control his/her terminal colors.  A side-effect A is that a user connecting a VT-241 is immediately given a set of   pleasant colors.  D Since there is no way to tell if a terminal is a VT-240 or a VT-241 ; (REGIS monochrome or color), the programs key on the REGIS  5 characteristic. VT-240s handle the color commands OK.   J oo  Some third-party terminals and (particularly) terminal emulators may G not like these programs.  We know of some which "lie" to SET TERM/INQ,  C and others which don't properly exit from REGIS mode when sent the  & standard sequence ( <ESC>\ ).  [Sigh!]  K oo  VT-241 terminals must be SETUP to do Mono + Color Display, or the PCO  F and XCO programs will not work properly.  There does not seem to be a 3 convenient way to check for this from the programs.      Commands  G The following commands are associated with Color Management.  They are  - described in more detail later in this guide.   C      OCO  Used if terminal is garbaged - Fixes your CRT & restores             colors.   7      NCO  Gets a new set of random, contrasting colors.   C      CCO  Gets a new set of random, complementary ("artsy") colors.   G      PCO  Lists 64 choices for each of 4 colors, and lets you pick the             ones you like.  -      XCO  An interactive/visual user chooser.   C      CO	  The most versatile (and complex) command.  Runs when you  +           login, and can be used afterward.   H The acronyms (sort of) stand for: OLD Colors, NEW Colors, COMPLEMENTARY 2 Colors, PICK Colors, (X)CHANGE Colors, and Colors.     OCO (Old Colors)  F This command will reset the terminal parameters to clean up "garbage" F and restore your default colors.  In addition to its use in restoring E your colors, it is useful (even with a VT-220) something causes your  D terminal to have "funny" scrolling, line-drawing character set, etc.     NCO (New Colors)  H This command will set up a random color setting.  The colors picked are C usually reasonable. The colors that are chosen will become the new  I default so you should save the old setting before executing this command  I if you want the previous setting saved. The current colors are always in  ! SYS$LOGIN:CURRENT_COLORS_CMD.SCR.      CCO (Complementary Colors)  F This command will set up a random complementary color setting.  It is A identical to NCO, except that the colors chosen are more "artsy".      XCO (X_Change Colors)   H This command lets you interactively set up your default color setting.  G The screen shows all combinations of normal, bold, and reverse lines.   I You use the arrow keys to select your 4 new colors.  The colors that are  F chosen will become the new default so you should save the old setting F before executing this command if you want the previous setting saved. B The current colors are always in SYS$LOGIN:CURRENT_COLORS_CMD.SCR.     PCO (Pick Colors)   G Like XCO, but has a different user interface.  A list of the 64 colors oG is given.  You may use the arrow keys and/or type the color number for p each of the 4 color choices.     CO (Colors)   I This command is done by the system when you log in.  You may also use it i at any time you wish.     @ When run interactively, CO will pass up to 8 parameters to your G SYS$LOGIN:SET_COLORS.COM.  This allows you to have many different ways  A of doing your color settings.  For example,  CO 4 would pass the KF parameter 4 to your SET_COLORS.COM which could then type color file 4.  ? Before trying to do anything "fancy" with CO, it is helpful to S2 understand how the Color Management programs work.     Suggestionsw   Try XCO or PCO.n   Try NCO or CCO.C  F Create your own SET_COLORS.COM in your SYS$LOGIN directory.  A simple E one would be one line: $ NCO which will give you a new set of random o colors each day.   Get as fancy as you like.     F If you think it's easy to pick "nice" colors randomly, ask the system H manager for a copy of NEWCOLORS.FOR or COMPCOLORS.FOR - we would really H like to see these improved.  They only pick reasonable colors about 80%  of the time.      Operating Philosophy of Programs  F oo  If the terminal is not ReGIS, do nothing (except OCO); otherwise,  G oo  If the user does nothing, always set the system default colors at c login.  ) oo  Provide user flexibility as follows:s  F      Users may run programs to select their own colors (explicitly or I      randomly).  If they do, the selected colors will stay with the user ,G      "forever" (are not changed to system default at any login).  This oE      is accomplished by writing a file Current_Colors_Cmd.Scr in the aD      user's SYS$LOGIN directory.  Two other files are written there:  ; 	  Current_Colors.Scr (for subsequent use by programs) and c(           Did_Colors.Before (see below).  I      Users may "do their own thing" by putting a Set_Colors.Com in their eG      SYS$LOGIN directory.  This will be executed at first login.  Some CD      users (like the author) like to use this to get a fresh set of C      "random" colors each day [my Set_Colors.Com contains "$ NCO"].w  F oo  For users who do multiple logins (SET HOST 0, Clusters, Terminal F Servers), the user's selected colors are not switched at each login - C until the user logs out once.  The selection programs write a file C0 Did_Colors.Before, which is destroyed at logout.     Operating Sequence at Logine  + When CO is executed, it does the following:h  6 1.  If the user has a DID_COLORS.BEFORE, Go To Step 3. 								       a ELSE  3 2. Execute the user's SET_COLORS.COM if it exists.     ELSE e  E 3. Type SYS$LOGIN:CURRENT_COLORS_CMD.SCR if it exists.  This file is  H created by the NCO, CCO, PCO or XCO commands.  This sets up the default  color scheme for a user.   ELSE    I 4. Type SYS$UTILS:[COLORS.MANAGER]SYSTEM_DEFAULT_COLORS.SCR. This is the r system default color setting.r    5 Attributions: (All at Los Alamos National Laboratory)    Dale Coy - Rationalization.X. Jim Whitfill, System Manager - the .COMs, etc.: Tom Beery - Initial implementation of Color_Changer (XCO).8 Dennis Hall - Initial implementation of PikColors (PCO).        