相對滑鼠移動和 CoreWindow

  • 發行項

在遊戲中，滑鼠是許多玩家熟悉的常用控制選項，對很多遊戲類型也是必要裝置，包括第一和第三人稱角度射擊，以及即時策略遊戲。 在本文中，我們將討論相對滑鼠控制項的實作，這不會使用系統游標，也不會傳回絕對螢幕座標；而是追蹤滑鼠移動之間的像素差異。

有些應用程式 (例如遊戲) 更常以滑鼠作為輸入裝置。 例如，3D 模組工具使用滑鼠時，可能會模擬虛擬軌跡球來定位 3D 物件；或者遊戲使用滑鼠時，會透過滑鼠的視角控制項，變更檢視相機的方向。

在這些案例中，應用程式需要相對滑鼠資料。 相對滑鼠值代表滑鼠自最後一格畫面以來移動的距離，而非視窗或畫面內的絕對 x-y 座標值。 此外，應用程式通常會隱藏滑鼠游標，因為對於操作 3D 物件或場景來說，游標相對於螢幕座標的位置並不相關。

當使用者採取動作，將應用程式移至相對 3D 物件/場景的操作模式，應用程式必須：

  • 忽略預設的滑鼠處理。
  • 啟用相對滑鼠處理。
  • 將滑鼠游標設為 null 指標 (nullptr)，即可隱藏滑鼠游標。

當使用者採取動作，將應用程式移出相對 3D 物件/場景的操作模式，應用程式必須：

  • 啟用預設/絕對滑鼠處理。
  • 關閉相對滑鼠處理。
  • 將滑鼠游標設為非 null 值 (使游標可見)。

注意
如果使用此模式，絕對滑鼠游標位置會保留在進入無游標相對模式時。 游標會重新出現在先前啟用相對滑鼠移動模式時，所在的同一個螢幕座標位置。

處理相對滑鼠移動

若要存取相對滑鼠差異值，請註冊 MouseDevice::MouseMoved 事件 (如這裡所示)。



// register handler for relative mouse movement events
Windows::Devices::Input::MouseDevice::GetForCurrentView()->MouseMoved +=
        ref new TypedEventHandler<MouseDevice^, MouseEventArgs^>(this, &MoveLookController::OnMouseMoved);





void MoveLookController::OnMouseMoved(
    _In_ Windows::Devices::Input::MouseDevice^ mouseDevice,
    _In_ Windows::Devices::Input::MouseEventArgs^ args
    )
{
    float2 pointerDelta;
    pointerDelta.x = static_cast<float>(args->MouseDelta.X);
    pointerDelta.y = static_cast<float>(args->MouseDelta.Y);

    float2 rotationDelta;
    rotationDelta = pointerDelta * ROTATION_GAIN;	// scale for control sensitivity

    // update our orientation based on the command
    m_pitch -= rotationDelta.y;						// mouse y increases down, but pitch increases up
    m_yaw   -= rotationDelta.x;						// yaw defined as CCW around y-axis

    // limit pitch to straight up or straight down
    float limit = (float)(M_PI/2) - 0.01f;
    m_pitch = (float) __max( -limit, m_pitch );
    m_pitch = (float) __min( +limit, m_pitch );

    // keep longitude in useful range by wrapping
    if ( m_yaw >  M_PI )
        m_yaw -= (float)M_PI*2;
    else if ( m_yaw < -M_PI )
        m_yaw += (float)M_PI*2;
}

此程式碼範例中的事件處理常式 OnMouseMoved 會根據滑鼠移動轉譯檢視。 滑鼠指標的位置會以 MouseEventArgs 物件形式傳遞至處理常式。

當應用程式變更為處理相對滑鼠移動值時，請略過處理來自 CoreWindow::PointerMoved 事件的絕對滑鼠資料。 不過，只有當 CoreWindow::PointerMoved 事件是產生自滑鼠輸入 (而非觸控輸入)，才能略過此輸入。 將 CoreWindow::PointerCursor 設為 nullptr 即可隱藏游標。

回到絕對滑鼠移動

一旦應用程式結束 3D 物件或場景操作模式，且不再使用相對滑鼠移動 (例如返回功能表畫面時)，則回到正常的絕對滑鼠移動處理方式。 此時請停止讀取相對滑鼠資料、重新開始處理標準滑鼠 (和指標) 事件，並將 CoreWindow::PointerCursor 設為非 null 值。

注意
當應用程式處於 3D 物件/場景操作模式 (處理相對滑鼠移動且滑鼠為關閉狀態)，滑鼠將無法叫用 Edge UI，例如：快速鍵、上一頁堆疊或應用程式列。 因此，請務必提供一個能結束此特定模式的機制，例如常用的 Esc 鍵。