目次 - SDL 3.0 API(機能別) - ディスプレイとウィンドウ - SDL_GetWindowSafeArea

SDL_GetWindowSafeArea

ウィンドウのセーフエリアを得る

ヘッダ

SDL3/SDL_video.h

構文

bool SDL_GetWindowSafeArea(SDL_Window *window, SDL_Rect *rect);

引数

SDL_Window *window調査するウィンドウ
SDL_Rect *rect相互作用のある要素に対して安全なクライアント領域の代入先へのポインタ

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す SDL_GetError()を呼んで詳細を知ることができる.

詳細

一部のデバイスは, スクリーン上のコントロール, 丸くなった角, カメラノッチ, 画面の見切れなどでスクリーンの一部が無効または不明瞭になっている. この関数で安全に相互作用を行えるウィンドウの領域を得られる. この領域の外もレンダリングを行うべきだが, 重要な情報や相互作用のある要素を配置すべきではない.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_GetWindowSafeArea - SDL Wiki