home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma15.dms / ma15.adf / SuperDark / docs / superdark.doc < prev    next >
Text File  |  1993-04-11  |  30KB  |  842 lines
  1. @AUTHOR "Thomas Landspurg"
  2.  
  3. ## $VER: SuperDark.guide v1.4 (20.3.93)
  4.  
  5. ----------------------------------------------------------------------------------
  6. Main "SuperDark"
  7. ----------------------------------------------------------------------------------
  8.             SuperDark
  9.  
  10.  
  11.     'Introduction'
  12.  
  13.     'Installation'
  14.  
  15.     'Utilization'
  16.  
  17.     'Configuration'
  18.  
  19.     'Modules'
  20.  
  21.     'Improvement'
  22.  
  23.     'Bug report'
  24.  
  25.     'History'
  26.  
  27.     'Address'
  28.  
  29.     'Thanks to...'
  30.  
  31. ----------------------------------------------------------------------------------
  32. Introduction "Introduction"
  33. ----------------------------------------------------------------------------------
  34. @Toc    "Main"
  35.  
  36.     What is SuperDark?
  37.  
  38.     SuperDark is a Screen Blanker...Yet another one, but this has some
  39.         special features. It's based on the well-known program called
  40.         AfterDark for the PC and Macintosh World.
  41.  
  42.         SuperDark_1.3, the version of SuperDark for Workbench 1.3 and 1.2,
  43.         is no longer supported. Get WB2.0!
  44.  
  45.  
  46. Some characteristics:
  47.  
  48.     - Many different effects (only one effect is loaded in
  49.       memory at a given time) examples:
  50.         o FireWorks,
  51.         o Flying Toaster,
  52.         o ASWarm,
  53.         o Classic ones like "Clock","Mistify",...
  54.         o More originals like Music, Shufffle, Spot,...
  55.         o etc...
  56.  
  57.     - Password protected Screen Locking
  58.  
  59.     - Immediate blanking
  60.  
  61.     - Font sensitive
  62.  
  63.     - Greatly improved since V1.2
  64.  
  65.  
  66. ----------------------------------------------------------------------------------
  67. Installation "Installation"
  68. ----------------------------------------------------------------------------------
  69. Installation
  70. ------------
  71.  
  72. To install SuperDark, just put the SuperDark directory somewhere on your hard
  73. disk, and put the SuperDark program in your WBStartup drawer.
  74. Then run superdark -- but don't forget to put the name of the directory where
  75. all the blankers modules are into the DARK DIRECTORY string gadget. If all is
  76. correct, you should now see a list with different modules in the main
  77. configuration window.
  78.  
  79. If nothing happens, maybe SuperDark is running and the main configuration
  80. window is closed. To open it, just run SuperDark a second time or press the
  81. "hotkey" (look 'Configuration'). 
  82. You can also open the window using your Workbench's "commodities exchange":
  83. Select SuperDark and press the 'show' gadget.
  84.  
  85. Note: SuperDark uses reqtools.library if present, and especially the screen
  86. format requester, only available with reqtools V38 or higher...
  87.  
  88. Note 2: SuperDark needs WB2.0 or higher
  89.  
  90. Tips:
  91. - If you've put superdark in your WBStartup, and if there is this requestor
  92. after reboot: "SuperDark not yet returned, keep waiting?" or something like
  93. that, just add the ToolType DONOTWAIT in the .info of superdark.
  94.  
  95.  
  96. ----------------------------------------------------------------------------------
  97. Utilization "Utilization"
  98. ----------------------------------------------------------------------------------
  99. II Utilization
  100. --------------
  101.  
  102.  To modify the parameters, press the key <left shift> and the key <f3> -- a
  103. window will appear...the explanation will be given next chapter Note: if you
  104. start another SuperDark while another is running, the new program will exit,
  105. but it will tell the older SuperDark to open its configuration window.
  106.  
  107.  Immediate blanking: If you press the <left shift> key and the <f4> key at
  108. the same time, there will be an 'immediate blanking', This means that the
  109. screen will be instantly be blanked.
  110.  
  111.   You can also put the mouse in the lower left corner of the screen to
  112. blank the screen after 2 seconds.
  113.   If you put your mouse in the lower right corner of the screen, 
  114. the screen will never blank.
  115.  
  116. If don't touch your computer for some time (depending of the configuration)
  117. it will be automatically go to a 'blanking state'
  118.  
  119.  
  120. ----------------------------------------------------------------------------------
  121. Configuration "Configuration"
  122. ----------------------------------------------------------------------------------
  123. 3.1 The main window configuration:
  124.     ----------------------------------------------------------
  125.     |             __________________            __            |
  126.     |            |                  |          |  |   SD V1.4 |
  127.     |            |                  |          |  |           |
  128.     |            |  'modules'        |          |  |           |
  129.     |            |                  |          |  | 'Smallmem' |
  130.     |            |                  |          |  |           |
  131.     |            |__________________| 'Tempo'   |__|           |
  132.     |                                               'Topaz'    |
  133.     | 'Param'                           Quiet ''               |
  134.     |                    _____________________                |
  135.     |   'Dark directory' |_____________________|               |
  136.     |                    _____________________                |
  137.     |         'CxPopkey' |_____________________|  'TaskPri'     |
  138.     |                    _____________________                |
  139.     |         'Blankkey' |_____________________|               |
  140.     |                          ____________                   |
  141.     |   Lock ''  'PassWord'    |____________|                  |
  142.     |                                                         |
  143.     |                                                         |
  144.     | 'Remove'   'Save'    ' Help '   ' Hide '              |
  145.      ---------------------------------------------------------
  146. ----------------------------------------------------------------------------------
  147. DARKDIR
  148. ----------------------------------------------------------------------------------
  149. Dark directory:
  150.   The first important thing in this window, is the 'SuperDark directory'. It's
  151. the place where superdark will look for his blanking modules. So, if you see
  152. nothing in the Modules list, fill the SuperDark directory with the correct
  153. place where you've put the modules.
  154. ----------------------------------------------------------------------------------
  155. CXPOPKEY
  156. ----------------------------------------------------------------------------------
  157.  You put in this gadget the hotkey used to open this window. This is a standart
  158. Amigados 2.x key description, like "shift f2", or "ctrl f1", or 
  159. "left shift ctrl a".
  160.   Default is "shift f3"
  161. ----------------------------------------------------------------------------------
  162. BLANKKEY
  163. ----------------------------------------------------------------------------------
  164.  This is the gadget where you put the defintition of the hotkey used to make
  165. an immediate blanking. Like the Cxpopkey, it's a standart amigados key
  166. definition. But do not use the same hotkey than cxpopkey!
  167.   Default is "shift f4"
  168.  
  169.   Note that you can also make an immediate blanking by moving your mouse
  170. the lower left corner of the screen.
  171.   If you want to disable screen blanking, just move your mouse to the
  172. lower right corner of your screen.
  173.  
  174. ----------------------------------------------------------------------------------
  175. MODMAIN
  176. ----------------------------------------------------------------------------------
  177.  In the modules list, you must see the superdark modules (like firework, effets,
  178. ramdom,...).If no, look at the Dar directory paragraph!. With this list you
  179. select the module that you eant to be active during the blanking. The current
  180. selection is show at the bottom of the list.
  181.  
  182.  
  183.     Look at:'Modules'
  184. ----------------------------------------------------------------------------------
  185. PARAM
  186. ----------------------------------------------------------------------------------
  187. Param:
  188.   This button open the configuration window of the selected module.
  189. ----------------------------------------------------------------------------------
  190. TEMPO
  191. ----------------------------------------------------------------------------------
  192. Tempo:
  193.   This slider gadget allows you to choose the inactivity time of the blanker, in
  194. seconds.
  195. ----------------------------------------------------------------------------------
  196. QUIET
  197. ----------------------------------------------------------------------------------
  198. Quiet:
  199.   This little checkbox just tell SuperDark not to show the little window 
  200. when started, the window with: "SuperDark Started,....."
  201. ----------------------------------------------------------------------------------
  202. LOCK
  203. ----------------------------------------------------------------------------------
  204. Lock:
  205.   If you select this checkbox, a passwd will be asked after each blanking of
  206. the screen. Example: you go somewhere else, but you don't want your computer
  207. be used by someone else.
  208. ----------------------------------------------------------------------------------
  209. PASSWORD
  210. ----------------------------------------------------------------------------------
  211.   This gadget allow you to enter the password used to unlock the screen. Note
  212. that the 'LOCK' gadget must be 'on' to use the password features.
  213. ----------------------------------------------------------------------------------
  214. TASKPRI
  215. ----------------------------------------------------------------------------------
  216.   This slider allow you to change the priority of the blanking task. By default,
  217. this priority is zero, but you can put it to a lower value, so the blanker
  218. won't still any precious CPU time to the other task running at this time.
  219. ----------------------------------------------------------------------------------
  220. TOPAZ
  221. ----------------------------------------------------------------------------------
  222. Topaz:
  223.    SuperDark can use default system font, or use a normal topaz 8 font. I
  224.    use this because sometime default fonts are too big, so I can just go
  225.    back to a small font quickly.
  226. ----------------------------------------------------------------------------------
  227. SMALLMEM
  228. ----------------------------------------------------------------------------------
  229. SmallMem:
  230.    This gadget allow you to choose if you want the module to be loaded only
  231.    during the blanking period. This use less memory when the blanker is
  232.    not used, but take a little bit to re-load the module each time, especally
  233.    with disk drive
  234. ----------------------------------------------------------------------------------
  235. PASSWD
  236. ----------------------------------------------------------------------------------
  237. Passwd:
  238.    This gadget allow you to enter the Passwd needed to Unlock Screen.
  239. ----------------------------------------------------------------------------------
  240. REMOVE
  241. ----------------------------------------------------------------------------------
  242. Remove:
  243.    If you press this button, SuperDark will be removed (it will exit)...
  244. ----------------------------------------------------------------------------------
  245. SAVE
  246. ----------------------------------------------------------------------------------
  247. Save:
  248.    To Save the current parameters of SuperDark and the Random module.
  249.  
  250. ----------------------------------------------------------------------------------
  251. HELP
  252. ----------------------------------------------------------------------------------
  253. Help:
  254.    This will shows you a little information window.
  255. ----------------------------------------------------------------------------------
  256. HIDE
  257. ----------------------------------------------------------------------------------
  258. Hide:
  259.    This button will close this configuration window. If you want to open
  260. it again, just press <left Shift> and <F3> (or the CxPopkey you've defined) .
  261.  
  262. ----------------------------------------------------------------------------------
  263. Modules
  264. ----------------------------------------------------------------------------------
  265.  
  266. 3.2 Blankings Modules
  267.  
  268. Note:
  269.    All the parameter window of the blanking module have the four following
  270. buttons:
  271.  
  272.    OK: to close the parameters window and to save configuration
  273.    TEST: to test the effect.
  274.    CANCEL:to close the parameter window, without saving configuration.
  275.    INFO: to have some information on this effect.
  276.  
  277. 'Anim'            'Line'            'Slide show'
  278. 'ARexx'            'Line2'            'Spot'
  279. 'ASWarm'            'Melt'            'Star'
  280. 'Effets'            'Mistify'        'Text'
  281. 'FireWork'        'Music'            'Time'
  282. 'FracBlank'        'Plasma'            'Random'
  283. 'FlyingToaster'        'Plasma Cycle'
  284.  
  285.    You can easyly add or remove modules, even when superdark is running.
  286. May be you don't like the module "music", so you just can erease it using
  287. your favorite disk tool, and then just select the "dark directory" field,
  288. press return and the module list will be updated.
  289.     If you want to add new module, it's the same kind of operation, just
  290. put new modules in the dark directory, select the dark directory string
  291. gadget and presse return....
  292.  
  293. ----------------------------------------------------------------------------------
  294. 3d "3d"
  295. ----------------------------------------------------------------------------------
  296. 3.2.1 3d
  297.  
  298.   This effect show you a 3d Object moving on the screen. That's all for
  299. the moment, but this effect is still in developpement to be more attractive!
  300. Note: that effect was called 'anim', but 3d is a most apropriate name!
  301.  
  302.    * Medium   cpu-user.
  303.  
  304.    * small memory-user.
  305.  
  306. ----------------------------------------------------------------------------------
  307. anim "anim"
  308. ----------------------------------------------------------------------------------
  309.  
  310.    This module show IFF animations, but be careful, AND READ THIS:
  311.  
  312. - This module call an external anim player. I use mugiff, but you can
  313. use the player you want, BUT THIS PLAYER SHOULD EXIT AFTER A CTRL-C
  314. SIGNAL!!! PP_anim DON'T EXIT AFTER A CTRL-C, so DO NOT USE PP_ANIM!
  315. Use MugIFF, it's small, and fine to use.
  316.  
  317. - Do not put more than one filemame in the file requester....If you
  318. do this, the anim player will never exit!
  319.  
  320. - And at least, this I put this module in this distribution, but I'm not
  321. shure that it will work perfectly....
  322.  
  323. ----------------------------------------------------------------------------------
  324. ARexx "Arexx"
  325. ----------------------------------------------------------------------------------
  326. 3.2.2 ARexx
  327.  
  328.   This effect allow you to send an ARexx command at the beginning of the
  329. blank, and another command at the end of the blanking period. This allow you
  330. to start for example a music program, paint program or custom program during
  331. blanking. I'am sure that a lot of poeple will find good idea for this effect!
  332.  
  333. AREXXPORT: This is the name of the ARexx port where the ARexx command are send.
  334.  
  335. CMD:    This is the command send at the beginning of the blank.
  336.  
  337. ENDCMD:    This is the command send at the end of the blank.
  338.  
  339.     * Small CPU-Usage
  340.  
  341.     * Small Memory-Usage.
  342.  
  343.  
  344. ----------------------------------------------------------------------------------
  345. ASWarm "ASWarm"
  346. ----------------------------------------------------------------------------------
  347. 3.2.3 ASWarm
  348.  
  349.   This module show you little things moving on screen....Just look at it
  350. to understand! It's based on a Sun effect's, and it was made by Markus Illenser
  351. and Matthias Scheler for another blanker.
  352.  
  353. SPEED=[Slow motion | Very Slow | Slow | Normal | Fast | Very Fast | Incredible ]
  354.  
  355. WASPS=[1-10] number of Wasps!
  356.  
  357. BEES=[1-500] number of bees!
  358.  
  359. TIGHTNESS=[1-10]
  360.  
  361. COLOR CYCLING=[ON|OFF]
  362.  
  363. AIM MODE=[ON|OFF]
  364.  
  365.     * Medium to big cpu-user
  366.     * Small cpu-user
  367.  
  368.  
  369. ----------------------------------------------------------------------------------
  370. Effets "Effets"
  371. ----------------------------------------------------------------------------------
  372. 3.2.4 Effets
  373.  
  374.   This in fact three different effects. But all these three effects have
  375. been described in an old issue of the scientific america.
  376.  
  377. TYPE= [ INTERFERENCES | DRAGON | FRAC EFFECT | RANDOM ]
  378.  
  379. DUREE= [ 50-100]
  380.  
  381.     * Big cpu-user
  382.     * Medium memory-user
  383.  
  384.  
  385. ----------------------------------------------------------------------------------
  386. FireWork "FireWork"
  387. ----------------------------------------------------------------------------------
  388. 3.2.5 FireWork
  389.  
  390. This effect show you a FireWork on your screen....
  391.  
  392.     * Big cpu-user
  393.     * Medium memory-user
  394.  
  395.  
  396. ----------------------------------------------------------------------------------
  397. FlyingToaster
  398. ----------------------------------------------------------------------------------
  399. 3.2.xx FlyingToaster
  400.  
  401.     This effect seems to be greatly inspired from the well now AfterDark.
  402. I've take the code from a PD ScreenBlanker, FlyingToaster, from xxx
  403.  
  404.     * Medium CPU-user
  405.     * Medium meory-user
  406.  
  407.  
  408.  
  409. ----------------------------------------------------------------------------------
  410. Fracblank
  411. ----------------------------------------------------------------------------------
  412. 3.2.6 Fracblank
  413.  
  414. Adapted from .....
  415.  
  416.  
  417. ----------------------------------------------------------------------------------
  418. Line
  419. ----------------------------------------------------------------------------------
  420. 3.2.7 Line
  421.  
  422.  The screen will slowly disappears under the lines....
  423.  
  424.     * Small cpu-user
  425.     * Medium cpu-user
  426.  
  427.  
  428. ----------------------------------------------------------------------------------
  429. Line2
  430. ----------------------------------------------------------------------------------
  431. 3.2.8 Line2
  432.  
  433.   This effect will show you multicolored lines...You can choose the number
  434. of lines, their speed, etc....
  435.  
  436.  
  437.     * Big cpu-user
  438.     * Medium memory-user
  439.  
  440. ----------------------------------------------------------------------------------
  441. Melt
  442. ----------------------------------------------------------------------------------
  443. 3.2.9 Melt
  444.  
  445.   Very nice effect! The current screen is suddenly moving in a very particular
  446. manner...Look at this one!
  447.   Three type of effects are available:type1,type2,type3 (not very clear...)
  448.  
  449.     * Medium cpu-user
  450.     * Medium cpu-user
  451.  
  452. ----------------------------------------------------------------------------------
  453. Mistify
  454. ----------------------------------------------------------------------------------
  455. 3.2.10 Mistify
  456.  
  457.   Draw moving line on screen, once again...Based on the Window's effect...
  458.  
  459. NUMBERS=[1-3]
  460. SPEED  =[1-10]
  461.  
  462.     * Medium to Big cpu-user
  463.     * Medim memory-usage
  464.  
  465. ----------------------------------------------------------------------------------
  466. Music
  467. ----------------------------------------------------------------------------------
  468. 3.2.10 Music
  469.  
  470.    This effect is based on my old demo named "The PoiPoi". Four little guys
  471. move with music, while PoiPoi musicians are playing the music...
  472.    You can select wich SoundTracker or protracker module to play, by
  473. selecting it's name in the "Module" string gadget (sorry, no requester for
  474. the moment).
  475.    Each of the musician have one or mor instrument assigned to him. Example,
  476. right drummer can play instrument number 5,9 and 15. YOu can see the name
  477. of the instrument by pressing the Instr. button. So you can easyly now witch
  478. voice is playing wich instrument.
  479.  
  480.   If the module can't find your module, or if the selected file is not a
  481. protracker/stk module, a default module will be played (mod.wizardy).
  482.  
  483.   Try this effect....Really nice!
  484.  
  485. MODULE=<name of the file to be played>
  486. VOICE [1..32]=[0..5]
  487.  
  488.     * Medium cpu-user
  489.     * Medim memory-usage
  490.  
  491.  
  492. ----------------------------------------------------------------------------------
  493. Plasma
  494. ----------------------------------------------------------------------------------
  495. 3.2.11 Plasma
  496.  
  497.   This effect is based on plasma effect from the demos. But it's not a 
  498. perfect programming, so there must be some problems on some Amiga...
  499.  
  500.     * Big cpu-user
  501.     * Big Memory-usage
  502.  
  503. ----------------------------------------------------------------------------------
  504. Plasma_Cycle
  505. ----------------------------------------------------------------------------------
  506. 3.2.xx Plasma_cycle
  507.  
  508.     This effect also make plasma, but using a standarts bitmap after
  509. cycle the colormap, so it must look nice...
  510.  
  511.     * Big cpu-user
  512.     * Medium Memory-usage
  513.  
  514. ----------------------------------------------------------------------------------
  515. Shuffle
  516. ----------------------------------------------------------------------------------
  517. 3.2.12 Shuffle
  518.  
  519.   Based on a blanking effect from the XSB program...
  520.  
  521. SPEED=[SLOW | MEDIUM | FAST | VERY FAST ]
  522.  
  523.     * Small cpu-user
  524.     * Medium memory-usage
  525.  
  526. ----------------------------------------------------------------------------------
  527. Slide-show
  528. ----------------------------------------------------------------------------------
  529. 3.2.13 Slide-Show
  530.  
  531.   Rem: This effect is only available in WB2.0 or higher....
  532.  
  533.  This effect allow you to make a slide show of your picture during blanking.
  534. Useful if you are a gfx artist!
  535.   Some explanation:
  536.      You must select wich pictures are shown during blanking by pressing the
  537. 'Add' buttonm and then select the picture you want. Delete will remove the
  538. selected filename in the list of the pictures.
  539.     Show will show you the selected picture during a few seconds.
  540.  
  541.     NEW: Slide show now use WB3.0 datatypes. So if you have the good datatype,
  542. SLide show use it, and can show any kind of image. If you don't have
  543. datatypes, or if he seems that he can't use it, slide show use his old
  544. IFF screen loader :-( .
  545.  
  546. Note: The list of the filename will be saved in the file s:slide-show.cfg
  547.   You can modify this file yourself if you want.
  548.  
  549.     * Small cpu-user
  550.     * Medium to big memory-user
  551.  
  552. ----------------------------------------------------------------------------------
  553. spot
  554. ----------------------------------------------------------------------------------
  555. 3.2.x  Spot
  556.  
  557.     One or more spots will highlight the screen. If the module can
  558. open a screen of one or more bitplanes than the actual one, you can change
  559. the luminosity of the background.
  560.     You will see the real screen in the spot (I mean that if something
  561. happens, something move in the screen, you'll see this in the spots).
  562.  
  563. SIZE   = [1-80]
  564. SPEED  = [1-10]
  565. NUMBER = [1-5]
  566. DOUBLEBUFFER=[TRUE|FALSE]  You can use or not dble buffer, but not in all the
  567.                cases.
  568.  
  569. SHADOW = [0-90]   Percentage of luminosity for the background
  570.  
  571.       * Medium Cpu-user
  572.     * Medium Memory-User
  573.  
  574. ----------------------------------------------------------------------------------
  575. Star
  576. ----------------------------------------------------------------------------------
  577. 3.2.14 Star
  578.  
  579.   This effect will show you a Starfield in your screen. You can change
  580. number of stars and their speed.
  581.  
  582.  
  583. STARS NUMBER=[10-150]
  584. SPEED       =[1-10]
  585.  
  586.     * Big cpu-user
  587.     * Medimu memory-user
  588.  
  589. ----------------------------------------------------------------------------------
  590. Text
  591. ----------------------------------------------------------------------------------
  592. Text
  593.  
  594.    Not a very original effect, but evrybody need this one some days.
  595. Just write a little text on your screen, and you can choose resolution screen
  596. and screen font.
  597.  
  598. TEXT=<your text>
  599. FONTS=<font used> (don't modify it from .info)
  600. SCREEN=<screen used> (don't modify it from .info)
  601. SPEEDX=[0..5] 
  602. SPEEDY=[0..5] 
  603.  
  604.     * Small to high cpu-user (dpend of the size font)
  605.     * Medium memory-user
  606.  
  607. ----------------------------------------------------------------------------------
  608. Time
  609. ----------------------------------------------------------------------------------
  610. Time
  611.  
  612.   This effect show you a clock. You can choose three different clocks.
  613. You can also choose the Font, but only for the digital Clock.
  614.   The Clock can move on your screen, if put something else than Zero
  615. in the self-explaining fields SpeedX and SpeedY.
  616.  
  617. TYPE=[DIGITAL|NORMAL|MODERN]
  618. SECONDS=[ON|OFF]
  619. SPEEDX=0..6
  620. SPEEDY=0..6
  621.  
  622.     * Small cpu-user
  623.     * Medium memory-user
  624.  
  625. ----------------------------------------------------------------------------------
  626. Random
  627. ----------------------------------------------------------------------------------
  628. Random
  629.  
  630.   This effect will choose randomly different other effects! You can
  631. select the effect that you want to be 'choosable' in the selection list.
  632. But if the All Checkbox is checked, all the effect are selectables!
  633.  
  634.   The list of the selectables effects is saved in the file s:dark_random.cfg
  635.  
  636.  
  637.         NOTE:
  638.         ----
  639.  
  640.    The blankers modules are executales, so you can pack them with powerpacker
  641. for instance!
  642.  
  643.   
  644.   
  645.  
  646. ----------------------------------------------------------------------------------
  647. Improvment "Improvment"
  648. ----------------------------------------------------------------------------------
  649.  
  650. The future:
  651.  
  652.    It would be nice to make a documentation in a correct english! :-)
  653.    --------------------------------------------------------------
  654.  
  655.     More blankers, but also improve the old one.... They are now much more
  656.     better than the earlier one, but it's only little things, but this make
  657.     life easier for users.
  658.  
  659.  
  660.     o Idea of modules:
  661.  
  662.     - Animation players (could have done using ppanim, but ppanim don't stop
  663.       after Ctrl-C....)
  664.     - "Look-like demos" modules...shaded bobs, plasma
  665.     - AGA specific modules
  666.  
  667.     o Implementation of a Timeout, like in ASWarmIII, to prevent the blanker
  668.     to show only a 'static' image, because another program (like Raytracer) is
  669.     taking the whole CPU.
  670.  
  671. ----------------------------------------------------------------------------------
  672. BugReport
  673. ----------------------------------------------------------------------------------
  674.  
  675. Now bugs:
  676.     - bug with spot: Problem with interlace screen...(no crash,
  677.       but only look ugly)
  678.  
  679. Bug Report
  680.  
  681.   Please, send me bug reports, or any information (idea, improvment,etc..)
  682.  
  683.   
  684.   I think there is some problems with A1200 or 4000, due to the DblPal mode..
  685. I don't know a lot of this mode. If you have any information, or any problem
  686. you know what to do!
  687.  
  688.  
  689. ----------------------------------------------------------------------------------
  690. History
  691. ----------------------------------------------------------------------------------
  692. History
  693.  
  694. 01/01/93
  695.     v.09:    -First version realised, on some BBS
  696.  
  697. 30/01/93
  698.     v1.0:    -Lot of bugs fixed, but a lot of bugs still here...
  699. 05/02/93
  700.     v1.1:    - Crash if incorrect configuration fixed
  701.         - TaskPri control added
  702.         - "Mouse in the corner" functions
  703.         - New effect in line.dark
  704.         - New: Spot.dark
  705. 12/02/93
  706.     v1.2:    - SuperDark for OS2.0 or higher is now a commodities
  707.         - Cx_popkey,and blankey can be modified
  708.         - Memory allocation error fixed in spot and anim
  709.         - New: Music.dark! GREAT...
  710.         - First version sent to FredFish and to BBS via SAN
  711. 25/02/93:
  712.     v1.21:    - Bug fixed in module spot.dark: if the screen width was not a 
  713.         multiple of 8 this cause a modulo problem...
  714.         - Bug fixed in the FireWork module, sometime the module never
  715.         exit.
  716.         - The 3d Amiga logo was in the wrong direction in the anim module
  717.         :-)
  718.         - French text removed in the effects and line 2 modules
  719.         - In overscan, Shuffle and line doesn't use the whole screen.
  720.         Corrected.
  721.         - Bug in slide-show: when the param window was opened the
  722.         first time, the file list wasn't correct. Fixed.
  723.         - The "Duree" field in the Random module was not correct. Fixed
  724.  
  725.         - Source: I've finally got the last 2.0 includes files, and I've
  726.         changed my files to fit them. No more "convert.h" file.
  727. 08/03/93:
  728.     v1.22:
  729.         - New type of datas: IMAGE, and DATA_STRING
  730.         - choice of screen reolution in some modules, using reqtools
  731.         requester.
  732. 10/03/93:
  733.     v1.3:
  734.         - Pointer should now disappear...
  735.         - Bug fixed in Plasma (screen depth is now really zero )
  736.         - Music: Now music players should be visible in NTSC :-)
  737.         - Music: File selector (and wait...soon, more interesting things)
  738.  
  739. 20/03/93:
  740.     v1.4
  741.         - Forgot to put UnLockPubScreen() ! Now fixed
  742.         - Look at the font size of window title bar.
  743.         - The famous Uppercase/Lowercase bug reported in Usenet
  744.           corrected. Now blankers modules are also recognise even
  745.           if they use uppercase letters.
  746.         - New type of data: FONT
  747.         - Bug removed in ASwarm if screen depth was less then 2 bitpl.
  748.         - Superdark_1.3 support stopped
  749.         - new: text.dark
  750.  
  751. 25/03/93:
  752.     v1.4b
  753.         - Support for other fonts than topaz 8. (All interlace WB users
  754.           will be happy!)
  755.         - New features: choice between Topaz and default font
  756.         - New features and SmallMem
  757.         - Bug: I had also a famous _lock_ bug... forgot to UnLock()..
  758.         - bug: RemPort was used instead of DeletePort(), this cause some
  759.           bytes of mem to be lost...
  760.         - Fixed problem with mode who wanted a copy of workbench screen.
  761.           Now this copy look like the original WBench screen...
  762.         - UnLock screen is now in hires
  763.         - Changed place of a SetTaskPri, so now even if there is a high
  764.          CPU usage, you see the blanking module. But if there is
  765.          absolutly no CPU left, it could stop and not show anything...
  766.          next step: put a timeout and show a black screen...
  767. 27/03/93:
  768.     v1.5
  769.         - Size of superdark have been reduced from about 4k by writing
  770.           my own printf(using RawDoFmt of course, scanf, etc....
  771.         - Clock is now moving.
  772.         - Better look of the blanker in random mode...Last screen is
  773.           now taken as the current screen for effects like shuffle,melt...
  774.         - Also in random mode: all the selected effects are show once
  775.           No more seing twice the same effect, or never saw one..
  776.         - Music module is now in 4 bitplanes, instead of 5 before->
  777.           smaller, faster.
  778.         - GREAT (for me!): Slide show use WB3.0 datatypes, so now
  779.           is you have the good datatype, you can display any kind
  780.           of images, GIF,IFF,etc...
  781.           Now the slide show file requester can also use multiselection
  782.  
  783. 05/04/93:
  784.     v1.5b
  785.         - The font requester is now the asl font requester, no more
  786.           the reqtools font req.
  787.         - Screen Mode requester, is now the ASL screenmode requester
  788.           if available (V38), or Reqtools screenmode req. if available.
  789.         - Use protos instead of CLIB -> smaller 
  790.         - NEW: module anim (play animation, the old anim is renamed
  791.           to 3d)
  792.  
  793. 11/04/93:
  794.     v.15c
  795.         - Correction of a bug in spot with WB3.0
  796.         - Main Window reorganisation, so all gadget are visible in NTSC
  797.           screen.
  798.  
  799. ----------------------------------------------------------------------------------
  800. Adress
  801. ----------------------------------------------------------------------------------
  802.  Contact adress
  803.  
  804.     Thomas LANDSPURG
  805.     9, Place Alexandre 1er
  806.     78000 VERSAILLES
  807.     FRANCE
  808.  
  809.     FidoNet: 2:320/104.18
  810.     AMyNet:     39:180/1.18
  811.     UseNet:     Thomas_Landspurg@ramses.gna.org
  812.  
  813.     (better use UseNet...faster and seafer)
  814.  
  815.  SuperDark may not be included with any commercial product nor may it be
  816.  sold for profit either separately or as part of a compilation without
  817.  my permission. It may be included in non-profit disk collections such as the
  818.  Fred Fish collection. It may be archived & uploaded to electronic bulletin
  819.  board systems as long as all files remain together & unaltered.
  820.  
  821.  
  822.  So you can use this program freely, but if you find it useful, just send
  823. me a letter or postcard with your opinion,
  824.  
  825. ----------------------------------------------------------------------------------
  826. Thanks
  827. ----------------------------------------------------------------------------------
  828. 8. Thanks:
  829.  
  830.  
  831.     Thanks to:
  832.  
  833. - Eric Delord, for his help!
  834. - Frank Geider
  835. - Per Jonsson
  836. - Aeneas Verhe
  837. - Chris Hurley
  838. - Theodore A. Serreyn 
  839. - Peter Smets 
  840. - Carl Tashian
  841.  
  842.