目次 - SDL 3.0 API(機能別) - 2Dレンダリング - SDL_ConvertEventToRenderCoordinates

SDL_ConvertEventToRenderCoordinates

イベント構造体の座標をレンダリングの座標に変換する

ヘッダ

SDL3/SDL_render.h

構文

bool SDL_ConvertEventToRenderCoordinates(SDL_Renderer *renderer, SDL_Event *event);

引数

SDL_Renderer *rendererレンダリングコンテキスト
SDL_Event *event変換するイベント

戻り値

(bool) イベントが変換された, または変更の必要がないとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

これはいくつかの状態を考慮する:

この関数で様々な種類(マウス, タッチ, ペンなど)のイベントを変換できる.

タッチ座標は, ウィンドウで正規化された座標から, 正規化されていないレンダリング座標に変換される.

相対マウス座標(イベントのxrel, yrelフィールド)も変換される. このフィールドを変換したくないアプリケーションは, SDL_RenderCoordinatesFromWindow()でイベント構造体全体ではなく特定のフィールドのみを変換する必要がある.

変換の結果, 座標がレンダリング領域の範囲外になる可能性がある.

スレッドセーフ

この関数を呼べるのはメインスレッドのみである.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_ConvertEventToRenderCoordinates - SDL Wiki