home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / ANIMATE4.ZIP / ANIMATE.DOC < prev    next >
Text File  |  1990-05-09  |  4KB  |  75 lines
  1. Animate - An animated desktop program for OS/2 Presentation Manager
  2.  
  3. By John Ridges
  4.  
  5. Invocation:  START ANIMATE [desktop]
  6.  
  7. To install, place ANIMATE.EXE in your path, ANIMATE.DLL in you libpath. Any
  8. Animated Desktop Extensions should also be placed in the same directory
  9. as ANIMATE.EXE.
  10.  
  11.  
  12. Animate is a program for those people who like to have nifty graphics dancing
  13. around their computer screen, and don't like having to stop them in order to
  14. actually USE their computer. With Animate, the action continues on the
  15. desktop, behind all your windows, even as you work, giving artistic enjoyment
  16. and resulting in an enriched and fulfilling computing experience. (Sorry,
  17. I got carried away.) Animate can also act as a "screen saver" - after a
  18. programmable period of inactivity, it will bring the graphic forward to fill
  19. the screen. Animate is also extensible, so there should be a steady
  20. flow of new animated desktops if anyone bothers to write any. In the off
  21. chance that someone does write some extensions, you can recognize them by the
  22. file extension (no pun intended) '.ANI'. Animated desktop programs have been
  23. tried with varying degrees of success on other windowing systems, but are
  24. usually too intrusive to have around permanently. But using the miracle of
  25. multi-tasking and low priority threads, this one is pretty darn unobtrusive,
  26. and shouldn't interfere with normal use of your computer (besides possibly
  27. driving you crazy with all the graphics going on all the time). 
  28.  
  29. When started, Animate randomly chooses a desktop from the list specified by
  30. 'desktop', which is a string of characters, one desktop per character. If
  31. 'desktop' is null, Animate will choose from all the desktops available to it.
  32. There are four desktops built into Animate, they are:
  33.     'Z' for zoom, a bouncing geometric figure that leaves a trail behind it.
  34.     'F' for fireworks, a fireworks display.
  35.     'S' for space, a simulation of moving through space.
  36.     'W' for wallpaper, a changing wallpaper display.
  37. Animated Desktop Extensions are specified using other letters, usually the
  38. first letter of the extension name. Example: You want Animate to show either
  39. 'space' or 'zoom', but you want 'space' to be twice as likely. You would type
  40. START ANIMATE SSZ
  41.  
  42. When the desktop has the focus, 'F' will bring it forward and another 'F'
  43. or a mouse movement will return it to the background. 'P' will pause the
  44. animation and another 'P' will allow it to continue. 'S' will bring up the
  45. screen saver dialog, and you can terminate Animate with 'F3'. Individual
  46. desktops may have other controls, double click on the desktop to find out.
  47.  
  48. For those of you that care, I hereby officially release the program into
  49. the public domain. If you're interested in writing Animated Desktop
  50. Extensions, there is a package with instructions and two sample extensions
  51. that I'll be posting. (If you can't find it, contact me and I'll get it to
  52. you.) I'm really looking forward to seeing some whiz-bang extensions, so
  53. somebody please write some. 
  54.  
  55. Animate's been pretty thoroughly tested and I'm willing to bet what's left
  56. of my professional reputation that it's bug free. Of course, legally, I
  57. make no guarantees about anything it might do to your programs, data,
  58. hardware, or sanity. Hey, you get what you pay for.
  59.  
  60. Comments? Questions? Suggestions? Hate mail? You can contact me at Gilmore
  61. /108 or Compuserve 72000,2057 (checked weekly).
  62.  
  63.  
  64. 4/28/90 - Bug that left Presentation Manager in an unpleasant state when
  65. Animate was stopped with the Task Manager fixed. I guess that just about
  66. wraps it up for my professional reputation. How embarrassing.
  67.  
  68. 4/29/90 - Added screen saver option.
  69.  
  70. 5/10/90 - Whoa, this is a bad one! Bug that was introduced when I switched
  71. to the OS/2 1.2 toolkit. Microsoft removed the "_export" declarator from the
  72. definition of "CALLBACK" in the C header files, so none of my window
  73. procedures were exported! This caused random, unpredictable weirdness with
  74. Presentation Manager. Oh well.
  75.