目次 - API(機能別) - ピクセル形式と変換 - SDL_MapRGB

# SDL_MapRGB

RGBの3つの値から指定のピクセル形式の不透明なピクセル値を求める

## 構文

`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とみなしてよい.)

## 関連項目(関数)

SDL_GetRGB
SDL_GetRGBA
SDL_MapRGBA

## SDL Wikiへのリンク

SDL_MapRGB - SDL Wiki