home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 138.lha / Colors / README < prev    next >
Encoding:
Text File  |  1986-11-20  |  4.1 KB  |  126 lines
  1.                                  COLORS
  2.                    Written by Tom Krehbiel, June 1988
  3.  
  4.  
  5.     This program in its executable form, along with the assembly source
  6. listing, is in the public domain.  They may be freely distributed to any
  7. BBS or person, provide that you (1) be sure you distribute ALL of the
  8. files listed below, and (2) do not charge any fee for distribution (who
  9. would buy this anyway?).  Feel free to make any modifications to the source
  10. code you wish, but if you redistribute it, please leave my name in it
  11. someplace.  If you have any questions or comments, I can be reached at:
  12.  
  13. Tom Krehbiel
  14. 10747 Surry Road
  15. Chester, VA 23831
  16.  
  17. or through David Krehbiel (yes, we're related) on Compuserve (70701,1515).
  18.  
  19.  
  20.                               IN THE ARC FILE
  21.  
  22.     The following files should be in the ARC file:
  23.  
  24.     Colors              - the program
  25.     WB_Colors.info      - sample Workbench color icon
  26.     CLI_Colors.info     - another sample color icon
  27.     MyColors            - a sample CLI color file
  28.     EXECUTE.ME          - to rename the files properly
  29.     README              - this document
  30.  
  31.  
  32.     I am distributing this mainly for Assembly programmers who are looking
  33. for example code.  It is not intended to DO a great deal, although I
  34. find that it works quite well in conjunction with my PopFuncs program (ie,
  35. just program a function key with "`C:Colors -S:My_Colors'" and you can have
  36. a color changer at the touch of a button).  Oh well, on to the documentation:
  37.  
  38.  
  39.  
  40.  
  41.                               HOW TO RUN IT
  42.  
  43.     Colors can be run three different ways.  There are (in the order I
  44. programmed them):
  45.  
  46.  
  47. METHOD 1:
  48.  
  49. 1> Colors 000 eef 345 899   (RETURN)
  50.  
  51.     This method works only from CLI (obviously).  In this method, you type
  52. the name of the program and then follow it with four sets of rgb color
  53. values.  Each rgb set has the form:
  54.  
  55.     <red component><green component><blue component>
  56.  
  57. where each component is a hex number from 0 to f, representing the
  58. amount of that color.   Examples:
  59.  
  60.     f00     would be bright red,
  61.     0f0     would be bright green,
  62.     00f     would be bright blue.
  63.  
  64.     Note that a-f's must be lower case.
  65.  
  66.  
  67. METHOD 2:
  68.  
  69. 1> Colors -MyColors
  70.  
  71.     This method also works only from CLI.  This way you can put the four
  72. rgb triplets in a disk file, so that you don't have to type them in each
  73. time.
  74.  
  75.     You do this by making a standard text file with the four rgb triplets
  76. (that you would have typed in on the command line in Method 1) at the
  77. very start of the file (NOTE: they must start at the first character of
  78. the file).  Then type 'Colors', a space, then a dash, and then the name
  79. of the file containing the rbg triplets.  The dash is very important!
  80.  
  81.     As you might have guessed, I did this because I got sick of typing in
  82. long command lines.
  83.  
  84.  
  85. METHOD 3:
  86.  
  87. From the Workbench, double click on a Color Definition icon.
  88.  
  89.     This is the Workbench method.  To use this method, you should put the
  90. Colors program in your C: directory (that's why I did this in assembly, so
  91. it wouldn't be very big).  Then make a PROJECT icon (see examples in the
  92. ARC file) with the following information:
  93.  
  94.     DEFAULT TOOL -  This should have the path name of the Colors program.
  95.                     If you have it in your C: directory, type this in:
  96.  
  97.                         C:Colors
  98.  
  99.                     and that should work.
  100.  
  101.     TOOL TYPES -    This is where you put the four rgb triplets.  Type in
  102.                     "COLORS=" and then the four rgb triplets just like
  103.                     you would use in Method 1 or 2.  Example:
  104.  
  105.                         COLORS=008 fff 000 f50
  106.  
  107.                     Note:  "COLORS" must be upper case (WB peculiarity).
  108.  
  109.     You can add the above information simply by using the Workbench INFO
  110. option from the Project menu.
  111.  
  112.  
  113.                               AFTERWORD
  114.  
  115.     Well, I guess that's about it.  I tried to comment the source code
  116. as much as I could, but if you have trouble reading it or have questions
  117. about why I did something a particular way, let me know.  This is actually
  118. *my* first 68K assembly project, so there are probably a few inefficiencies
  119. in it in places.
  120.  
  121.     Have fun with it!
  122.  
  123.     -Tom-
  124.  
  125.  
  126.