home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / v2 / wallpape.lzh / wallp.doc < prev    next >
Encoding:
Text File  |  1991-11-08  |  8.0 KB  |  184 lines
  1.  
  2.                              Wallpaper  v1.0
  3.  
  4.                               by Joe Rumsey
  5.  
  6.    Sick of solid backrounds and tiny little patterns on your workbench?  Now
  7. under Workbench/Intuition 2.0, any image you can view on your Amiga can become
  8. the backdrop for your Workbench window.
  9.  
  10.    Wallpaper allows you to place an iff image in the background of the
  11. Workbench window.  The image may contain up to 16 colors.  Pictures with more
  12. colors than the current Workbench can display are accepted, but no attempt is
  13. made to adjust the colors.
  14.  
  15. Important note:  Make sure that the main workbench window is the ONLY workbench
  16.  window open when you run wallp.  That is, no disk or drawer windows should be
  17.  open, but other windows on the workbench screen are ok.  Disk and drawer
  18.  windows will sometimes confuse wallp into using them for it's picture.
  19.  
  20. Usage:   Wallp [-options] [filename]
  21.  
  22. To quit wallpaper and restore the normal background, just click on the close
  23. box on wallpaper's window.
  24.  
  25.    Options supported in this version:
  26.  
  27. Positioning options:
  28. -c    Center the picture.  This is the default
  29.  
  30. -t    'Tile' the picture.  Fills the Workbench window with copies of the
  31.       picture.  Great for using IFF brushes as patterns.
  32.  
  33. Color Options:
  34.  
  35. -f    First-Four. load palette from picture, but use the 'standard' (as defined
  36.       by preferences) colors for the first four colors.  This is so that
  37.       Workbench's color scheme doesn't get messed up. This option is the
  38.       default.
  39.  
  40. -s    Same. Keep the same colors.  Don't modify the color palette at all.
  41.  
  42. -p    Picture.  Load all colors from the picture, including the first four.
  43.       With most pictures, this option will really mess up the color scheme
  44.       under 2.0.  The pictures and patterns I've provided almost all have
  45.       color schemes which work under 2.0, however.
  46.  
  47. If no filename is specified, Wallp looks for the picture "wallp.pic" in the
  48. current directory.  If this can't be found either, wallp will exit with an
  49. error message.
  50.  
  51. use Run >nil: wallp   to run wallp in the background and return control to the
  52.                      shell it was run from.
  53.  
  54. Examples:
  55.    wallp         load the picture "wallp.pic", centered, keeping the first four
  56.                  colors intact.
  57.  
  58.    wallp zap     load "zap", same options as above.
  59.  
  60.    wallp -t -p zowie    load "zowie", tiled, and loading all colors from the
  61.                         picture.
  62.  
  63.    run >nil: wallp -s      load "wallp.pic", but don't change the colors.  Run
  64.                         wallp in the background so control is returned to CLI.
  65.  
  66. NOTE:  this version MUST be run from the CLI.  Sorry about that, I'll have
  67.          the workbench version done soon, I hope.
  68.  
  69.  
  70. That's all the options for now, but I am planning on many more, such as:
  71.  
  72. Scan a directory for IFF files and choose one at random(good for use in
  73.     the startup-sequence so you get a different picture each time you boot)
  74.  
  75. Stretch the image to fit the screen or window, or to a specified size for
  76. tiling.
  77.  
  78. Try to remap the color palette for pictures with too many colors(including
  79.       HAM pictures if I REALLY get motivated)
  80.  
  81. Let the scroll bars on the workbench window scroll around the picture.  Right
  82.       now, the picture stays in the same place relative to the window.
  83.  
  84. Get rid of the window and replace it with an icon.  Those of you who are fast
  85.       may notice that an icon already appears when the program is started.
  86.       This is my sneaky way of forcing Workbench to do a refresh.  As soon as
  87.       I get my hands on some 2.0 documentation, I'll figure out a better way,
  88.       but for now this will do.
  89.  
  90. Add a file requestor to allow an easy choice of picture.
  91.  
  92. Dynamic Hi-res pictures, if only I knew how(and if it's even possible).  I
  93.    don't even have any pictures of this type to fool around with, so it's
  94.    not likely to happen soon.
  95.  
  96. Run Animations in the background (and in my dreams).
  97.  
  98. Other things I would like to fix are:
  99.    Better refreshes.  You'll probably notice that right before the picture is
  100. refreshed after icons or windows are moved around, the regular workbench pattern
  101. is displayed for a split second.  This bothers me, but I can't figure out how
  102. to stop it.  In fact, I spent the better part of two days trying to stop
  103. the workbench from drawing the pattern back in, but finally gave up.  If anyone
  104. knows the method used by workbench to do this, PLEASE let me know!  After much
  105. experimenting, it seems as though it is using some @#!$% internal procedure,
  106. making it difficult to impossible to stop.  This is the only major 'bug'
  107. I know of.
  108.    Occasionally, pieces of icons are not refreshed properly.  This happens
  109. mostly when Wallp is started from the startup sequence before Workbench has
  110. fully loaded.  The best way around this is to put a suitable delay(using Wait
  111. or something similar) between the LoadWB statement and starting Wallpaper.
  112.  
  113. Questions and Possible Answers:
  114.  
  115. Q: How come the picture I've loaded looks wrong, and it's not just the colors?
  116. A: The iff routines I'm using unfortunately screw up with some pictures.  The
  117.    most likely culprits are pictures saved with Stencils.  The solution is
  118.    easy: just load them into dpaint(or whatever), Free the stencil, and resave
  119.    it.  In the next version, I will try to use the 2.0 iff library, but as of
  120.    now, I don't have any information on it.
  121.  
  122. Q: Once in a while my computer crashes for no apparent reason, even after
  123.    I've quit Wallp.  Why?
  124. A: I don't know why.  This is rare, and never seems to happen at exactly
  125.    the same point, making it very hard to trace.  I'm working on it.
  126.  
  127. Q: How can I adjust the palettes of my pictures to work in 4, 8, or 16 colors,
  128.    depending on the depth I run workbench in?
  129. A: There are several good picture conversion utilities around which can aid
  130.    you in this.  Dpaint is also good at remapping colors.  The method I use
  131.    is to load a picture into dpaint with the palette you want to use.  Then,
  132.    load the picture you want mapped to that palette and select Restore Palette.
  133.    Finally, select Remap.  Hopefully, it will turn out well.
  134.  
  135. Q: Fine, now the colors are right, how can I stretch it to fill the screen?
  136. A: just load the picture in it's normal resolution and choose Screen Format.
  137.    Then select 640x200 or 640x400, depending on the mode you want.  Dpaint
  138.    will ask you if you want the picture stretched.  Just say yes, and it'll
  139.    be done.
  140.  
  141. Q: How does Wallp work?
  142. A: If I told you, you'd probably be afraid to use it. :-)  I will say that it
  143.    modifies two functions slightly.  The only time these modifications do
  144.    anything is when they are called with the WB window as a parameter, so it's
  145.    actually pretty safe.  
  146.  
  147.  
  148. If you want more detailed info, the source is available for a $10 shareware
  149. fee.  This also of course entitles you to the most recent version, plus some
  150. other goodies.
  151.  
  152. For this version, I am not asking for any money.  Future versions, when I
  153. have more options and fewer problems, will be around $10.
  154.  
  155. For the source code mentioned above, send $10 to:
  156.       Joe Rumsey
  157.       265 W. Big Springs Rd. Apt. L
  158.       Riverside, CA 92507
  159.  
  160. The quickest place to reach me with questions and comments is on GEnie. My
  161. email address is J.RUMSEY
  162.  
  163. many thanks to:
  164. Leo Schwab, for source code to turn the workbench into a smart refresh
  165.                window.  Wallp doesn't do this, but the code was invaluable
  166.                in getting me started.
  167.  
  168. Stefan Becker, for ToolManager, and for including source.  This is where
  169.             I found out virtually everything I now know about WB2.0.  Plus
  170.             it's a wonderful program.
  171.  
  172. Also available:
  173.  
  174. Crazy Pipes -- A thinking game, object is to lay pipes to keep the water from
  175.                spilling.  32 color cutomizeable graphics, sampled sound.
  176.  
  177. Bomb Squad  -- Find the bombs without blowing 'em up.  Sampled sounds,
  178.                runs on workbench screen(so you can look at the pretty
  179.                wallpaper ;-) sampled sound.
  180.  
  181. Very very soon: Mother Lode.  An extremely accurate version of Lode Runner.
  182.                This will be my very next release.  I would have had it done
  183.                already if Wallp hadn't turned out to be so hard to write.
  184.