home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 260.lha / DropGFX_v1.0 / DropGfx.DOC < prev    next >
Encoding:
Text File  |  1989-07-06  |  12.7 KB  |  287 lines
  1.                     * ** ***   D R O P G F X !   *** ** *
  2.  
  3.                                  Version 1.0
  4.  
  5.  
  6.                       Copyright (c)1989 by Thomas White
  7.  
  8.                   Free Software for Non-Commercial Use Only
  9.  
  10.  
  11.                      PLEASE READ THIS DOCUMENTATION FILE
  12.                             BEFORE USING DROPGFX!
  13.  
  14.  
  15.  
  16. WHAT DOES IT DO? *** ** *
  17.  
  18.     DropGfx! replaces the blank Workbench window with a bitmap picture
  19. stored in an ILBM (IFF) file.  It is a nice way to customize your Amiga
  20. system, and it helps to relieve the boredom which is caused by the
  21. monotonous blue (or whatever colour you prefer) Workbench screen.
  22.  
  23.     DropGfx! comes with a default ILBM file, cleverly named 'DropGfx.ILBM'.
  24. Use this picture to verify that DropGfx! does indeed function correctly.
  25. Then, most certainly, you will want to replace this picture with one of
  26. your own.
  27.  
  28.     When DropGfx! is started, it opens a little window on top of the
  29. Workbench screen title bar to indicate that DropGfx! is indeed active.
  30. Then it proceeds to load the requested ILBM file from disk.  After the
  31. picture is in memory, DropGfx will (by default) centre it in the Workbench
  32. window.  Then, finally, the screen's colour map will be altered to reflect
  33. the values stored in the ILBM file.
  34.  
  35.     DropGfx! will then go to sleep, and it won't wake up until you click
  36. on the close gadget of the little window.  After it awakes, DropGfx! will
  37. kindly restore the Workbench screen to its previous state.  The little
  38. window will close and DropGfx! will be no more.
  39.  
  40.     If an error should happen to occur when DropGfx! is started, the
  41. Workbench screen will flash (or beep), the little window will become active,
  42. and an error message will appear on the screen title bar.  Read this
  43. message to figure out what went wrong, and then close the little window.
  44. After you have corrected the situation, try starting DropGfx! again.
  45.  
  46.  
  47. PICTURE PARTICULARS *** ** *
  48.  
  49.     This version (1.0) of DropGfx! only works with pictures with 4 or
  50. fewer colours (that is, 1 or 2 bitplanes).  If you instruct DropGfx! to
  51. load a picture with more than 4 colours, it will simply ignore the
  52. additional bitplanes.  In this situation, the displayed image will probably
  53. look quite unlike the original picture.
  54.  
  55.     Another feature of DropGfx! is that it will take any sized ILBM picture
  56. and centre it on the screen.  So if you have DropGfx! display a 640x400
  57. image on a non-interlaced Workbench screen, you will only see the middle
  58. vertical section.  Another example could be a 320x200 picture.  In this
  59. case, the resulting image will appear tall and thin, which is not a bad
  60. physical description of myself.
  61.  
  62.     However, you may wish to display an image at a specific position on
  63. the Workbench screen.  Fortunately, DropGfx! permits you to do just that.
  64. You may specify the (x,y) coordinate on the Workbench screen at which
  65. the top, left-hand corner of the image is to appear.  Now don't go bananas
  66. if you don't know the coordinate system;  I'll show you a diagram:
  67.  
  68. (0,0)                              x                               (639,0)
  69.     ----------------------------------------------------------------
  70.     |                                                              |
  71.     |                                                              |
  72.     |                                                              |
  73.     \  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /
  74.  y  \\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//
  75.     |\/  \/  \/  \/  \/  \/  \/  \/  \/  \/  \/  \/  \/  \/  \/  \/|
  76.     |                                                              |
  77.     |                                                              |
  78.     |                                                              |
  79.     ----------------------------------------------------------------
  80. (0,199)                                                          (639,199)
  81.  
  82. So, if for example, you wanted the top, left-hand corner of the image to
  83. be in the middle of the screen, you would specify a coordinate of (320,100).
  84.  
  85.     Just to confuse you if you aren't already (I am!), you may also
  86. specify negative coordinates. (huh?)  The use of negative coordinates
  87. will cause a certain portion of the top left-hand corner to be hidden
  88. beyond the edge of the screen.  Thus a coordinate of (-320,-100) would
  89. result in the bottom right-hand corner of a 640x200 picture appearing
  90. in the top-left hand corner of the Workbench screen.
  91.  
  92.     In any case, don't specify really wierd coordinates that are less
  93. than -1024 or greater than 1024.  If you are a daring type of person,
  94. do so at your own risk.
  95.  
  96.     I suggest you use some image processing program to alter full-screen
  97. pictures to 640x200, 2 bitplanes.  If you do so, you can allow DropGfx!
  98. to centre the picture on the screen automatically, and it won't look
  99. like a scrambled image due to bitplane stripping.
  100.  
  101.  
  102. STARTING DROPGFX! *** ** *
  103.  
  104.     Enough of talk, time for action!  DropGfx! can be started from either
  105. the CLI or the Workbench.  You'll probably want to put DropGfx! in your
  106. Startup-Sequence, so I'll talk about that in detail later.  But first,
  107. we'll look at how DropGfx! is started from the Workbench.
  108.  
  109.     DropGfx! has its own icon.  Ensure that the 'DropGfx.ILBM' picture is
  110. in the same drawer as DropGfx!, and then double-click on the DropGfx icon.
  111. After a few moments, the picture should appear.  Easy!
  112.  
  113.     When you are prepared to display a different ILBM picture, copy it
  114. onto the same disk (preferably the same drawer) as DropGfx! is on.  Then
  115. select the DropGfx icon and choose 'Info' from the Workbench menu.  You
  116. should then examine the TOOL TYPES section of the Info window.  There will
  117. be a 'PICTURE=DropGfx.ILBM' tool type there.  Edit this line so that it
  118. now reads 'PICTURE=<name of your ILBM file>'.  For example, if the picture
  119. 'Seashore' was in the 'Lo-res' drawer of the disk, the tool type would
  120. read 'PICTURE=:Lo-res/Seashore'.  Don't forget to give the full pathname
  121. if the ILBM file is not in the same directory as DropGfx! is!
  122.  
  123.     To change the position of the picture on the Workbench screen, you
  124. must add the tool type "POSITION=x,y".  For example, if you wanted to
  125. display a small picture in the top, left-hand corner, you would enter
  126. "POSITION=0,0".  Remember that you can also use negative coordinates;
  127. for example, "POSITION=-320,-100".
  128.  
  129.     Using DropGfx! from the CLI is more tricky.  Here is the syntax:
  130.  
  131.                     use: DropGfx ILBM_file [xpos ypos]
  132.  
  133.     ...where 'ILBM_file' is the name of the ILBM picture file
  134.              [xpos ypos] are the optional coordinates for positioning
  135.                          the top, left-hand corner of the image
  136.                          (if no coordinates are given, the image will
  137.                           be centred on the Workbench screen)
  138.  
  139. So, as an example, if you wanted to display that 'Seashore' picture at
  140. a position of (0,-11), you would enter:
  141.  
  142.                     1> DropGfx :Lo-res/Seashore 0 -11
  143.  
  144.     However, if you type the above line in as shown, you will be unable to
  145. enter any other commands until you close the little window to make DropGfx!
  146. to go away.  This is easily solved using the 'Run' command:
  147.  
  148.                     1> RUN DropGfx :Pix/SelfPortrait
  149.  
  150.     But, (argh!) this solution does not solve the other problem with using
  151. DropGfx! with the CLI, which is that the CLI window will not close until
  152. you get rid of DropGfx!  So the final solution was to resort to the
  153. 'RunBack' command, which is a fine utility written by Rob Peck.
  154.  
  155.     Fortunately, I have included this handy thingy in the DropGfx! archive
  156. file so that you won't have to rummage through your PD disks to find it.
  157. So an example of the proper CLI use of DropGfx! is as follows:
  158.  
  159.                     1> RunBack DropGfx :Med-Res/OntheBeach
  160.  
  161.     Please note that the Workbench program must be up and running in order
  162. for DropGfx! to do its thing.  You will be notified with an error message
  163. if you forget to 'LoadWB' before you 'DropGfx'.  Thus, a segment of your
  164. Startup-Sequence should be as follows:
  165.  
  166.                     LoadWB
  167.                     RunBack >NIL: DropGfx :Images/Wierd
  168.  
  169.  
  170. MEMORY MADNESS! *** ** *
  171.  
  172.     I won't lie to you:  DropGfx! is somewhat memory hungry.  Depending on
  173. the size and resolution of the Workbench screen, DropGfx! can consume a
  174. fair chunk of your precious CHIP memory.  For a standard, non-interlaced
  175. 640x200 Workbench screen, DropGfx! requires about 60-80K, depending on the
  176. number of windows that are open.  SO WATCH OUT!  If you're getting low on
  177. CHIP memory, get rid of DropGfx! immediately.  Otherwise, the infamous
  178. Guru might be just around the corner.
  179.  
  180.     It's a good idea to start DropGfx! only when no other programs are
  181. running.  This prevents the CHIP memory from becoming overly fragmented.
  182. At some point you might think you have 300K left, but if it's all in little
  183. pieces, you'll probably be in for some trouble.
  184.  
  185.     Face it, if you only have 512K total memory, DropGfx! is little more
  186. than a Workbench hack for you.  You can use it while doing disk maintenance
  187. and the like, but if you start another program with its own screen, you
  188. should kill DropGfx! before you do so.  Don't say I didn't warn you!
  189.  
  190.  
  191. NOTES AND STUFF *** ** *
  192.  
  193.     To the best of my knowledge, this program will not directly cause a
  194. dreaded Software Failure.  However, if you carelessly use up all of your
  195. memory while DropGfx! is active, you'll probably crash.
  196.  
  197.     DropGfx! was tested on different computer models with different
  198. memory configurations, and this version (1.0) worked without a hitch.
  199. Thanks to Marc Aubut and Richard Dominique for risking whatever they were
  200. working on while they had beta versions of DropGfx up and running.
  201.  
  202.     However, if you have reason to believe that DropGfx occasionally
  203. worships the infinitely wise Guru, please send me a note completely
  204. describing your system's configuration, what you were doing when it went
  205. bye-bye, and what happened as a result of the crash.  Thanks!
  206.  
  207.     One side effect of DropGfx! is that the Workbench screen will be
  208. unable to close while DropGfx! is active.  Again, if you're running low
  209. on memory, get rid of DropGfx! by closing the little window.  Then you'll
  210. be able to close the Workbench screen.
  211.  
  212.     A note on compatibilty is in order.  DropGfx! has been tested and
  213. found to work with the following programs that alter the Workbench screen:
  214.  
  215.                              VScreen, MoreRows
  216.  
  217. Anything else you run that modifies the Workbench screen could be a sworn
  218. enemy of DropGfx!, so combine programs at your own risk!
  219.  
  220.  
  221. A FINE OFFER! *** ** *
  222.  
  223.     Have I ever got a great deal for you! (groan...)
  224.  
  225.     As you should know by now, this program is free.  It costs you zilch.
  226. However, it has cost ME a lot of time and effort.  But that's all right,
  227. 'cause other programmers have done the same.
  228.  
  229.     However, DropGfx! is being updated at this very moment.  DropGfx! V2.0
  230. will soon be (or is already) finished.  It will make up for the shortcomings
  231. inheirent in V1.0.  Here's my 'To Do' list:
  232.  
  233.     -   More colours!  More colours!  Yes, 8+ colours on the Workbench!
  234.     -   Colour cycling!  Just think, an animated Workbench picture...
  235.     -   Nuke the little window!  It's a pain in the rotunda!
  236.     -   A better CLI interface... no more need for 'RunBack'!
  237.     -   Allow the Workbench screen to close!
  238.  
  239. Here's the scoop:  V2.0 will only be available to registered owners of
  240.                    DropGfx! (shucks!)
  241.  
  242.     To become a registered owner of DropGfx!, simply send a cheque or
  243. money order for fifteen dollars ($15), along with your name, address,
  244. comments, and suggestions, to:
  245.  
  246.                     Thomas White
  247.                     1215 Voyageur St.,
  248.                     Sudbury, Ontario, Canada.
  249.                     P3A 3Z5
  250.  
  251.     When DropGfx! V2.0 is complete, registered owners will receive it
  252. on a 3.5" 880K disk, along with some other PD stuff and some neato, nifty,
  253. and downright unusual pictures to use with DropGfx!
  254.  
  255.  
  256. LEGAL WRAP-UP *** ** *
  257.  
  258.     This program is offered "as is".  The author assumes no responsibility
  259. for any damage or loss of data that occurs while this program resides in
  260. computer memory.
  261.  
  262.     This program is Copyright (c) 1989.  The author grants permission for
  263. any and all persons to freely distribute this program, this documentation
  264. file, and support files, as long as the program is accompanied by these
  265. files.
  266.  
  267.     This program may NOT be used in any commercial product without prior
  268. written permission from the author.  Please contact the author at the
  269. above address to make an arrangement if this permission is desired.
  270.  
  271.   Amiga(TM) is a registered trademark of Commodore Business Machines, Inc.
  272.  
  273.  
  274.                             * ** *** *** ** *
  275.  
  276.  
  277.         Thanks to the guys at Commodore-Amiga for making such an
  278.              awesome, excellent, totally terrific machine!
  279.  
  280.           Yes, I do live in Canada, that's why I spell "colour"
  281.                           and "centre" properly.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.