home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / GRAPHICS / MDEM5C.ZIP / DOC / ADDENDUM.DOC next >
Text File  |  1994-03-31  |  16KB  |  367 lines
  1. 7 Feb 94
  2.  
  3. Addendum to the MakeDemo Manual.
  4.  
  5. 1. 'NAG' Screens and Branding:
  6.  
  7. If you choose to 'brand' and do NOT include a 'NAG' screen in
  8. your creation, and the user runs your creation without using the
  9. correct validation code, it will not run and the user will be
  10. returned directly to the DOS prompt.
  11.  
  12. Previously, the presentation would run anyway, showing any 'NAG'
  13. screens when and if they came up.
  14.  
  15. The chart below shows exactly what the different options mean.
  16.  
  17.  Using MakeDemo Runtimes  |    Without    |       With
  18. to Present Your Creations | 'NAG' Screens |  'NAG' Screens
  19. --------------------------+---------------+---------------------
  20. WWP Shareware             |               |
  21.                           |      n        |    Show
  22. WWP Registered            |       /       |
  23.   Bound into .EXE File    |        a      |         NAG
  24.     Branded with Ser. No. |               |
  25.       Validation Code     |---------------|              Screens
  26.         None or Incorrect |   Terminate   |
  27.                           |---------------|---------------------
  28.         Correct           |      n/a      | Bypass 'NAG' Screens
  29.  
  30. ------------------------
  31. 2. Making the System Menu Invisiable
  32.  
  33. In response to those who want to assign certain keys to system
  34. functions like 'SHELL', 'COLOR', etc., but NOT include the always
  35. accessible "_SIDE0" screen, just rename it "MENU0". Your user can
  36. still access the screen by pressing <F1>, so you should have
  37. something on it for him or her to view. You can include a menu
  38. with highlighted bars or leave it off. It's up to you. The menu
  39. need not be layed out on the screen for it to be active. Only the
  40. menu definition need be there. MSHOW.EXE looks for the 'MENU0'
  41. screen only if it can't find a '_SIDE0' system menu screen.
  42.  
  43. ------------------------
  44. 3. Auto Mode Default Upons Start-up
  45.  
  46. Some MakeDemo afficionados have requested the ability to start
  47. a presentation in something other than the default "EFFECT"
  48. presentation mode. The runtimes now recognize the '@' symbol
  49. prefixed to one of the presentation methods as it appears in the
  50. system menu, either the accessible "_SIDE0" or "MENU0" screen.
  51. For example..
  52.  
  53.            MENU0,SHELL=S,COLOR=C,@AUTO=A,N_EFFECT=N
  54.  
  55. The '@' prefix for 'AUTO' tells the runtime to initially start in
  56. the 'AUTO' mode.
  57.  
  58. ---------------------
  59. 4. Defining Screen Segments and Menu Items Now the Same
  60.  
  61. MakeDemo runtimes now look for screen segments and menu bars
  62. using the same methodology. The width is determined by looking
  63. along the top edge; the height is found by traversing the right
  64. edge.
  65.  
  66. In the case of screen segments, the runtimes look for the top
  67. left corner of the segment defined by the color attribute NOT
  68. being a BLACK background and a dull GREEN foreground color. This
  69. means that the color attribute along these two edges need not be
  70. uniform.
  71.  
  72. Defining menu selections is a little more limiting. The top edge
  73. ( or line for a normal list bars ) must be of the same background
  74. color. The foreground color can change. This makes highlighting
  75. certain keys possible. The runtimes determine the the width by
  76. looking for a change in background color. Multiple line menu
  77. selections must use the same background / foreground colors along
  78. the right edge. The runtimes replace the color attribute along
  79. the right edge with that of the character to its immediate left
  80. before presenting the screen.
  81.  
  82. ------------------------------
  83. 5. "DIALOG" Now a Reserved Name
  84.  
  85. A dialog screen named "DIALOG" is now a reserved name. This
  86. screen presents a message and a button to click on. Right now
  87. there are three possible messages that use this screen for
  88. warning the user that something is wrong with whatever has been
  89. attempted. Primarily used in "MINSTALL.EXE" the three messages
  90. warn for no disk in disk drive, disk in disk drive doesn't
  91. appear to have been formatted, and the file to install can not
  92. be found on the source disk.
  93.  
  94. The DIALOG screen conatins all the messages. To be recognized by
  95. MINSTALL, each message must start it's own line aligned at the
  96. left edge of the screen. The line must start with
  97.  
  98.      D,  meaning there is no disk in the disk drive,
  99.      F,  meaning that the disk appears to be unformatted, and
  100.      S,  meaning that the source disk isn't the correct one.
  101.  
  102. The messages can be listed in any order and take no more than
  103. one line.
  104.  
  105. MINSTALL looks for "<Alt+9>DIALOG" as the upper left corner of a
  106. screen segment. The width and height are defined as are any menu
  107. or database fields as defined in the manual.
  108.  
  109.  
  110. 6. Now your computer can access the yellow background color
  111. along with all the other high intensity background colors for
  112. display on EGA and VGA monitors. While we locked out access to
  113. blinking colors, MSHOW as well as the other runtimes, when an EGA
  114. or VGA monitor is detected, automatically switches your computer
  115. to substitute the high intensity for the blinking background
  116. colors.
  117.  
  118. ---------------------------------
  119. 7. Different ways to Exit Your Creation
  120.  
  121. You can now exit your creation returning to DOS with the
  122. option of first clearing the screen. If you are calling your
  123. creation from within another program, in effect shelling out to
  124. view a presentation, you might not want MkShow to clear the
  125. screen for that second or two while the calling program is
  126. attempting to paint the screen. Here's how it works: If there is
  127. now "XXX" screen, exit from the presentation does not clear the
  128. screen. Or, quiting by using the "EXIT1" menu selection on the
  129. system menu will cause the last screen to remain. Otherwise, the
  130. screen will be cleared before the DOS prompt appears.
  131.  
  132. --------------------------
  133. 8. Roll Your Own Sound Effects
  134.  
  135. Sound effects have been expanded. And if you don't like our
  136. choices, you can define your own right on the screen.
  137.  
  138. There are two types of audio: sound effects and tunes. Of the
  139. former, there is the sound ramp and the arcade sound. Each lasts
  140. as long as it takes for the screen to present itself. The tunes
  141. continue to play out even if the presentation effect is
  142. completed. These audio selections are choosen from the
  143. "presentation effects menu" while in MDEMO.
  144.  
  145. Should you like to write your own tunes, be our guest. For
  146. example, the following string of characters is the tune for
  147.  
  148. "Mary Had A Little Lamb:"
  149.  
  150.      EE*DD*CC*DD*EE*EE*EE****DD*DD*DD****EE*GG*GG
  151.  
  152. The letters denote the keys on a piano, The '*' denote a period
  153. of silence. Type this on a clear line of the screen just as you
  154. see it preceeded by a <Alt>,2 character. Use upper case letters.
  155. Limit the number of characters to 80 or one line. That's all
  156. there is to it. The lowest note is the 'G' below middle 'C'
  157. signified by the '@'. The next note is 'A' represented by 'A' and
  158. so on up to 'G'. Going further up the scale requires a little
  159. sleigh of hand. Instead of starting the alphabet over, we just
  160. continue. Here's a list of notes that MSHOW recognizes:
  161.  
  162. @       G
  163. A       A
  164. B       B
  165. C       C      <-- Middle 'C'
  166. D       D
  167. E       E
  168. F       F
  169. G       G
  170. A       H      <-- 440 Hz.
  171. B       I
  172. C       J
  173. D       K
  174. E       L
  175. F       M
  176.  
  177.  
  178. ------------------------
  179. 9. MkInstall discussion:
  180.  
  181. MkInstall is designed to install a program from archived
  182. collections of files. By "install" we mean "unpack" or "unarc"
  183. the archive to a target directory, first creating that directory
  184. if necessary. Presently, MkInstall can work with PkZipped files,
  185. LHArced files, or self extracting .EXE files. And MkInstall will
  186. recreate the sub-directory structure defined in the archive
  187. itself.
  188.  
  189. The MakeDemo distribution for the MkInstall program includes a
  190. unpacking utility WLZ.EXE which you are free to include with
  191. your distribution. It will unpack LHArced files that have been
  192. renamed with the ".WLZ" extension. It is designed to be used by
  193. the MkInstall program and will produce a visual bar graph on the
  194. screen indicating progress in the unpacking process.
  195.  
  196. To unpack either ".ZIP" or ".LZH" files requires access to a copy
  197. of PKUNZIP.EXE or LHA.EXE respectively already installed on the
  198. user's system. Neither is supplied with MakeDemo. Use of either
  199. will produce that utility's usual screen showing the progress of
  200. the unpacking operation.
  201.  
  202. The real advantage of this methodology is that one install
  203. program will work unaltered with distributions including either
  204. PkZipped or LHArced files, or (with the included WLZ.EXE
  205. utility) LHArced files renamed with the "WLZ" extension.
  206.  
  207. An example might show how MkInstall is designed to work. You'll
  208. note that a menu selection prefixed with "&&" tells MkInstall
  209. that the following menu selection is the name of a file to be
  210. installed. For example
  211.  
  212.                            &&MDEM5A
  213.  
  214. is interpreted thusly. MkInstall first looks for as file named
  215. "MDEM5A" with the one of the following extensions: "COM", "EXE",
  216. "BAT", "ZIP", "LZH", or "WLZ", in that order. Once a match is
  217. found, MkInstall performs as follows:
  218.  
  219.     1. Copies the archive to the target directory, creating it
  220.     first if it doesn't already exist.
  221.  
  222.     2. MkInstall internally changes to the target directory and
  223.     performs the equivalent of
  224.  
  225.                   MDEM5A               Self-extracting .EXE file
  226.  
  227.                   PKUNZIP -d MDEM5A    PkUnzip MDEM5A.ZIP
  228.  
  229.                   LHARC x MDEM5A       LHArc (eXtract) MDEM5A.LZH
  230.  
  231.                   WLZ x MDEM5A         WLZ (eXtract) MDEM5A.WLZ
  232.  
  233.     3. Deletes the source archive file from the target directory.
  234.  
  235.     4. MkInstall changes back to the source directory, ready to
  236.     present the next screen and the possible unpacking of
  237.     another archive.
  238.  
  239. If you intend your program to be installed in a number of
  240. subdirectories of the target directory, you'll need to make sure
  241. that your files are archived using the correct switches. Here
  242. are a cople of lines from a .BAT file we use to put together the
  243. MakeDemo distribution.
  244.  
  245.                   pkzip -a -P mdem5a @mdem5a.cfg
  246.  
  247.                   lha a /x1 mdem5a @mdem5a.cfg
  248.  
  249. We use a configuration file listing all files that go into the
  250. archive. That file lists each file complete with its own path.
  251. Of course, these subdirectories must exist below the directory
  252. where the packing occurs and contain the files so defined.
  253.  
  254. Show below is the list of files that go into the MDEM5A archive
  255. and where they can be found.
  256.  
  257. file_idm.diz
  258. readme
  259. exam\watch_me.1st
  260. exam\go_show.bat
  261. doc\register.doc
  262. wwp_make.com
  263. mshow.exe
  264. doc\pack_a.lst
  265.  
  266. Large programs can be broken into a number of small archives
  267. with a screen in your install program devoted to describing
  268. each's unique features. And if your packed files are organized
  269. differently depending upon the capacity of the medium being
  270. used, the screen can alert the user as to how to handle the
  271. differences. Or you can easily make a MkInstall variation for
  272. each.
  273.  
  274.  
  275. CHK_SYS Screen
  276.  
  277. This screen empowers the install program to check a number of
  278. system parametes and present a warning message if a problem is
  279. found. Generally, the MkInstall program can install a program on
  280. virtually any system, you might want to alert the user of
  281. possible problems area in the system configuration. For example,
  282. maybe you would like to alert the user that RAM is not adequate
  283. to eventually run your program.
  284.  
  285. The CHK_SYS screen is basically a dialog screen that can present
  286. a half dozen messages should conditions warrant. It is similar to
  287. other MakeDemo dialog screens. Instead of the defining menu
  288. selections in the lines with a preceding <Alt,4> character, we
  289. list the system conditions for checking. If MkInstall finds any
  290. of the selections not adequate, the apprpriate message comes up.
  291. For example, if DOS version less than 7.10 is discovered, the
  292. message following the "D," is displayed shown on the screen
  293. below, there being no DOS greater than 6.2 as of this writing. In
  294. like manner, MkInstall checks available RAM and as long as
  295. MEM=641 or more, message "M" appears. Message "C" appears only if
  296. the there is a math coprocessor present.
  297.  
  298.   +------------------------------------------------------------+
  299.   | <Alt,4>CHK_SYS,DOS=7.10,MEM=710,FILES=70,BUFFERS=70,8087   |
  300.   |                                                            |
  301.   |D,MakeDemo requires DOS version 2.10 or greater to function |
  302.   |M,Crea|ing an application needs 256 kBytes RAM; running it, |
  303.   |F,FILES=15 or less can thwart apps running under DOS version|
  304.   |B,MakeDemo creations work best with disk caching or BUFFERS=|
  305.   |C,MakeDemo does not make use of a math coprocessor.         |
  306.   |                                                            |
  307.   |               +------------------------------------------+ |
  308.   |               |                   W a r n i n g          | |
  309.   |               |                                          | |
  310.   |               |          <Alt,6>                  X      | |
  311.   |               |                                   X      | |
  312.   |               |                                   X      | |
  313.   |               |                                          | |
  314.   |               | To continue, press a key or click mouse. | |
  315.   |               +------------------------------------------+ |
  316.   |                                                            |
  317.   +------------------------------------------------------------+
  318.     
  319. The message is placed like any other field on a MakeDemo screen.
  320. The space following the <Alt,6> defines the upper left corner.
  321. The left edge, defined by a different foreground and background
  322. color, sets the width and height. Three lines of 35 spaces should
  323. be allocated for displaying the message. MkInstall word wraps the
  324. message to fit.
  325.  
  326.  
  327. PROBLEM Screen
  328.  
  329. MkInstall uses this screen to warn the installer that something
  330. is wrong with the way the installation is progressing. There are
  331. ten malfunctions for which a message will pop up on the screen.
  332. Most of the message are self explanatary, but you might wish to
  333. express the problem a little differently.
  334.  
  335. The layout is much the same as other dialog screens. Please note
  336. that the <Alt,9> character is used to define the upper left
  337. corner of the message area. This different from the CHK_SYS
  338. screen where the <Alt,6> character was used.
  339.  
  340.    +----------------------------------------------------------+
  341.    |    <Alt,4>DIALOG,_YES=O                                  |
  342.    |                                                          |
  343.    |D,The requested disk drive does not exist on your system. |
  344.    |R,The disk drive is not ready. Make sure disk is in drive |
  345.    |F,Can't find disk sectors. Possibly disk needs first to b |
  346.    |S,Unable to continue. Problem is possibly limited availab |
  347.    |M,Unable to create requested directory and/or tree struct |
  348.    |X,You must prefix the directory with the drive letter des |
  349.    |P,Unable to continue: can not find PKUNZIP.EXE by followi |
  350.    |L,Unable to continue: can not find LHA.EXE by following s |
  351.    |Z,Miscellaneous error.                                    |
  352.    |A,Unable to find archive. Make sure file exists, possibly |
  353.    |                                                          |
  354.    |           +------------------------------------------+   |
  355.    |           |     X             W a r n i n g          |   |
  356.    |           |     X                                    |   |
  357.    |           |     X    <Alt,9> DIALOG           X      |   |
  358.    |           |                                   X      |   |
  359.    |           |     X                             X      |   |
  360.    |           |                                          |   |
  361.    |           |                         <Alt,6> Ok X     |   |
  362.    |           +------------------------------------------+   |
  363.    |                                                          |
  364.    +----------------------------------------------------------+
  365.  
  366.  
  367.