home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / tools / syscols / syscols.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1992-07-18  |  13.7 KB  |  449 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. PM System Color Keys ΓòÉΓòÉΓòÉ
  3.  
  4. Accelerator mnemonic keys: 
  5.  
  6. F3 
  7.    Exit 
  8.  
  9. F1 
  10.    Help 
  11.  
  12. R 
  13.    Reset 
  14.  
  15. D 
  16.    reaD 
  17.  
  18. K 
  19.    Keep 
  20.  
  21. W 
  22.    Write 
  23.  
  24. S 
  25.    Set 
  26.  
  27. L 
  28.    deLete 
  29.  
  30. T 
  31.    seT 
  32.  
  33. V 
  34.    saVe 
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ 2. Extended Help for PM System Colors ΓòÉΓòÉΓòÉ
  38.  
  39. This program offers configuration of OS/2 Presentation Manager's system colors. 
  40. Features include: 
  41.  - All 41 system colors can be changed.  whereas the .........Control 
  42. Panel........ only allows configuration of 26 colors. 
  43.  - Most color changes are visible immediately. 
  44.  - Sample Color Templates are available.  Additional Templates can be created, 
  45. or existing ones can be modified. 
  46.  - Colors can be set temporarily or permanently. 
  47.  - A color template can be loaded from the command line (ideal for use in .CMD 
  48. files). 
  49.  
  50. The system colors in OS/2 1.x are: 
  51.  
  52. ButtonLight - Top and left edges of scrollbar slider box 
  53. ButtonMiddle - Scrollbar slider box and pushbuttons 
  54. ButtonDark - Right and botton edges of scroll bar slider box 
  55. ButtonDefault - Outline of default pushbutton 
  56. TitleBottom - Thin line outlining action or menu bar 
  57. Shadow -  Shadow around edge of pull down menus 
  58. IconText -  Text under icons 
  59. DialogBackground -  Background for dialogue boxes 
  60. HiLiteForeground - Text of hilighted selection 
  61. HiLiteBackground - Hilighted selection menu bar 
  62. InActiveTitleTextBgnd - Inactive title-text background 
  63. ActiveTitleTextBgnd - Active title-text background 
  64. InActiveTitleText - Text of menu or action bar on inactive windows 
  65. ActiveTitleText - Text of menu or action bar on active window (window with 
  66. focus) 
  67. OutputText - Appears in dialogue boxes as default text in entry fields 
  68. WindowStaticText - Static window text 
  69. ScrollBar - Background for scroll bar (note: not slider box) 
  70. Background - Screen background 
  71. ActiveTitle - Text on title bar of active window 
  72. InActiveTitle - Text on title bar of inactive window 
  73. Menu - Menu or action bar background 
  74. Window - Background of window 
  75. WindowFrame - Thin border line outlining all windows 
  76. MenuText - Text of menu or action bar 
  77. WindowText - Window normal text 
  78. TitleText - Title text 
  79. ActiveBorder - Border around active window (window with focus) 
  80. InActiveBorder - Border around inactive windows 
  81. AppWorkSpace - Application background 
  82. HelpBackground - Background for help screens 
  83. HelpText - Text for help screens 
  84. HelpHiLite - Highlighted text for help screens 
  85.  
  86. OS/2 2.0 added the following colors: 
  87.  
  88. ShadowHiLiteBgnd - Background of shadowed icon text 
  89. ShadowHiLiteFgnd - Foreground of shadowed icon text 
  90. ShadowText - Shadowed icon text 
  91. EntryField - Background of entry fields 
  92. MenuDisabledText - Text of disabled menu options 
  93. MenuHiLiteText - Text of hilighted menu options 
  94. MenuHiLite - Background of hilighted menu options 
  95. PageBackground - Tabs and outline on certain Notebook controls (Find is one 
  96. example) 
  97. FieldBackground - Tabs and outline on Notebook controls 
  98.  
  99. Note that with OS/2 2.0, depending on the color used as the background (Window) 
  100. for pop-up folders, you may have to change the Icon Text used in individual 
  101. folders so that it is visible. 
  102.  
  103. (*) indicates that only pure colors can be applied to this system object 
  104. (+) non-pure colors can be applied to scroll box slider buttons, but not to 
  105. push buttons. 
  106. Apparently, Presentation Manager does it's best to find matching display colors 
  107. for the colors you choose, however for colors applied to certain system 
  108. objects, the results may be different from that displayed in the sample color 
  109. area.  This is most likely due to Presentation Manager's rejection of dithered 
  110. colors for some settings.  Those system objects that do not seem compatible are 
  111. marked with (*). 
  112. (=) On the OS/2 systems I have had experience with, setting colors for these 
  113. system objects has no visible effect.  I'm not positive where these system 
  114. objects appear, but apparently they have something to do with 'Function Key 
  115. Areas'.  At any rate, they are documented as system colors and may very well be 
  116. "reserved for future use"  items.  If anyone can provide a screen or 
  117. application where these colors appear, I would greatly appreciate the 
  118. information. 
  119.  
  120. Actions for PM System Color Configuration: 
  121.  
  122. The following actions may be invoked by clicking on the pushbutton 
  123. corresponding to the action, or by pressing the letter corresponding to the 
  124. underlined mnemonic character. 
  125.  
  126. R 
  127.    Reset to original colors 
  128.  
  129. D 
  130.    Read data file containing color codes to set 
  131.  
  132. K 
  133.    Keep current screen colors for future sessions (Save to OS/2's .INI file) 
  134.  
  135. W 
  136.    Write current color codes to data file 
  137.  
  138. S 
  139.    Set colors to those defined by the color template selected in the Color 
  140. Templates list box 
  141.  
  142. F 
  143.    Default sets system colors item (i.e. Icon Text, Window Text, Background) to 
  144. OS/2's default color 
  145.  
  146. L 
  147.    Delete color template 
  148.  
  149. T 
  150.    Set system colors item (i.e. Icon Text, Window Text, Background) to the 
  151. color displayed in the sample color region 
  152.  
  153. V 
  154.    Save the currently selected system colors item and the color selected in the 
  155. sample area to an existing or new Color Template 
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 3. Help for Reset ΓòÉΓòÉΓòÉ
  159.  
  160. This action resets the colors back to the ones which were active when this 
  161. program was invoked  (which may or may not be OS/2's original colors depending 
  162. upon if you have changed them with other OS/2 utilities. 
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ 4. Help for Read ΓòÉΓòÉΓòÉ
  166.  
  167. This action reads a data file containing color codes to set.  The data file 
  168. must be a pure ASCII text file containing one line for each of the 41 colors. 
  169. If you like the colors loaded from the data file, use the action Save to save 
  170. the colors to a template name. 
  171.  
  172. The order of the colors in the data file is as follows: 
  173.  
  174.  1. ShadowHiLiteBgnd 
  175.  
  176.  2. ShadowHiLiteFgnd 
  177.  
  178.  3. ShadowText 
  179.  
  180.  4. EntryField 
  181.  
  182.  5. MenuDisabledText 
  183.  
  184.  6. MenuHiliteText 
  185.  
  186.  7. MenuHilite 
  187.  
  188.  8. PageBackground 
  189.  
  190.  9. FieldBackground 
  191.  
  192. 10. ButtonLight 
  193.  
  194. 11. ButtonMiddle 
  195.  
  196. 12. ButtonDark 
  197.  
  198. 13. ButtonDefault 
  199.  
  200. 14. TitleBottom 
  201.  
  202. 15. Shadow 
  203.  
  204. 16. IconText 
  205.  
  206. 17. DialogBackground 
  207.  
  208. 18. HiLiteForeground 
  209.  
  210. 19. HiLiteBackground 
  211.  
  212. 20. InActiveTitleTextBgnd 
  213.  
  214. 21. ActiveTitleTextBgnd 
  215.  
  216. 22. InActiveTitleText 
  217.  
  218. 23. ActiveTitleText 
  219.  
  220. 24. OutputText 
  221.  
  222. 25. WindowStaticText 
  223.  
  224. 26. ScrollBar 
  225.  
  226. 27. Background 
  227.  
  228. 28. ActiveTitle 
  229.  
  230. 29. InActiveTitle 
  231.  
  232. 30. Menu 
  233.  
  234. 31. Window 
  235.  
  236. 32. WindowFrame 
  237.  
  238. 33. MenuText 
  239.  
  240. 34. WindowText 
  241.  
  242. 35. TitleText 
  243.  
  244. 36. ActiveBorder 
  245.  
  246. 37. InActiveBorder 
  247.  
  248. 38. AppWorkSpace 
  249.  
  250. 39. HelpBackground 
  251.  
  252. 40. HelpText 
  253.  
  254. 41. HelpHiLite 
  255.  
  256. OS/2 specifies colors with 24 bits of Red-Green-Blue intensity information. 
  257. Since there are 8 bits for each color, the valid ranges are from 0 to 255. The 
  258. integers represent the Red, Green, and Blue components of an RGB color value. 
  259.  
  260. Some example colors are: 
  261.  
  262. White   255  255  255
  263. Yellow  255  255    0
  264. Pink    255    0  255
  265. Cyan      0  255  255
  266. Blue      0    0  255
  267. Green     0  255    0
  268. Red     255    0    0
  269. Black     0    0    0
  270.  
  271. The data file should contain a line for each of the 41 colors in the order 
  272. outlined above.  The leftmost integer is the Red value, the middle integer is 
  273. the Green value, and the rightmost integer is the Blue value. 
  274.  
  275. Sample data file: 
  276.  
  277. 128 128 128
  278. 255 255 255
  279. 128 128 128
  280. 255 255 204
  281. 128 128 128
  282.   0   0   0
  283. 204 204 204
  284. 255 255 255
  285. 204 204 204
  286. -----------
  287. 255 255 255
  288. 204 204 204
  289. 128 128 128
  290. 0 0 0
  291. 128 128 128
  292. 128 128 128
  293. 0 0 0
  294. 204 204 204
  295. 255 255 255
  296. 128 128 128
  297. 204 204 204
  298. 64 128 128
  299. 128 128 128
  300. 255 255 255
  301. 0 0 0
  302. 0 0 128
  303. 192 192 192
  304. 128 128 128
  305. 64 128 128
  306. 204 204 204
  307. 204 204 204
  308. 255 255 255
  309. 128 128 128
  310. 0 0 0
  311. 0 0 0
  312. 255 255 255
  313. 255 255 128
  314. 204 204 204
  315. 255 255 224
  316. 255 255 255
  317. 0 0 128
  318. 0 128 128
  319.   --------------- 255 255 255 204 204 204 128 128 128  0  0  0 204 204 204 128 
  320. 128 128  0  0  0 255 255 255 255 255 255  0  0  0  0  0  0  0  0  0  0  0  0 
  321. 255 255 255  0  0  0  0  0 128 224 224 224 192 192 192  0  64 128 255 255 255 
  322. 255 255 255 255 255 255  0  0  0  0  0  0  0  0  0 255 255 255 128 128 128 255 
  323. 255 255 255 255 232 255 255 255  0  0 128  0 128 128 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 5. Help for Keep ΓòÉΓòÉΓòÉ
  327.  
  328. This action saves the current colors for future sessions by writing to OS/2's 
  329. OS2.INI file.  OS2.INI is an initialization file that OS/2 processes when the 
  330. system is started. 
  331.  
  332.  
  333. ΓòÉΓòÉΓòÉ 6. Help for Set Color Template ΓòÉΓòÉΓòÉ
  334.  
  335. This action sets the system colors to the colors defined by the currently 
  336. highlighted selection in the Color Templates list box. 
  337.  
  338. To reset the colors back to the ones which were active when this program was 
  339. invoked, click the Reset pushbutton. 
  340.  
  341. When the program loads, it searches the current directory for it's own .INI 
  342. file to load the Color Template names.  If the .INI file is not found, a 
  343. message box is displayed. 
  344.  
  345. If you exit (close) this program (without selecting Keep), the colors will 
  346. remain in effect, however, when the system is shutdown and brought back up 
  347. again, the "original" colors will once again be in effect (since the colors 
  348. were not saved to OS/2's OS2.INI file with the Keep action). 
  349.  
  350. A Color Template name can be specified on the command line. If a parameter is 
  351. given on the command line, the interactive Presentation Manager screen will not 
  352. be invoked. 
  353.  
  354.  
  355. ΓòÉΓòÉΓòÉ 7. Help for Delete ΓòÉΓòÉΓòÉ
  356.  
  357. This action removes a Color Template.  Since you cannot "undelete" a color 
  358. template, you will be prompted to confirm the deletion. 
  359.  
  360. This action removes a Color Template.  Since you cannot restore a deleted color 
  361. template, you will be prompted to confirm the deletion. 
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ 8. Help for Set System Color Item ΓòÉΓòÉΓòÉ
  365.  
  366. This action sets the currently selected system item (i.e. WindowStaticText, 
  367. ScrollBar, Background, etc.) in the System Colors listbox to the color 
  368. currently displayed in the sample color region.  This action affects only the 
  369. currently selected system item. 
  370. Selecting Reset or Set Color Template will override the individual colors 
  371. previously set with this option. 
  372.  
  373. The Color Template "Different", although some may think it ugly, serves to 
  374. demonstrate each system item as a different color. 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 9. Help for Save to Color Template ΓòÉΓòÉΓòÉ
  378.  
  379. This action saves the current system colors to an existing or new Color 
  380. Template.   The default color template to save to is the one highlighted in the 
  381. Color Templates list box, however, another template can be specified. 
  382.  
  383. To build (or modify) a template, select the system color item in the System 
  384. Colors listbox that you want to change (i.e. Icon Text, WindowText, Background, 
  385. etc.), use the scrollbars to choose a color, then use Set (next to the System 
  386. Colors listbox) to test the color.  Then, optionally, use save to save the 
  387. changes to a Color Template. 
  388.  
  389.  
  390. ΓòÉΓòÉΓòÉ 10. Help for Write Data File ΓòÉΓòÉΓòÉ
  391.  
  392. This action writes the current color setting codes to a file.  This is handy to 
  393. transfer color setting between systems.  If a friend has colors that you would 
  394. like to add to your Color Templates, simply have him/her save their colors to a 
  395. data file, then use Read to load the colors on your system, and optionally save 
  396. them to a Color Template. 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 11. Loading Templates from Command Line ΓòÉΓòÉΓòÉ
  400.  
  401. A Color Template name can be specified on the command line. 
  402. Command line syntax is: 
  403.  
  404. SYSCOLS ["]templatename["] [/L] 
  405.  
  406. where templatename is space-sensitive but not case-sensitive, and /L indicates 
  407. to load the main System Colors Configuration Presentation Manager screen after 
  408. changing the colors. 
  409.  
  410. Specifying Color Templates on the command line without loading the main screen 
  411. is useful for .CMD files, especially if you run a program that conflicts with 
  412. your default color choices.  Simply put the lines 
  413.  
  414. SYSCOLS "newtemplatename" 
  415. <commands to run confliciting program> 
  416. SYSCOLS "default or oldtemplatename" 
  417.  
  418. in a .CMD file to set colors compatible with the program, run the program, and 
  419. then set the colors back to your favorite selection. 
  420.  
  421. No action is taken if the Color Template name given on the command line is not 
  422. found in this program's .INI file.  Note that the Color Template name is not 
  423. case sensitive, but if the Color Template name consists of two or more words, 
  424. the template name must be enclosed in " ". 
  425.  
  426. For example, 
  427. SYSCOLS "Penn State"    is valid 
  428. SYSCOLS "penn state"    is valid 
  429. SYSCOLS "pEnN sTaTe"    is valid 
  430. SYSCOLS penn state    is not valid 
  431. SYSCOLS pennstate    is not valid 
  432. SYSCOLS PennState    is not valid 
  433.  
  434. If a paramter is given on the command line, the program simply searches for the 
  435. Color Template in the .INI file, and if it is found, the system colors are 
  436. changed.  If the template name is not found, the colors do not change. In 
  437. either case, the Presentation Manager interactive screen is not invoked unless 
  438. /l or /L is given as the second parameter. 
  439. SYSCOLS "penn state"  /l   would change the colors and load the program. 
  440. SYSCOLS "invadid template"  /l   would not change the colors, however the main 
  441. System Colors Configuration Presentation Manager screen would be loaded 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ 12. Help for Default ΓòÉΓòÉΓòÉ
  445.  
  446. This action sets the currently selected system item (i.e. WindowStaticText, 
  447. ScrollBar, Background, etc.) in the System Colors listbox to OS/2 2.0's default 
  448. color.  This action affects only the currently selected system item. 
  449.