home *** CD-ROM | disk | FTP | other *** search
/ C/C++ User's Journal & Wi…eveloper's Journal Tools / C-C__Users_Journal_and_Windows_Developers_Journal_Tools_1997.iso / zincmeta / readme.1st
Encoding:
Text File  |  1996-10-21  |  9.6 KB  |  215 lines
  1.                        smxKey32 (Zinc) Demonstration                10/21/96
  2.    
  3.    *** PRINT THESE NOTES so you can read them as you run the demos
  4.    --------------------------------------------------------------------------
  5.    
  6.    Requirements:
  7.       386 or higher
  8.       2MB of extended memory or more
  9.       IDE drive C: with at least 4MB free
  10.       VGA display (or at least one capable of running in graphics mode)
  11.       
  12.    Installation:
  13.       Change directory to the root directory of your C: drive
  14.       Put this Demo Disk in drive X:
  15.       Type   "pkunzip -d X:zincdemo"
  16.       to uncompress files onto your C: drive
  17.       This will create the following directories in your root:
  18.          \METAWNDO
  19.          \ZINCDEMO
  20.       (if you already have directories with these names, please rename
  21.       them temporarily when running the demos. When done, you may erase
  22.       these directories and put yours back.)
  23.    
  24.       IMPORTANT: These directories must be in the root and you must not
  25.       change their names or the demos will not run, since they are hard-coded
  26.       to look in certain paths for files.
  27.    
  28.    Running the Zinc/smx Demos:
  29.       1. Boot to DOS, using stripped-down autoexec.bat and config.sys files
  30.          that don't load memory managers such as EMM386.SYS
  31.       2. Change to the \ZINCDEMO directory.
  32.       3. Exit from any DOS shells such as Norton Commander (or boot without
  33.          loading them).
  34.       4. Type "demo match" to run the MATCH demo.
  35.    
  36.       What You Should See:
  37.        - The demo file is quickly copied to the root (as ~app.exe)
  38.        - The screen will switch to graphics mode (a message will flash
  39.          by indicating that MetaWINDOW has done this).
  40.        - Then, the screen will be solid blue-gray for a while, as the demo
  41.          is initializing and loading data from disk.
  42.        - After a delay, you will see a Window pop up in the middle of the
  43.          screen with rows of "cards" -- this is the Concentration game.
  44.        - Use the keyboard cursor keys to move the selection. Press spacebar
  45.          or Enter to turn over the card. See below for more about the demos.
  46.        - When you exit (F3), you will see the C:\> prompt.
  47.   
  48.       SEE THE TROUBLESHOOTING SECTION AT THE END IF YOU HAVE ANY PROBLEMS.
  49.  
  50.       A mouse driver has not been implemented for smxKey yet (we're working
  51.       on it), so you will have to use the keyboard (sorry).
  52.  
  53.  
  54.    Useful Keys for the Demos:
  55.       Alt-F6      move to different window
  56.       F10         system menu: move, resize, minimize, etc. the window
  57.       F3          exit, close window
  58.       F1          help (when available)
  59.       Arrow Keys  move cursor, move to different fields and buttons
  60.       Tab         move to next field
  61.                   
  62.    
  63.    To Run the Other Demos:
  64.       The demo to run is specified by the parameter to DEMO.BAT.
  65.       Type "demo" for a list of valid choices.
  66.    
  67.    
  68.    About the Demos
  69.    ===============
  70.    
  71.    MATCH:
  72.    
  73.    This is a running version of the zinc 4.2 example program "MATCH"
  74.    which is basically a version of the popular game known as "Concentration".
  75.    It runs under smx and pmEasy 32 bit versions, compiled with the Borland C++
  76.    compiler, using zinc 4.2 and MetaWINDOW/386 v 5.0b.
  77.    
  78.    Rules of the game:
  79.       Use arrow keys to select your "card" and hit <Enter> or <Space> key to 
  80.       flip the card. You may flip any two cards at a time.  If the images 
  81.       match then the cards are removed.  If they don't match then the cards 
  82.       are flipped back over by the program.  The object of the game is to 
  83.       remove all of the cards by matching. (No, there is no score and you 
  84.       don't get any congratulations for finishing.)
  85.    
  86.    To exit the program press <F3>, <Alt-F4>, or select exit from the menu
  87.    (Alt-G, X).
  88.    
  89.    We have supplied the zinc code for this program example which has been 
  90.    slightly modified to work under smx. The only change is to use the smx 
  91.    timer device, UID_XTIMER, which is a derivative of the zinc timer device, 
  92.    UID_TIMER. This demonstrates how easy it is to port moderately complex 
  93.    zinc application code from other operating systems to smx.
  94.    
  95.    This means that you can design and test your user interface with zinc 
  96.    designer on your development computer under DOS or Windows and then, 
  97.    with minimal modifications, you can port that code to run on your target 
  98.    system with smx.
  99.    
  100.    GRAPH:
  101.    
  102.    This demo shows 4 windows with different types of graphs in them. Use
  103.    Alt-F6 to switch windows. To Move or Size a window, press F10 for the
  104.    system menu. Use the cursor keys to move/resize. When done, press Enter.
  105.    Source code for this example is provided in the GRAPH directory.
  106.    
  107.    HELLO:
  108.    
  109.    The help system is demonstrated in this demo. Press F1 to bring up the
  110.    help screen. Tab and space move around in it and select different topics.
  111.    
  112.    This demo also demonstrates the error system. Type a different number
  113.    in place of "42" and tab off the field. You will get an error message.
  114.  
  115.    Use the tab key to move between fields.
  116.    
  117.    METADEMO:
  118.    
  119.    This one demonstrates some of the capabilites of MetaWINDOW, alone. 
  120.    This shows our protosystem with a few tasks displaying their output in 
  121.    graphics mode rather than in text mode. Also, the metaworld demo 
  122.    (METWORLD.C) is run on the right side of the screen, which displays a 
  123.    few common shapes.  Use the arrow keys to move the blue box around on 
  124.    the screen. Note that as you move the box, fine black lines are left
  125.    in the text and shapes on the screen, since they are not redrawn when
  126.    the box moves.
  127.    
  128.    
  129.    No modifications were made to HELLO or GRAPH to get them working under
  130.    smxKey. Only one modification to MATCH was necessary: changed UID_TIMER
  131.    to UID_XTIMER. The Windows versions of the demos (wmatch.exe, wgraph.exe,
  132.    whello3.exe) are provided to show that the same Zinc application code
  133.    that works under Windows will also work under smx.
  134.    
  135.  
  136.    Running the Same Demos under Windows
  137.    ====================================
  138.  
  139.       Reboot with your normal autoexec.bat and config.sys
  140.       From the Program Manager, select File, then Run from the menu.
  141.       Type the path and name of the demo to run:
  142.          c:\ZINCDEMO\wmatch.exe
  143.          c:\ZINCDEMO\whello3.exe
  144.          c:\ZINCDEMO\wgraph.exe
  145.       Repeat for the other demos.
  146.  
  147.    
  148.    Troubleshooting
  149.    ===============
  150.  
  151.    - MetaWINDOW error code -6 when GRAFMODE.EXE runs is most likely due to
  152.      the METAPATH environment variable not being set. Put a pause statement 
  153.      in DEMO.BAT after the SET command to see if "Out of Environment Space" 
  154.      appears on the screen. If so, the problem is either that you really are 
  155.      out of environment space or you are running a DOS shell, such as 
  156.      Norton Commander which prevents you from setting environment variables.
  157.         1. To increase your environment space, use the "/e:" command
  158.            for shell in your config.sys file:
  159.                       shell=c:\dos\command.com/p/e:1024
  160.         2. Quit Norton Commander or any similar package you are running.
  161.    
  162.    - If the screen goes blank for a while, then comes back to DOS, the 
  163.      problem is most likely that you did not install the files to the proper 
  164.      directories or you moved files. Keep all files where they are after 
  165.      installation.  You must have
  166.         \METAWNDO
  167.         \ZINCDEMO
  168.      in your root of drive C, and drive C must be an IDE drive. You may not 
  169.      run these demos from another drive or change the paths in any way, 
  170.      since data is loaded at run-time, and the demos are hard-coded to look 
  171.      for it in particular places.
  172.    
  173.    - It is also possible that pmEasy is having trouble reading from your 
  174.      hard disks for some reason. Some IDE drives may be a problem.
  175.      Try running on a different system.
  176.    
  177.    - Ensure that you are booting "clean". We suggest you create special 
  178.      autoexec.bat and config.sys files that do the absolute minimum that 
  179.      is necessary to boot your system. Particularly, they must not load 
  180.      memory managers, such as EMM386.EXE. Also, don't try to run from a DOS 
  181.      box in Windows or other protected mode operating system!
  182.  
  183.    - If you find that you are unable to run another demo or other program
  184.      after running a demo, you may need to reboot the computer. The demos
  185.      access drive C: using smxFile and pmEasy, and these accesses may
  186.      cause DOS to return in a confused state.
  187.     
  188.    - The main cause of difficulty in determining what is going wrong is
  189.      the screen switch to graphics mode. The problem is that pmEasy displays
  190.      to text video memory, so you see no output! Because of this, you cannot 
  191.      see whether pmEasy is hung up, or the Zinc demo application is hung up.
  192.    
  193.    - If the demos run, but the keyboard does not respond correctly, ensure 
  194.      that NumLock and CapsLock are off and start the demo over again.
  195.    
  196.    - Demo aborts after a while (maybe 20 minutes or so). This demo disk uses 
  197.      a run-limited version of pmEasy. Restart the demo.
  198.  
  199.    - A simpler, standard 386 or 486 system may work better for running
  200.      the demos than a high-end desktop machine with special hardware,
  201.      such as special disk controllers or graphics boards. We do not know
  202.      of any particular problems, but this is a tip to keep in mind if
  203.      you have problems running these demos on your computer.
  204.  
  205.    - Call us if you have trouble!
  206.  
  207.  
  208.    To Un-Install the Demos
  209.    =======================
  210.  
  211.       Delete the \METAWNDO and \ZINCDEMO directories
  212.       Delete ~app.exe from the root.
  213.  
  214.  
  215.