home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / screen / colours.lzh / colour.doc < prev    next >
Text File  |  1990-05-31  |  5KB  |  117 lines
  1.  
  2. /*------------------------------------------------------------------------*/
  3.  
  4. Colour    - make a screen any colour you like, and load & save colour sets.
  5. ------
  6.  
  7. Copyright 1987, John Russell
  8.  
  9. 5 Alderdice Place
  10. St. John's, Newfoundland
  11. Canada     A1B 2P8
  12. (709) 726-7847
  13.  
  14. UseNet: john13@garfield.uucp
  15.     john13@garfield.mun.cdn
  16.  
  17. Freely redistributable.
  18.  
  19. /*------------------------------------------------------------------------*/
  20.  
  21.     This program has 4 uses:
  22.  
  23.     First, you can experiment with different colour combinations by actually
  24. specifying numeric parameters for Red, Green, and Blue. You can also do the
  25. same with numerous programs which use "slider gadgets", but I include the
  26. capability for completeness. Note there's also a slider-gadget option in
  27. this program which you can enable at compile time.
  28.  
  29.     Second, once you have found a colour combination you like, whether it's
  30. on your Workbench screen, or on the screen of some other program, you
  31. can save it to disk. The format of the saved file is very simple - for a
  32. screen with N colours, there are N lines with 3 integer values each, for
  33. Red, Green, and Blue which combine to any of the Amiga's 4096 possible
  34. colours.
  35.  
  36.     Third, you can instantly load this definition back in, and specify the
  37. screen whose colours you want to change. You can thus have special colours
  38. to use when running a word processor, terminal program, CLI session, etc.
  39. I personally have about 5 sets of colours I use depending on my mood, if
  40. my eyes are tired, if my monitor will be on for a long time and I want to
  41. save a few phosphor molecules, etc.
  42.  
  43.     Fourth, if you want to experiment with different colour combinations
  44. interactively, you can bring up a colour window requestor on a specified
  45. screen. This has the standard slider gadgets for adjusting colours and
  46. also features like copy, undo, and range. The range option is the only
  47. one that is not immediately obvious -- after selecting it, choose 2
  48. colours in the palette and all colours in between will be changed to
  49. a gradation somewhere between the two endpoints.
  50.  
  51. NB: This last option of the colour requestor may be omitted when the
  52. program is compiled (this saves about 5K), since many other programs
  53. are available that accomplish the same function. However I prefer to
  54. leave it enabled since the code doesn't have to stay in memory at all
  55. times as it does in most other similar utilities.
  56.  
  57. ------
  58. SYNTAX
  59. ------
  60.  
  61. To set one particular colour, on one particular screen -
  62. colour set <screen> index red green blue
  63.  
  64. To load a group of colours -
  65. colour load <screen> [from] <filename>
  66.  
  67. To save a group of colours -
  68. colour save <screen> [to] <filename>
  69.  
  70. To adjust colours with the mouse -
  71. colour adjust <screen>
  72.  
  73. If the screen has no title, you can specify "-null" in place of the title,
  74. in which case the first screen with no title is used. Only the first word
  75. of the title is considered, and case is not important. When loading a colour
  76. file, the current directory is searched first and then the S: directory.
  77. If the S: directory must be searched, the suffix ".col" is assumed to be
  78. present; thus the following two forms are equivalent :
  79.  
  80. colour load workbench from black-and-white
  81. colour load workbench from s:black-and-white.col
  82.  
  83. Examples -
  84.  
  85. colour set workbench 0 0 0 0      : sets Workbench background to black.
  86. colour load vt100 from modem.col  : set VT100 seperate screen colours.
  87. colour save -null to dpaint.col   : saves DPaint palette; screen has no title
  88. colour load workbench wb.col      : use the old Workbench colours
  89. colour save mandelbrot mand.col   : save a pretty-looking palette
  90. colour adjust workbench       : fairly powerful interactive control
  91.  
  92. ------------
  93. DISTRIBUTION
  94. ------------
  95.  
  96.     This program is freely redistributable; no fees beyond reasonable charge
  97. for media may be charged. 
  98.  
  99.     Source is included with this initial posting, along with an encoded
  100. version of the executable. The source may be informative if you are
  101. interested in how colours relate to the structure of the screen they affect.
  102. If you pass this program on, please keep at least this documentation with
  103. the executable. In the spirit of Canadian nationalism, I ask that you not 
  104. change the spelling of the excutable -- the "u" is supposed to be there.
  105.  
  106.     A portion of the source is derived from a public domain colour
  107. manipulation program. This section carries its own copyright notice and
  108. distribution conditions, which are present in the file colorreq.c if you
  109. have a copy of the source.
  110.  
  111.     No donations are solicited; however if you send me a disk with public
  112. domain software that you find useful (and possibly hasn't received wide
  113. distribution), I'll do the same from this end with some lesser-known programs
  114. that I use a lot.
  115.  
  116. John
  117.