目次 - API(機能別) - サーフェイスの生成と単純な描画 - SDL_UnlockSurface

SDL_UnlockSurface

ピクセル領域に直接アクセスした後にロックを解放する

構文

void SDL_UnlockSurface(SDL_Surface* surface)

引数

surfaceロックを解放するSDL_Surface

サンプルコード

/* サーフェイスのピクセルにアクセスできるようにする */

SDL_LockSurface(surface);

/* サーフェイスがロックされた */
/* ここで直接ピクセルにアクセスできる */

SDL_UnlockSurface(surface);

/* サーフェイスはアンロックされた */

詳細

SDL_LockSurface()SDL_UnlockSurface()の間で, surface->formatに格納されたピクセル形式でsurface->pixelの読み込みと書き込みができる. サーフェイスへのアクセスを終えたなら, SDL_UnlockSurface()を呼んでロックを解放する必要がある.

全てのサーフェイスがロックを必要としているとは限らない SDL_MUSTLOCK(surface)が0ならば, いつでもサーフェイスに読み書き可能で, サーフェイスのピクセル形式は変化しない.

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_LockSurface

SDL Wikiへのリンク

SDL_UnlockSurface - SDL Wiki