目次 - API(機能別) - ピクセル形式と変換 - SDL_AllocFormat

# SDL_AllocFormat

指定のピクセル形式のSDL_PixelFormatを生成する

## 構文

`SDL_PixelFormat* SDL_AllocFormat(Uint32 pixel_format)`

## 引数

pixel_format | SDL_PixelFormatEnumの値の1つ

## 戻り値

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

## 詳細

戻された構造体は, (新しく確保された領域ではなく)共通のグローバルな領域なので, 変更してはならない. 特にパレットはそうである. "Blit combination not supported" のような不可解なエラーが発生するだろう.

## バージョン

SDL 2.0.0以降

## 関連項目(関数)

SDL_FreeFormat

## SDL Wikiへのリンク

SDL_AllocFormat - SDL Wiki