2019-03-02 22:16:55 +08:00
|
|
|
#ifndef VIDEO_BUFFER_H
|
|
|
|
#define VIDEO_BUFFER_H
|
2017-12-12 22:12:07 +08:00
|
|
|
|
2021-01-09 02:24:51 +08:00
|
|
|
#include "common.h"
|
|
|
|
|
2019-03-03 06:52:22 +08:00
|
|
|
#include <stdbool.h>
|
2017-12-12 22:12:07 +08:00
|
|
|
|
2018-08-15 23:01:54 +08:00
|
|
|
#include "fps_counter.h"
|
2021-02-01 01:24:35 +08:00
|
|
|
#include "util/thread.h"
|
2018-02-07 19:25:52 +08:00
|
|
|
|
2017-12-12 22:12:07 +08:00
|
|
|
// forward declarations
|
|
|
|
typedef struct AVFrame AVFrame;
|
|
|
|
|
2021-02-01 16:38:11 +08:00
|
|
|
/**
|
|
|
|
* There are 3 frames in memory:
|
|
|
|
* - one frame is held by the decoder (decoding_frame)
|
|
|
|
* - one frame is held by the renderer (rendering_frame)
|
|
|
|
* - one frame is shared between the decoder and the renderer (pending_frame)
|
|
|
|
*
|
|
|
|
* The decoder decodes a packet into the decoding_frame (it may takes time).
|
|
|
|
*
|
|
|
|
* Once the frame is decoded, it calls video_buffer_offer_decoded_frame(),
|
|
|
|
* which swaps the decoding and pending frames.
|
|
|
|
*
|
|
|
|
* When the renderer is notified that a new frame is available, it calls
|
|
|
|
* video_buffer_take_rendering_frame() to retrieve it, which swaps the pending
|
|
|
|
* and rendering frames. The frame is valid until the next call, without
|
|
|
|
* blocking the decoder.
|
|
|
|
*/
|
|
|
|
|
2019-03-02 22:16:55 +08:00
|
|
|
struct video_buffer {
|
2017-12-12 22:12:07 +08:00
|
|
|
AVFrame *decoding_frame;
|
2021-02-01 16:38:11 +08:00
|
|
|
AVFrame *pending_frame;
|
2017-12-12 22:12:07 +08:00
|
|
|
AVFrame *rendering_frame;
|
2021-02-01 16:38:11 +08:00
|
|
|
|
2021-02-01 01:24:35 +08:00
|
|
|
sc_mutex mutex;
|
2019-06-06 01:02:50 +08:00
|
|
|
bool render_expired_frames;
|
2019-03-03 06:52:22 +08:00
|
|
|
bool interrupted;
|
2021-02-01 16:38:11 +08:00
|
|
|
|
|
|
|
sc_cond pending_frame_consumed_cond;
|
|
|
|
bool pending_frame_consumed;
|
2017-12-12 22:12:07 +08:00
|
|
|
};
|
|
|
|
|
2019-03-03 06:52:22 +08:00
|
|
|
bool
|
2021-02-20 03:56:09 +08:00
|
|
|
video_buffer_init(struct video_buffer *vb, bool render_expired_frames);
|
2019-03-03 03:09:56 +08:00
|
|
|
|
|
|
|
void
|
|
|
|
video_buffer_destroy(struct video_buffer *vb);
|
2017-12-12 22:12:07 +08:00
|
|
|
|
2019-03-02 22:16:55 +08:00
|
|
|
// set the decoded frame as ready for rendering
|
2019-03-03 07:26:48 +08:00
|
|
|
// the output flag is set to report whether the previous frame has been skipped
|
|
|
|
void
|
|
|
|
video_buffer_offer_decoded_frame(struct video_buffer *vb,
|
|
|
|
bool *previous_frame_skipped);
|
2018-02-09 02:23:24 +08:00
|
|
|
|
|
|
|
// mark the rendering frame as consumed and return it
|
2021-02-01 16:38:11 +08:00
|
|
|
// the frame is valid until the next call to this function
|
2019-03-03 03:09:56 +08:00
|
|
|
const AVFrame *
|
2021-02-01 16:38:11 +08:00
|
|
|
video_buffer_take_rendering_frame(struct video_buffer *vb);
|
2017-12-12 22:12:07 +08:00
|
|
|
|
2018-02-09 15:42:39 +08:00
|
|
|
// wake up and avoid any blocking call
|
2019-03-03 03:09:56 +08:00
|
|
|
void
|
|
|
|
video_buffer_interrupt(struct video_buffer *vb);
|
2018-02-09 15:42:39 +08:00
|
|
|
|
2017-12-12 22:12:07 +08:00
|
|
|
#endif
|