SDL_MouseButtonFlags SDL_GetGlobalMouseState(float *x, float *y);
| float * | x | 環境のカーソルのデスクトップの左上からのX座標の代入先のポインタ. NULLも可 |
| float * | y | 環境のカーソルのデスクトップの左上からのY座標の代入先のポインタ. NULLも可 |
(SDL_MouseButtonFlags) SDL_BUTTON_MASK(X)マクロで比較可能な32ビットのビットマスクによるボタンの状態を戻す.
この関数は動作環境に最新のマウスの状態を非同期に問い合わせる. これはSDL_GetMouseState()でSDLがキャッシュした状態を得るよりも高価である.
NULLでないポインタをxとyに渡すと, デスクトップ上のXとY座標が書き込まれる.
相対モードでは, 動作環境のマウスの位置と, SDL_GetMouseState()やSDL_GetWindowPosition()で得たSDLのマウスの位置は, 通常一致しない.
この関数は, ウィンドウの外のマウスを追跡する必要があり, SDL_CaptureMouse()では実現できない場合に有用になりうる. 例えば, ウィンドウをドラッグしている間もマウスを追跡する必要がある場合である. この場合, ウィンドウ上のマウスの座標は常に同期するとは限らない.
この関数を呼べるのはメインスレッドのみである.