SDL_Surface * SDL_CreateSurfaceFrom(int width, int height, SDL_PixelFormat format, void *pixels, int pitch);
| int | width | サーフェイスの幅 |
| int | height | サーフェイスの高さ |
| SDL_PixelFormat | height | 生成するサーフェイスのピクセル形式のSDL_PixelFormat |
| void * | pixels | 既存のピクセルデータへのポインタ |
| int | pitch | 水平方向のバイト数 |
ピクセルデータはコピーされない. ピクセルデータは自動的に管理されないため, ピクセルデータを解放する前にサーフェイスを解放する必要がある.
pitchは, ある行から見た次の行のバイト単位のオフセットで, 例えばSDL_PIXELFORMAT_RGBA8888ならばwidth*4である.
pixelsにNULLを, pitchに0を渡してサーフェイスを生成し, 後で適切な値を書き込むこともできる.