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

SDL_GetRenderSafeArea

レンダラの現在の表示領域のセーフエリアを得る

ヘッダ

SDL3/SDL_render.h

構文

bool SDL_GetRenderSafeArea(SDL_Renderer *renderer, SDL_Rect *rect);

引数

SDL_Renderer *rendererレンダリングコンテキスト
SDL_Rect *rect相互作用のある要素に対して安全な領域の代入先へのポインタ

戻り値

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

詳細

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

スレッドセーフ

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

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_GetRenderSafeArea - SDL Wiki