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

SDL_GetDisplayName

ディスプレイの名前をUTF-8文字列で得る

ヘッダ

SDL3/SDL_video.h

構文

const char * SDL_GetDisplayName(SDL_DisplayID displayID);

引数

SDL_DisplayIDdisplayID問い合わせるディスプレイ

戻り値

(const char *) ディスプレイの名前を戻す. 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

サンプルコード

// サンプルプログラム:
// SDL3で検知したディスプレイの名前をログに出力する

#include <SDL3/SDL_log.h>
#include <SDL3/SDL_main.h>
#include <SDL3/SDL_video.h>

int
main(int argc, char** argv)
{
  if (!SDL_Init(SDL_INIT_VIDEO)) {
    SDL_Log("SDLを初期化できなかった: %s", SDL_GetError());
    return 0;
  }

  int num_displays;
  SDL_DisplayID *displays = SDL_GetDisplays(&num_displays);

  for(int i = 0; i < num_displays; i++) {
    SDL_Log("検知したディスプレイ '%s'", SDL_GetDisplayName(displays[i]));
  }

  SDL_free(displays);

  return 0;
}

関連項目

SDL Wikiへのリンク

SDL_GetDisplayName - SDL Wiki