text: //-----------------------------------------------------------------------------
  // Copyright (c) 2013 GarageGames, LLC
  //
  // Permission is hereby granted, free of charge, to any person obtaining a copy
  // of this software and associated documentation files (the "Software"), to
  // deal in the Software without restriction, including without limitation the
  // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  // sell copies of the Software, and to permit persons to whom the Software is
  // furnished to do so, subject to the following conditions:
  //
  // The above copyright notice and this permission notice shall be included in
  // all copies or substantial portions of the Software.
  //
  // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  // IN THE SOFTWARE.
  //-----------------------------------------------------------------------------
  
  #ifndef MAC_CARB_EVENTS_H
  #define MAC_CARB_EVENTS_H
  
  /// Hides the mouse cursor when the mouse is locked, when we are in fullscreen
  /// mode, and when the cursor is inside the window bounds.
  /// Optionally takes the cursor location, in window local coords.
  //void AndroidCheckHideCursor(S32 x=-1, S32 y=-1);
  
  /// Hides or shows the system mouse cursor, regardless of the mouse position,
  /// and tracks the hidden state.
  //void AndroidSetHideCursor(bool shouldHide);
  
  /// Install event loop timer, replacing any existing event loop timer.
  /// This is useful for updating the sleep time
  void AndroidRunEventLoopTimer(S32 intervalMs);
  
  /// Install event handlers on the current window & on the app.
  void AndroidInstallCarbonEventHandlers(void);
  
  /// Remove all event handlers, except the alert event handlers.
  void AndroidRemoveCarbonEventHandlers(void);
  
  /// Install event handlers for custom Torque inter-thread communication.
  ///  This must be called before starting multithreaded execution in main().
  void AndroidInstallTorqueCarbonEventHandlers(void);
  
  /// Handle an HICommand that comes from a native MacOSX menu.
  /// Returns false if the command can't be handled.
  bool AndroidHandleMenuCommand(void* hiCommand);
  
  /// create an event of class kEventClassTorque, and send it to the main thread
  void AndroidSendTorqueEventToMain( U32 eventKind, void* userData = NULL );
  
  /// event type for alerts. The event class is an arbitrary val, it must not collide w/ kEventApp* .
  const U32 kEventClassTorque   = ('T' * 0x1000000 + 'O' * 0x10000 + 'R' * 0x100 + 'Q'); //'TORQ';
  const U32 kEventTorqueAlert   = 1;
  const U32 kEventTorqueFadeInWindow = 2;
  const U32 kEventTorqueFadeOutWindow = 3;
  const U32 kEventTorqueReleaseWindow = 4;
  const U32 kEventTorqueShowMenuBar = 5;
  const U32 kEventTorqueModalDialog = 6;
  const U32 kEventTorqueDrawMenuBar = 7;
  
  const U32 kEventParamTorqueData           = ('t' * 0x1000000 + 'D' * 0x10000 + 'A' * 0x100 + 'T'); //'tDAT'; // typeVoidPtr void*
  //const U32 kEventParamTorqueSemaphorePtr   = 'tSEM'; // typeVoidPtr void*
  //const U32 kEventParamTorqueDialogRef      = 'tDRF'; // typeDialogRef DialogRef
  //const U32 kEventParamTorqueHitPtr         = 'tHIT'; // typeVoidPtr U32*
  //const U32 typeDialogRef                   = 'dlog'; // oddly, not provided in Frameworks.
  
  
  // this command id is used for all dynamically created menus.
  const U32 kHICommandTorque = ('T' * 0x1000000 + 'O' * 0x10000 + 'R' * 0x100 + 'Q'); //'TORQ';
  
  #endif
  