home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / JUEGOS / DMAPED40.ZIP / DOCS / DEMOS.TXT < prev    next >
Encoding:
Text File  |  1996-06-17  |  5.5 KB  |  112 lines
  1. All about Demos for DMapEdit
  2. ----------------------------
  3.  
  4. Demo files for DMapEdit have the extention '.rec', which stands for 
  5. recording.  By default, DMapEdit will use 'demo.rec' if you don't give 
  6. it a filename.  To play a demo file, you use the '-play' switch:
  7.  
  8. dmapedit -play           <-- playback the demo.rec file
  9. dmapedit -play doors     <-- playback the doors.rec file
  10.  
  11. With a demo running, the word 'demo' will flash in the upper left-hand 
  12. corner of the screen just under the toolbar.  This is just there to 
  13. remind you a demo is playing.  During playback, all control functions 
  14. (mouse and keyboard) are read from the demo file, instead of you the 
  15. user.  You can stop playback at any time by pressing 'ESC'.
  16.  
  17. During playback, windows will most likely appear from time to time
  18. containing information for you to read.  This is to explain what the
  19. 'demo' is doing.  With demo mode, I wanted to try and make it so that I 
  20. could show each and every user of DMapEdit how to use my editor, without 
  21. actually having to be there to show you myself.  If I was there teaching 
  22. you how to use it, I would talk to you and tell you exactly what I'm 
  23. doing as I do it.  Since I'm not really there, though, these windows 
  24. serve that purpose.
  25.  
  26. I call these windows 'info boxes'.  When an info box appears, DMapEdit 
  27. will wait until you read it all.  When you are done reading it, all you 
  28. need to do is press any key on the keyboard to continue, except 'ESC', 
  29. since this will stop playback.
  30.  
  31. Playback will automatically end when the end of the demo file being 
  32. played is reached, or when DMapEdit terminates.  In the first case, an 
  33. info box will appear informing you that the demo is at an end.  You will 
  34. once again have full control of DMapEdit at this point.
  35.  
  36. ---------------
  37. Recording Demos
  38. ---------------
  39.  
  40. In addition to simply being able to play demos, you can also record your 
  41. own demos.  This can be useful for many reasons:
  42.  
  43. * Someone you are trying to explain something to can't make heads or 
  44.    tails of what you are saying, and you can't get together with him/her 
  45.    to actually show them.  An example is worth 10,000 words. (Just a 
  46.    simple picture is only worth 1,000!)  You can create a demo for them 
  47.    to explain it all.
  48.  
  49. * You've found a bug in DMapEdit that you can reproduce at will, but 
  50.    can't seem to explain the bug to me very well.  You can create a demo 
  51.    that demonstrates the error happening.
  52.  
  53. * You can create a tutorial on DMapEdit usage, or on how to create a 
  54.    PWAD from start to finish, or whatever.  Beats reading a big long file.
  55.  
  56. As you can see, the common theme here is 'DEMOnstrating' your ideas in 
  57. real time.  Ok, so how do you do it?
  58.  
  59. Basically, you follow the same format for playing a demo, except you use 
  60. the '-record' switch:
  61.  
  62. dmapedit -record           <-- record the demo.rec file
  63. dmapedit -record doors     <-- record the doors.rec file
  64.  
  65. Please note however that this will erase whatever file already exists 
  66. with that name, overwritting it with your new demo.  If you want to 
  67. append to an existing demo, see below.
  68.  
  69. Once DMapEdit is up and running, all mouse and keyboard commands are
  70. automatically saved as you go along.  The word 'recording' will also 
  71. flash in the upper left-hand corner of the screen just below the toolbar
  72. to remind you that it is recording a demo.
  73.  
  74. "So what about the info boxes?" you are probably asking.  When you are 
  75. ready to have an info box display, simply press the ` key (not the ' key!),
  76. which should be located just below the 'ESC' on most keyboards.  This 
  77. will pop up a big empty window for you to put your message in.  It's not 
  78. the world's greatest editor or anything, but it does support cursor 
  79. movement, insert, delete, page up/down, home, end, and word-wrap.  If 
  80. you find what you want to say is more than will fit in the window, put 
  81. it into 2 windows instead, one right after the other.
  82.  
  83. When you are done typing in your message to the user, pressing 'ESC' 
  84. will save the window and let you continue where you left off.  A word of 
  85. warning, however.  Info boxes are really only meant to be displayed from 
  86. the 'main editing loop', inside standard windows (not picklists), and I
  87. added it to the 3D previewer as well.  Anywhere else you try to bring one
  88. up will probably not work.
  89.  
  90. To stop the demo, just press 'ESC' in the main editing loop.  If you are
  91. not in the main editing loop, 'ESC' will do whatever it normally does
  92. (cancel the action and/or return to the main editing loop).
  93.  
  94. Ok, so that about covers everything, right?  Well, there's a few more 
  95. things you might be interested to know about..
  96.  
  97. While you are playing a demo, you can at any point switch over to 
  98. recording mode by pressing 'Alt-R'.  This can be very handy to pick up 
  99. where you left off on a demo you started but didn't finish for whatever 
  100. reason (got sleepy, ran into a bug, power failure, etc.)  This is in 
  101. fact the reason I put it in.  I got tired of having to start all over 
  102. from scratch each time I ran into a bug, or didn't like the direction I 
  103. took with what I was doing and wanted to rewrite it.  Once you are in 
  104. recording mode, however, there is no way to switch back to playback 
  105. again or anything.  Anything else that was in the demo beyond your 
  106. 'take-over' point is history.
  107.  
  108. If you happen to create any really good demos, feel free to send it to 
  109. me.  I'll add it to the library of demos I distribute with DMapEdit, as 
  110. well as the official DMapEdit homepage.  Demos can redefine the whole
  111. meaning of what a map editor tutorial should do!
  112.