home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 148.lha / Planes_v1.1 / Readme < prev    next >
Encoding:
Text File  |  1980-11-15  |  14.4 KB  |  272 lines
  1.  
  2. =============================================================================
  3.  
  4.           More colors on the Worbench Screen (The sequel) 11/25/87 (orig.)
  5.                           New version 1.1 - 7/12/88
  6.  
  7.                              By David M. Pochron
  8.                                (aka:  The MCP)
  9. =============================================================================
  10.  
  11.  
  12. OVERVIEW:
  13. --------
  14.  * Note: Some bugs have been fixed see end of document for more details.
  15.  * Note: I suggest you read this whole file before using this program! (Big
  16.          document for such a teeny program, ain't it??)
  17.  
  18.     Here it is! What I thought originally would imvolve complex routines to
  19. open and close the WorkBench screen with more bitplanes and such, only
  20. required minimal programming. The OS in the Amiga is so versatile, it took
  21. the changes with open arms. (er- almost, that is)
  22.     Nevertheless, eight colors (or more) is possible on all Amigas now, with
  23. or without the KickStart in ROM. (That means you, Amiga 500/2000/2500/3000(?)
  24. owners!)
  25.    The program ties into the screen structures and just appends a new bitplane
  26. on to it. That's it! The program can be executed at any time during the
  27. session, so you need not even alter your Startup-Sequence, (though that is
  28. the best time to activate the program)
  29.    The programs included with this ARC file are all 100% assembly language
  30. so the code is quite small. (Besides, I love assembly language!)
  31.  
  32.  
  33. WHAT YOU GET WITH THIS ARC FILE:
  34. -------------------------------
  35. ARCed Name:      Should be named as:   Description:
  36. ------------------------------------------------------------------------------
  37. Planes           BitPlanes             Program that makes 8/16 color WB! v.1.1
  38. Planes.info      BitPlanes.info        Icon for the above program
  39. Readme           Readme                This file (duh!)
  40. Readme.info      Readme.info           Nice 8 color project icon for this file
  41. Disk.info        Disk.info             3 bitplane disk icon
  42. Trash.info       Trashcan.info         3 bitplane trashcan icon
  43. CLI.info         CLI.info              3 bitplane CLI icon
  44. Drawer.info      Drawer.info           3 bitplane drawer icon
  45. Setcolor         SetColor              Program to set color registers 0-15
  46. Savecolor        SaveColor             Program to save the colors currently
  47.                                          being used on the WB screen
  48. Lauren.info      Lauren.info           *4* bitplane icon (the famous "Lauren"
  49.                                          pic, courtesy of NewTek's Digi-View!)
  50.                                          (with help from Butcher & Dpaint II!)
  51. New 1.1 stuff:
  52. FixIcon.bas  \
  53. MakeIcon.bas  >---See end of document for details
  54. ICON.BMAP    /
  55.  
  56. USING THE BITPLANE PROGRAM:
  57. --------------------------
  58.    The BitPlanes program, which changes the number of bitplanes on the screen
  59. can be called from CLI or from Workbench. When using it from CLI, (the best
  60. place to use it) the format for the call is:
  61.  
  62. BITPLANES [n]    (where n is a value from 3 to 8)
  63.  
  64. For now, the only real "legal" values you can use are 3 or 4. A three will
  65. give you 8 colors, and a four will give you a maximum of 16 colors. If you
  66. give no value, it defaults to 3 bitplanes. If you have already installed the
  67. extra bitplanes and run the program again, any value passed in is ignored and
  68. the screen is toggled back to 2 bitplanes again. (the normal WorkBench screen)
  69.  
  70.    If you run this program from WorkBench by clicking on its icon, you can
  71. get a 16 color WB screen by keeping the left mouse button pressed after you
  72. double-click the icon. The program isn't going to take too long to load so
  73. you had better be fast! If you only want 8 colors, just double-click the icon
  74. and make sure the left mouse button is not pressed while the program executes.
  75. Again, if you run this program after more colors have been installed, it
  76. will toggle back to a 4 color WorkBench screen no matter whether you are
  77. keeping the button depressed or not.
  78.    After the extra bitplanes are installed, it will probably be necessary to
  79. use the "Redraw" function under the Workbench "Special" menu, so all the
  80. icons are re-rendered in their full colors.
  81.  
  82.    Still, the best place to execute this program is at the beginning of a
  83. startup-sequence, since the WorkBench usually hasn't been loaded so all the
  84. menus and icons will come up rendered properly. Also, if you add bitplanes
  85. after a huge hunk of chip memory has been allocated by another program, and
  86. then that program deallocates that memory, the extra bitplanes will end up
  87. sitting like and island in the middle of chip memory. Not a good situation!
  88.  
  89.    One other note: this program works FINE with interlaced workbench
  90. screens!
  91.  
  92.    Finally, this program automatically sets the first 16 color registers to
  93. the values my icons included with this arc file need. If you want a different
  94. set of colors, use the Set&SaveColor programs (see below) or use a disk
  95. editor (like NewZap) and edit the RGB values. The data for these values is
  96. CLEARLY marked in the Bitplanes programs as to where they begin, so changing
  97. the values should be no problem.
  98.    Note that the color registers are set WHENEVER the program is run - even
  99. when it is toggling back to 2 bitplanes, so keep that in mind.
  100.  
  101.    An interesting side effect: If you have another screen open at the time
  102. this program is run, the bitplanes will be modified for THAT screen! This is
  103. particularly useful for terminal programs that you want to have more colors
  104. on - like Comm 1.34.
  105.  
  106.  
  107. SETCOLOR AND SAVECOLOR
  108. ----------------------
  109.    These programs are similar to the Set & Save color programs included in
  110. the original KickStart mod, except they set all colors from 0 to 15. They
  111. still use the file "Color.palette" as the source & destination file. Since
  112. the BitPlanes program automatically sets the colors when it is run, these two
  113. files are actually not really necessary. I included them just in case you
  114. didn't have a disk editor to change the default colors in BitPlanes and you
  115. wanted your own set of colors. (You will need a program like PopColors,
  116. however, to set your own RGB values on the screen before saving them.)
  117.  
  118.  
  119. MAKING 8 & 16 COLOR ICONS:
  120. -------------------------
  121.    Obviously, you can't use the existing icon editor anymore if you want to
  122. create icons with more than four colors. Until someone writes an icon editor
  123. with a variable # of bitplanes, a utility to make IFF brushes into icons will
  124. usually do the trick. Some icon zappers (as they are called) won't create
  125. icons with more than 3 bitplanes, so depending on the icon zapper you have,
  126. you may be limited to just 8-color icons. (I included a icon zapper I wrote
  127. in BASIC which will do all 16 colors and tool types.)
  128.    To make Lauren an icon, I used DigiView 2.0 to convert her to a B&W image,
  129. then went to Dpaint II and removed the background. I then used Butcher to fit
  130. the image into the color registers I wanted and finally used an icon zapper
  131. written in BASIC from Compute! magazine.
  132.  
  133.  
  134. CAVEAT EMPTOR: (or let the user beware!)
  135. -------------
  136.    Okay, as in the text that went with my previous KickStart mod, some icons
  137. don't work quite right when extra bitplanes are added. Also, backfill doesn't
  138. work with icons having more than 2 bitplanes. Most 2 bitplane icons work fine
  139. with the mod, though animated ones won't show when they are dragged - add a
  140. bitplane to 'em and they'll work fine. Again, although the OS exhibits no
  141. real problems when more planes are added, if you run it from an icon, the
  142. menus may not get rendered properly the first few times they are used. Also,
  143. if a window is covering a CLI window when the program is run from an icon,
  144. garbage will appear in part of the CLI window that was covered. Drag &
  145. resize the CLI window to clear out this garbage. (If you run the program at
  146. the beginning of a startup-sequence, none of these rendering problems will
  147. occur, of course!)
  148.    The biggest caveat is the fact that although the program will let you have
  149. 4 bitplanes on a WorkBench screen, the computer slows down a great deal.
  150. Use 4 bitplanes only for demoing purposes. (ex: "wow" your Mac & ST friends
  151. by inserting a disk and having your digitized face come up as the disk icon!)
  152. (* Note see new version additions for a problem the occurs with certain icons
  153. in 16 colors...)
  154. Use 3 bitplanes for normal computer use. If you really need digitized icons
  155. during normal everyday use, consider setting the first 8 color registers to 8
  156. shades of grey and then use dithering to get 16 shades. This should look even
  157. better than the Lauren icon, as it only uses *12* of 16 shades available on
  158. the Amiga.
  159.  
  160.  
  161. RULES:
  162. -----
  163.    Okay, this program is almost as "PD" as "PD" can get. You can hack at it
  164. all you like, include it in commercial (or system) software with no fees
  165. whatsoever, and pass it around as you like. The only thing I ask is
  166. you not change the credits and version info located within the BitPlane,
  167. Fixicon, and Makeicon programs themselves. This text file you are reading does
  168. not need to be included with any commercial software the Bitplanes program is
  169. used with. People uploading this ARC file to other BBSes, however, ought to
  170. leave this document intact, included with the other files.
  171.    The icons, of course, are free for everyone to use - even Commodore-Amiga
  172. in their new Workbench releases. (1.3? 1.4?? 1.5??? 2.0?!?!)  (grin!)
  173. (PS: except Lauren - I don't know how NewTek would take to seeing their
  174. demo picture show up in someone else's commercial software!)
  175.  
  176. New 1.1 rule:
  177.    Okay, this program will no longer be known as PD...Let it be known from
  178. now on it is... (I love this term I made up) ..."SpreadWare!"
  179.    That is, the rules are exactly the same as listed above (PD) with one extra
  180. rule: If you use this program, give a copy of it to at least one other person
  181. or upload it to another BBS. (No big deal, I hope!)
  182.  
  183.  
  184.  
  185. FUTURE IMPROVEMENTS: (not in v.1.1 though!)
  186. -------------------
  187.    The first thing I'd like to do is to remove the "toggle back to 2
  188. bitplanes" when run from CLI and instead have the user just enter the # of
  189. bitplanes they want on the screen - any number from 1-8! No hassle, no fuss.
  190. Also, I hope to have it check for a Color.palette file and load it if it
  191. finds one. That way, the user wouldn't have to use separate program to set
  192. his own preferences for the color registers. Other future enhancements may
  193. include a color palette editor built-in and a # of bitplanes requester for
  194. WorkBench users. If you have any suggestions (or, heaven forbid!) find a bug,
  195. you can reach me on CompuServe via system _EMAIL_ (I don't get on too often,
  196. and messages on the Amigaforum scroll off so quickly!) at user # 72517,2102.
  197.  
  198.  
  199. That's all for now! Enjoy having more colors on Workbench! Who knows...a HAM
  200. WorkBench might just be around the corner!   (fat chance - 7/12/88)
  201.  
  202.  
  203.  
  204.  
  205. Version 1.1 fixes and bug reports: (Heaven forbid, yes!)
  206. ----------------------------------
  207.  
  208.    Unbelievable as it may sound, a bug cropped up in the Bitplanes program!
  209. Unfortunately, my own short-sightedness led to this nasty little bug. (Or,
  210. more accurately, an incompatability.)  The old version of Bitplanes ASSUMED
  211. a screen width of 640 pixels across, and only recently did I find out this
  212. causes some major problems with MOREROWS, and makes it impossible for you to
  213. change the depth of any screen other than 640 pixels across. Well, this
  214. problem is now solved as the program not only configures to the vertical
  215. resolution, but also the horizontal resolution, as it should have done in
  216. the first place. Well, almost a year late isn't TOO bad, is it? ;-)
  217.  
  218.    Other stuff: WorkBench (or is it Intuition?) has a bug in it! It seems for
  219. some reason when you change the # of planes to 4, and you have icons that
  220. use alternate images which are 2 bitplanes or less deep, as soon as you
  221. click on the icon, all the chip memory vanishes! And what's stranger is that
  222. the available memory meter will not show this, yet the menus will not draw
  223. and windows will not drag, and soon the system will crash due to no chip
  224. memory.
  225.    The problem seems to be with WorkBench (or Intuition) as it can't handle
  226. the alt. image to be displayed when it has 2 or more fewer bitplanes than the
  227. screen it's being drawn on. (ex: 3 bp screen, 1 bp icon would cause a crash,
  228. however, a 4 bp screen with a 3 bp icon works just fine) Remember: This will
  229. only happen with icons that use alt. images - the normal INVERSE icons have no
  230. problems. (Actually, I shouldn't call this a "bug" in WB as it just may not
  231. be able to handle the addition of bitplanes "on the fly" in all cases...so
  232. pardon me for doing the "blame the system software" routine.)
  233.  
  234. The Solutions? 1) Write new WorkBench or Intuition
  235.                2) Never use 4 bitplane screen
  236.                3) Make sure all animated icons are at least 3 bitplanes
  237.  
  238.    Well, the first fix is up to others, and the second is limiting, so I
  239. have included a program in this ARC file which will change the depth of any
  240. icon which falls into the crash-catagory. (2 bitplanes, alt. image) All it
  241. does is add an extra plane to the icon, and your troubles shall vanish.
  242. Plus, it fixes the "invisible dragging" problem when you use a 3 bitplane
  243. WorkBench. Course, if you are using 4 bitplanes and you bring home a friend's
  244. disk with some 2 bp, alt. image icons, your back to square one. (Besides,
  245. you're supposed to use 16 colors only for demo purposes, remember? :-> )
  246.  
  247.    I'd like to thank the people who spent their valuable time spotting these
  248. two problems. (Don't know if they want their names known so I'll just say they
  249. know who they are!)
  250.    I'd also like to thank all the users who spread the program around like I
  251. asked. Hopefully, this new "SpreadWare" version will get around even faster!
  252. Thanks!
  253.  
  254. Here is what you get with this new version ARC file:
  255.  
  256. Planes       - New version of the Bitplanes program.
  257. FixIcon.bas  - Makes sure icons have at least 3 bitplanes in them. Type in
  258.                filename of .info file and follow the prompts. (If any)
  259.                MS BASIC program
  260. MakeIcon.bas - Makes brushes into icons - written by me! Makes 8 & 16 color
  261.                icons of any tool type with no problem. MS BASIC program. Just
  262.                enter the IFF brush filename, program loads it in, then you're
  263.                asked for a .info filename that will have its image replaced
  264.                with the IFF brush image you just loaded. Simple.
  265.  
  266. The BASIC programs are easy to use, just make sure the ICON.BMAP file is
  267. located in the LIBS: directory on your Workbench disk (or HD) or in the
  268. same directory the BASIC programs reside in. There is an ICON.BMAP file in
  269. this ARC file if you don't have it handy...
  270.  
  271.                                           - David M. Pochron
  272.