Uint32 SDL_MapRGB(const SDL_PixelFormat* format, Uint8 r, Uint8 g, Uint8 b)
| format | ピクセルのSDL_PixelFormat |
| r | 0〜255の赤成分の値 |
| g | 0〜255の緑成分の値 |
| b | 0〜255の青成分の値 |
この関数はRGB値を指定したピクセル形式に変換し, 与えられた形式とRGB値で最も近いピクセル値を戻す.
ピクセル形式がパレットならば, パレットの中で最も近い色の添え字を戻す.
指定のピクセル形式にα成分があるならば, 全てのビットが1の値(完全に不透明)を戻す.
ピクセル形式のbpp(ビット深度)が32bpp未満ならば, 戻り値の使われない上位ビットは考慮しなくても安全である. (例: 16bpp形式の戻り値はUint16とみなしてよい. 8bpp形式もUint8とみなしてよい.)