osgGA.GUIEventAdapter

OpenSceneGraph是一个用于创建实时3D应用程序的开源图形引擎。osgGA.GUIEventAdapter是OpenSceneGraph中的一个重要类，用于处理交互事件和GUI事件。

1. 概述

osgGA.GUIEventAdapter是OpenSceneGraph中的一个事件适配器类。它负责处理鼠标、键盘和其他用户输入事件，并将其传递给应用程序的其他部分。

osgGA.GUIEventAdapter继承自osgGA.InputEventAdapter类。InputEventAdapter类是osgGA.GUIEventAdapter的基类，用于处理输入事件并向适当的事件处理程序发送消息。

osgGA.GUIEventAdapter处理用户输入事件时，将其分为两类：零时事件和非零时事件。零时事件发生时，osgGA.GUIEventAdapter会将事件立即发送给应用程序的事件处理程序。非零时事件会在每个帧之间存储起来，等待应用程序来提取它们。

2. 常用方法

osgGA.GUIEventAdapter类中包含了很多常用的方法，下面列举一些常用的方法：

getEventType()

获取事件类型，返回值为osgGA.GUIEventAdapter::EventType枚举类型。

getButton()

获取鼠标事件的按钮值，返回值为osgGA.GUIEventAdapter::MouseButton枚举类型。

getX()

获取鼠标的x轴坐标。

getY()

获取鼠标的y轴坐标。

getKey()

获取键盘事件的键值，返回值为osgGA.GUIEventAdapter::KeySymbol枚举类型。

getModifierMask()

获取键盘事件的修饰键值，返回值为osgGA.GUIEventAdapter::ModKeyMask类型。

getMouseYOrientation()

获取鼠标纵向方向。

3. 示例

下面是一个使用osgGA.GUIEventAdapter的简单示例：

#include <osgViewer/Viewer>
#include <osgGA/GUIEventHandler>
#include <osgGA/GUIEventAdapter>

class EventHandler : public osgGA::GUIEventHandler
{
public:
    virtual bool handle(const osgGA::GUIEventAdapter& ea, osgGA::GUIActionAdapter& aa)
    {
        if (ea.getEventType() == osgGA::GUIEventAdapter::KEYDOWN)
        {
            std::cout << "Key " << ea.getKey() << " pressed." << std::endl;
            return true;
        }
        return false;
    }
};

int main()
{
    osgViewer::Viewer viewer;
    viewer.setSceneData(/* Your scene data */);
    viewer.addEventHandler(new EventHandler());
    viewer.run();
    return 0;
}

上面的示例中，我们创建了一个名为EventHandler的类，继承自osgGA::GUIEventHandler，重写了handle()方法。在handle()方法中，我们通过osgGA.GUIEventAdapter类的getEventType()方法获取事件类型，如果是键盘的按下事件，就输出相应的信息。

在main()函数中，我们将这个事件处理程序添加到osgViewer::Viewer对象中，并运行Viewer。这里的/* Your scene data */需要替换为您的场景数据。