home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d569 / spliner.lha / Spliner / Spliner.doc < prev    next >
Text File  |  1991-11-21  |  4KB  |  89 lines
  1.  
  2.  
  3.                                  Spliner
  4.  
  5.                     A Spline Screen Blanker Commodity
  6.  
  7.                          Graphics by Tom Rokicki
  8.  
  9.                User Interface and Docs by Sebastiano Vigna
  10.  
  11.  
  12. Tom Rokicki's Mackie is one of the most well-known and most beautiful
  13. utilities for the Amiga. It has two separate functionalities: it's a blanker
  14. which draws wonderful splines, and a powerful hot-key manager.
  15.  
  16. What I did was taking out the spline code from the original Mackie sources
  17. and encapsulate it in a standard Commodity (of course, this means someone
  18. else will have to port the hot-key part...).
  19.  
  20. Commodities are the new way, designed by Commodore, by which all special
  21. utilities like mouse accelerators, macro expanders etc. should be designed.
  22. This standard, available *only* under 2.0, allows easy and customizable
  23. control of the interaction of different utilities. This means, of course,
  24. that Spliner will work only under 2.0.
  25.  
  26. In the process of moving to 2.0, some new features were added, namely
  27. programmable pattern change timeout, and the possibily to open the blank
  28. screen in *any* of the modes available on your Amiga.
  29.  
  30. For the generic use of a Commodity, please refer to the 2.0 manual. Spliner
  31. will (more or less) work just like the screen blanker supplied on the
  32. Workbench 2.0 disk.
  33.  
  34. If you activate Spliner by double-clicking on its icon, you will see a
  35. little window popping up. The meaning of the HIDE and QUIT gadgets and menu
  36. items are identical to the ones of Commodore's blanker. The TIMEOUT gadget
  37. lets you set the number of seconds after which the screen is blanked, while
  38. the gadget CHANGE lets you set the time after which the drawing pattern is
  39. changed. Set this to zero to go psychedelic. 8^)  Both default to 60. The
  40. CYCLE COLORS checkbox allows you to enable/disable the color cycling (mainly
  41. for special screen modes such as 2024_10Hz). The IMMEDIATE EFFECT gadget
  42. blanks immediately (after 1 second) the screen (this feature was coded by
  43. Jean-Michel Bezeau).
  44.  
  45. The list displayed on the right represents all video modes installed on your
  46. system. This list could also include some modes that aren't really
  47. displayable on your Amiga, but no harm can be done. You can click on any
  48. display mode in order to force Spliner to use that kind of display when
  49. blanking the screen.
  50.  
  51. There are five extra tooltypes: TIMEOUT, CHANGE, DISPLAY, CYCLE and BLANK.
  52. The first four act just like the corresponding gadgets. Note that the name
  53. you set DISPLAY to must be an exact copy of the name appearing in the window
  54. list (up to lower/upper casing). For instance, DISPLAY=PAL:Lores-Interlaced.
  55. If you have a PAL (resp. NTSC) Amiga and you have a real MultiSync monitor,
  56. you can even add the NTSC (resp. PAL) monitor to your system and open the
  57. blank screen with another video frequency! This has no usefulness at all,
  58. but it's amusing. The CYCLE tooltype can of course be set to ON or OFF.
  59. BLANK lets you specify an hotkey (in the same format as CX_POPKEY) which
  60. will immediately (after 1 second) blank the screen, just like the IMMEDIATE
  61. EFFECT gadget (the delay is necessary because otherwise the input event
  62. caused by the hotkey would unblank the screen).
  63.  
  64. In order to start Spliner at power-up, the best thing is to move its icon
  65. into the WBStartup drawer, and to set its tooltypes to the desired values.
  66. Don't forget to add the DONOTWAIT tooltype, too. You'd probably also want to
  67. set CX_POPUP=NO. Another thing to consider is that since Spliner reads the
  68. display modes in the graphical database, you must be sure Mode_Names is ran
  69. before it. In order to obtain this, you should add the tooltype
  70. STARTPRI=-120.
  71.  
  72. IMPORTANT NOTICE: Some people think that terrific blankers steal CPU time.
  73. This is not the case with Spliner. If a task is using the CPU, Spliner will
  74. stop drawing. If in particular your application has a hi-res multi-color
  75. screen, the presence of the blank screen will actually speed up whatever the
  76. Amiga is doing, by lessening DMA contention.
  77.  
  78. This program is copyrighted, but freely distributable. Permission is hereby
  79. granted to distribute it provided both this documentation accompanies the
  80. executable and that no charge is made for its distribution. Comments,
  81. complaints, desiderata are welcome.
  82.  
  83.     Sebastiano Vigna
  84.     Via Valparaiso 18
  85.     I-20144 MILANO MI
  86.  
  87.     BIX: svigna
  88.     UUCP:...{uunet|piramid|rutgers}!cbmvax!cbmehq!cbmita!sebamiga!seba
  89.