home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1332 / gepackt.exe / DOC / ADDENDUM.DOC next >
Encoding:
Text File  |  1994-02-16  |  13.3 KB  |  306 lines
  1. 7 Feb 94
  2.  
  3. Addendum to the MakeDemo Manual.
  4.  
  5. 1. If you choose to 'brand' and do NOT include a 'NAG' screen in
  6. your creation, and the user runs your creation without using the
  7. correct validation code, it will not run and the user will be
  8. returned directly to the DOS prompt.
  9.  
  10. Previously, the presentation would run anyway, showing any 'NAG'
  11. screens when and if they came up.
  12.  
  13.  
  14. 2. In response to those who want to assign certain keys to system
  15. functions like 'SHELL', 'COLOR', etc., but NOT include the always
  16. accessible "_SIDE0" screen, just rename it "MENU0". Your user can
  17. still access the screen by pressing <F1>, so you should have
  18. something on it for him or her to view. You can include a menu
  19. with highlighted bars or leave it off. It's up to you. The menu
  20. need not be layed out on the screen for it to be active. Only the
  21. menu definition need be there. MSHOW.EXE looks for the 'MENU0'
  22. screen only if it can't find a '_SIDE0' system menu screen.
  23.  
  24.  
  25. 3. Some MakeDemo afficionados have requested the ability to start
  26. a presentation in something other than the default "EFFECT"
  27. presentation mode. The runtimes now recognize the '@' symbol
  28. prefixed to one of the presentation methods as it appears in the
  29. system menu, either the accessible "_SIDE0" or "MENU0" screen.
  30. For example..
  31.  
  32.            MENU0,SHELL=S,COLOR=C,@AUTO=A,N_EFFECT=N
  33.  
  34. The '@' prefix for 'AUTO' tells the runtime to initially start in
  35. the 'AUTO' mode.
  36.  
  37.  
  38. 4. MakeDemo runtimes now look for screen segments and menu bars
  39. using the same methodology. The width is determined by looking
  40. along the top edge; the height is found by traversing the right
  41. edge.
  42.  
  43. In the case of screen segments, the runtimes look for the top
  44. left corner of the segment defined by the color attribute NOT
  45. being a BLACK background and a dull GREEN foreground color. This
  46. means that the color attribute along these two edges need not be
  47. uniform.
  48.  
  49. Defining menu selections is a little more limiting. The top edge
  50. ( or line for a normal list bars ) must be of the same background
  51. color. The foreground color can change. This makes highlighting
  52. certain keys possible. The runtimes determine the the width by
  53. looking for a change in background color. Multiple line menu
  54. selections must use the same background / foreground colors along
  55. the right edge. The runtimes replace the color attribute along
  56. the right edge with that of the character to its immediate left
  57. before presenting the screen.
  58.  
  59.  
  60. 5. A dialog screen named "DIALOG" is now a reserved name. This
  61. screen presents a message and a button to click on. Right now
  62. there are three possible messages that use this screen for
  63. warning the user that something is wrong with whatever has been
  64. attempted. Primarily used in "MINSTALL.EXE" the three messages
  65. warn for no disk in disk drive, disk in disk drive doesn't
  66. appear to have been formatted, and the file to install can not
  67. be found on the source disk.
  68.  
  69. The DIALOG screen conatins all the messages. To be recognized by
  70. MINSTALL, each message must start it's own line aligned at the
  71. left edge of the screen. The line must start with
  72.  
  73.      D,  meaning there is no disk in the disk drive,
  74.      F,  meaning that the disk appears to be unformatted, and
  75.      S,  meaning that the source disk isn't the correct one.
  76.  
  77. The messages can be listed in any order and take no more than
  78. one line.
  79.  
  80. MINSTALL looks for "<Alt+9>DIALOG" as the upper left corner of a
  81. screen segment. The width and height are defined as are any menu
  82. or database fields as defined in the manual.
  83.  
  84.  
  85. 6. We have added the presentation effect of a "swing arc" or
  86. 'radar' type effect that progressively reveals the new screen as
  87. an arc swings around the screen with one end anchored at screen
  88. center.  Additionally, there are sound effects available for all
  89. presentation styles.
  90.  
  91.  
  92. 7. Now your computer can access the yellow background color
  93. along with all the other high intensity background colors for
  94. display on EGA and VGA monitors. While we locked out access to
  95. blinking colors, MSHOW as well as the other runtimes, when an EGA
  96. or VGA monitor is detected, automatically switches your computer
  97. to substitute the high intensity for the blinking background
  98. colors.
  99.  
  100.  
  101. 8. Sound Effects
  102.  
  103. Now you can choose one of two kinds of sound effects for the
  104. viewer to hear as a screen is being presented. The first is the
  105. original tone ramp of ascending or descending tone as the screen
  106. appears. Screens of older presentations that were keyed to have
  107. sound effects automatically default to this sound effect.
  108.  
  109. You can now select an arcade sound from the sound effects menu
  110. while selecting the appearance mode of MkDemo. Now there is a
  111. third from which to choose. Have fun!
  112.  
  113.  
  114. 9. MkInstall discussion:
  115.  
  116. MkInstall is designed to install a program from archived
  117. collections of files. By "install" we mean "unpack" or "unarc"
  118. the archive to a target directory, first creating that directory
  119. if necessary. Presently, MkInstall can work with PkZipped files,
  120. LHArced files, or self extracting .EXE files. And MkInstall will
  121. recreate the sub-directory structure defined in the archive
  122. itself.
  123.  
  124. The MakeDemo distribution for the MkInstall program includes a
  125. unpacking utility WLZ.EXE which you are free to include with
  126. your distribution. It will unpack LHArced files that have been
  127. renamed with the ".WLZ" extension. It is designed to be used by
  128. the MkInstall program and will produce a visual bar graph on the
  129. screen indicating progress in the unpacking process.
  130.  
  131. To unpack either ".ZIP" or ".LZH" files requires access to a copy
  132. of PKUNZIP.EXE or LHA.EXE respectively already installed on the
  133. user's system. Neither is supplied with MakeDemo. Use of either
  134. will produce that utility's usual screen showing the progress of
  135. the unpacking operation.
  136.  
  137. The real advantage of this methodology is that one install
  138. program will work unaltered with distributions including either
  139. PkZipped or LHArced files, or (with the included WLZ.EXE
  140. utility) LHArced files renamed with the "WLZ" extension.
  141.  
  142. An example might show how MkInstall is designed to work. You'll
  143. note that a menu selection prefixed with "&&" tells MkInstall
  144. that the following menu selection is the name of a file to be
  145. installed. For example
  146.  
  147.                            &&MDEM5A
  148.  
  149. is interpreted thusly. MkInstall first looks for as file named
  150. "MDEM5A" with the one of the following extensions: "COM", "EXE",
  151. "BAT", "ZIP", "LZH", or "WLZ", in that order. Once a match is
  152. found, MkInstall performs as follows:
  153.  
  154.     1. Copies the archive to the target directory, creating it
  155.     first if it doesn't already exist.
  156.  
  157.     2. MkInstall internally changes to the target directory and
  158.     performs the equivalent of
  159.  
  160.                   MDEM5A               Self-extracting .EXE file
  161.  
  162.                   PKUNZIP -d MDEM5A    PkUnzip MDEM5A.ZIP
  163.  
  164.                   LHARC x MDEM5A       LHArc (eXtract) MDEM5A.LZH
  165.  
  166.                   WLZ x MDEM5A         WLZ (eXtract) MDEM5A.WLZ
  167.  
  168.     3. Deletes the source archive file from the target directory.
  169.  
  170.     4. MkInstall changes back to the source directory, ready to
  171.     present the next screen and the possible unpacking of
  172.     another archive.
  173.  
  174. If you intend your program to be installed in a number of
  175. subdirectories of the target directory, you'll need to make sure
  176. that your files are archived using the correct switches. Here
  177. are a cople of lines from a .BAT file we use to put together the
  178. MakeDemo distribution.
  179.  
  180.                   pkzip -a -P mdem5a @mdem5a.cfg
  181.  
  182.                   lha a /x1 mdem5a @mdem5a.cfg
  183.  
  184. We use a configuration file listing all files that go into the
  185. archive. That file lists each file complete with its own path.
  186. Of course, these subdirectories must exist below the directory
  187. where the packing occurs and contain the files so defined.
  188.  
  189. Show below is the list of files that go into the MDEM5A archive
  190. and where they can be found.
  191.  
  192. file_idm.diz
  193. readme
  194. exam\watch_me.1st
  195. exam\go_show.bat
  196. doc\register.doc
  197. wwp_make.com
  198. mshow.exe
  199. doc\pack_a.lst
  200.  
  201. Large programs can be broken into a number of small archives
  202. with a screen in your install program devoted to describing
  203. each's unique features. And if your packed files are organized
  204. differently depending upon the capacity of the medium being
  205. used, the screen can alert the user as to how to handle the
  206. differences. Or you can easily make a MkInstall variation for
  207. each.
  208.  
  209.  
  210. CHK_SYS Screen
  211.  
  212. This screen empowers the install program to check a number of
  213. system parametes and present a warning message if a problem is
  214. found. Generally, the MkInstall program can install a program on
  215. virtually any system, you might want to alert the user of
  216. possible problems area in the system configuration. For example,
  217. maybe you would like to alert the user that RAM is not adequate
  218. to eventually run your program.
  219.  
  220. The CHK_SYS screen is basically a dialog screen that can present
  221. a half dozen messages should conditions warrant. It is similar to
  222. other MakeDemo dialog screens. Instead of the defining menu
  223. selections in the lines with a preceding <Alt,4> character, we
  224. list the system conditions for checking. If MkInstall finds any
  225. of the selections not adequate, the apprpriate message comes up.
  226. For example, if DOS version less than 7.10 is discovered, the
  227. message following the "D," is displayed shown on the screen
  228. below, there being no DOS greater than 6.2 as of this writing. In
  229. like manner, MkInstall checks available RAM and as long as
  230. MEM=641 or more, message "M" appears. Message "C" appears only if
  231. the there is a math coprocessor present.
  232.  
  233.   +------------------------------------------------------------+
  234.   | <Alt,4>CHK_SYS,DOS=7.10,MEM=710,FILES=70,BUFFERS=70,8087   |
  235.   |                                                            |
  236.   |D,MakeDemo requires DOS version 2.10 or greater to function |
  237.   |M,Crea|ing an application needs 256 kBytes RAM; running it, |
  238.   |F,FILES=15 or less can thwart apps running under DOS version|
  239.   |B,MakeDemo creations work best with disk caching or BUFFERS=|
  240.   |C,MakeDemo does not make use of a math coprocessor.         |
  241.   |                                                            |
  242.   |               +------------------------------------------+ |
  243.   |               |                   W a r n i n g          | |
  244.   |               |                                          | |
  245.   |               |          <Alt,6>                  X      | |
  246.   |               |                                   X      | |
  247.   |               |                                   X      | |
  248.   |               |                                          | |
  249.   |               | To continue, press a key or click mouse. | |
  250.   |               +------------------------------------------+ |
  251.   |                                                            |
  252.   +------------------------------------------------------------+
  253.     
  254. The message is placed like any other field on a MakeDemo screen.
  255. The space following the <Alt,6> defines the upper left corner.
  256. The left edge, defined by a different foreground and background
  257. color, sets the width and height. Three lines of 35 spaces should
  258. be allocated for displaying the message. MkInstall word wraps the
  259. message to fit.
  260.  
  261.  
  262. PROBLEM Screen
  263.  
  264. MkInstall uses this screen to warn the installer that something
  265. is wrong with the way the installation is progressing. There are
  266. ten malfunctions for which a message will pop up on the screen.
  267. Most of the message are self explanatary, but you might wish to
  268. express the problem a little differently.
  269.  
  270. The layout is much the same as other dialog screens. Please note
  271. that the <Alt,9> character is used to define the upper left
  272. corner of the message area. This different from the CHK_SYS
  273. screen where the <Alt,6> character was used.
  274.  
  275.    +----------------------------------------------------------+
  276.    |    <Alt,4>DIALOG,_YES=O                                  |
  277.    |                                                          |
  278.    |D,The requested disk drive does not exist on your system. |
  279.    |R,The disk drive is not ready. Make sure disk is in drive |
  280.    |F,Can't find disk sectors. Possibly disk needs first to b |
  281.    |S,Unable to continue. Problem is possibly limited availab |
  282.    |M,Unable to create requested directory and/or tree struct |
  283.    |X,You must prefix the directory with the drive letter des |
  284.    |P,Unable to continue: can not find PKUNZIP.EXE by followi |
  285.    |L,Unable to continue: can not find LHA.EXE by following s |
  286.    |Z,Miscellaneous error.                                    |
  287.    |A,Unable to find archive. Make sure file exists, possibly |
  288.    |                                                          |
  289.    |           +------------------------------------------+   |
  290.    |           |     X             W a r n i n g          |   |
  291.    |           |     X                                    |   |
  292.    |           |     X    <Alt,9> DIALOG           X      |   |
  293.    |           |                                   X      |   |
  294.    |           |     X                             X      |   |
  295.    |           |                                          |   |
  296.    |           |                         <Alt,6> Ok X     |   |
  297.    |           +------------------------------------------+   |
  298.    |                                                          |
  299.    +----------------------------------------------------------+
  300.       
  301.       
  302.    
  303.  
  304.  
  305.  
  306.