home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C++ / Frameworks / GameShell / GameShell Services.doc < prev    next >
Encoding:
Text File  |  1995-12-03  |  2.2 KB  |  51 lines  |  [TEXT/CWIE]
  1. GameShell Behaviors/Services
  2. Version 1.0
  3. Hiep Dam
  4. starlabs@aol.com
  5. 12/3/95
  6.  
  7.  
  8. •) Provide automatic main window (mandatory)
  9.     * You must supply the address to an update function. It will
  10.     be called whenever an update event is generated for the main window.
  11.  
  12. •) Provide automatic mouse handling (mandatory)
  13.     * You must supply the address to a mouse handler function. It will be
  14.     called, with the mouse loc in local coords, whenever the mouse is
  15.     clicked in the main window.
  16.  
  17.  
  18.  
  19. •) Backdrop window (optional)
  20.     * A backdrop window will be created if the main window is smaller than the
  21.     monitor it appears on. The backdrop window will be filled with black. You
  22.     need not worry anything about the window; GameShell will automatically take
  23.     care of everything having to do with the backdrop window, including updates.
  24.  
  25. •) Blackout windows (optional)
  26.     * If more than one monitor is attached, all other monitors that are not
  27.     used will be "blacked-out"; i.e. a window will be created for each monitor
  28.     and then the window will be filled with black.
  29.  
  30. •) Menu initialization and handling (optional)
  31.     * You supply function pointers to a menu init function and a menu handler
  32.     function. Everything else (i.e. mouse hits in the menu bar, hiding and
  33.     showing the menubar, etc) will be handled by GameShell. When appropriate,
  34.     your menu handler will be called.
  35.     If your game does not use menus, you need not use these features.
  36.  
  37. •) Menu bar hiding/showing (optional)
  38.     * If the user clicks in the area normally associated with the menu, it will
  39.     appear. Once the mouse moves away from the menu bar, it will be hidden
  40.     again.
  41.     * If an item is chosen, right after it's chosen the menu bar will be hidden
  42.     again, automatically. Also, any menu hiliting is also handled automatically.
  43.     * Your responsibility is just to decode the menu argument and handle the
  44.     menu item chosen (done in your menu handler function, called by GameShell).
  45.  
  46.  
  47. Notes:
  48.     GameShell will also behave appropriately if the user should switch applications.
  49.     The game's windows will be hidden, and the menubar will be restored. When
  50.     the user switches back to GameShell, the windows will be shown again and the
  51.     menubar hidden. One less hassle the game programmer has to deal with!