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

SDL_SetTextureColorMod

レンダーのコピー操作で各色成分に乗算される値を設定する

構文

int SDL_SetTextureColorMod(SDL_Texture* texture, Uint8 r, Uint8 g, Uint8 b)

引数

texture設定するテクスチャ
rコピー時に赤成分に乗算される値
gコピー時に緑成分に乗算される値
bコピー時に青成分に乗算される値

戻り値

成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()で詳細を知ることができる.

サンプルコード

...
SDL_Texture* pTexture = SDL_CreateTextureFromSurface( renderer, loadedSurface );
SDL_SetTextureColorMod( pTexture, 64, 64, 64 );
...

詳細

サーフェイスがコピーされるとき, コピー元の各色成分は, これら値によって次の式に従い修正される.

srcC = srcC * (color / 255)

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

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_GetTextureColorMod
SDL_SetTextureAlphaMod

SDL Wikiへのリンク

SDL_SetTextureColorMod - SDL Wiki