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

SDL_AllocFormat

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

構文

SDL_PixelFormat* SDL_AllocFormat(Uint32 pixel_format)

引数

pixel_formatSDL_PixelFormatEnumの値の1つ

戻り値

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

サンプルコード

SDL_PixelFormat* pixel_format = NULL;

/* ... */

SDL_Init(SDL_INIT_EVERYTHING);

pixel_format = SDL_AllocFormat(SDL_PIXELFORMAT_RGBA32);

if (pixel_format == NULL) printf( "エラー: %s¥n", SDL_GetError() );

/* ... */

printf("バイト数: %i¥n", pixel_format->BytesPerPixel);

詳細

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

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_FreeFormat

SDL Wikiへのリンク

SDL_AllocFormat - SDL Wiki