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

# SDL_GetDisplayMode

利用可能なディスプレイモードの一覧からディスプレイモードを得る

## 構文

`int SDL_GetDisplayMode(int displayIndex, int modeIndex, SDL_DisplayMode* mode)`

## 引数

displayIndex | 調査するディスプレイの番号
modeIndex | ディスプレイモードの番号
mode | modeIndexのディスプレイモードを代入するSDL_DisplayModeのポインタ

## 戻り値

成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()を呼んで詳細を知ることができる.

## サンプルコード

``

        int display_count = 0, display_index = 0, mode_index = 0;
        SDL_DisplayMode mode = { SDL_PIXELFORMAT_UNKNOWN, 0, 0, 0, 0 };

        if ((display_count = SDL_GetNumVideoDisplays()) < 1) {
            SDL_Log("SDL_GetNumVideoDisplays の戻り値: %i", display_count);
            return 1;
        }

        if (SDL_GetDisplayMode(display_index, mode_index, &mode) != 0) {
            SDL_Log("SDL_GetDisplayMode 失敗: %s", SDL_GetError());
            return 1;
        }
        SDL_Log("SDL_GetDisplayMode(0, 0, &mode):\t\t%i bpp\t%i x %i",
        SDL_BITSPERPIXEL(mode.format), mode.w, mode.h);

## 詳細

ディスプレイモードの一覧は次の順位で並んでいる

- 幅 大きい→小さい
- 高さ 大きい→小さい
- 色数 多い→少ない
- 圧縮ピクセル 最大→最小
- 更新周期 高い→低い

## バージョン

SDL 2.0.0以降

## 関連項目(関数)

SDL_GetNumDisplayModes

## SDL Wikiへのリンク

SDL_GetDisplayMode - SDL Wiki