sdlReleaseCameraFrame function

void sdlReleaseCameraFrame(Pointer<SdlCamera> camera, Pointer<SdlSurface> frame)

Release a frame of video acquired from a camera.

Let the back-end re-use the internal buffer for camera.

This function must be called only on surface objects returned by SDL_AcquireCameraFrame(). This function should be called as quickly as possible after acquisition, as SDL keeps a small FIFO queue of surfaces for video frames; if surfaces aren't released in a timely manner, SDL may drop upcoming video frames from the camera.

If the app needs to keep the surface for a significant time, they should make a copy of it and release the original.

The app should not use the surface again after calling this function; assume the surface is freed and the pointer is invalid.

\param camera opened camera device. \param frame the video frame surface to release.

\threadsafety It is safe to call this function from any thread.

\since This function is available since SDL 3.1.3.

\sa SDL_AcquireCameraFrame

extern SDL_DECLSPEC void SDLCALL SDL_ReleaseCameraFrame(SDL_Camera *camera, SDL_Surface *frame)

Implementation

void sdlReleaseCameraFrame(
    Pointer<SdlCamera> camera, Pointer<SdlSurface> frame) {
  final sdlReleaseCameraFrameLookupFunction = libSdl3.lookupFunction<
      Void Function(Pointer<SdlCamera> camera, Pointer<SdlSurface> frame),
      void Function(Pointer<SdlCamera> camera,
          Pointer<SdlSurface> frame)>('SDL_ReleaseCameraFrame');
  return sdlReleaseCameraFrameLookupFunction(camera, frame);
}