SDL_Cursor* SDL_CreateCursor(const Uint8* data, const Uint8* mask, int w, int h, int hot_x, int hot_y)
| data | カーソルの各ピクセルの色 (詳細を参照すること) |
| mask | カーソルの書くピクセルのマスク (詳細を参照すること) |
| w | カーソルの幅 (詳細を参照すること) |
| h | カーソルの高さ (wと同じ?) |
| hot_x | カーソルの左上の実際のカーソルからの相対位置のX座標??? |
| hot_y | カーソルの左上の実際のカーソルからの相対位置のY座標??? |
カーソルの幅(w)は8の倍数の必要がある.
生成されるカーソルの黒と白は次の表に従う.
| data | mask | スクリーン上の結果 |
|---|---|---|
| 0 | 1 | 白 |
| 1 | 1 | 黒 |
| 0 | 0 | 透明 |
| 1 | 0 | 可能なら反転, 不可能なら黒 |
この関数で生成されたカーソルはSDL_FreeCursor()で解放する必要がある.
色のついたカーソルが必要ならば, この関数は向いていない. 代わりに, 通常のカーソルをSDL_ShowCursor()で隠し, メインループでSDL_Surface()をカーソルの位置に描く必要がある. (訳者注: これは古い説明で, SDL_CreateColorCursor()を使えば可能なはず.)