bool SDL_GetClosestFullscreenDisplayMode(SDL_DisplayID displayID, int w, int h, float refresh_rate, bool include_high_density_modes, SDL_DisplayMode *closest);
| SDL_DisplayID | displayID | 問い合わせるディスプレイのインスタンスID |
| int | w | 要求するディスプレイモードの横ピクセル数 |
| int | h | 要求するディスプレイモードの縦ピクセル数 |
| float | refresh_rate | 要求するディスプレイモードの更新周期. 0.0fのときデスクトップの更新周期 |
| bool | include_high_density_modes | 検索に高密度モードを含めるか |
| SDL_DisplayMode * | closest | 要求と一致する, または要求よりも大きなモードの代入先へのポインタ |
(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.
利用可能なディスプレイモードが検索され, 要求と最も近いモードがclosestに代入される.
モードのformatとrefresh_rateが0の場合, デスクトップのモードとなる.
モードは, サイズを最優先で検索し, ピクセル形式は次の優先度となる. そして最後に更新周期をチェックする.
利用可能なモードが要求に対して小さすぎる場合, 偽を戻す.
この関数を呼べるのはメインスレッドのみである.