osgGA.EventQueue

osgGA 命名空间中的 EventQueue 类提供了一个事件队列，它用于存储用户交互产生的事件，比如键盘事件和鼠标事件。通过使用事件队列，开发人员可以更好地管理和处理这些事件。

1. 构造函数

EventQueue();

构造函数创建一个新的事件队列。

2. 添加事件方法

void addEvent(const osgGA::GUIEventAdapter& ea);

该方法向事件队列中添加一个事件。ea 参数是一个 GUIEventAdapter 类型的引用，代表一个具体的事件，它可以是键盘事件或鼠标事件等。

除了 addEvent 方法，EventQueue 类还提供以下两个方法用于添加事件：

void addKeyEvent(int type, int key, int modKeyMask, double time = DBL_MAX);
void addMouseEvent(int type, int button = 0, float x = 0.0f, float y = 0.0f, double time = DBL_MAX);

其中，addKeyEvent 方法用于添加键盘事件，addMouseEvent 方法用于添加鼠标事件，它们的参数意义与 GUIEventAdapter 类中相应的方法相同。

3. 获取事件方法

osg::ref_ptr<osgGA::GUIEventAdapter> getNextEvent();

该方法从事件队列中获取下一个事件。如果事件队列为空，则返回 NULL。

4. 清空事件方法

void flush();

该方法清空事件队列，删除其中的所有事件。

5. 其他方法

在 EventQueue 类中还有一些其他的方法，用于查询事件队列的状态、设置事件队列的属性等。这些方法包括：

• int getNumEvents() const：获取事件队列中事件的数量。

• bool getKeyRepeat() const：获取键盘事件是否支持重复。

• void setKeyRepeat(bool value)：设置键盘事件是否支持重复。

• void setEventsEnabled(bool value)：启用或禁用事件队列中的事件。

• void setMouseYOrientation(osgGA::GUIEventAdapter::YOrientation value)：设置鼠标事件的 Y 轴方向。

• void setWindowRectangle(const osg::Viewport& vp)：设置此事件队列与发生事件的窗口大小。

6. 使用示例

以下是一个简单的示例，演示如何使用 EventQueue 类来处理鼠标事件：

osg::ref_ptr<osgGA::EventQueue> eq = new osgGA::EventQueue;
osg::Vec2d lastMousePos;

while (true)
{
   // 获取事件队列中的下一个事件
   osg::ref_ptr<osgGA::GUIEventAdapter> ea = eq->getNextEvent();

   // 处理鼠标移动事件
   if (ea.valid() && ea->getEventType() == osgGA::GUIEventAdapter::MOVE)
   {
      osg::Vec2d currPos(ea->getX(), ea->getY());
      if (lastMousePos != currPos) {
         // 处理鼠标移动事件...
         lastMousePos = currPos;
      }
   }

   // 添加新的鼠标事件到队列中
   osgGA::GUIEventAdapter newEA(osgGA::GUIEventAdapter::MOVE);
   newEA.setX(10);
   newEA.setY(20);
   eq->addEvent(newEA);
}