home *** CD-ROM | disk | FTP | other *** search
/ Fujiology Archive / fujiology_archive_v1_0.iso / !MAGS / !BONUS / COVERDSK / STFORMAT / STF55.ZIP / STF55.MSA / DAWN / DAWN.TXT < prev    next >
Text File  |  1993-12-03  |  15KB  |  437 lines
  1.  
  2.          BBBBB   EEEEEE  FFFFFF   OOOOO   RRRRR   EEEEEE
  3.          BB  BB  EE      FF      OO   OO  RR  RR  EE
  4.          BB  BB  EE      FF      OO   OO  RR  RR  EE
  5.          BBBBB   EEEEE   FFFFF   OO   OO  RRRRR   EEEEE
  6.          BB  BB  EE      FF      OO   OO  RR RR   EE
  7.          BB  BB  EE      FF      OO   OO  RR  RR  EE
  8.          BBBBB   EEEEEE  FF       OOOOO   RR  RR  EEEEEE
  9.  
  10.                  DDDD      AA    WW   WW  NN  NN
  11.                  DD DD    AAAA   WW   WW  NNN NN
  12.                  DD  DD  AA  AA  WW   WW  NNNNNN
  13.                  DD  DD  AA  AA  WW W WW  NNNNNN
  14.                  DD  DD  AAAAAA  WWWWWWW  NN NNN
  15.                  DD DD   AA  AA  WWW WWW  NN  NN
  16.                  DDDD    AA  AA  WW   WW  NN  NN
  17.  
  18.                           Version 1.2x
  19.  
  20.                             Shareware
  21.                             =========
  22.                        Copyright (c) 1993
  23.                          by Arne Rudolph
  24.                        All rights reserved
  25.  
  26.                           Arne Rudolph
  27.                         Salvatorstraße 2
  28.                           52070 Aachen
  29.                              Germany
  30.  
  31.                              EMail:
  32.                    Mausnet: Arne Rudolph @ AC
  33.  
  34.  
  35. _Page_1__________________________________________________________
  36.  
  37. 1. Statement
  38.  
  39. 'Before Dawn' is copyright  (c) 1993 by Arne Rudolph - all rights
  40. reserved!
  41.  
  42. This program is NOT Public Domain! You may distibute it freely as
  43. long as it is free to the customer.  The distribution on PD disks
  44. and commercial mailbox systems has to be authorized by me. I hold
  45. the right to withdraw this authorization at any time.
  46.  
  47. I, Arne Rudolph,  don't undertake liability for any direct or in-
  48. direct damage, including, but not restricted to,  material or fi-
  49. nancial damage,  caused by the use of 'Before Dawn' or the unsui-
  50. tability of 'Before Dawn' for a specific purpose.
  51.  
  52.  
  53. 2. Shareware
  54.  
  55. 'Before Dawn' is Shareware! This means you may test 'Before Dawn'
  56. freely for four weeks.  If you decide to use  'Before Dawn' regu-
  57. larly or use it  longer than the specified four week period,  you
  58. have to register as a user. The registration fee is 20 DM!
  59. If you enclose the eqivalent of $20 you will  receive a disk with
  60. the latest version of 'Before Dawn'.
  61. Please don't send cash - a cashable cheque is sufficient!
  62.  
  63. My bank account:
  64.  
  65.   Arne Rudolph
  66.   Postgiroamt Hamburg
  67.   Konto-Nr. 554658 - 209
  68.   BLZ: 200 100 20
  69.  
  70.  
  71. _Page_2__________________________________________________________
  72.  
  73. 3. A brief description
  74.  
  75. 'Before Dawn' is a modular screensaver for all ATARI ST/STE/TT or
  76. Falcon. It uses  GEM-Image  graphics to display  animations while
  77. saving your precious screen. 'Before Dawn' offers three different
  78. modules:
  79.  
  80. - 'Warp 5 - Mr. Sulu!', a starfield simulation.
  81. - 'Bouncing Hole', a peektrough-hole bounces around your screen.
  82. - 'At the Movies',  a rather complex  module to design  your  own
  83.   animations without any knowledge of C or any other  programming
  84.   language!
  85.  
  86. All modules allow to load GEM-Image pixel files,  so that you can
  87. alter the  apperance of your screensaver. Example: you would like
  88. to see your company's logo bouncing around the screen,  while the
  89. saver is active? No problem: just scan the logo and change it in-
  90. to the format  'Before Dawn' needs.  You may use any graphic pro-
  91. gram that is able to create GEM-Image files.
  92.  
  93. This manual will try to explain how to use  'Before Dawn', but it
  94. will try to do so very briefly.  The reason why is, that the next
  95. update of 'Before Dawn' will bring many changes.  This would mean
  96. writing the manual again - a very  difficult task if you're not a
  97. native speaker of English.  On the other  hand there are not that
  98. much foreign customers by now. I hope the information supplied is
  99. sufficient to get to work with 'Before Dawn'.  You will also find
  100. English  resource files and two  IMGs that explain how to  create
  101. animations for the  modules   'At the Movies'  and  'Warp 5 - Mr.
  102. Sulu!' in this folder!
  103.  
  104.  
  105. _Page_3__________________________________________________________
  106.  
  107. 4. Installing 'Before Dawn'
  108.  
  109. Copy  DAWN.ACC  and  DAWN.RSC into the rootdirectory of your boot
  110. disk.  Copy  DAWNAUTO.PRG into your AUTO folder.  All other files
  111. may be placed anywhere on your disk.
  112. Reboot your system. After you have rebooted your system, you may
  113. do all necessary alterations in 'Before Dawn'.  Usually the pre-
  114. set options  work fine,  but paths to the  IMG files have to  be
  115. set.
  116.  
  117.  
  118. 5. How to use the dialogs
  119.  
  120. 'Before Dawn' uses window dialogs. All buttons are selectable by
  121. mouse and by keyboard. If  you prefer  using the  keyboard  just
  122. press the underlined key in  combination with the  ALTERNATE key
  123. to select/deselect the item. The ENTER key on the numeric keypad
  124. skips from one editable field to the next.
  125. 'OK'  usually leaves the dialog and accepts all alterations.  It
  126. is by default selectable with the  RETURN  key.  'Cancel' leaves
  127. the dialog without accepting the alterations. 'Set' can be found
  128. in all but the  'Info'  dialog and acts like  'OK'  only that it
  129. does not exit the dialog.
  130.  
  131.  
  132. 5.1. ''Before Dawn'' dialog
  133.  
  134. 'Module'
  135.   selects one of the modules 'Before Dawn' offers.
  136.  
  137. 'Setup'
  138.   opens the 'Setup' dialog for the selected module.
  139.  
  140. 'Random selection'
  141.   if  selected  'Before Dawn'  randomly  selects one of the three
  142.   modules when it is activated.
  143.  
  144. ''Before Dawn' active after __ minutes'
  145.   if selected 'Before Dawn'  starts saving after  __ minutes  if
  146.   there have been no actions by the user in this period.
  147.  
  148. 'Info'
  149.   vital information about 'Before Dawn' - read this and weep.
  150.  
  151. 'Options'
  152.   opens the 'Options' dialog.
  153.  
  154. 'Save'
  155.   saves all options.
  156.  
  157.  
  158. _Page_4__________________________________________________________
  159.  
  160. 5.2. 'Options' dialog
  161.  
  162. 'Watch ...'
  163.   selects all the  system events that will be watched by  'Before
  164.   Dawn'.
  165.  
  166. 'Timesharing'
  167.   when selected, 'Before Dawn' not only allows other processes to
  168.   make screen outputs via the AES, but also continuously makes an
  169.   'event_multi'.
  170.  
  171. 'Center dialogs'
  172.   if selected all  dialogs are  displayed  at the  center of  the
  173.   screen.
  174.  
  175. 'Change color index 0 to black'
  176.   the RGB values of color index 0 are changed to black if a  XIMG
  177.   file is loaded.  Usefull if you are using an ATARI in low ST or
  178.   TT resolutions.
  179.  
  180. 'Wake-/sleep corner'
  181.   selects the size of the  wake-/sleep corner in pixel.  The wake
  182.   corner is the bottom left and the sleep corner the bottom right
  183.   corner of the screen.
  184.  
  185. 'Mouse sensitivity'
  186.   selects how many mouse-packets shall be received  until screen-
  187.   saving is terminated.
  188.  
  189. 'Reserve memory'
  190.   reserves memory for IMG caching.
  191.  
  192. 'Sound by ...'
  193.   selects the program that takes  care of the sound effects.  You
  194.   may use PAULA, a player for MOD-files,  or CrazySounds a player
  195.   for samples sold by 'maxon' in Germany.
  196.  
  197. 'Change vectors'
  198.   selects when  'Before Dawn'  should change the  system  vectors
  199.   selected under 'Watch ...'.  Usually  'always'  works fine, but
  200.   some programs just don't like it.  So if you encounter a system
  201.   hangup while  'Before Dawn' activates itself,  try setting this
  202.   popup to 'at boot' or 'after dialog'.
  203.  
  204.  
  205. _Page_5__________________________________________________________
  206.  
  207. 5.3. Setup 'Bouncing Hole'
  208.  
  209. 'Image-File Selection'
  210.   selects the IMG file to be used by this module. You may enter a
  211.   wildcard to randomly select between more IMGs.
  212.  
  213. 'MOD/HSN-File Selection'
  214.   selects the MOD- or HSN-file to be played.  HSN-file are played
  215.   by CrazySounds whenever the IMG touches a side of the screen.
  216.   Wildcard possible!
  217.  
  218.  
  219. 5.4. Setup 'Warp 5'
  220.  
  221. 'The galaxy has __ stars!'
  222.   selects the number of stars to be animated.
  223.  
  224. 'Image-File Selection'
  225.   selects the animations IMG file.
  226.  
  227. 'Frames in IMG-file: __'
  228.   selects the number of frames of the animations IMG-file.
  229.  
  230. 'MOD/HSN-File Selection'
  231.   selects the MOD- or HSN-file to be played.  HSN-file are played
  232.   by CrazySounds from time to time. Wildcard possible!
  233.  
  234.  
  235. 5.5. Setup 'At the Movies'
  236.  
  237. 'Info-File Selection'
  238.   selects the BDI-file that contains all necessary information to
  239.   display an animation. Wildcard possible!
  240.   BDI-files are  created with  EDITOR.PRG  from this archive.  It
  241.   also creates  sound information files called BDS-files,  if you
  242.   are using CrazySounds. BDS-files are loaded automatically.
  243.  
  244. 'MOD-File Slection'
  245.   selects the MOD-file to be played. Wildcard possible!
  246.  
  247.  
  248. _Page_6__________________________________________________________
  249.  
  250. 6. The 'Movie-Editor'
  251.  
  252. When using the 'Movie-Editor' you might notice that it's slightly
  253. different in  apperance.  This is,  because I have been using the
  254. MyDial library  instead  of  Chirstian Grunenberg's  Enhanced GEM
  255. library.  This is going to change in the future,  but for the mo-
  256. ment I don't have the time to switch libraries.
  257. What's the idea behind the 'Movie-Editor'?
  258. Earlier versions of  'Before Dawn' had the problem,  that you al-
  259. ways had  to change the  complete setup,  just to load a new ani-
  260. mation for the module  'At the Movies'.  With the  'Movie-Editor'
  261. you may edit an animation, save it into a  BDI-file and reload it
  262. as often as you like.
  263.  
  264.  
  265. 6.1 The 'Info' menu
  266.  
  267. You will find vital information about the author of this program
  268. in this menu. Look into this menu at least once a day, otherwise
  269. it might get lonely and start living its own life (and who knows
  270. what will happen then - party time ;-)
  271.  
  272.  
  273. 6.2. The 'Open' menu
  274.  
  275. Clicking here will open a GEM fileselector. Select the BDI-File
  276. you  wish to edit.  If you  enter a  non-existant  filename the
  277. editor will keep that name until you try to save it.
  278.  
  279.  
  280. 6.3. The 'Save' menu
  281.  
  282. You guessed it! This menu saves the  BDI-file you  have been edi-
  283. ting.  If you have made wrong  entries or no  entries at all, you
  284. will be promted with an alert box.
  285. If you have made  entries  in the  'Sound' menu,  the editor will
  286. save the  corresponding  BDS-file automatically.  So please don't
  287. worry about how to save a BDS-file.
  288.  
  289.  
  290. 6.4. The 'Quit' menu
  291.  
  292. This menu  immediately  quits the editor.  If you have  not saved
  293. your BDI-file it is gone.
  294.  
  295.  
  296. _Page_7__________________________________________________________
  297.  
  298. 6.5. The 'Global' menu
  299.  
  300. 'Start X:' and 'Start Y:'
  301.   define the starting point of the animation.
  302.  
  303. 'Use complete screen'
  304.   tells  'At the Movies'  to  start  animations  not  only in the
  305.   specified  edge of the  screen,  but using all  adjacent sides,
  306.   too.
  307.  
  308. 'Direction: __ degrees'
  309.   the direction, the animations should be moved into.
  310.   Note:  0 degrees ist upward,  90 degrees to the right,  180 de-
  311.   grees downward and 270 degrees to the left.
  312.  
  313. 'Number'
  314.   specifies the number  of animations in the used  IMG file.  See
  315.   MAKEMOVI.IMG for more detail.
  316.  
  317. 'Number of objects'
  318.   specifies the number of objects to be moved around the screen.
  319.  
  320. 'Animation-Image-File Selection'
  321.   selects the IMG file to be used. No wildcards here!
  322.  
  323. 'Author'
  324.   leaves  space for the  author of the  animation to  immortalize
  325.   himself.
  326.  
  327.  
  328. 6.6. The 'Animation x' menu
  329.  
  330. 'in direction'/'against direction'
  331.   specifies,  whether this sequence should be moved in or against
  332.   the direction specified in the 'Global' menu.
  333.  
  334. 'Stepsize'
  335.   is the size of steps between each painted frame.
  336.  
  337. 'Speed'
  338.   well, its the speed of this sequence.
  339.  
  340. 'Frames'/'Width'/'Height'
  341.   specifies the number of frames  and its  width and height.  See
  342.   MAKEMOVIE.IMG for more detail.
  343.  
  344.  
  345. _Page_8__________________________________________________________
  346.  
  347. 'continuous'/'single without stop'/'single with stop'
  348.   selects the way,  this sequence should be animated.  It may ei-
  349.   ther be drawn countinuously, that is it will start at the first
  350.   frame if the last frame has been painted, or it it may be drawn
  351.   once. The last option is divided into two more options. 'single
  352.   with stop'  will draw your animation in the specified  stepsize
  353.   and frequency, but will draw only the last frame, when all pre-
  354.   vious frames have been painted. 'single without stop' will draw
  355.   it in a way so that the first frame is painted in the  starting
  356.   point and the last frame in the opposite corner.
  357.  
  358. 'Frame frequency'
  359.   specifies the  frequency at  which the frames will  follow each
  360.   other. A frequency of 1 means, that each step a new frame  will
  361.   be painted. At a frequency of 2 the next frame will be  painted
  362.   after two steps ...
  363.  
  364. 'Steps ahead'
  365.   when using the 'single with stop' option,  it may happen,  that
  366.   part of the  animation will be drawn  'off screen'.  To prevent
  367.   this,  you may enter how many  steps the first frame  should be
  368.   painted until the animation starts.
  369.  
  370. 'Relative to stepsize'
  371.   means that 'Frame frequency' and 'Steps ahead'  not only depend
  372.   on the number of steps, but also on the size of each step.
  373.   Example: wheels turning realtive to their moving speed.
  374.  
  375. 'Follows animation'
  376.   animations may  follow each  other.  Note: continuous loops and
  377.   animations moving in different directions are not allowed.
  378.  
  379.  
  380. 6.7 'Sound' menu
  381.  
  382. You may select one  HSN-file  for each animation.  This soundfile
  383. has to be linked to a frame in the animation sequence.
  384.  
  385.  
  386. 6.8. 'Test' menu
  387.  
  388. If you have 'Before Dawn' installed, you can test the edited ani-
  389. mation with this menu.
  390.  
  391.  
  392. _Page_9__________________________________________________________
  393.  
  394. 7. The end
  395.  
  396. This  completes  our very  brief  journey  through the  depths of
  397. 'Before Dawn'. It is quite  possible,  that there are  still some
  398. questions to be asked  and answered,  but for the  moment this is
  399. all I can offer you.  Try playing around with  'Before Dawn'  and
  400. the 'Movie-Editor' to find out what all these mystic options mean
  401. and how to use them.  This manual may not be one of my best works
  402. in English as well,  but considering that I typed it into my com-
  403. puter in just one afternoon it should  at least help you  finding
  404. your way through the first steps with 'Before Dawn'.
  405. The pictures MAKEMOVI and MAKESTAR may help you, too.
  406.  
  407. Corrections of this manual  are always welcome!  You will find my
  408. address somewhere at the top of this manual.
  409.  
  410.  
  411. Finally  I have to  give some credits to all  those  people  that
  412. helped in one way or the other. In alphabetical order:
  413.  
  414.     Stefan Becker
  415.     Catch Computer
  416.     Jörg Granzow
  417.     Martin Heise
  418.     Dirk Johannwerner
  419.     Richard Kurz
  420.     Ruth Langohr
  421.     Jens Lehmann
  422.     Michael Schwingen
  423.     Achim Wilhelm
  424.     Ralf Zimmermann
  425.  
  426.     and all those others who reported bugs and painted these
  427.     stunning animations!
  428.  
  429. And - last but not least - I  have to give  credit  to  Christian
  430. Grunenberg who supplied the 'Enhanced GEM' library.  I can recom-
  431. mend this library to any programmer,  who would like to have such
  432. neat window-dialogs in his program as 'Before Dawn' has.
  433.  
  434. That's all for now and don't forget to support shareware!
  435.  
  436. Aachen, August 26 1993
  437.                             Arne Rudolph