OgreMouseEvent.h

Go to the documentation of this file.

/*
-----------------------------------------------------------------------------
This source file is part of OGRE
    (Object-oriented Graphics Rendering Engine)
For the latest info, see http://www.ogre3d.org/

Copyright (c) 2000-2005 The OGRE Team
Also see acknowledgements in Readme.html

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General  License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Lesser General  License for more details.

You should have received a copy of the GNU Lesser General  License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place - Suite 330, Boston, MA 02111-1307, USA, or go to
http://www.gnu.org/copyleft/lesser.txt.
-----------------------------------------------------------------------------
*/
/***************************************************************************
OgreMouseEvent.h  -  
 * An event which indicates that a mouse action occurred in a MouseTarget (e.g. MouseTarget).
 * This event is used both for mouse events (click, enter, exit) and mouse 
 * motion events (moves and drags). 
 * <P>
 * This low-level event is generated by a MouseTarget object for:
 * <ul>
 * <li>Mouse Events
 *     <ul>
 *     <li>a mouse button is pressed
 *     <li>a mouse button is released
 *     <li>a mouse button is clicked (pressed and released)
 *     <li>the mouse cursor enters a MouseTarget
 *     <li>the mouse cursor exits a MouseTarget
 *     </ul>
 * <li> Mouse Motion Events
 *     <ul>
 *     <li>the mouse is moved
 *     <li>the mouse is dragged
 *     </ul>
 * </ul>
 * <P>
 * A MouseEvent object is passed to every MouseListener
 * object which registered to receive 
 * the "interesting" mouse events using MouseTarget's 
 * <code>addMouseListener</code> method.
 *
 * A MouseEvent object is also passed to every MouseMotionListener
 * object which registered to receive 
 * mouse motion events using the MouseTarget's addMouseMotionListener
 * method
 *
 * When a mouse button is clicked, events are generated and sent to the
 * registered MouseListeners, with the button mask set in the modifier field.
 * For example, if the first mouse button is pressed, events are sent in the
 * following order:
 * <PRE>
 *    MOUSE_PRESSED:  BUTTON1_MASK
 *    MOUSE_RELEASED: BUTTON1_MASK
 *    MOUSE_CLICKED:  BUTTON1_MASK
 * </PRE>
 * When multiple mouse buttons are pressed, each press, release, and click
 * results in a separate event. The button mask in the modifier field reflects
 * only the button that changed state, not the current state of all buttons.
 * <P> 
 * For example, if the user presses button 1 followed by button 2 and
 * releases them in the same order, the following sequence of events is
 * generated:
 * <PRE>
 *    MOUSE_PRESSED:  BUTTON1_MASK
 *    MOUSE_PRESSED:  BUTTON2_MASK
 *    MOUSE_RELEASED: BUTTON1_MASK
 *    MOUSE_CLICKED:  BUTTON1_MASK
 *    MOUSE_RELEASED: BUTTON2_MASK
 *    MOUSE_CLICKED:  BUTTON2_MASK
 * </PRE>
 * If button2 is released first, the MOUSE_RELEASED/MOUSE_CLICKED pair
 * for BUTTON2_MASK arrives first, followed by the pair for BUTTON1_MASK.
 *
-------------------
begin                : Dec 03 2002
copyright            : (C) 2002 by Kenny Sabir
email                : kenny@sparksuit.com
***************************************************************************/
#ifndef __MouseEvent_H__
#define __MouseEvent_H__

#include "OgrePrerequisites.h"
#include "OgreInputEvent.h"

namespace Ogre {

    class _OgreExport MouseEvent : public InputEvent
    {
    protected:
        Real mX;
        Real mY;

        Real mZ;


        Real mRelX;
        Real mRelY;
        Real mRelZ;

        int mButtonID;
        int mClickCount;




    public:

        enum
        {
            ME_FIRST_EVENT = 500,
            ME_LAST_EVENT = 510
        };

        enum 
        {
            ME_MOUSE_CLICKED    = ME_FIRST_EVENT,
            ME_MOUSE_PRESSED,
            ME_MOUSE_RELEASED,
            ME_MOUSE_MOVED,
            ME_MOUSE_ENTERED,
            ME_MOUSE_EXITED,
            ME_MOUSE_DRAGGED,

      ME_MOUSE_DRAGENTERED,
      ME_MOUSE_DRAGEXITED,
      ME_MOUSE_DRAGMOVED,
      ME_MOUSE_DRAGDROPPED
        };

        MouseEvent(PositionTarget* source, int id, int whichButton, Real when, int modifiers,
            Real x, Real y, Real z, int clickCount);

        MouseEvent(PositionTarget* source, int id, int whichButton, Real when, int modifiers,
            Real x, Real y, Real z, Real relx, Real rely, Real relz, int clickCount);
        
         int getClickCount();

         Real getX() const;

         Real getY() const;

         Real getZ() const;

         Real getRelX() const {return mRelX;}
         
         Real getRelY() const {return mRelY;}
         
         Real getRelZ() const {return mRelZ;}

         String paramString() const;

         void translatePoint(Real x, Real y);

         int getButtonID() const;
    };


}


#endif 

---

Copyright © 2000-2005 by The OGRE Team

This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.
Last modified Sun Mar 12 14:37:44 2006