目次 - API(機能別) - サーフェイスの生成と単純な描画 - SDL_LoadBMP

SDL_LoadBMP

BMPファイルをサーフェイスに読み込む

構文

SDL_Surface* SDL_LoadBMP(const char* file)

引数

fileBMPイメージファイル

戻り値

成功のとき生成されたSDL_Surface, 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

生成されたサーフェイスはSDL_FreeSurface()で解放する必要がある.

SDL_LoadBMP()は, SDL_RWFromFile()でファイルを開き自動的にファイルを閉じるSDL_LoadBMP_RW()のマクロである.

サンプルコード

const char *image_path = "myimage.bmp";
SDL_Surface *image = SDL_LoadBMP(image_path);

/* ファイルの読み込みに失敗したらユーザに知らせる */
if (!image) {
    printf("画像の読み込みに失敗した %s: %s\n", image_path, SDL_GetError());
    return;
}

/* ここで画像を使う */

/* 最後にサーフェイスの資源を解放する */
SDL_FreeSurface(image);

関連項目(関数)

SDL_FreeSurface
SDL_LoadBMP_RW
SDL_SaveBMP

SDL Wikiへのリンク

SDL_LoadBMP - SDL Wiki