目次 - API(機能別) - ゲームコントローラー - SDL_GameControllerMapping

SDL_GameControllerMapping

ゲームコントローラーの現在のマッピングを得る

構文

char* SDL_GameControllerMapping(SDL_GameController* gamecontroller)

引数

gamecontrollerマッピングを得るゲームコントローラー

戻り値

ゲームコントローラーのマッピング文字列を戻す. NULLのときマッピングは使えない. SDL_GetError()で詳細を知ることができる.

サンプルコード

#include "SDL.h"

/* ... */

SDL_GameController *ctrl;
int i;

SDL_Init(SDL_INIT_GAMECONTROLLER);

for (i = 0; i < SDL_NumJoysticks(); ++i) {
    if (SDL_IsGameController(i)) {
        char *mapping;
        SDL_Log("\'%d\'番はジョイスティック互換のコントローラ, 名称は\'%s\'", i, SDL_GameControllerNameForIndex(i));
        ctrl = SDL_GameControllerOpen(i);
        mapping = SDL_GameControllerMapping(ctrl);
        SDL_Log("コントローラ %i は \"%s\" にマッピングされた", i, mapping);
        SDL_free(mapping);
    } else {
        SDL_Log("\'%d\'番はジョイスティックと非互換のコントローラ", i);
    }
}

詳細

戻された文字列はSDL_Free()で解放する必要がある.

マッピングの詳細はSDL_GameControllerAddMapping()のページにある.

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_GameControllerAddMapping
SDL_GameControllerMappingForGUID

SDL Wikiへのリンク

SDL_GameControllerMapping - SDL Wiki