home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / superdark-2.0a.lha / SuperDark-2.0a / docs / superdark.doc < prev    next >
Encoding:
Text File  |  1993-06-26  |  34.8 KB  |  962 lines

  1. @AUTHOR "Thomas Landspurg"
  2.  
  3. ## $VER: SuperDark.guide v1.6 (16.4.93)
  4.  
  5. ----------------------------------------------------------------------------------
  6. Main "SuperDark"
  7. ----------------------------------------------------------------------------------
  8.             SuperDark v2.0
  9.  
  10.            THE screen blanker for the Amiga
  11.  
  12.         'Disclaimer'
  13.         'Introduction'
  14.         'Installation'
  15.         'Utilization'
  16.         'Configuration'
  17.         'Modules'
  18.         'Improvement'
  19.         'Few words about the doc...'
  20.         'superdark is postcardware!'
  21.         'Bug report'
  22.         'History'
  23.         'Address'
  24.         'Thanks to...'
  25.  
  26. ----------------------------------------------------------------------------------
  27. Disclaimer "Disclaimer"
  28. ----------------------------------------------------------------------------------
  29. Now the usual Crap...
  30.  
  31. SuperDark has been throughly tested and debugged. Although there can be
  32. some Bugs which may cause Damage or Problems. The SuperDark Package is
  33. provided "as is" without Warrenty of any Kind! The entire Risk by using
  34. this Program is assumed by you, the User! Neighter Thomas Landspurg nor
  35. Pieter Hollants are liable for direct, indirect, incidental or consequential
  36. Damage resulting from Using SuperDark, even if they have been advised of
  37. the Possibility of such a Damage.
  38.  
  39. This Manual is Copyright 1993 Thomas Landspurg (and the
  40. others contributors to this manuel like Pieter Hollants!). It may
  41. be printed out for personal Use only. Neighter the Printout nor the Docfile
  42. may be spread alone. Nothing in this Docfile may be changed without our
  43. written Permission.
  44.  
  45. Official Releases of SuperDark may be copied for private Usage. No Fee may be
  46. charged. For commercial Usage you need to contact the Author, Thomas Landspurg,
  47. first. PD-Distributors: As long as this Package is on an AmigaLibDisk made by
  48. Fred Fish it may be sold as long as the Price is below the Cost Fred Fish wants
  49. for the Disc. It must not be included in any other Series without the Author's
  50. written Permission. The Package may be uploaded on non-commercial Bulletin
  51. Board Systems only. Downloading must be free of any Costs except the Phone Bill.
  52. In all Cases all Files must be included and remain unaltered! Copying must
  53. be done eighter as Archive or as Drawer.
  54. But remember, don't forget to send me a 'postcard' if you use superdark,
  55.  
  56. If you have any Questions about this, contact the Author and tell him what
  57. you want to do with the Package. You will be told whether it's legal or not.
  58.  
  59. If you've already changed the Configuration some Things in this Manual may
  60. be different!
  61. ----------------------------------------------------------------------------------
  62. Introduction "Introduction"
  63. ----------------------------------------------------------------------------------
  64. @Toc    "Main"
  65.  
  66. SuperDark is a Screen Blanker. For those who don't know what it is:
  67. On some old Monitors (maybe also the newer ones) there's the Possibility
  68. that if the Display (f.E. the Workbench Screen) stands for a longer Time
  69. this Screen stays in the Monitor! This means, when you turn the Computer
  70. off and on again, you may see the Workbench Screen IN the Kickstart Screen
  71. or Bootmenu!!! To pretend this, there are Screen Blankers. After a Period
  72. of Time they become active and blank the Screen black like if it's turned
  73. off or they do some Kind of Activity.
  74. SuperDark is such a Screen Blanker...Yes, another one, but this one has some
  75. special Features. You'll have seen a well known Program named AfterDark in
  76. the MS-DOS and Macintosh World. Well, this is an Amiga Adaption requiring
  77. Kickstart 2.0 or higher. SuperDark_13 isn't supported any longer.
  78.  
  79. Some characteristics:
  80.  
  81.     - Many different effects (only one effect is loaded in
  82.       memory at a given time) examples:
  83.         o FireWorks,
  84.         o Flying Toaster,
  85.         o ASWarm,
  86.         o Classic ones like "Clock","Mistify",...
  87.         o More originals like Music, Shufffle, Spot,...
  88.         o etc...
  89.  
  90.     - Password protected Screen Locking
  91.  
  92.     - Immediate blanking
  93.  
  94.     - Font sensitive
  95.  
  96.     - CPU timeout
  97.  
  98.     - Greatly improved.....
  99.  
  100.  
  101. CPU timeout:
  102.    This is the major improvment of v2.0. Before, I superdark was running
  103. when there was a big cpu usage (like a raytracing computation) the blanker
  104. was stopped, showing the current image, but not moving it.
  105.    Now, if there is not enough CPU time, a black screen will popup, but
  106. the current superdark module will come back when CPU will become available.
  107.  
  108.  
  109. ----------------------------------------------------------------------------------
  110. Installation "Installation"
  111. ----------------------------------------------------------------------------------
  112. Installation
  113. ------------
  114.  
  115.      - Move SuperDark where you want it to be and modify the User-Startup
  116.        or Startup-Sequence to call SuperDark at Startup.
  117.  
  118.      - Or just drop the SuperDark Icon into your WBStartup Drawer.
  119.  
  120.      - If you don't have WB3.0, copy reqtools.library to your LIBS:
  121.        if it isn't already present. The Version should be V38 or higher.
  122.        if you have WB3.0, you don't need any more reqtools...
  123.  
  124. If you did the second Way or if the Blankers Directory is not in the same
  125. Directory as the SuperDark Program you need to change the Configuration to
  126. enter the new Path. Look in Usage how to pop up the Configuration Window.
  127.  
  128. If you've put SuperDark in your WBStartup Drawer and after Reboot a
  129. Requester appears saying "SuperDark hasn't returned yet..." or something
  130. like that, click on the SuperDark Icon, select "Information" from the
  131. Icons Menu and add the Tooltype DONOTWAIT. Then select Save and the
  132. Requester should not appear any longer.
  133.  
  134. You can also open the window using your Workbench's "commodities exchange":
  135. Select SuperDark and press the 'show' gadget.
  136.  
  137. Note 2: SuperDark needs WB2.0 or higher
  138.  
  139.  
  140. ----------------------------------------------------------------------------------
  141. Utilization "Utilization"
  142. ----------------------------------------------------------------------------------
  143. II Utilization
  144. --------------
  145.  
  146.  When you start SuperDark, and the configuration is correct, a small window
  147. will be opened unless <QUIET = YES>
  148.  
  149.  To modify the parameters, press the key <left shift> and the key <f3> -- a
  150. window will appear...the explanation will be given next chapter.
  151.  Attempting to start SuperDark while it is already running also will open
  152. the configuration window.
  153.  
  154.  Immediate blanking: If you press the <left shift> key and the <f4> key at
  155. the same time, there will be an 'immediate blanking', This means that the
  156. screen will be instantly be blanked.
  157.  
  158.   You can also put the mouse in the lower left corner of the screen to
  159. blank the screen after 2 seconds.
  160.   If you put your mouse in the lower right corner of the screen, 
  161. the screen will never blank.
  162.  
  163.   Of course, if don't use your computer for the time specified in the
  164. configuration, SuperDark  will send the screen into a 'blanking state'
  165.  
  166.  
  167. ----------------------------------------------------------------------------------
  168. Configuration "Configuration"
  169. ----------------------------------------------------------------------------------
  170. The main window configuration:
  171.     ----------------------------------------------------------
  172.     |             __________________            __            |
  173.     |            |                  |          |  |   SD V1.5 |
  174.     |            |                  |          |  |           |
  175.     |            |  'modules'        |          |  |           |
  176.     |            |                  |          |  | 'Smallmem' |
  177.     |            |                  |          |  |           |
  178.     |            |__________________| 'Tempo'   |__|           |
  179.     |                                               'Topaz'    |
  180.     | 'Param'                           Quiet ''               |
  181.     |                    _____________________                |
  182.     |   'Dark directory' |_____________________|               |
  183.     |                    _____________________                |
  184.     |         'CxPopkey' |_____________________|  'TaskPri'     |
  185.     |                    _____________________                |
  186.     |         'Blankkey' |_____________________|               |
  187.     |                          ____________                   |
  188.     |   Lock ''  'PassWord'    |____________|                  |
  189.     |                                                         |
  190.     |                                                         |
  191.     | 'Remove'   'Save'    ' Help '   ' Hide '              |
  192.      ---------------------------------------------------------
  193. ----------------------------------------------------------------------------------
  194. DARKDIR
  195. ----------------------------------------------------------------------------------
  196. Dark directory:
  197. Explanation:
  198.  This String Gadget is one of the most important Things in the Configuration
  199.  File. SuperDark will look in the Directory specified here for his Blanking
  200.  Modules. So, if you see nothing in the Modules list, the Path specified
  201.  here could be wrong.
  202. Examples:
  203.  SYS:Tools/SuperDark/Blankers
  204.  DH0:Data/Blankers
  205. ----------------------------------------------------------------------------------
  206. CXPOPKEY
  207. ----------------------------------------------------------------------------------
  208.  You put in this gadget the hotkey used to open this window. This is a standart
  209. Amigados 2.x key description, like "shift f2", or "ctrl f1", or 
  210. "left shift ctrl a".
  211.   Default is "shift f3"
  212. ----------------------------------------------------------------------------------
  213. BLANKKEY
  214. ----------------------------------------------------------------------------------
  215.  This is the gadget where you put the defintition of the hotkey used to make
  216. an immediate blanking. Like the Cxpopkey, it's a standart amigados key
  217. definition. But do not use the same hotkey than cxpopkey!
  218.   Default is "shift f4"
  219.  
  220.   Note that you can also make an immediate blanking by moving your mouse
  221. the lower left corner of the screen.
  222.   If you want to disable screen blanking, just move your mouse to the
  223. lower right corner of your screen.
  224.  
  225. ----------------------------------------------------------------------------------
  226. MODMAIN
  227. ----------------------------------------------------------------------------------
  228.  In this List, you see the Blanking Modules currently avaible (if not,
  229.  check the Dark Directory Path!). Click on the Module you want to be active
  230.  during the blanking. The current Module is shown at the Bottom of the
  231.  List.
  232.  
  233.     Look at:'Modules'
  234. ----------------------------------------------------------------------------------
  235. PARAM
  236. ----------------------------------------------------------------------------------
  237. Param:
  238.   This button open the configuration window of the selected module.
  239.   Use this to modify the parameters of any module.
  240. ----------------------------------------------------------------------------------
  241. TEMPO
  242. ----------------------------------------------------------------------------------
  243.  
  244. Explanation:
  245.  This Slider Gadget allows you to choose the Time after which the Blanker
  246.  is started.
  247. Examples:
  248.  10 - lowest possible Value; After 10 Seconds the Screen starts blanking
  249.  300 - highest possible Value; After 5 Minutes the Screen starts blanking
  250.  
  251. ----------------------------------------------------------------------------------
  252. QUIET
  253. ----------------------------------------------------------------------------------
  254. Quiet:
  255.  This Checkbox just tells SuperDark not to show the little Window saying
  256.  "SuperDark started..." at Startup.
  257.  
  258. ----------------------------------------------------------------------------------
  259. LOCK
  260. ----------------------------------------------------------------------------------
  261. Lock:
  262.         After the screen blanking, if you have selected this
  263.        checkbox, a password is requested. So, if you need to go
  264.        somewhere, but you don't want your computer used by anyone
  265.        else, you should use this feature.
  266.  
  267. ----------------------------------------------------------------------------------
  268. PASSWORD
  269. ----------------------------------------------------------------------------------
  270.   This gadget allows you to enter the password used to unlock the screen. Note
  271. that the 'LOCK' gadget must be 'on' to use the password features.
  272. ----------------------------------------------------------------------------------
  273. TASKPRI
  274. ----------------------------------------------------------------------------------
  275.   This slider allows you to change the priority of the blanking task. By default,
  276. this priority is zero, but you can put it to a lower value, so the blanker
  277. won't still any precious CPU time to the other task running at this time.
  278. ----------------------------------------------------------------------------------
  279. TOPAZ
  280. ----------------------------------------------------------------------------------
  281. Topaz:
  282.    SuperDark can use default system font, or use a normal topaz 8 font. I
  283.    use this because sometime default fonts are too big, so I can just go
  284.    back to a small font quickly.
  285. ----------------------------------------------------------------------------------
  286. SMALLMEM
  287. ----------------------------------------------------------------------------------
  288. SmallMem:
  289.    This gadget allows you to choose if you want the module to be loaded only
  290.    during the blanking period. This use less memory when the blanker is
  291.    not used, but take a little bit to re-load the module each time, especially
  292.    with disk drive
  293. ----------------------------------------------------------------------------------
  294. PASSWD
  295. ----------------------------------------------------------------------------------
  296. Passwd:
  297.    This gadget allows you to enter the Passwd needed to Unlock Screen.
  298. ----------------------------------------------------------------------------------
  299. REMOVE
  300. ----------------------------------------------------------------------------------
  301.  
  302. Explanation:
  303.  If you press this Button, SuperDark will be completely removed from
  304.  Memory. Be careful, it quits without any Request!!
  305.  
  306. ----------------------------------------------------------------------------------
  307. SAVE
  308. ----------------------------------------------------------------------------------
  309.  
  310. Explanation:
  311.  Pressing this Button causes SuperDark to save the current Configuration of
  312.  SuperDark and of the Random Module.
  313.  
  314. ----------------------------------------------------------------------------------
  315. HELP
  316. ----------------------------------------------------------------------------------
  317. Help:
  318.    This will shows you a little information window.
  319. ----------------------------------------------------------------------------------
  320. HIDE
  321. ----------------------------------------------------------------------------------
  322.  
  323.  
  324. Explanation:
  325.  This Button will close the Configuration Window, just like if you click on
  326.  the Close Gadget. It does NOT remove SuperDark. See above about how to
  327.  open it again.
  328.  
  329.  
  330. ----------------------------------------------------------------------------------
  331. Modules
  332. ----------------------------------------------------------------------------------
  333.  
  334. Blankings Modules
  335.  
  336. Yes, this Chapter describes everything about the Blanking Modules!
  337. If you select one and click on Param, the appearing Window will
  338. have these Buttons:
  339.  
  340.  
  341. -OK: Saves the Configuration and goes back to SuperDark's Window
  342. -TEST: To test the Module
  343. -CANCEL: Goes back to SuperDark's Window without saving
  344. -INFO: Information about the Module
  345.  
  346. Now I'll handle the single Modules which should accompany SuperDark.
  347. They are:
  348.  
  349. 'Anim'            'Line'            'Slide show'
  350. 'ARexx'            'Line2'            'Spot'
  351. 'ASWarm'            'Melt'            'Star'
  352. 'Effets'            'Mistify'        'Text'
  353. 'FireWork'        'Music'            'Time'
  354. 'FracBlank'        'Plasma'            'Random'
  355. 'FlyingToaster'        'Plasma Cycle'
  356.  
  357. New modules:
  358. 'Dimmer'            'Music dream'
  359.  
  360.  
  361.    You can easyly add or remove modules, even when superdark is running.
  362. May be you don't like the module "music", so you just can erease it using
  363. your favorite disk tool, and then just select the "dark directory" field,
  364. press return and the module list will be updated.
  365.     If you want to add new module, it's the same kind of operation, just
  366. put new modules in the dark directory, select the dark directory string
  367. gadget and presse return....
  368.  
  369. ----------------------------------------------------------------------------------
  370. 3d "3d"
  371. ----------------------------------------------------------------------------------
  372.  
  373.   This effect show you a 3d Object moving on the screen. That's all for
  374. the moment, but this effect is still in development to be more attractive!
  375. Note: that effect was called 'anim', but 3d is a most apropriate name!
  376.  
  377.    * Medium   cpu-user.
  378.  
  379.    * small memory-user.
  380.  
  381. ----------------------------------------------------------------------------------
  382. anim "anim"
  383. ----------------------------------------------------------------------------------
  384.  
  385.    This module show IFF animations, but be careful, AND READ THIS:
  386.  
  387. - This module call an external anim player. I use mugiff, but you can
  388. use the player you want, BUT THIS PLAYER SHOULD EXIT AFTER A CTRL-C
  389. SIGNAL!!! PP_anim DON'T EXIT AFTER A CTRL-C, so DO NOT USE PP_ANIM!
  390. Use MugIFF, it's small, and fine to use.
  391.  
  392. - Do not put more than one filemame in the file requester....If you
  393. do this, the anim player will never exit!
  394.  
  395. - And at least, this I put this module in this distribution, but I'm not
  396. shure that it will work perfectly....
  397. ----------------------------------------------------------------------------------
  398. ARexx "Arexx"
  399. ----------------------------------------------------------------------------------
  400.  
  401.   This effect allows you to send an ARexx command at the beginning of the
  402. blank, and another command at the end of the blanking period. This allows you
  403. to start for example a music program, paint program or custom program during
  404. blanking. I'am sure that a lot of poeple will find good idea for this effect!
  405.  
  406. AREXXPORT: This is the name of the ARexx port where the ARexx command are send.
  407.  
  408. CMD:    This is the command send at the beginning of the blank.
  409.  
  410. ENDCMD:    This is the command send at the end of the blank.
  411.  
  412.     * Small CPU-Usage
  413.  
  414.     * Small Memory-Usage.
  415.  
  416.  
  417. ----------------------------------------------------------------------------------
  418. ASWarm "ASWarm"
  419. ----------------------------------------------------------------------------------
  420.  
  421.   This module show you little things moving on screen....Just look at it
  422. to understand! It's based on a Sun effect's, and it was first made by Markus
  423. Illenser and Matthias Scheler on the Amiga.
  424.  
  425. SPEED=[Slow motion | Very Slow | Slow | Normal | Fast | Very Fast | Incredible ]
  426.  
  427. WASPS=[1-10] number of Wasps!
  428.  
  429. BEES=[1-500] number of bees!
  430.  
  431. TIGHTNESS=[1-10]
  432.  
  433. COLOR CYCLING=[ON|OFF]
  434.  
  435. AIM MODE=[ON|OFF]
  436.  
  437.     * Medium to big cpu-user
  438.     * Small memory-user
  439.  
  440.  
  441. ----------------------------------------------------------------------------------
  442. Effets "Effets"
  443. ----------------------------------------------------------------------------------
  444.  
  445.  These are three different Effects in one Module. They've all been described
  446.  in an old issue of the Scientific America.
  447.  
  448. TYPE= [ INTERFERENCES | DRAGON | FRAC EFFECT | RANDOM ]
  449.  
  450. DUREE= [ 50-100]
  451.  
  452.     * Big cpu-user
  453.     * Medium memory-user
  454.  
  455.  
  456. ----------------------------------------------------------------------------------
  457. FireWork "FireWork"
  458. ----------------------------------------------------------------------------------
  459.  
  460.  Just Fireworks...A Happy New Year ;-)
  461.  
  462.     * Big cpu-user
  463.     * Medium memory-user
  464.  
  465.  
  466. ----------------------------------------------------------------------------------
  467. FlyingToaster
  468. ----------------------------------------------------------------------------------
  469.  
  470.  This Effect seems to be inspired from the well known AfterDark.
  471.  The Code was taken from a PD Screenblanker, FlyingToaster.
  472.  
  473.     * Medium CPU-user
  474.     * Medium memory-user
  475.  
  476.  
  477.  
  478. ----------------------------------------------------------------------------------
  479. Fracblank
  480. ----------------------------------------------------------------------------------
  481.  
  482.              Adapted from a program by Olaf Barthel. Real plane
  483.           fractals (yes, real fractals) are drawn.
  484.           The algorithm employed comes from the September 1986
  485.           issue of Scientific American;  some of you who are familiar
  486.           with OpenWindows Version 2 (such as running  on  the  Sun4)
  487.            will know it from the popular `xlock' program.
  488.  
  489.     * big cpu-user
  490.     * medium memory user
  491.  
  492. ----------------------------------------------------------------------------------
  493. Line
  494. ----------------------------------------------------------------------------------
  495.  
  496.  The screen will slowly disappears under the lines....
  497.  
  498.     * Small cpu-user
  499.     * Medium memory-user
  500.  
  501.  
  502. ----------------------------------------------------------------------------------
  503. Line2
  504. ----------------------------------------------------------------------------------
  505.  
  506.   This effect will show you multicolored lines...You can choose the number
  507. of lines, their speed, etc....
  508.  
  509.  
  510.     * Big cpu-user
  511.     * Medium memory-user
  512.  
  513. ----------------------------------------------------------------------------------
  514. Melt
  515. ----------------------------------------------------------------------------------
  516.  
  517. Description:
  518.  Very nice Effect! Forget melting Nuclear Power Plants - watch this!
  519. Types:
  520.  Type1: Looks like it shrinks
  521.  Type2: Looks like it melts to the Floor
  522.  Type3: Really undefineable
  523.  Aleatoire: Also undefineable
  524.  
  525. TYPE = [type1|type2|type3|random]
  526. TEMPO = [50..200]
  527.  
  528.     * Medium cpu-user
  529.     * Medium memory-user
  530.  
  531. ----------------------------------------------------------------------------------
  532. Mistify
  533. ----------------------------------------------------------------------------------
  534.  
  535.  Moving Lines on the Screen...based on a Window's Effect.
  536.  
  537. NUMBERS=[1-3]
  538. SPEED  =[1-10]
  539.  
  540.     * Medium to Big cpu-user
  541.     * Medium memory-usage
  542.  
  543. ----------------------------------------------------------------------------------
  544. Music
  545. ----------------------------------------------------------------------------------
  546.  
  547.    This effect is based on my old demo named "The PoiPoi". Four little guys
  548. moves with music, while PoiPoi musicians are playing the music...
  549.    You can select wich SoundTracker or protracker module to play, by
  550. selecting it's name in the "Module" string gadget (sorry, no requester for
  551. the moment).
  552.    Each of the musician have one or more instrument assigned to him. Example,
  553. right drummer can play instrument number 5,9 and 15. YOu can see the name
  554. of the instrument by pressing the Instr. button. So you can easyly now witch
  555. voice is playing wich instrument.
  556.  
  557.   If the module can't find your module, or if the selected file is not a
  558. protracker/stk module, a default module will be played (mod.wizardy).
  559.  
  560.   Try this effect....Really nice!
  561.  
  562. MODULE=<name of the file to be played>
  563. VOICE [1..32]=[0..5]
  564.  
  565.     * Medium cpu-user
  566.     * Medium memory-usage
  567.  
  568.  
  569. ----------------------------------------------------------------------------------
  570. Plasma
  571. ----------------------------------------------------------------------------------
  572.  
  573.   This effect is based on plasma effect from the demos. Not that this
  574. effect is based on copperlist only, absolutly no image is displayed 
  575. (0 bitplanes).
  576.  
  577.     * Big cpu-user
  578.     * Big Memory-usage
  579.  
  580. ----------------------------------------------------------------------------------
  581. Plasma_Cycle
  582. ----------------------------------------------------------------------------------
  583. 3.2.xx Plasma_cycle
  584.  
  585.     This effect also make plasma, but using a standarts bitmap after
  586. cycle the colormap, so it must look nice...
  587.  
  588.     * Big cpu-user
  589.     * Medium Memory-usage
  590.  
  591. ----------------------------------------------------------------------------------
  592. Shuffle
  593. ----------------------------------------------------------------------------------
  594.  
  595.   Based on a blanking effect from the XSB program...
  596.  
  597. SPEED=[SLOW | MEDIUM | FAST | VERY FAST ]
  598.  
  599.     * Small cpu-user
  600.     * Medium memory-usage
  601.  
  602. ----------------------------------------------------------------------------------
  603. Slide-show
  604. ----------------------------------------------------------------------------------
  605.  
  606.   Rem: This effect is only available in WB2.0 or higher....
  607.  
  608.  This effect allows you to make a slide show of your picture during blanking.
  609. Useful if you are a gfx artist!
  610.   Some explanation:
  611.      You must select wich pictures are shown during blanking by pressing the
  612. 'Add' button and then select the picture you want. Delete will remove the
  613. selected filename in the list of the pictures.
  614.     Show will show you the selected picture during a few seconds.
  615.  
  616.     NEW: Slide show now use WB3.0 datatypes. So if you have the good datatype,
  617. SLide show use it, and can show any kind of image. If you don't have
  618. datatypes, or if he seems that he can't use it, slide show use his old
  619. IFF screen loader :-( .
  620.  
  621. Note: The list of the filename will be saved in the file s:slide-show.cfg
  622.   You can modify this file yourself if you want.
  623.  
  624.     * Small cpu-user
  625.     * Medium to big memory-user
  626.  
  627. ----------------------------------------------------------------------------------
  628. spot
  629. ----------------------------------------------------------------------------------
  630.  
  631.     One or more spots will highlight the screen. If the module can
  632. open a screen of one or more bitplanes than the actual one, you can change
  633. the luminosity of the background.
  634.  
  635. SIZE   = [1-80]
  636. SPEED  = [1-10]
  637. NUMBER = [1-5]
  638. DOUBLEBUFFER=[TRUE|FALSE]  You can use or not dble buffer, but not in all the
  639.                cases.
  640.  
  641. SHADOW = [0-90]   Percentage of luminosity for the background
  642.  
  643.       * Medium Cpu-user
  644.     * Medium Memory-User
  645.  
  646. ----------------------------------------------------------------------------------
  647. Star
  648. ----------------------------------------------------------------------------------
  649.  
  650.  A real Starfield! Scott' me up,Beamie...
  651.  
  652.  
  653. STARS NUMBER=[10-150]
  654. SPEED       =[1-10]
  655.  
  656.     * Big cpu-user
  657.     * Medium memory-user
  658.  
  659. ----------------------------------------------------------------------------------
  660. Text
  661. ----------------------------------------------------------------------------------
  662. Text
  663.  
  664.    Not a very original effect, but everybody needs this one some days.
  665. Just write a little text on your screen, and you can choose resolution screen
  666. and screen font.
  667.  
  668. TEXT=<your text>
  669. FONTS=<font used> (don't modify it from .info)
  670. SCREEN=<screen used> (don't modify it from .info)
  671. SPEEDX=[0..5] 
  672. SPEEDY=[0..5] 
  673.  
  674.     * Small to high cpu-user (depend of the size font)
  675.     * Medium memory-user
  676.  
  677. ----------------------------------------------------------------------------------
  678. Time
  679. ----------------------------------------------------------------------------------
  680. Time
  681.  
  682.   This effect show you a clock. You can choose three different clocks.
  683. You can also choose the Font, but only for the digital Clock.
  684.   The Clock can move on your screen, if put something else than Zero
  685. in the self-explaining fields SpeedX and SpeedY.
  686.  
  687. TYPE=[DIGITAL|NORMAL|MODERN]
  688. SECONDS=[ON|OFF]
  689. SPEEDX=0..6
  690. SPEEDY=0..6
  691.  
  692.     * Small cpu-user
  693.     * Medium memory-user
  694.  
  695. ----------------------------------------------------------------------------------
  696. Random
  697. ----------------------------------------------------------------------------------
  698. Random
  699.  
  700.   This effect will choose randomly different other effects! You can
  701. select the effect that you want to be 'choosable' in the selection list.
  702. But if the All Checkbox is checked, all the effect are selectables!
  703.  
  704.   The list of the selectables effects is saved in the file s:dark_random.cfg
  705.  
  706.  
  707.         NOTE:
  708.         ----
  709.  
  710.    The blankers modules are executales, so you can pack them with powerpacker
  711. for instance!
  712.  
  713.   
  714.   
  715. ----------------------------------------------------------------------------------
  716. not_yet_ready
  717. ----------------------------------------------------------------------------------
  718.  
  719.   The documentation for these modules is not yet ready, but you
  720. can use them...it's easy to understand!
  721.   
  722.  
  723. ----------------------------------------------------------------------------------
  724. Improvement "Improvement"
  725. ----------------------------------------------------------------------------------
  726.  
  727. The future:
  728.  
  729.     More blankers, but also improve the old one.... They are now much more
  730.     better than the earlier one, but it's only little things, but this make
  731.     life easier for users.
  732.  
  733.  
  734.     o Idea of modules:
  735.  
  736.     - "Look-like demos" modules...shaded bobs, plasma
  737.     - AGA specific modules
  738.  
  739.  
  740. ----------------------------------------------------------------------------------
  741. BugReport
  742. ----------------------------------------------------------------------------------
  743.  
  744. Now bugs:
  745. Bug Report
  746.  
  747.   Please, send me bug reports, or any information (idea, improvement,etc..)
  748.  
  749.   
  750.   I think there is some problems with A1200 or 4000, due to the DblPal mode..
  751. I don't know a lot of this mode. If you have any information, or any problem
  752. you know what to do!
  753.  
  754.  
  755. ----------------------------------------------------------------------------------
  756. Doc
  757. ----------------------------------------------------------------------------------
  758.    A lot of poeple send me some a correct doc file, so you think:
  759. "Why there is still so much mistakes in this doc?". There is different
  760. reasons:
  761.    - SuperDark is always moving, so when somebody send me a correct
  762.      file, the current doc file is different, bigger,etc... So I have
  763.      to make all the changes by hand, line by line!
  764.    - I'm a little bit tired of all these changes....I've try to get
  765.      the best of all these docs, but I'm not shure that the final doc
  766.      is correct!
  767.  
  768. So, a message to all my nice "Text senders"!:
  769.  
  770. Don't blame me if I've not always use all your corrected file! but thanks
  771. for your help!
  772.  
  773. ----------------------------------------------------------------------------------
  774. History
  775. ----------------------------------------------------------------------------------
  776. History
  777.  
  778. 01/01/93
  779.     v.09:    -First version realised, on some BBS
  780.  
  781. 30/01/93
  782.     v1.0:    - Lot of Bugs fixed, but there are still a Lot of Bugs... 
  783. 05/02/93
  784.     v1.1:    - Crash if incorrect configuration found,now fixed
  785.         - TaskPri slider added
  786.         - "Mouse in the corner" functions added
  787.         - New effect in line.dark
  788.         - New: Spot.dark
  789. 12/02/93
  790.     v1.2:    - SuperDark is now under OS2.0 and higher a commodities
  791.         - Cx_popkey,and blankey can now be modified
  792.         - Memory allocation error fixed in spot and anim
  793.         - New: Music.dark! GREAT...
  794.         - First version sent to FredFish and to BBSes via SAN
  795. 25/02/93:
  796.     v1.21:    - Bug fixed in module spot.dark: if the screen width was not a 
  797.           multiple of 8 this causeed a modulo problem...
  798.         - Bug fixed in the FireWork module, sometime the module never
  799.           exited.
  800.         - anim.dark:The 3d Amiga logo was in the wrong direction :-)
  801.         - French text removed in the effects and line 2 modules
  802.         - with overscan, Shuffle and line doesn't use the whole screen.
  803.           now fixed
  804.         - Bug in slide-show: when the param window was opened the
  805.           first time, the file list wasn't correct. Now Fixed.
  806.         - The "Duree" field in the Random module was not correct. Fixed
  807.         - Source: I've finally got the last 2.0 includes files, and I've
  808.           changed my files to fit them. No more "convert.h" file.
  809. 08/03/93:
  810.     v1.22:
  811.         - New type of datas: IMAGE, and DATA_STRING
  812.                 - Add Screen Resolution Choice in some Modules using
  813.                   reqtools.library
  814. 10/03/93:
  815.     v1.3:
  816.         - Pointer should now disappear...
  817.         - Bug fixed in Plasma (screen depth is now really zero )
  818.         - Music: Now music players should be visible in NTSC :-)
  819.         - Music: File selector added
  820.  
  821. 20/03/93:
  822.     v1.4
  823.         - Forgot to put UnLockPubScreen() ! Now fixed
  824.         - SuperDark now looks at the Font Size of the Window Title
  825.           Bar
  826.         - The famous Upper/Lowercase bug reported in Usenet hase been
  827.           corrected. Now are also modules recognized
  828.           if they use uppercase letters.
  829.         - New type of data: FONT
  830.         - Bug fixed in ASWarm.dark: Appeared if Screen Depth was
  831.           less than 2 Bitplanes
  832.         - Now SuperDark_1.3 isn't any longer supported
  833.         - New: Text.dark
  834.  
  835. 25/03/93:
  836.     v1.4b
  837.         - Support for other fonts than topaz 8. (All interlace WB users
  838.           will be happy!)
  839.         - New features: choice between Topaz and default font
  840.         - New features and SmallMem
  841.         - Bug: I had also a famous _lock_ bug... forgot to UnLock()..
  842.         - bug: RemPort was used instead of DeletePort(), this cause some
  843.           bytes of mem to be lost...
  844.         - Fixed problem with mode who wanted a copy of workbench screen.
  845.           Now this copy look like the original WBench screen...
  846.         - UnLock screen is now in hires
  847.         - Changed place of a SetTaskPri, so now even if there is a high
  848.           CPU usage, you see the blanking module. But if there is
  849.           absolutly no CPU left, it could stop and not show anything...
  850.           next step: put a timeout and show a black screen...
  851. 27/03/93:
  852.     v1.5
  853.         - Size of superdark have been reduced from about 4k by writing
  854.           my own printf (using RawDoFmt of course, scanf, etc....
  855.         - Clock is now moving.
  856.         - Better look of the blanker in random mode...Last screen is
  857.           now taken as the current screen for effects like shuffle,melt...
  858.         - Music module is now in 4 bitplanes, instead of 5 before->
  859.           smaller, faster.
  860.         - GREAT (for me!): Slide show use WB3.0 datatypes, so now
  861.           is you have the good datatype, you can display any kind
  862.           of images, GIF,IFF,etc...
  863.           Now the slide show file requester can also use multiselection
  864.  
  865. 05/04/93:
  866.     v1.5b
  867.         - The font requester is now the asl font requester, no more
  868.           the reqtools font req.
  869.         - Screen Mode requester, is now the ASL screenmode requester
  870.           if available (V38), or Reqtools screenmode req. if available.
  871.         - Use protos instead of CLIB -> smaller 
  872.         - NEW: module anim.dark (play animation, the old anim is renamed
  873.           to 3d)
  874.  
  875. 11/04/93:
  876.     v.15c
  877.         - Correction of a bug in spot with WB3.0
  878.         - Main Window reorganisation, so all gadget are visible in NTSC
  879.           screen.
  880.  
  881. 12/04/93:
  882.     v.15d
  883.         - Screen mode requester in the clock module.
  884.         - Correction of a bug in melt, which cause some crash in
  885.           superhires mode!!
  886.         - Big doc corrections...
  887.  
  888. 12/05/93:
  889.     v1.5e
  890.         - Screen mode requester in firework, star
  891.         - Music should now open correctly in dblpal
  892.         - Different text choices in text module.
  893.         - New: module hypno...
  894. 29/05/93:
  895.     v2.0a
  896.         - Screen timeout added
  897.         - Information windows are now standart information windows.
  898.         - Big changes in music.dark (new interface)
  899.         - minor changes in modules
  900.         - Changes in some fields of the communication structure, but
  901.                   old modules should still work.
  902.         - Added a debugging tool: show_info. This tool allow to make
  903.           some print_d() (like printf) in blankers
  904.         - New module:Dimmer and music_dream
  905.         - The pointer pixel bug should be corrected!
  906.  
  907.  
  908. ----------------------------------------------------------------------------------
  909. post
  910. ----------------------------------------------------------------------------------
  911.  
  912.   SuperDark is postcardware, this mean that if you like it, and if you
  913. use it, you have to send me a postcard of your contry! Nice no? look
  914. at my 'adress'.
  915.   But due to the lack of foreign modules for superdark, maybe I'll
  916. make superdark shareware in the future!
  917.  
  918.  
  919. ----------------------------------------------------------------------------------
  920. Adress
  921. ----------------------------------------------------------------------------------
  922.  Contact adress
  923.  
  924.     Thomas LANDSPURG
  925.     9, Place Alexandre 1er
  926.     78000 VERSAILLES
  927.     FRANCE
  928.  
  929.     FidoNet: 2:320/104.18
  930.     AMyNet:     39:180/1.18
  931.     UseNet:     Thomas.Landspurg@ramses.gna.org
  932.  
  933.     (better use UseNet...faster and seafer)
  934.  
  935.  The last realease of SuperDark are availables on the Ramses BBS:
  936.  
  937.     19-(33)-60037713 (up to 14.4 I think)
  938.  
  939.  
  940.  So you can use this program freely, but if you find it useful, just send
  941. me a letter or postcard with your opinion,
  942.  
  943. ----------------------------------------------------------------------------------
  944. Thanks
  945. ----------------------------------------------------------------------------------
  946.  
  947.  
  948.     Thanks to:
  949.  
  950. - Eric Delord, for his help!
  951. - Frank Geider
  952. - Per Jonsson
  953. - Aeneas Verhe
  954. - Chris Hurley
  955. - Theodore A. Serreyn 
  956. - Peter Smets 
  957. - Carl Tashian
  958. - Rand Fredricksen (help for doc!)
  959. - Pieter Hollants  
  960. - Jérôme Santini for the hypno module
  961.  
  962.