[Crystal-cvs] CVS update: CS/include/cssys/win32

[Eric S. <sun...@us...>]

Date:	Sunday August 26, 2001 @ 6:54
Author:	sunshine

Update of /cvsroot/crystal/CS/include/cssys/win32
In directory usw-pr-cvs1:/tmp/cvs-serv17648/include/cssys/win32

Modified Files:
	win32.h 
Log Message:
Eric Sunshine made the following changes to the project:

-*- Removed all event related code and functionality from csSystemDriver
    and the cssys library as part of the continuing effort to eliminate
    the monolithic system driver concept.  All event related functionality
    has been generalized and moved into the csutil library.

-*- Rather than the system driver being responsible for event related
    activities, an object of type iEventQueue is now available to clients
    via the shared object registry (iObjectRegistry) and is registered
    with the name "crystalspace.event.queue".

-*- Added new SCF interface iEventQueue.  All event-related activities in
    CS are now performed by interacting with an object implementing this
    interface.  Everything related to a particular event queue is now
    maintained by that queue rather than being manually maintained by the
    system driver.  Examples of ancillary functions and objects now
    maintained by the event queue include event outlets, event cords, and
    event handlers.  iEventQueue provides the following main functions
    (along with some other minor ones):

    - Process(); Processes the event queue, dispatching each contained
      event to the appropriate event handler.  Also responsible for
      sending the cscmdPreProcess and cscmdPostProcess events to
      interested listeners.  This method takes over all the major
      functionality which used to be handled by iSystem::NextFrame().
      Re-implemented iSystem::NextFrame() as a very thin cover over this
      method.

    - Dispatch(); Actually dispatches each event retrieved from the queue
      by Process().  This method takes over all the major functionality
      which used to be handled by iSystem::HandleEvent().

    - RegisterListener(); Entities interested in listening for events
      register with the event queue via this method.  This replaces the
      old iSystem::CallOnEvents() method.  Also added RemoveListener() to
      provide a way for entities to stop listening; and
      ChangeListenerTrigger() to provide a way for entities to alter the
      set of event types in which they are interested.

    - CreateEventOutlet(); Returns a new event outlet to the caller.
      Replaces iSystem::CreateEventOutlet().

    - GetEventOutlet(); Returns the shared event outlet for this
      particular event queue (for those cases where creating a new one is
      overkill).  Replaces iSystem::GetSystemEventOutlet().

    - GetEventCord(); Returns the event cord for a particular category and
      subcategory.  Replaces iSystem::GetEventCord().

-*- The system driver now registers itself as an event listener with the
    shared event queue just like all other modules which are interested in
    events.  This allows csSystemDriver to listen for the cscmdQuit event
    in order to set its `Shutdown' variable appropriately.  It also allows
    the HandleEvent() method in subclasses of csSystemDriver to function
    as expected.  Note that this is a merely a temporary state of affairs,
    as the system driver will soon cease to exist.

-*- Converted all applications, plugin modules, and other support code to
    work with the new event system organization.

-*- Because the generic input drivers, csKeyboardDriver, csMouseDriver,
    and csJoystrickDriver, are tied closely to event outlets, they were
    also moved from cssys to csutil.

-*- The generic input drivers, csKeyboardDriver, csMouseDriver, and
    csJoystrickDriver, are themselves now responsible for listening for
    the cscmdFocusChanged event, rather than relying upon the system
    driver to do so on their behalf.

-*- Added new SCF interfaces: iKeyboardDriver, iMouseDriver,
    iJoystickDriver.

-*- Objects implementing iKeyboardDriver, iMouseDriver, and
    iJoystickDriver are now made available via the shared object registry
    (iObjectRegistry) under the following names, respectively:

    crystalspace.driver.input.generic.keyboard
    crystalspace.driver.input.generic.mouse
    crystalspace.driver.input.generic.joystick

-*- Converted all applications and plugin modules to access the generic
    drivers directly from the shared object registry rather than calling
    upon iSystem methods to interact with these objects.  Removed all
    knowledge of these drivers from iSystem and csSystemDriver.

-*- Moved the utility functions csParseKeyDef() and csGetKeyDesc() in
    cskeys.h and cskeys.cpp from cssys to csutil since they are totally
    generic and have no platform-specific bindings.

-*- Fixed a nasty bug in csEventCord where it failed to unlock itself in
    some cases when posting an event.

-*- Fixed a bad bug in csEventCord where it was leaking all events posted
    to it.

-*- Fixed broken logic in iObjectRegistry::Unregister() where it did not
    actually remove the entry for the object, but instead just left a
    dangling (and potentially) dead pointer.

-*- iObjectRegistry implementation now correctly reference counts the
    contained objects.  It also now protects itself against modification
    during its own destruction, since some of the objects which it is
    removing from itself might also get destroyed and might try modifying
    the registry.

-*- Moved mouse driver settings out of system.cfg and into mouse.cfg.
    csMouseDriver is now responsible for accessing these settings itself
    rather than relying upon the system driver to do so.

-*- Fixed bug in definition of SCF_IMPLEMENT_IBASE table for
    csSystemDriver.  The table neglected to mention that csSystemDriver
    implements iObjectRegistry and iPluginManager.  Added mention of
    iPlugin which csSystemDriver now implements so that it can listen for
    events from the event queue.

-*- Eliminated compilation warnings in aseie.cpp, dxfie.cpp, hrcie.cpp,
    ivie.cpp, objie.cpp, povie.cpp, smfie.cpp, stlaie.cpp, and vlaie.cpp
    about non-virtual destructor.

-*- Eliminated compilation warning about unused variable in md2ie.cpp.
    Also fixed a memory leak.

-*- Eliminated compilation warning about `float' assigned to `int' in
    spr2d.cpp.

-*- Fixed broken header-protection macros in intarray.h.

-*- Fixed g2dtest so that it once again actually displays a window.  This
    had been broken for quite some time.

-*- csSchedule no longer unnecessarily depends upon the system driver.

-*- csSchedule no longer publishes its private utility class.

-*- The cssys library no longer relies upon the csgeom library.

-*- Eliminated several compilation warnings from AWS.  Worked around a
    couple NextStep compiler shortcomings.

-*- Rewrote csRectRegion in csgeom so that it no longer relies upon the
    csutil library.  I think it is best if we keep csgeom free of any
    csutil dependencies.

-*- Fixed csRectRegion so that, at destruction time, it no longer leaks
    each of the csRect structures in its `region' list.

-*- Fixed the comment-style in csrectrg.h so that Doxygen will produce
    proper documentation for csRectRegion.

-*- Repaired some overfull and underfull `hbox' warnings reported by TeX
    for tutorial/wincvs/step1.txi.

-*- Finally, note that I eliminated quite a few unnecessary #include
    directives from the event-related headers and from isys/system.h &
    cssys/system.h.  Since I am unable to test-compile every single port
    of CS and every driver, port maintainers may have to add an #include
    statement here and there in platform-specific and/or driver-specific
    code.