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

SDL_PremultiplyAlpha

ピクセル群のα要素を事前に積算する

ヘッダ

SDL3/SDL_surface.h

構文

bool SDL_PremultiplyAlpha(int width, int height, SDL_PixelFormat src_format, const void *src, int src_pitch, SDL_PixelFormat dst_format, void *dst, int dst_pitch, bool linear);

引数

dstのピクセル形式
intwidth変換するピクセル群の幅
intheight変換するピクセル群の高さ
SDL_PixelFormatsrc_formatsrcのピクセル形式
const void *src変換元ピクセル群
intsrc_pitch変換元ピクセル群のピッチのバイト数
SDL_PixelFormatdst_format
void *dst変換後のピクセル群の書き込み先へのポインタ
intdst_pitch変換後ピクセル群のピッチのバイト数
boollinear真のときsRGBから線形空間に変換して乗算する. 偽のときsRGB空間で乗算する

戻り値

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

詳細

src == dstでも安全に使用できるが, 他の領域が重複する場合は安全でない.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_PremultiplyAlpha - SDL Wiki