目次 - SDL 3.0 API(機能別) - 2Dレンダリング - SDL_SetTextureAlphaMod

SDL_SetTextureAlphaMod

レンダのコピー操作で乗算されるα値を設定する

ヘッダ

SDL3/SDL_render.h

構文

bool SDL_SetTextureAlphaMod(SDL_Texture *texture, Uint8 alpha);

引数

SDL_Texture *texture設定するテクスチャ
Uint8alphaコピー時に乗算されるα値

戻り値

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

詳細

このテクスチャのレンダリングを行っている場合, コピー元のα値は次の式のように修正される.

srcA = srcA * (alpha / 255)

レンダラが常にこの機能に対応しているとは限らない. 対応していないときは偽を戻す.

スレッドセーフ

この関数を呼べるのはメインスレッドのみである.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_SetTextureAlphaMod - SDL Wiki