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

# SDL_LoadBMP

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

## 構文

`SDL_Surface* SDL_LoadBMP(const char* file)`

## 引数

file | BMPイメージファイル

## 戻り値

成功のとき生成された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