home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / gkdemo.zip / README.TXT < prev    next >
Text File  |  1994-12-28  |  9KB  |  241 lines
  1. GUI-Kit Demonstration Disk for Win32s and Windows NT
  2. Copyright 1994 Visual Systems Corporation
  3. 12-28-94
  4.  
  5. Visual Systems Corporation
  6. 2512 Crosstown Blvd. N.E.
  7. Ham Lake, MN   55304
  8. 800-247-2108
  9. 612-434-6382
  10. Fax: 612-434-6538
  11. E-Mail: Internet: vsystems@ix.netcom.com
  12.         CompuServe: 73361,3131
  13.  
  14. ----------------------------------------------------------------------
  15. This document contains information on how to install and run the
  16. GUI-Kit demonstrations. If you have any questions, please call
  17. us at 1-800-247-2108. GUI-Kit for Win32s and Windows NT
  18. is available for $249 (US) until April 30, 1995. After April 30,
  19. you can purchase it for $495. We also have an unconditional 60 day
  20. money-back guarantee; you can try it absolutely risk-free (excludes
  21. shipping and handling charges).
  22.  
  23. Installation
  24. ------------
  25.  
  26. 1. This demo runs under Windows NT 3.1, Windows 3.1, or Windows for
  27. Workgroups 3.11 (WfW). If you want to install on Windows 3.1 or WfW,
  28. you must have previously installed Win32s (this comes with Microsoft's
  29. and Borland's compilers and is also available on Microsoft Developer's
  30. Network CD). If you don't have Win32s, we have supplied a copy of
  31. Win32s 1.1 on the demo diskette. To install Win32s, or to get the
  32. latest version from Microsoft, see the section ``Installing Win32s''
  33. below.
  34.  
  35. 2. To install the demo, insert the demo diskette into a diskette
  36. drive.
  37.  
  38. 3. Using Program Manager's File|Run menu option, run:
  39.  
  40. A:\INSTALL
  41.  
  42. (or B: depending on the drive you used). Follow the instructions
  43. on the screen. If you downloaded this demo, simply run the install
  44. program from the directory where you unzipped the file.
  45.  
  46. ----------------------------------------------------------------------
  47.  
  48. Installing Win32s
  49. -----------------
  50.  
  51. If you have already installed Win32s, you may skip this section.
  52. We have supplied Win32s 1.1 on the installation diskette for you.
  53. However, there have been newer releases of Win32s (1.15, 1.15a,
  54. 1.20) since 1.1; we did not supply these releases because they
  55. would not fit on a single diskette. If you want, you can retrieve
  56. the newest release from CompuServe or the Internet as follows:
  57.  
  58. CompuServe:
  59.    MSWIN32 forum, Library 14.
  60.       Files: 32s115.zip - Win32s 1.15
  61.              115a.zip - Win32s 1.15a
  62.       As of 12-09-94, Microsoft has not posted 1.20 on CompuServe.
  63.  
  64. Internet:
  65.    FTP ftp.microsoft.com:/Softlib/MSLFiles/PW1118.EXE - This is
  66.    Win32s 1.20.
  67.  
  68. 1. To install Win32s 1.1 from the demo diskette, create a 
  69. working directory on your hard disk and change to that directory.
  70.  
  71. 2. From a DOS prompt, type A:\WIN32S (or B: as the case may be). This
  72. is a self-extracting file of the Win32s installation files.
  73.  
  74. 3. Using Program Manager's File|Run menu option, run the SETUP.EXE
  75. program in your working directory.
  76.  
  77. 4. Follow the instructions that appear on the screen.
  78.  
  79. 5. After Windows restarts, you can delete your working directory.
  80. ----------------------------------------------------------------------
  81.  
  82. Running the Demos
  83. -----------------
  84.  
  85. The demo is comprised of a series of executables and source files.
  86. These are actual GUI-Kit programs. We have included the source code
  87. for all of the programs so that you can see how easy it is to create
  88. GUI-Kit programs.
  89.  
  90. For a good overview of GUI-Kit, we have included Chapter 3 ``GUI-Kit:
  91. Hands-On Training'' from the GUI-Kit Programmer's Guide and Reference
  92. on the diskette. This chapter will give you a good overview of what
  93. GUI-Kit is and how it works. The programs referenced in this chapter
  94. are also included on the demo disk.  You can print the chapter if you
  95. have a PostScript or LaserJet compatible printer.
  96.  
  97. For a PostScript printer, type:
  98.  
  99.    COPY /B C:\GKDEMO\CHAP3.PS LPT1:
  100.  
  101. For a HP LaserJet compatible (PCL) printer, type:
  102.  
  103.    COPY /B C:\GKDEMO\CHAP3.PCL LPT1:
  104.  
  105. If you cannot print these files, call us at 800-247-2108 and we'll
  106. send you a hard copy.
  107.  
  108. The demos are designed to be run from the File Manager. Simply open
  109. the directory where you installed the demo and double click on the
  110. .EXE files. If you are running under Window NT, you can run them from
  111. the command prompt if you switch to the demo directory (e.g.,
  112. C:\GKDEMO) first.
  113.  
  114. A description of each program follows.
  115.  
  116. ----------------------------------------------------------------------
  117. Tutorial Programs
  118.  
  119. PROG1.EXE, PROG1A.EXE, PROG1B.EXE, PROG1C.EXE, PROG1D.EXE
  120. PROG1.C, PROG1A.C, PROG1B.C, PROG1C.C, PROG1D.C
  121. PROG1D.GKR
  122.  
  123. These are the examples from the "GUI-Kit: Hands-On Training" chapter.
  124. Print and read this chapter for more details (see above).
  125.  
  126. ----------------------------------------------------------------------
  127. Employee Information Application
  128.  
  129. EMPLAPPL.EXE, EMPLAPPL.C, EMPLAPPL.GKR
  130. CANCELX.XPM, EINSTIEN.BMP, EMPLAPPL.HLP, HELP.XPM, OKCHECK.XPM,
  131. SEARCH.XPM
  132.  
  133. This is the skeleton code for an employee information application.
  134. You should note that the entire user interface is specified in
  135. EMPLAPPL.GKR, while the action (NotifyProc) routines are in
  136. EMPLAPPL.C.
  137.  
  138. ----------------------------------------------------------------------
  139. Controls Demo
  140.  
  141. DEMOCTRL.EXE, DEMOCTRL.C, DEMOCTRL.GKR     
  142. DEMOBUT1.XPM, DEMOBUT2.XPM, DEMOBUT3.XPM
  143.  
  144. This program demonstrates some of GUI-Kit's controls and automatic
  145. layout features. When you run the program, note the following:
  146.  
  147. - The window has a bar menu. Highlighting or selecting a menu item
  148. will cause the edit control's (below the buttons) text to change. The
  149. Edit menu has a sub-menu attached to it. The first three menu items in
  150. the "Options" menu can be toggled on and off independently. The second
  151. and third groups of menu items can be toggled, but are mutually
  152. exclusive.
  153.  
  154. - If you press the "Button" Button, its label will grow larger. Note
  155. how the other controls automatically adjust their positions.
  156.  
  157. - The "Push Me" button illustrates a image with a text label. If you
  158. press this button, a simple dialog box will be displayed.
  159.  
  160. - The "No, Push Me" button illustrates GUI-Kit's control of the
  161. keyboard focus and traversal. The button can be clicked, but you
  162. cannot tab to it.
  163.  
  164. - The "Smiley" button is an example of a custom button. If you press
  165. it the image changes. Otherwise, it works like a regular push button.
  166.  
  167. - The "Check" button is one example of how button labels can be
  168. positioned in GUI-Kit.  In this case, the label is to the left of the
  169. check box.
  170.  
  171. - The radio buttons show various label positions (right, center) as
  172. well as GUI-Kit's text capabilities. The "Radio 1" button has a
  173. multi-line label. The "Radio 2" button is multi-line and also includes
  174. a font and color change.
  175.  
  176. - The "Off" button is an example of a toggle button. Press it once and
  177. it will change to "On", press it again and it changes to "Off".
  178.  
  179. - The Edit control allows multiple lines and is scrollable both
  180. vertically and horizontally.
  181.  
  182. - The last three controls demonstrate the three types of Combo boxes.
  183. Selecting an item in a Combo box causes the Edit control's text to
  184. change.
  185.  
  186. - Pressing Alt+D anywhere causes the Edit control to be
  187. deleted. Notice how the controls reposition themselves.
  188.  
  189. - Double-clicking in the item list of the left-most Combo box causes
  190. the font typeface and size to change. Again notice how GUI-Kit
  191. automatically resized the control and repositioned the other controls.
  192.  
  193. - Pressing the right mouse button anywhere brings up a pop-up
  194. menu (the same "Options" menu used on the bar menu).
  195.  
  196. ----------------------------------------------------------------------
  197. Clock Demo
  198.  
  199. CLOCK.EXE, CLOCK.C,CLOCK.GKR
  200. ACLKMID.XPM, ACLOCK.BMP
  201.  
  202. This wall-clock sample demonstrates some of GUI-Kit's graphics object
  203. (GfxObj) capabilities.
  204.  
  205. NOTE: If you have the environment variable TZ set to something other
  206. than "GMT0" under Windows 3.1, the hour hand will indicate the wrong
  207. hour.  If you do not set the TZ environment variable, the hour hand
  208. will work correctly.
  209.  
  210. ----------------------------------------------------------------------
  211. Animation Demo
  212.  
  213. ANIMATN.EXE, ANIMATN.C
  214. EYE*.XPM, BULB.XPM, FGIMG.BMP
  215.  
  216. This program demonstrates sprite animation. Sprites are
  217. non-rectangular images that can be moved around the window without
  218. flicker. Sprites also have a top-to-bottom order so that one sprite
  219. can pass in front of, or behind, another. The result is smooth
  220. animation that is typically used in games.
  221.  
  222. In GUI-Kit, sprites make extensive use of the GfxImage graphics
  223. object. In addition, they utilize the GfxImage transparency 
  224. feature which allows you to specify what parts of an image are
  225. drawn. Sprites also take advantage of the double-buffering
  226. feature in the Window class. Double-buffering allows an
  227. GfxImage, or other graphics object, to be moved or changed
  228. without causing unsightly flicker on the display.
  229.  
  230. When you start the program, two figures will run around the window.
  231. You can see the effects of transparency when they pass behind the red 
  232. circle or when one passes in front of the other. If you resize the
  233. window, they will constrain themselves to it. If you iconify the
  234. window, they will continue to run within the icon's image.
  235.  
  236. ANIMATN takes two optional arguments. The first argument is the number
  237. figures; this defaults to 2.  The second argument, if specified (e.g.,
  238. a dash), causes the figures to run on top of a background image.
  239.  
  240. ----------------------------------------------------------------------
  241.