Uint32 SDL_MapRGBA(const SDL_PixelFormatDetails *format, const SDL_Palette *palette, Uint8 r, Uint8 g, Uint8 b, Uint8 a);
| const SDL_PixelFormatDetails * | format | ピクセルのSDL_PixelFormatDetails |
| const SDL_Palette * | palette | インデックス形式の場合のパレット. NULLも可 |
| r | 0～255の赤要素の値 | |
| g | 0～255の緑要素の値 | |
| b | 0～255の青要素の値 | |
| a | 0～255のα要素の値 |
この関数はRGB値を指定したピクセル形式に変換し, 与えられた形式とRGB値で最も近いピクセル値を戻す.
指定のピクセル形式にα要素がなければ, α値は無視される (パレットのある形式の場合も同様である).
ピクセル形式がパレットならば, パレットの中で最も近い色の添え字を戻す.
ピクセル形式のbpp(ビット深度)が32bpp未満ならば, 戻り値の使われない上位ビットは考慮しなくても安全である. (例: 16bpp形式の戻り値はUint16とみなしてよい. 8bpp形式もUint8とみなしてよい.)
この関数はパレットを変更しない限りどのスレッドからも安全に呼べる.