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

SDL_ConvertSurfaceAndColorspace

既存のサーフェイスを別の形式に変換して新しいサーフェイスを生成する

ヘッダ

SDL3/SDL_surface.h

構文

SDL_Surface * SDL_ConvertSurfaceAndColorspace(SDL_Surface *surface, SDL_PixelFormat format, SDL_Palette *palette, SDL_Colorspace colorspace, SDL_PropertiesID props);

引数

SDL_Surface *surface変換する既存のSDL_Surface
SDL_PixelFormatformat新しいピクセル形式
SDL_Palette *paletteインデックス付きの形式で使用するパレット. NULLも可
SDL_Colorspacecolorspace新しい色空間
SDL_PropertiesIDpropertiesコピー元の追加の色プロパティ, または0

戻り値

(SDL_Surface *) 生成されたサーフェイスを戻す. 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

この関数は既存のサーフェイスを新しい形式と色空間に変換して新しいサーフェイスを戻す. これには全てのピクセルの形式と色空間の変換が必要となる.

変換元のサーフェイスに別バージョンの画像がある場合, 新しいサーフェイスも同様に参照する.

スレッドセーフ

この関数は別のスレッドから別のサーフェイスに対して呼ぶことができる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_ConvertSurfaceAndColorspace - SDL Wiki