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

SDL_ConvertSurfaceFormat

既存のサーフェイスを指定のピクセル形式に変換してコピーする

構文

SDL_Surface *SDL_ConvertSurfaceFormat(SDL_Surface *surface, Uint32 pixel_format, Uint32 flags)

引数

surface変換元のSDL_Surface
pixel_formatSDL_PixelFormatEnumの値の1つ
flags未使用 常に0にすること

戻り値

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

詳細

この関数の動作はSDL_ConvertSurface()とよく似ている. しかし, SDL_PixelFormat構造体の代わりにSDL_PixelFormatEnumの値を取る. そのため簡単に使用できるが, 変換後のサーフェイスのパレット情報には, それが重要であってもアクセスできない.

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_AllocFormat
SDL_ConvertSurface
SDL_CreateRGBSurface

SDL Wikiへのリンク

SDL_ConvertSurfaceFormat - SDL Wiki