home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / tools / syscols / syscols.doc next >
Encoding:
Text File  |  1992-07-18  |  8.6 KB  |  206 lines
  1.                               SYSCOLS.DOC
  2.                           ver 2.0   July, 1992
  3.  
  4.         Presentation Manager System Color Configuration Program
  5.  
  6. This program offers configuration of OS/2 Presentation Manager's system
  7. colors.  It was originally written to provide several advantages over OS/2
  8. 1.x's Control Panel.   Version 2.0 is the update for OS/2 2.0.
  9.  
  10. Features include:
  11. * 41 system colors can be changed   (the Color Template "Different",
  12.   although some may think it ugly, serves to demonstrate each system
  13.   item as a different color)
  14. * Most color changes are visible immediately.
  15. * Sample Color Templates are available.  Additional Templates can be
  16.   created, or existing ones can be modified.
  17. * Colors can be set temporarily or permanently (saved to OS/2's INI file).
  18. * A color template can be loaded from the command line (ideal for use in
  19.   CMD files).
  20.  
  21.  
  22. FILES
  23.  
  24. Required files: SYSCOLS.EXE, SYSCOLS.HLP, SYSCOLS.INI
  25. Ideally, these three files should be placed in the same directory.   For
  26. online help and color template choices the .HLP and .INI files need to be
  27. in the default directory.
  28.  
  29.  
  30. ON-LINE HELP
  31.  
  32. SYSCOLS provides hypertext, context-sensitive help from either the help
  33. menu or by pressing F1.  Further details concerning the running of this program
  34. can be found in the online help.  For online help to be available, the
  35. SYSCOLS.HLP file is needed.  To load color templates, the SYSCOLS.INI file is
  36. needed.  SYSCOLS looks in current directory for the .HLP help and .INI
  37. initialization files.  If either file is not found when the program is invoked, a
  38. message box is displayed.  If you add a program entry icon for SYSCOLS, set the
  39. working directory to the directory where SYSCOLS.EXE, SYSCOLS.HLP, and
  40. SYSCOLS.INI, are located.
  41.  
  42.  
  43.  
  44. LOADING TEMPLATES FROM COMMAND lINE
  45.  
  46. A color template name can be specified on the command line using the syntax:
  47.  
  48.                   SYSCOLS ["]validtemplatename["] [/L]
  49.  
  50. where validtemplatename is space-sensitive but not case-sensitive, and /L
  51. indicates to load the main System Colors Configuration Presentation Manager
  52. screen after changing the colors.
  53.  
  54. Specifying color templates on the command line without loading the main screen
  55. is useful for .CMD files, especially if you run a program that conflicts
  56. with your default color choices.   Simply put the lines
  57.    SYSCOLS "newtemplatename"
  58.    <commands to run confliciting program>
  59.    SYSCOLS "default or oldtemplatename"
  60. in a .CMD file to set colors compatible with the program, run the program, and
  61. then set the colors back to your favorite selection.
  62. No action is taken if the color template name given on the command line is not
  63. found in this program's .INI file.   Note that the color template name is not
  64. case sensitive, but if the color template name consists of two or more words,
  65. the template name must be enclosed in quotes, as in "templatename" .
  66. For example,
  67.   SYSCOLS "Penn State"   is valid       SYSCOLS penn state   is not valid
  68.   SYSCOLS "penn state"   is valid       SYSCOLS pennstate    is not valid
  69.   SYSCOLS "pEnN sTaTe"   is valid       SYSCOLS PennState    is not valid
  70.  
  71.  
  72. If a paramater is given on the command line, the program simply searches for
  73. the color template name in the .INI file, and if it is found, the system
  74. colors are changed.  If the template name is not found, the colors do not
  75. change.  In either case, the Presentation Manager interactive screen is not
  76. invoked unless /l or /L is given as the second parameter.
  77.  
  78. SYSCOLS "penn state"  /l         Would change the colors and load the program.
  79. SYSCOLS "invalid template"  /l   Would not change the colors, however the
  80.                                  main System Colors Configuration Presentation
  81.                                  Manager screen would be loaded.
  82.  
  83.  
  84. For example, to change colors each day at system startup based on the day
  85. of the week, put the line   START C:\CMD\SETCOLRS   in STARTUP.CMD where
  86. SETCOLRS is a REXX command file is similar to:
  87.  
  88. /*  SETCOLRS.CMD    Sample REXX command file to demonstrate loading color
  89.     templates based on the day of the week.
  90.     Note that
  91.     - D:, SOURCE, D:\SOURCE\SYSCOLS should be replaced as per your
  92.       system requirements
  93.     - To load a template name containing more than one word, use '" name "'
  94. */
  95. "D:"
  96. "chdir \SOURCE"
  97. commandline = "D:\SOURCE\SYSCOLS "
  98. if Date('W') = 'Monday' then
  99.      commandline = commandline || '"Default with a Twist"'
  100. if Date('W') = 'Tuesday' then
  101.      commandline = commandline || "bordeaux"
  102. if Date('W') = 'Wednesday' then
  103.      commandline = commandline || '"Penn State"'
  104. if Date('W') = 'Thursday' then
  105.      commandline = commandline || "southwest"
  106. if Date('W') = 'Friday' then
  107.      commandline = commandline || "southwest"
  108. commandline
  109. "exit"
  110.  
  111.  
  112.  
  113. SHARING COLOR TEMPLATES
  114.  
  115. If a friend has colors that you would like to add to your Color Templates,
  116. simply have him/her save their colors to a data file by selecting the Write
  117. action, then use Read to load the colors on your system, and optionally
  118. save them to a Color Template.  The color codes written to the data file
  119. are those of the colors currently in effect.
  120.  
  121.  
  122.  
  123. INI FILES FROM SYSCOLS VERSION 1.0
  124.  
  125. Since OS/2 2.0 provides more color items than previous versions, the SYSCOLS.INI
  126. file format is different between SYSCOLS versions 1.0 and 2.0.  When running
  127. SYSCOLS version 2.0 I do not recommend trying to use an INI file from version
  128. 1.0.  If you have color templates from the previous version that you want to
  129. keep using, there is an easy way to bring them from SYSCOLS 1.0 to 2.0.  Run
  130. SYSCOLS 1.0 and activate the desired color template (by selecting the color
  131. template in the listbox and press the Set pushbutton), then in another OS/2 2.0
  132. session, run SYSCOLS version 2.0 and save the template (by pressing the Save
  133. pushbutton, giving the name you wish to save it to, and pressing the Ok
  134. pushbutton).   The new color template will be added using OS/2 2.0's default
  135. values for the colors which are new to OS/2 2.0.   SYSCOLS version 1.0 runs fine
  136. under OS/2 2.0, however it does not know about OS/2 2.0's new color items
  137. (ShadowHiLiteBgnd, ShadowHiLiteFgnd, ShadowText, EntryField, MenuDisabledText,
  138. MenuHiLiteText, MenuHiLite, PageBackground, and FieldBackground).  Note that
  139. SYSCOLS expects SYSCOLS.INI to be in the same directory, so when running the two
  140. versions at the same time, it is important to either run the programs from
  141. different directories (do not just rename of the the executables), or rename all
  142. the files (EXE, INI, and HLP) associated with one version.
  143.  
  144.  
  145.  
  146. ACTIONS
  147.  
  148. The following is a brief description of the available actions for this program.
  149. Further details can be found in the on-line help (F1).
  150.   Reset   to colors which were active when the program was invoked
  151.   Read    data file containing color codes to set
  152.   Keep    current screen colors for future sessions (Save to OS/2's .INI file)
  153.   Write   current color codes to data file
  154.   Set     colors to those defined in the color template selected in the
  155.           Color Templates list box
  156.   Default sets individual item (i.e. Icon Text, Window Text, Background) to
  157.           OS/2 2.0's default color
  158.   Delete  color template
  159.   Set     system colors object (i.e. Icon Text, Window Text, Background) to
  160.           the color displayed in the sample color region
  161.   Save    the currently selected system colors object and the color
  162.           selected in the sample area to an existing or new Color Template
  163.  
  164.  
  165. REVISION HISTORY 
  166.  
  167.    *  ver 2.0   July, 1992
  168.  
  169.       Support for additional colors defined by OS/2 version 2.0.
  170.  
  171.       Default action added to set an individual item to OS/2 2.0's
  172.       default color.
  173.  
  174.       Additional color templates available in the default SYSCOLS.INI file.
  175.  
  176.  
  177.  
  178.    *  ver 1.0   June, 1991
  179.  
  180.       Originally, SYSCOLS development and testing began under OS/2 1.2 and
  181.       continued under version 1.3.
  182.  
  183.  
  184. REGISTRATION
  185.  
  186.    I would be most greatful for any comments, suggestions, and/or bug
  187.    reports.  SYSCOLS is distributed as-is, with no warranties involved.
  188.  
  189.    You may give individual copies of the unregistered version SYSCOLS to
  190.    friends, associates, collegues, etc. for evaluation purposes, however,
  191.    please include the files SYSCOLS.EXE, SYSCOLS.HLP, SYSCOLS.INI, and
  192.    SYSCOLS.DOC without any modification.
  193.  
  194.    If you use SYSCOLS, please send a small donation of $15.00 so that I
  195.    can prove to my husband that all the long hours I spend with my PC
  196.    instead of with him are really worth something.  Thank you.
  197.    
  198.  
  199.    Donna Campanella
  200.    508 Natalie Lane
  201.    Norristown, PA 19401
  202.  
  203.    CompuServe 72010,2305
  204.    Prodigy    KCTW07A
  205.  
  206.