目次 - SDL 3.0 API(機能別) - ビデオキャプチャ - SDL_CameraID

SDL_ReleaseCameraFrame

カメラに要求したビデオフレームを返却する

ヘッダ

SDL3/SDL_camera.h

構文

void SDL_ReleaseCameraFrame(SDL_Camera *camera, SDL_Surface *frame);

引数

SDL_Camera *cameraオープンしたカメラデバイス
SDL_Surface *frame戻すビデオフレーム

詳細

カメラの内部バッファを再び使用できるようにする.

この関数はSDL_AcquireCameraFrame()が戻したサーフェイスオブジェクトに対してのみ使用できる. SDLには小さなビデオフレームサーフェイスFIFOキューしかないため, この関数はフレームの要求の後にできるだけ早く呼ぶ必要がある. フレームを時間内に戻さなかった場合, SDLはカメラからまだ得ていないフレームをドロップする可能性がある.

フレームを長時間保持する必要がある場合, コピーして元画像を返却するべきである.

この関数を再び呼んだ後は, このサーフェイスを使ってはならない. サーフェイスは解放されポインタは無効になっている.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_ReleaseCameraFrame - SDL Wiki