目次 - SDL 3.0 API(機能別) - 領域 - SDL_PointInRect

SDL_PointInRect

点が長方形の内側にあるかチェックする

ヘッダ

SDL3/SDL_rect.h

構文

SDL_FORCE_INLINE bool SDL_PointInRect(const SDL_Point *p, const SDL_Rect *r);

引数

const SDL_Point *pチェックする点
const SDL_Rect *rチェックする長方形

戻り値

(bool) prの内側にあるとき真, そうでないとき偽を戻す.

詳細

prのどちらもNULLでなく, かつpのXとYが長方形の左上以上で, かつ長方形のX+WとY+H未満のとき, 点は長方形の内側にあるとみなされる. そのため, 1×1の長方形の(0,0)は「内側」だが, (0,1)はそうではない.

この関数はヘッダにある強制インライン関数で, SDLライブラリのパブリックAPI関数として有効ではないので注意すること. (言い換えると, このコードは呼び出したプログラムに組み込まれるので, リンカや動的ローダはSDL内部にこの関数を見つけることができない.)

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_PointInRect - SDL Wiki