目次 - 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 2.0.0以降

## 関連項目(関数)

SDL_GetRGB
SDL_GetRGBA
SDL_MapRGBA

## SDL Wikiへのリンク

SDL_MapRGB - SDL Wiki