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

SDL_ConvertPixelsAndColorspace

ある形式のピクセル群を別の形式と色空間に変換してコピーする

ヘッダ

SDL3/SDL_surface.h

構文

bool SDL_ConvertPixelsAndColorspace(int width, int height, SDL_PixelFormat src_format, SDL_Colorspace src_colorspace, SDL_PropertiesID src_properties, const void *src, int src_pitch, SDL_PixelFormat dst_format, SDL_Colorspace dst_colorspace, SDL_PropertiesID dst_properties, void *dst, int dst_pitch);

引数

intwidthピクセル群の幅
intheightピクセル群の高さ
SDL_PixelFormatsrc_formatコピー元のピクセル形式
SDL_Colorspacesrc_colorspaceコピー元の色空間
SDL_PropertiesIDsrc_propertiesコピー元の追加の色プロパティ, または0
const void *srcコピー元のピクセル群
intsrc_pitchコピー元のピクセル群の水平方向のバイト数
SDL_PixelFormatdst_formatコピー先のピクセル形式
SDL_Colorspacedst_colorspaceコピー先の色空間
SDL_PropertiesIDdst_propertiesコピー先の追加の色プロパティ, または0
void *dst生成したピクセル群を書き込むポインタ
intdst_pitchコピー先のピクセル群の水平方向のバイト数

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

スレッドセーフ

同じコピー先のピクセル群を2つのスレッドから同時に使用してはならない. コピー元のピクセル群は複数のスレッドから安全に使用できる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_ConvertPixelsAndColorspace - SDL Wiki