SDL_Palette * SDL_CreateSurfacePalette(SDL_Surface *surface);
| SDL_Surface * | surface | 変換するSDL_Surface |
この関数は与えられたサーフェイスと合ったパレットを生成する. パレットは変更できるようにアプリケーションに戻され, かつ自動的にサーフェイスはこのパレットを使用する. 戻されたパレットを破棄する必要はない. 参照カウンタが0になったとき解放される. これは通常はサーフェイスが破棄されたときである.
ビットマップサーフェイス(SDL_PIXELFORMAT_INDEX1LSBまたはSDL_PIXELFORMAT_INDEX1MSB形式の)には, 初期値として0が白で1が黒のパレットがある. その他のサーフェイスのパレットは全て白である.
既にパレットのあるサーフェイスにこの関数が呼ばれたとき, 新しく生成されたパレットに置き換わる.
この関数は別のスレッドから別のサーフェイスに対して呼ぶことができる.