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

# SDL_ConvertSurfaceFormat

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

## 構文

`SDL_Surface* SDL_ConvertSurfaceFormat(SDL_Surface* src, Uint32 pixel_format, Uint32 flags)`

## 引数

src | 変換元のSDL_Surface
pixel_format | SDL_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