Uint32 SDL_MapSurfaceRGB(SDL_Surface *surface, Uint8 r, Uint8 g, Uint8 b);
| SDL_Surface * | surface | ピクセル形式とパレットを使用するサーフェイス |
| Uint8 | r | ピクセルの0～255の赤要素 |
| Uint8 | g | ピクセルの0～255の緑要素 |
| Uint8 | b | ピクセルの0～255の青要素 |
この関数は, RGBの値に対応する与えられたピクセル形式のピクセル値を求め, その値を与えられたRGBの値とピクセル形式に最も近い値にして戻す
サーフェイスにパレットがある場合は, パレットの最も近い色のインデックス番号を戻す.
サーフェイスのピクセル形式にα要素がある場合, 全てのビットが1(完全に不透明)として求める.
ピクセル形式のbpp(色深度)が32bpp未満の場合, 戻された値の設定されていない上位ビットは安全に無視できる(例えば, 16bpp形式の場合, 戻された値はUint16とみなしてよく, 8bpp形式ならば同様にUint8としてよい).
この関数は別のスレッドから別のサーフェイスに対して呼ぶことができる.