home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / DemoManiac.TXT < prev    next >
Encoding:
Text File  |  1994-08-05  |  47.3 KB  |  1,029 lines

  1.  
  2.    iT cAME fRoM tHE mANSiON aGAiN  +44-(FiND iT)
  3.   
  4.           HaVE fUN oUT tHERe GuYS..........!!
  5.  
  6.   __                                                                    __
  7.  /_/\__________________________________________________________________/_/\
  8.  \_\/                                                                  \_\/
  9.   |                      CALL +(44)51 474 0856                           |
  10.   |  ____  _____________ ______        ______  ______________  _______   |
  11.   |  \_  \/  _/\__ _ __/|      \      |      \ \_ _ _/\     / /  ____/   |
  12.   |   /       \ /  |  \ |   |   \     |   |   \/  |  \/  Y  \ \_____ \   |
  13.   |  /  \  /   /   _   \|___|    \ ___|___|    \      \  |   \/       \  |
  14.   | /    \/   /    |    \        / \           /  |    \ |    \        \ |
  15.   | \____||___\____|     \______/   \_ _______/___|     \|____/   _____/ |
  16.   |                l_____/__|         |___|       i_____/     \____j BB's|
  17.   |                                                                      |
  18.   |                                                                      |
  19.   |_                     This is Mad Dan's BB's                          |_
  20.  /_/\___________________________________________________________________/_/\
  21.  \_\/                                                                   \_\/
  22.              Speeds from 9600 to 16.8 Dhst online 24Hr's a day !
  23.  
  24.       Amiga-Warez/Pc/Requests/Offline Files - Friendly Sysop- Mad Dan
  25.  
  26. @BEGIN_FILE_ID.DIZ__/l__________/\________/\_______
  27. \__.  ____ _____)  _______)__.  /----------.
  28. / ¬|  |  _  /  ¬\  \ ¬|  ¬\ ¬|  \ pRESENTS |
  29. \___  l__|  \_  /___  l_  /  l__/ iN 1994: |
  30.    `--' ¬`---'\/tGø`--'¬\/---'-------------'
  31.     DEMOMANIAC FULL DOCUMENTATION
  32. @END_FILE_ID.DIZ
  33.             GReeTING`S mORTALS 
  34.  
  35.         cHA®ON iS bACK wITH tHE fULL dOCS
  36.  
  37.               FoR DEMOMANIAC
  38.  
  39.         INTRODUCTION
  40.  
  41. Many intromakers, titling and multimedia programmes exist for the Amiga but
  42. only a very small minority is powerful enough for you to receive what you 
  43. want as an end result.  In most cases your imagination is very limited by
  44. the programme.  Naturally it isn`t possible to let the users imagination
  45. run freely in all cases - the computers hardware also limits the
  46. possibillities - but it is still possible to give them much more
  47. possibillities than such programmes habe previously.
  48. Demomaniac does this for you.  Demomaniac lets you create impressive demos
  49. and presentations not requiring any programming knowledge whatsoever!
  50. With it you are in a position to produce in a few short minutes what would
  51. take you months to program yourself - and that is not counting the years of
  52. programming experience necessary to do that.  You can even produce complete
  53. presentations without touching the keyboard: totally mouse-driven.
  54. But even if you have experiences in Assembly programming and theoretically
  55. can make demos without Demomaniac, using it will make things for you a lot
  56. simpler.  You can use your own routines instead of the effect modules
  57. supplied with Demomaniac.  As the programme is modularly structured this is
  58. a simple take.  In this case Demomaniac will become a great help in the
  59. design and the music / sound of your demonstration.
  60.  
  61.         THE BASICS
  62.  
  63. The basic unit or structure in Demomaniac are the `EFFECT MODULES`.  Each
  64. of these offers you an effect which can be mutated through various
  65. parameters.  There are both simple effects such as showing a picture on
  66. screen and very complex ones such as letting the spectator fly through a
  67. vector world.
  68. These effect modules are now connected to so call `PATTERNS`.  Within one
  69. pattern up to 6 effects can run simultaneously.
  70.  
  71. Staying with our vector world example ... If you combine a fade in effect
  72. (FADE) with the flight through the vector world (VECTORSCAPE) in one
  73. pattern, you will get a vector world that slowly fades in.  At the same
  74. time you could also present a text to the spectator as he is flying over
  75. the vector world. And you can fade the text in and out at the same time,
  76. too.
  77. To produce a complete presentation or demonstration you will first have to
  78. design the separate scenes (`PATTERNS`) and then sort and present them
  79. correctly in a `SCRIPT`
  80. There are three levels when making a presentation:  The lowest are the
  81. `EFFECT MODULES`, the next are the `PATTERNS` and the highest level is the
  82. `SCRIPT`.
  83.  
  84.         THE FIRST STEPS
  85.  
  86. To give you a glimpse of what is possible in demomaniac, here is a test run
  87. in form of a simple expamle.
  88.  
  89. Enter the construct editor first by choosing it in the pulldown menu or
  90. clicking the `CONSTRUCTION` gadget at the bottom of the screen.
  91. Each pattern is designed in this editor.
  92. You will now see four blue windows. The top one holds all information for
  93. the pattern being edited at the moment and the lower three show all the
  94. possibke effect modules sorted by type and alphabet.
  95. Use the mouse to select `LAYER 0` in the top window just click on it and it
  96. is already selected.  "what in the world is a LAYER?" you may be asking
  97. yourself at this moment.  Well each PATTERN includes 6 LAYERS and each of
  98. these LAYERS can be filled with an EFFECT-MODULE.  Why the effects have to
  99. be place in layers and not just anywhere will become apparen later on.
  100. To now allocate an effect to a layer you have to select one in the left
  101. hand window below (MAIN-EFFECTS). Please choose `Stars` for this example;
  102. if you can`t find stars on the list use the slider on the right to move the
  103. list up and down. After a short loading period the word stars will be
  104. allocated to `LAYER )` and further information will be presented below it
  105. in the top window. The stars effect module has now been allocated to `LAYER
  106. 0`.  The new lines between `LAYER 0` and `LAYER 1` are the variable
  107. parameters the stars effect have to offer.
  108. Okease choose one of the parameters now (maximum number of stars)/ Next to
  109. your pointer a new window will appear in which you can edit the parameters.
  110. The value at the moment is 400 but if you now use the slider to change the
  111. number of stars you can have up to 2000 or go as low as one single star!.
  112. If the slider isn`t accurate enough for you then you can enter the value
  113. using the keyboard.
  114. Now that you have had a short play around with the parameters press `RESET`
  115. to return to the standard value and the ok to complet the editing of the
  116. parameters. Click on TEST PATTERN ato view the stars effect. After a short
  117. while you will already find yourself in deepest darkest space(LAME)
  118.  
  119. Press the left mouse button to complete the test and return to the editor
  120. Have a go at changing the parameters and effects and then view the results
  121. of your changes by clicking on `TEST PATTERN`.  This will give you a feel
  122. for Demomaniac.  So you don`t experience too many problems, here`s a short
  123. explanation of the `Stars` parameters.
  124.  
  125.     EFFECT delay        :We`ll tell you what this one is for later
  126.                  on
  127.     START Starnumber    :The `stars` effect gradually increases
  128.                  the number of stars on screen. This is the
  129.                  starting value
  130.     Starnumber incr.    :How quickly should the number of stars
  131.                  rise.
  132.                  (0=not at all,1=very slowly,100=v.fast)
  133.     Maximum number        :Maximum number of stars on screen
  134.  
  135. An explanation of all parameters of the other effects can be found in the
  136. back of the handbook.
  137. Now that you have learned how to change parameters we can get a bit more
  138. complex - after all, demomaniac can handle more than just one effect.
  139.  
  140. So lets scroll down the pattern list (top window) using the slider next to
  141. it so that the next layer (LAYER1) becomes visible and click on it.
  142. We would like the LAYER 1 to contain the effect-module `DotText`.  So we
  143. click on `DotText` in the MAIN EFFECTS menu.
  144. This effect offers somewhat more parameters that wel will not be explaining
  145. fully in this chapter.  But if you now full of enthusiaism click on `TEST
  146. PATTERN` demomaniac will come up with an error message saying you have to
  147. load a text for the DotText effect.  And viewing the parameters you will
  148. realise that the parameter (`ACTUAL TEXTPAGE`) is empty.  So this parameter
  149. is waiting for data file!. These are not loaded from the pattern editor
  150. though but from the MEMORY EDITOR
  151.  
  152. In the bottom gadget line-up you will be pleased to find one marked MEMORY.
  153. Select it and you will find yourself on a new screen.  Please choose `BLOCK
  154. 0` (this is the only block on the screen anyway at the moment)
  155. After this click on `LOAD FILE` and choose a file with the ending .TXT
  156. using the file requester and load it (`OK`). A text file is now in memory
  157. that can be used at any time in your product.  You have now loaded all the
  158. necessary data and can continue work on the pattern (click on
  159. CONSTRUCTION).
  160. Back in the CONSTRUCTION EDITOR you can now active the `Actual Page`
  161. parameter and will be presented a list of all text files in memory. Now
  162. choose your file from this list (the list isn`t too big at the moment
  163. anyway)
  164. As all parameters are `loaded` we can give it a trial run by pressing the
  165. `Test Pattern` button.  Its starting to look good isn`t it?
  166.  
  167. Now lets have a play-around with the parameters ... Why don`t you give the
  168. following settings a try
  169.  
  170.     X-Angle increment gl.        :44
  171.     Y-Angle increment gl.        :77
  172.     X-Angle increment rel.        :0
  173.     Y-Angle increment rel.        :0
  174.     Start X-Angle            :000
  175.     Start Y-Angle            :000
  176.     Speed                :2
  177.     Number of letters        :25
  178. or ...  X-Angle increment gl.           :000
  179.     Y-Angle increment gl.           :000
  180.     X-Angle increment rel.          :3
  181.     Y-Angle increment rel.          :0
  182.     Start X-Angle                   :130
  183.     Start Y-Angle                   :090
  184.     Speed                           :1
  185.     Number of letters               :25
  186.  
  187. A bit of music and we could be as happy as a lark...(?)
  188.  
  189. Actually there is just one programme on the Amiga that is used to make demo
  190. soundtracks- the Protracker, but there are loads of versions around, making
  191. it impossible to play all pieces of music with just one universal player.
  192. For this reason we have included a whole collection of players with
  193. Demomaniac.  Before playing a song respectively module (the correct
  194. terminology) you have to select one of these players (BEWARE: The wrong
  195. player combined with the wrong module may cause your computer to crash.)
  196.  
  197. So lets chooes one. Click on `PLAYER` (top right) and choose `TRACKER
  198. PACKER` from the list. All the modules include with Demomaniac have been
  199. packed with this one. This is also the only player that is capable of
  200. playing modules PACKED.
  201. As we have now made our player decision we can choose a module to listen.
  202. For this click on `SONG` (all music can be packed with the Power Packer)
  203. And with the next test run we can see and hear what kind of a difference
  204. sound can make.
  205.  
  206. We might as well mention another feature while we are at it. Click on
  207. `DESIGN` in the pattern list and choose the option `NEWS SCREEN`. Another
  208. go at `Test Pattern` will slowly give you a feeling what it is like to work
  209. with Demomaniac.
  210.  
  211.         THE CONSTRUCTION EDITOR
  212.  
  213. We will explain this editor first because it handles the lowest level of a
  214. Demomaniac presentation the effect modules.
  215. You can enter the CONSTRUCTION EDITOR anytime by cliking on the
  216. CONSTRUCTION button at the lower part of the screen or hitting the F6
  217. function key. You can also enter it via the pulldown menus.
  218.  
  219.         THE PATTERN LIST
  220.  
  221. In this editor patterns are developed and tested. Each pattern is manager
  222. through the pattern list that is in the top window.  The list is built up
  223. in the following way:
  224.  
  225. NAME     :        (Pattern name)
  226. DESIGN   :        (Name of the screen design used in this pattern)
  227. TIME     :        (Time-length of the patterns)
  228. RELATIONS:        (Relations between the layers)
  229. LAYER 0  :        (Name of the effect module in LAYER 0)
  230.             (Its parameters)
  231.  
  232. LAYER 1  :        (Name of the effect module in LAYER 1)
  233.             (Its parameters)
  234.             And so on ...
  235.  
  236. The pattern name is of no importance to Demomaniac itself. It is purely to
  237. help you in your administration of the various patterns and the putting
  238. together of a script.
  239.  
  240. Design is the screen setup. Please find more information on this one in the
  241. chapter on `DESIGN EDITOR`
  242.  
  243. Time isrepresented - as indeed all times in Demomaniac are - in seconds and
  244. frames.  One frame is the time it takes the electron beam to build up a
  245. screen on your monitor.  If something happened even faster then you
  246. wouldn`t even recognise it as the screen could`nt be prepared so quickly.
  247. A frame is therefore the smallest time scale that is relevant for
  248. Demomaniac. One frame is 0.02 seconds (1/50 second) in length.  Therefore
  249. you can only enter values between 0 and 49 as 50 frames would be one
  250. second. Times are represented in Demomaniac as
  251. SSSS/FF
  252.  
  253. The S stands for seconds (maximum of 9999) and F stands for frames (maximum
  254. 49). One minute would thus equal 0060/00 and one minute and half a second
  255. 0060/25/
  256.  
  257. You can also programme the lenght of a pattern as `INFINITE`.  This is also
  258. the time preset.  To set it you have to leave the time-requester by
  259. pressing the "INFINITE" key.  If you have already calculated a time for
  260. your pattern and only want to enter the infinite mode for a test then thats
  261. no problem whatsoever - the number will stay in memory and will
  262. automatically be enter once you switch back from infinite mode.
  263.  
  264. The next option, relations, describes the relations between the 6 layers in
  265. memory and `real` layers you will see on screen.  Each effect runs on a
  266. transparency: on `unused` parts you can see the effect underneath.  To
  267. change the order of these transparencies without have to move the effect
  268. modules around you can use these layer relation.  This layer represebts a
  269. layer and its positio represents the position in the pile of
  270. transparencies.  The standard layer sequence 012345 means that layer 0 is
  271. at the bottom and layer 5 is the top transparency and not covered by any
  272. other one.  If you change the layer sequebce to 543210 then the situation
  273. is exactly the opposite without you having to change the position of the
  274. effect modules themselves.
  275. `Weird` cp,binations are also possible sucg as 425301.  This would result
  276. in following order in the transparencies:
  277.  
  278.     Layer 4        : at the bottom
  279.     Layer 2        : Over layer 4
  280.     Layer 5        : Over layer 2
  281.     Layer 3        : over layer 5
  282.     Layer 0        : Almost at the top
  283.     Layer 1        : At the top
  284.  
  285. The layer sequence is not the only thing you can change in the layer
  286. relations.  Additionally to the order you can also set the transparency for
  287. the layer itself.  This is basically a switch whether the layer is
  288. `painted` with normal paint or see through paint.  Is this value for
  289. instance 1 -3 -- that means that just laters 1 and 3 are transparent.
  290. Using the requester that pops up when you enter the layer relations option
  291. is simple, once you have understood the principles of the layer sequence
  292. and transparency values the top line (switches for the layer sequence) has
  293. 6 small gadgets that go up by one each time you click on them.  This way
  294. you can enter any order you wish.  The gadget below (switches for the
  295. transparency values) work like light switches - they are either ON or OFF.
  296. This way you can set the transparency for each individual layer.
  297.  
  298. Now you know about all entries in the pattern list apart from LAYER
  299. entries.  The layers contain the most important information for a pattern:
  300. the EFFECT MODULES.
  301. Each layer can hold one effect. Click on one of the lines that include the
  302. word `LAYER x :` then you activate that layer.  This way, you are telling
  303. Demomaniac in to which layer you would like the next effext loading (or
  304. which layer the next delete effect is to affect).
  305. If you click on a line that contains a parameter for an effect you can then
  306. change these parameters.
  307.  
  308.         THE VARIOUS TYPES OF PARAMETERS
  309.  
  310. There are various types of parameters:
  311.  
  312. The standard are VALUE parameters that contain a decimal number. If you
  313. choose one of these a new window will be opened.  The value of the paramter
  314. can be changed using the slider and the arrows or just enter the number on
  315. your keyboard.  If you mess up the parameters value totally you can press
  316. the `RESET` key to get back to the standard values. Leave the window by
  317. pressing `RETURN` after entering your value, press the `OK` or `CANCEL`
  318. buttons or just click outside the window (same effect as choosing `OK`).
  319.  
  320. Apart from the VALUE parameters, Demomaniac also includes VARIABLE
  321. parameters. Just like in a programming language you insert variables
  322. instead of constant values.  This allows you to change an effect while it`s
  323. running by changing the value in parameter. You can for instance define the
  324. position of a vector object as (x, y) instead of (160, 127). If another
  325. effect changes the variables it will automatically also change the postion
  326. of said vector object.  if you program the value of the variables to
  327. represent the current mouse position for instance, the user can move the
  328. vector object with the mouse.
  329.  
  330. If all this sounds a bit too complicated, you can just ignore it. A VALUE
  331. parameter allowing variables differ from the "standard" parameter only by
  332. having another switch at the bottom of the window:
  333.  
  334. "VARIABLE":    Click on this switch and a string gadget and a `CHOOSE`
  335. button will appear instead of the slider. You can choose the name of the
  336. variable to be connected to the effect.  The name can be any character
  337. combination as long as it doesn`t start with a space or is made up entirely
  338. of spaces.  All names are stored in capital letters. Possible names are for
  339. example `x`, `Hallo`, `3d`, `X position` or `#$%^&Q!`. Calling you variable
  340. `007` for example is also possible but will surely cause some problem as
  341. you may later not recognise it as being a variable and not a definate value
  342. of `007`. So please us names you will recognise again later on. If you have
  343. already been using variables in your programme you can find them and
  344. implement them here, too , by useing the `CHOOSE` function.  And if you
  345. decide a constant value is better after all then you can return to the
  346. VALUE requester by choosing the `NUMBER` button.
  347.  
  348. Above we have described parameters that accept either a constant or
  349. variable value.  Next we have parameters that ALWAYS require a variable -
  350. they don`t read a value from the variable but a write to it.  These are
  351. called `OUTPUT` parameters.  Some effect modules don`t actually do anything
  352. you can see on screen (DUMMY EFFECTS) as their only function is to change
  353. the variables and thus for example allow interactivity.
  354.  
  355. As certain effects require more data than just numbers further types of
  356. parameter exist:
  357.  
  358. If you click on the PICTURE parameter you will be present with a list of
  359. all pictures located in memory to choose from.  These already have to have
  360. been loaded into memory via the memory-editor. This type of parameter is
  361. therefore known as `MEMORY` parameter. There are various of these for
  362. animations, fonts, samples, texts etc.
  363.  
  364. Apart from these major parameters (VALUE, VARIABLE and MEMORY) there are
  365. various other ones that for instance handle the relationship between the
  366. layer and the effect.
  367. Others work like switches between two positions (on/off or Top/Bottom etc)
  368.  
  369. An exact description of each individual effect and its parameters can be
  370. found when you choose info in the construction-editor.  You will habe to
  371. select the respective layer beforehand.  When using an effect for the first
  372. time it is best to read the info file for a complete descrition of the
  373. effect`s features.
  374.  
  375.         THE EFFECTS LIST
  376.  
  377. All available effects are listed in the three windows in the bottom part of
  378. the screen.  The split into three windows is purely for organisational
  379. purposes and doesn`t have any internal significance to Demomaniac.  The
  380. effects are sorted by type.  The left window contains the main effects, the
  381. middle one contains transtional effects (fades, bumps etc.) and the right
  382. one the special effects.  If you click on any of these effects it will be
  383. loaded into the current kayer, if an effect is already in the respective
  384. layer the programme will double check whether you really want to replace
  385. the ol effect with the new one.
  386.  
  387.         THE PATTERN ADMINISTRATION
  388.  
  389. In the top left of the screen you will find information on how many
  390. patterns you have already designed and the number of the one you are
  391. working on at the moment.  To view the effect lists of the other patterns
  392. you can use the NEXT and PREVIOUS buttons. If you press the NEXT button
  393. when no further pattern is there then a new pattern is opened for you to
  394. edit.  A new patern opened in such a way automatically copies the design
  395. and layer relations of its predecessor.
  396. The BEG and END buttons allow you to jump to the first respectively last
  397. pattern available.  The GOTO button lets you choose the pattern to edit
  398. from a list (only if you have more than one pattern of course)
  399. The DELETE button ddeletes the active pattern and moves all following ones
  400. up by one.  Of course this movement does NOT mess up any previously uses
  401. made of the pattern numbers (for example in the script editor) as all these
  402. matters are corrected automatically by Demomaniac. If you habe only made
  403. one pattern you can delete it - all entries will be set to standard but it
  404. will naturally bot be removed from the lise.
  405. The INSERT button pushes the present pattern and all following ones up by
  406. one position this way you get a  new and empty position that you can now
  407. begin to edit.
  408.  
  409. `DELETE EFFECT` will delete the effect module in the chosen layer emptying
  410. the layer again.  The execution of this command can be interrupted by
  411. pressing the left mouse button.
  412.  
  413. `TEST PATTERN` tests the pattern being edited at the moment. The execution
  414. can be interrupted by pressing the left mouse button.
  415.  
  416. Before we continue with the next editor we would like to point out that can
  417. either leave the parameter editing window by either pressing the `OK`
  418. buton or by just choosing the next parameter by mouse.  This of course
  419. saves time as every click outside the window is regarded as an `OK`, you
  420. could also jump directly to `Test Pattern`.
  421.  
  422.         THE SCRIPT EDITOR
  423.  
  424. After you have made all the patterns you want in the CONSTRUCTION EDITOR
  425. you can now start thinking about putting them together to a demo.
  426. The script editor is entered by choosing the SCRIPT gadget at the bottom of
  427. the screen.
  428.  
  429. On the left-hand side of the script editor there`s a long list: the script.
  430. The script is partitioned in many entries, each of which can hold a PATTERN
  431. or a COMMAND,  The number of entries you require can be set using the
  432. `Script entries` (top right). The minimum number of script entries equals
  433. the number of patterns you have designed: otherwise you couldn`t show all
  434. patterns you habe designed and therefore would be wasting memory. Press
  435. NORMAL and the number of patterns will automatically be set to the number
  436. of patterns designed.  Please do not exaggerate with the number of script
  437. entries; everything takes up memory and needs to be administrated and will
  438. slow Demomaniac down during editing.
  439.  
  440. Just below the script entries you will the Active Pattern.  This is the
  441. pattern number you have been working on last in the construction editor.
  442. This can be changed easily, either by the string gadget, the cursor keys or
  443. the CHOOSE function (has the same function as the GOTO button in the
  444. construction editor has)
  445. If you after changing the active pattern return to the construction editor
  446. you will automatically be editing the pattern last addressed in the script
  447. editor.  What the active pattern is needed for in the script editor will be
  448. explained later.
  449. Beneath the active pattern there are a further five gadgets that define
  450. what should happen when a script entry is selected. A blue arrow on the
  451. right next to the gadget shows you which one is active at the moment. (you
  452. can select the active gadget resp. function by pressing it with the mouse
  453. pointer.)
  454.  
  455. The functions are as follows:
  456.  
  457. Choose patterns        :    Every time you choose a script entry you
  458.                 will be able to choose the pattern to be
  459.                 inserted from a list.
  460.  
  461. Choose Commands        :    Choose a script command (to influence the
  462.                 course of the script run) and enter its
  463.                 parameters.
  464.  
  465. Increase Pat.        :    If you have already designed all patterns
  466.                 in a logical order and want to spare yourself 
  467.                 the hassle of having to enter them all into 
  468.                 the script (first pattern 1,then 2, then 3, 
  469.                 then 4 etc),.Then this function will help.  
  470.                 Just click on a script entry and the active
  471.                 pattern will be stored in theat position and 
  472.                 one is automatically added to the number of 
  473.                 the active pattern.  This way you only have to 
  474.                 click once on each of the script entries.
  475.  
  476. Decrease Pat.        :    Works the same way as `Increase Pat` but
  477.                 one is deducted after each click.
  478.  
  479. Edit Command        :    Change the parameters of a script command.
  480. The INSERT button stays pressed after you have selected it to show you that
  481. you are now in the insert mode.  Just click on a script entry and all
  482. following entries are pushed down by one.  The resulting free space in the
  483. script can now be edited in the choosen mode (choose pattern, choose
  484. command etc.).  That meant that immediately after the insertion of a
  485. position a pattern or command is entered.  After the insert function has
  486. been completed the insert gadget is deactivated again the the script list
  487. is updated.  All commands that referred to a script position are also
  488. updated so they don`t point to a wrong entry.
  489.  
  490. The DELETE function works in a similar fashion.  When in delete mode you
  491. can delete entries in your script by clicking on them and all following
  492. entries will move up one position.
  493.  
  494. You can deactivate the insert and delete functions by pressing the buttons
  495. a second time.
  496.  
  497. The `TEST SCRIPT` and `TEST PATTERN` gadgets are at the very bottom and do
  498. exactly what their names imply:
  499.  
  500. Test Pattern    :    Has exactly the same function as it does in the
  501.             construction editor with the difference that it
  502.             refers to the active pattern (the last pattern
  503.             edited).
  504.  
  505. Test Script    :    View the whole script.  Press the right mouse
  506.             button to break off the script test and the left
  507.             mouse button to skip the active pattern.
  508.             THE SCRIPT COMMANDS
  509.  
  510. We have already mentioned the fact that script are not just a list of
  511. patterns but also include COMMANDS.
  512.  
  513. If you choose a script entry while in `Choose Command` mode instead of
  514. being the `Choose Pattern` mode you will be presented a list of all
  515. possible script commands.  Choose a command from this list and (if
  516. necessary) set its parameters.  Script commands basically exist to
  517. influence the running of the script, but are also capable of much more.
  518. Let`s have a look....
  519.  
  520. FADE MUSIC IN    :    If the player supports fades then this command will
  521.             fade the music in whilst the demo continues to run.
  522.             At the very beginning you will have to set the
  523.             music `silent`.
  524.  
  525. FADE MUSIC OUT  :    Fade-out
  526.  
  527. SILENT        :    Switches the music off. This is mainy necessary to
  528.             enable a pause between the beginning of the demo
  529.             and the fade in.
  530.  
  531. GOTO X        :    Jump directly to script position X.
  532.  
  533. EXIT        :    End the script.
  534.  
  535. LOOP X        :    Repeats the following scripts entries X times.
  536.  
  537. ENDLOOP        :    Marks the end of the loop block (started with 
  538.             LOOP X)
  539.  
  540. GOSUB X        :    Jumps the script position X and returns once it
  541.             finds a `RETURN` command.
  542.  
  543. RETURN        :    Ends a subblok started with the GOSUB command.
  544.  
  545. FREEBLOCK X    :    This command only actually works in the executable
  546.             demo as it frees any memory possible during the
  547.             demo. CAUTION: This will of course only work if the
  548.             date you are deleting is NOT needed later on in the
  549.             demo!.
  550.  
  551. SKIP X=Y    :    Jumps the next script position if the relation is
  552.             correct.
  553.  
  554. NOP xxxx    :    This command doesn`t actually have a function and
  555.             is solely there so you can insert notes and
  556.             comments into the script.
  557.  
  558. WAIT X        :    Wait X seconds/frames.
  559.  
  560. These script commands are possibly not very easy to understand, but they
  561. can open the doors to amazing possibilities once used correctly.
  562.  
  563. The script commands are surely easily understandable for everyone.  Here`s
  564. a small example:
  565.  
  566. 0001: SILENT        :Switch music off
  567. 0002: FADE MUSIC IN    :Start fading the music in
  568. 0003: SMALL INFO (0001) :Start pattern
  569. 0004: FADE MUSIC OUT    :Fade out music
  570. 0005: WAIT 1        :Wait until complete
  571.  
  572. So you don`t habe any problems fading music we suggest you use the
  573. Demomaniac player tracker packer!.  This player is also capable of fading
  574. CIA-timed songs with many effects.
  575.  
  576. Lets continue with the other editors...
  577.  
  578.         THE MEMORY EDITOR
  579.  
  580. In a demo or presentation you will be needing loads of data apart from all
  581. the effects we have already discussed.  This data has to be available in
  582. memory and have to be handled in such a way that you can use the same data
  583. more than once without having to load it into memory again.
  584. This task is handled by the MEMORY EDITOR. Enter it by choosing the MEMORY
  585. gadget in the bottom gadget list.
  586.  
  587. The memory editor looks a lot like the script editor. Again theres a long
  588. list on the left and gadgets on the right.  The list (memory list) contains
  589. all data files that have to be in memory during the presentation.  Each of
  590. these data files is give a MEMORY BLOCK number.
  591.  
  592. When you enter the Memory Editor for the first time you will only find one
  593. block (0000).  Once you have filled this slot with data though, another
  594. empty block will appear.  This way you always have acces to an empty
  595. position.
  596.  
  597. When you choose a block entry it will just be highlighted and will not
  598. automatically open a window as most other options.  This has it`s reasons:
  599. It is very important that data is not deleted from memory unnecessarily as
  600. this would cut up the computer`s memory into small chunks.  Always choose
  601. the block you want to edit before you using the gadgets.
  602.  
  603. Following gadgets and functions are included in the memory editor:
  604.  
  605. LOAD FILE    :    Load a file into the designated memory block
  606.             (This is necessary if you want to use the file with
  607.             an effect.)When working with disks as opposed to a 
  608.             Harddrive please always use the disk`s name and not
  609.             `DF0` etc. in the file requester.  This way
  610.             Demomaniac will be able to find your data at any
  611.             time.
  612.  
  613. UNLOAD FILE    :    Empties a block
  614.  
  615. SHOW BLOCK    :    Shows you the contents of the active block.
  616.  
  617. SORT BLOCKS TYPE:    Sorts memory blocks by data types.  This does not
  618.             affect all other lists.
  619.  
  620. SORTBLOCKS ALPHA:    Sorts memory blocks in alphabetical order.
  621.  
  622. SORTBLOCKS SIZE :    Sorts memory blocks by size.
  623.  
  624. REMOVE UNUSED    :    Removes all blocks that aren`t use by any pattern.
  625.  
  626. MAKE TEXT    :    Use this option to edit text for the active memory
  627.             block.
  628.  
  629. All data files in the memory editor are presented in the following way:
  630.  
  631. BLOCK {Block number} : {NAME} (Type) {Size in Bytes}
  632.  
  633. The block number is of lesser importance whereas the name and the type are
  634. important criteria for the data management. Following data types exist:
  635.  
  636. TEXTFILE    :    Standard ASCII file (you can edit yourself).
  637.             A Demomaniac textfile has following standard setup:
  638.  
  639.             TEXT Thisisthenameofthistextfile
  640.             This is the first line of my text file...
  641.             and this the second...
  642.             ...blah blah blah ...
  643.  
  644.             The only thing you have to remember is that the
  645.             first four letters of the text file have to be 
  646.             `TEXT` (in capital letters) followed by a space.
  647.             Everything typed after this space before the first
  648.             return is the name of the file. And everything
  649.             following this return is the actual text.
  650.  
  651. PICTURE        :    Pictures are standard IFF pictures as all Amiga
  652.             Paint programmes generate (12, 18 and 24 bit
  653.             pictures are not supported.)
  654.  
  655. SAMPLE        :    Sampe is the term used for sound effects.  They
  656.             have to be standard IFF format (IFF-8SVX). They are
  657.             used to connect sound effects to actions on screen.
  658.  
  659. ANIMATION    :    These are standard animations (IFF-ANIM5) as
  660.             generated by DPAINT.
  661.  
  662. FONT        :    Fonts are data files that can only be generated by
  663.             the Demomaniac font converter. We regret you cannot
  664.             use Amiga system fonts as these (for techinical
  665.             reasons) are saved in a different format. (A
  666.             converter will be available shortly)
  667.  
  668. OBJECT        :    Vector objects.
  669.  
  670. SCAPE        :    Whole vector landscapes.
  671.  
  672. DATA        :    If a file is described as `Data` this means a
  673.             specific data type could not be recognised.
  674.  
  675. Now you know how to load data into memory and how Demomaniac manages it.
  676. Try not to waste memory as you can never habe too much of it when making a
  677. demo.  Let`s go on to the next editor.
  678.  
  679.         THE DESIGN EDITOR
  680.  
  681. The screen setup (`DESIGN`) is a very important part of a demo resp. a
  682. presentation. As much freedom as possible in making your own screen setup
  683. is important to let your imagination flow freely.
  684.  
  685. The DESIGN EDITOR let`s you do just this.  You can enter it by clicking on
  686. the DESIGN gadget.
  687.  
  688. The DESIGN EDITOR gives you following possibilities:
  689.  
  690. You can limit the "action window" on the screen to any choosen area and
  691. present graphics in the empty parts of the screen above and below this
  692. window.  Or you can have graphics on screen that are not linked to effects
  693. and areas ("over" or "under" the action).  The Amigas hardware sprites make
  694. this possible.  You now can for instance lay a frame around the screen or
  695. create the feeling that you are sitting in a cockpit .... Apart from this
  696. graphical extras tje design editor also allows you to habe rainbows
  697. background colours, include mirrors etc.
  698.  
  699. How do you make your own design?
  700.  
  701. Once again the whole thing is managed by an easy to understand list that
  702. contains all effects, colours and settings. This are listen in order of
  703. their position on screen (from top to bottom).  By clicking on one of these
  704. entries you can change the parameters,
  705.  
  706. This design list is the large blue window in the design editor.  Above you
  707. will find the name of the design you editing momentarily.  You can edit the
  708. name any time by clicking on it.  Also, there are two gadgets called
  709. `CHOOSE` and `NEW` there.  When creating a new design, click on the `NEW`
  710. gadget and then enter a name so as to avoid complications.
  711.  
  712. When creating a design one `effect` is always there - the `ActionWindow`.
  713. THis is the are on screen where the effect modules are actually displayed.
  714. Outside this area the effect can not be seen.
  715.  
  716. You edit a design by using the gadgets on the righthand side of the screen:
  717.  
  718. ADD GRAPHIC    :    Show graphics on screen.
  719.  
  720. ADD RAINBOW    :    Change the background screen colours into a
  721.             rainbow.
  722.  
  723. ADD MIRROR    :    Add a mirror effect.
  724.  
  725. ADD OBJECT    :    Define the start position for a graphical object.
  726.  
  727. ADD BAR        :    Add a colour bar to devide the screen.
  728.  
  729. These five commands add effects to the screen design.  When you choose one
  730. of these effects you will always first asked where (on the screen) the
  731. effect has to start and where it finishes.  Following your entry the effect
  732. is added to the design list on the left.
  733.  
  734. Once an effect has been entered in the list you can activate it by clicking
  735. on it`s name and edit it by clicking on the parameter you wish to change
  736. (as in the construction editor).
  737. Please note that object and grapgics effects require a picture to be loaded
  738. into the memory editor beforehand.
  739.  
  740. So you can edit designs comfortably we habe include further gadgets:
  741.  
  742. CLEAR DESIGN    :    Clears the complete design list.
  743.  
  744. REMOVE EFFECT    :    Removes the active effect from the design list.
  745.  
  746. ADJUST POSITION    :    Allows you to change the position and size of the
  747.             active effect visually.  Use the mouse to change
  748.             the position and press the right mouse button to 
  749.             change the size.  Press the left mouse button to
  750.             transfer the values (you have just set manually)
  751.             into the design list.
  752.  
  753. TEST DESIGN    :    View the active design.
  754.  
  755. LOAD DESIGN    :    Load a design from disk or harddisk.
  756.  
  757. SAVE DESIGN    :    Save the active design to disk or harddisk.
  758.  
  759. When you take a look at your design with the `Test Design` Function you of
  760. course won`t be able to see the mirrors as the actionwindow is empty.  This
  761. can bypassed if you set up a pattern in the construction editor already
  762. using the new pattern (and containing an effect in the Action Window)
  763.  
  764. By pressing the Amiga + T (short cut for `Test Pattern`) you will be able
  765. to look at the pattern without leaving the design editor.  This way you can
  766. easily habe a look at the effect a mirror has on the overall look.
  767.  
  768.         THE CONFIGURATION EDITOR
  769.  
  770. The sole role of this editor is to establish some general settings for
  771. Demomaniac and for the completed demo presentation.
  772.  
  773. `MINIMAL CONFIGURATION` lets you define the systems the demo should be able
  774. to run on and with how much / how little memory the demo shouldn`t even
  775. start. (if you habe to littl memory the computer may only crash during the
  776. demo when it actually requires more than the available memory...)
  777.  
  778. It is best to configure these settings before you start making a demo.
  779. This way effects that won`t run on the chosen `minimal configuration` will
  780. be rejected when you try to load them.  The same counts for pictures with
  781. too many colours and music that is too long.  Of course the demo will run
  782. without any problems on any systems higher than your configuration
  783. settings.
  784.  
  785. Also, you can set whether the copper lists should be precalculated or
  786. realtime-calculated.  Even if you aren`t quite sure what copper lists are,
  787. you should know the consequences this button brings with it:
  788.  
  789. Copper lists are nothing else than a description of your design lists that
  790. the computer can understand and use (throught the graphics co-processor
  791. COPPER).  Usually these are calculated just before a pattern is executed;
  792. this of course causes a slight delay, but a precalculation will take
  793. memory. (The amount can vary substantially.) It is up to you to decide if
  794. you habe enough memory and if so you can switch this function on.
  795.  
  796. The next option if FreeUsedEffects and as you may guess is for handling
  797. consumption and freeing of memory.  This function only has an effect in an
  798. executable demo! it deletes all effects that aren`t to be used again from
  799. memory during the running of the demo.  This makes the running of demos -
  800. especially long ones - possible on systems that have substantially less
  801. memory than the syste, used to create the demo.  The only disadvanatage
  802. this option has is that after the demo has finished your computr`s memory
  803. is "messy" and without reseting the machine you will not be able to
  804. continue. Bue if your demo resets anyway or runs endlessly you can use this
  805. function without commiting second thoughts.
  806. All the other parameters the configuration editor offers are
  807. selfexplanatory and are not detailed any closer here.
  808.         THE GENERAL SCREEN
  809.  
  810. This is (as you surely will have noticed) the first screen you see when
  811. using Demomaniac.  From here you can control all general disk and
  812. organisational operations.
  813.  
  814. This screen contains the following:
  815.  
  816. The info panel details your system`s capacities. It details the maximum
  817. amount of memory your system offers, not the amount of free memory at the
  818. moment.
  819.  
  820.         SCRIPT CONTROL
  821.  
  822. Here you can save the demo, consisting of effects, data and lists.
  823.  
  824. You can save the demo without all data (graphices, music etc.), just with
  825. the paths and file names of the data, its that when you reload the script
  826. all can be found and included automatically.  This saves loads of disk
  827. space, but can be a bother if you habe to find the datas on loads of disks
  828. first pr of you want to pass on the script to a friend.  When loading the
  829. data you will also have to remember to include the FULL path. If working
  830. with numerous disks you shouldn`t load a file with `DF0:picture.iff`, but
  831. with `PICTURES:picture.iff` (if the respective disk is call PICTURES).
  832. This could otherwise cause problems trying to retrieve data from various
  833. disks for a script.
  834.  
  835. In such cases it is much easier to save your work as a MODULE (do not
  836. confuse this with the effect modules).  This will save the script and all
  837. the necessary files together.  Of course this saved file is somewhat
  838. larger, but you can be sure you won`t be missing any important data.
  839.  
  840. The most important possibility is to save a Demomaniac demo as an
  841. EXECUTABLE fileonto a disk or hard disk.  This is a stand-alone, from
  842. workbench or shell executable program.
  843. A demo that has been saved as an executable can`t be reloaded into
  844. Demomaniac and thus also not re-edited.  You should always kepp a copy of
  845. your script or module if you want to continue work on your demo at a later
  846. date.
  847.  
  848. We tried to keep the executable files generated by Demomaniac as short (in
  849. KB) as possible but we do suggest you still crunch it with one of the
  850. standard crunchers such as powerpacker, Imploader, Titanics cruncher etc.
  851.  
  852. Another form of saving an executable demo is saving as BootBlock.  The demo
  853. is save directly onto the sectors of a disk and set so that it will
  854. automatically start when the disk is inserted in the drive - without a
  855. startup-sequence or other files being necessary.  The only disadvantage is
  856. that all data previously on the said disk will be deleted.
  857.  
  858.         EFFECTS CONTROL
  859.  
  860. Apart from the script commands the general screen also contains
  861. possibilities to alter the effect list (list of all available effect
  862. modules).  This becomes necessary when you want to include new effects into
  863. your system; these can either be ones you have programmed yourself or
  864. effects from future update or expansion disks.  When adding ne effects, all
  865. you habe to do is copy them into your DM_effects directory, press `ADD
  866. EFFECT` and they will be automatically added to your list of effects.
  867.  
  868. `SHOW EFFECTS` lists all available effects.
  869.  
  870. To delete an effecct from the list use the function `REMOVE EFFECT`.  This
  871. funtion is doubly secured as it is terminal.
  872.  
  873. All changes to the effect list have to be saved by selecting `SAVE
  874. EFFECT-LIST`.  This will save your changes on disk or hard disk
  875. respectively.
  876.  
  877.         DISK CONTROL
  878.  
  879. These commands are included to save you the job of having to enter the
  880. Workbench or CLI for small file operations.  `CHECK FILE` tries to
  881. recognise the tyoe if file (text, graphics, effect module, script etc) and
  882. `SHOW FILE` will show the file.
  883.  
  884.         THE MENUS
  885.  
  886. The menus are sorted the same way as the various editors.  Each editor has
  887. its corresponding menu that includes all the functions you can reach using
  888. the gadgets but also often contain further functions, too.
  889.  
  890. A very important one for instance is the `Record Time` function in the
  891. construction menu.  It allows you to change the length of a pattern by
  892. clicking on the mouse button at the chosen moment instead of having to
  893. enter the number in the TIME parameter manually.  It`s very simple to use:
  894. Once you have sekected the `Record Time` function the pattern begins to run
  895. as usual. Let it run until you feel it should switch to the next pattern in
  896. the actual demo (for instance a rhythm change in the music) and then press
  897. the left mouse button.  The time passed will automatically be entered in
  898. the TIME parameter.  A similar possibility has been included for the whole
  899. script.  The `Record Times` function here starts the script and runs as it
  900. is supposed to, meaning times will be used as set (this is why it is only
  901. possible to lengthen the times). Press the left mouse button to shorten the
  902. playing time of a certain pattern and the new time will be saved.  When you
  903. rerun the pattern from the beginning this new time setting will be used.
  904.  
  905. All other functions in the menu should be easy to understand.
  906.  
  907.         LIMITATIONS
  908.  
  909. Demomaniac tries to leave you as much freedom as possible when making
  910. demos, but naturally there are certain limitations and knowing what they
  911. are is very useful and important.  The most important limitation is set by
  912. your computer system`s memory - especially the graphics memory (called Chip
  913. Mem).  The rule here is that you can almost never have enough.  As a
  914. programmer you are often given the choice between memory consumption and
  915. speed and when developing Demomaniac we decide to produce the most flexible
  916. and also fastest demomaker on the market.  So we decided to use an extra
  917. few bytes and instead have the highest possible speed.  It will always
  918. require more memory to produce the demo than to actually watch it.
  919.  
  920. The first limitation is memory, the second are bitplanes.  Demomaniac uses
  921. the bitplane system of the Amiga hardware.  This wau each effect that is
  922. shown on the monitor gets its own bitplanes and can be presented without
  923. loss of speed.  There is just on problem: The amiga can only handle a
  924. maximum of 8 bitplanes and on an old (non-AGA) machine you can only present
  925. 5 bitplanes. This means you can`t place as many effects over each other as
  926. you want even if you have empty layers.  An effect with 2 colours uses one
  927. bitplane, an effect with 4 colours uses 2 bitplanes, 8 colours 3 bitplanes
  928. and 16 colours 4.  32 colours use 5 bitplanes and 64 requires 6.  128
  929. colour effects require 7 and 256 colour effects the full 8 bitplanes.  This
  930. means a four coloured stars effect (2 planes) and a 8 coloured font (3
  931. planes) already use up a standard Amigas 5 bitplanes.
  932.  
  933. If we have now confused you, don`t worry.  You will notice what is meant
  934. when playing around with the demo maker.
  935.  
  936.         REPLAYERS
  937.  
  938. The replayers we have included all have different characteristics we would
  939. like to list:
  940.  
  941. Noise packer V3        quite old
  942.  
  943. Noise Tracker V2    To be used with very old modules
  944.  
  945. Sound Tracker V2    For old songs,doesn`t support CIA-timing
  946.  
  947. Sound Tracker V2.6    For old songs,doesn`t support CIA-timing
  948.  
  949. Star Trekker V4        Getting a bit long in the tooth...
  950.  
  951. Pro Tracker V1-V3    These are the original replayers
  952.  
  953. Pro Packer V2        Can play modules packed with the propacker
  954.             WARNING:unpacked sounds will cause this to crash
  955.  
  956. Pro Packer V2Fx        At the moment the only replayer that allows you
  957.             to play music and sound effects simultaneously
  958.  
  959. Pro Runner V2        A good replayer for Pro Tracker music. The module
  960.             is automatically packed after loading and is kept
  961.             and played packed. Thus replayer also allows music
  962.             fading!.
  963.  
  964. Tracker Packer V3    The standard Demomaniac player! It plays programmes
  965.             packed with TrackerPacker, supports CIA-timing and
  966.             music fading.
  967.  
  968. NONE            This isn`t really a replayer as it can`t play any
  969.             modules.  It can play sound effects as is basically
  970.             for use in demos you just require sound effects
  971.             its fine.
  972.             Its supports music fading and will thus fade any
  973.             any active sound effects.
  974.  
  975. As you se there isn`t really a replayer that has all the features you would
  976. wish for (play packed songs, Protracker compatible, CIA timing, sound
  977. fading, sound effects amd speed)
  978.  
  979.         INTERNAL
  980.  
  981. Demomaniac`s modular system works in the following way.  Each drawer
  982. contatins data of just the on type (for instance effects in the DM_effects
  983. drawer).  This drawer also has to be assigned so that the data can be found
  984. on disk or hard disk.
  985. Example: You need to assign the DM_effects drawer that you have placed in
  986. the partition then include the following assign
  987.  
  988. Assign DM_effects: HD0:demomaniac/DM_effects
  989.            ©Black Legend Software and Complex Developments
  990. Dox type in by CHA®ON-OGN
  991.  
  992. Greets goto:
  993.  
  994. TANG0,MAD DAN,NERO,TWISTER,DREAM WARRIOR,OEDIPUS,TAS,STAB,LAMPHREY,HOGSTER  
  995. TROLL,TROOPER,SUGGS,BLADE-RUNNER,GHOST,ICON,JUICY FRUIT,ULTRAMARINE,
  996. LSD,DA LOONS,CANDYMAN,
  997.     AND EVERYONE WHO KNOWS ME
  998.  
  999.     ~THAT IS NOT DEAD CAN ETERNAL LIE
  1000.         YET WITH STRANGE AEONS
  1001.         EVEN DEATH MAY DIE~
  1002.  
  1003. CHA®ON-EVEN DEATH ASKS PERMISSION
  1004.  
  1005.   __                                                                    __
  1006.  /_/\__________________________________________________________________/_/\
  1007.  \_\/                                                                  \_\/
  1008.   |                      CALL +(44)51 474 0856                           |
  1009.   |  ____  _____________ ______        ______  ______________  _______   |
  1010.   |  \_  \/  _/\__ _ __/|      \      |      \ \_ _ _/\     / /  ____/   |
  1011.   |   /       \ /  |  \ |   |   \     |   |   \/  |  \/  Y  \ \_____ \   |
  1012.   |  /  \  /   /   _   \|___|    \ ___|___|    \      \  |   \/       \  |
  1013.   | /    \/   /    |    \        / \           /  |    \ |    \        \ |
  1014.   | \____||___\____|     \______/   \_ _______/___|     \|____/   _____/ |
  1015.   |                l_____/__|         |___|       i_____/     \____j BB's|
  1016.   |                                                                      |
  1017.   |                                                                      |
  1018.   |_                     This is Mad Dan's BB's                          |_
  1019.  /_/\___________________________________________________________________/_/\
  1020.  \_\/                                                                   \_\/
  1021.              Speeds from 9600 to 16.8 Dhst online 24Hr's a day !
  1022.  
  1023.       Amiga-Warez/Pc/Requests/Offline Files - Friendly Sysop- Mad Dan
  1024.  
  1025.    iT cAME fRoM tHE mANSiON aGAiN  +44-(FiND iT)
  1026.   
  1027.           HaVE fUN oUT tHERe GuYS..........!!
  1028.  
  1029.