FFmpeg
Enumerations | Functions
thread.h File Reference
#include "libavutil/buffer.h"
#include "avcodec.h"

Go to the source code of this file.

Enumerations

enum  ThreadingStatus { FF_THREAD_IS_COPY, FF_THREAD_IS_FIRST_THREAD, FF_THREAD_NO_FRAME_THREADING }
 

Functions

void ff_thread_flush (AVCodecContext *avctx)
 Wait for decoding threads to finish and reset internal state. More...
 
int ff_thread_decode_frame (AVCodecContext *avctx, AVFrame *picture, int *got_picture_ptr, AVPacket *avpkt)
 Submit a new frame to a decoding thread. More...
 
int ff_thread_can_start_frame (AVCodecContext *avctx)
 
void ff_thread_finish_setup (AVCodecContext *avctx)
 If the codec defines update_thread_context(), call this when they are ready for the next thread to start decoding the next frame. More...
 
int ff_thread_get_buffer (AVCodecContext *avctx, AVFrame *f, int flags)
 Wrapper around get_buffer() for frame-multithreaded codecs. More...
 
int ff_thread_init (AVCodecContext *s)
 
int ff_slice_thread_execute_with_mainfunc (AVCodecContext *avctx, int(*action_func2)(AVCodecContext *c, void *arg, int jobnr, int threadnr), int(*main_func)(AVCodecContext *c), void *arg, int *ret, int job_count)
 
void ff_thread_free (AVCodecContext *s)
 
int ff_slice_thread_allocz_entries (AVCodecContext *avctx, int count)
 
int ff_slice_thread_init_progress (AVCodecContext *avctx)
 
void ff_thread_report_progress2 (AVCodecContext *avctx, int field, int thread, int n)
 
void ff_thread_await_progress2 (AVCodecContext *avctx, int field, int thread, int shift)
 
enum ThreadingStatus ff_thread_sync_ref (AVCodecContext *avctx, size_t offset)
 Allows to synchronize objects whose lifetime is the whole decoding process among all frame threads. More...
 

Detailed Description

Multithreading support functions

Author
Alexander Strange astra.nosp@m.nge@.nosp@m.ithin.nosp@m.ksw..nosp@m.com

Definition in file thread.h.

Enumeration Type Documentation

◆ ThreadingStatus

Enumerator
FF_THREAD_IS_COPY 
FF_THREAD_IS_FIRST_THREAD 
FF_THREAD_NO_FRAME_THREADING 

Definition at line 87 of file thread.h.

Function Documentation

◆ ff_thread_flush()

void ff_thread_flush ( AVCodecContext avctx)

Wait for decoding threads to finish and reset internal state.

Called by avcodec_flush_buffers().

Parameters
avctxThe context.

Definition at line 911 of file pthread_frame.c.

Referenced by avcodec_flush_buffers().

◆ ff_thread_decode_frame()

int ff_thread_decode_frame ( AVCodecContext avctx,
AVFrame picture,
int got_picture_ptr,
AVPacket avpkt 
)

Submit a new frame to a decoding thread.

Returns the next available frame in picture. *got_picture_ptr will be 0 if none is available. The return value on success is the size of the consumed packet for compatibility with FFCodec.decode. This means the decoder has to consume the full packet.

Parameters are the same as FFCodec.decode.

Definition at line 488 of file pthread_frame.c.

Referenced by decode_simple_internal().

◆ ff_thread_can_start_frame()

int ff_thread_can_start_frame ( AVCodecContext avctx)

Definition at line 939 of file pthread_frame.c.

Referenced by ff_mpv_frame_start(), and h264_frame_start().

◆ ff_thread_finish_setup()

void ff_thread_finish_setup ( AVCodecContext avctx)

If the codec defines update_thread_context(), call this when they are ready for the next thread to start decoding the next frame.

After calling it, do not change any variables read by the update_thread_context() method, or call ff_thread_get_buffer().

Parameters
avctxThe context.

Definition at line 617 of file pthread_frame.c.

Referenced by frame_worker_thread().

◆ ff_thread_get_buffer()

int ff_thread_get_buffer ( AVCodecContext avctx,
AVFrame f,
int  flags 
)

◆ ff_thread_init()

int ff_thread_init ( AVCodecContext s)

Definition at line 71 of file pthread.c.

Referenced by avcodec_open2().

◆ ff_slice_thread_execute_with_mainfunc()

int ff_slice_thread_execute_with_mainfunc ( AVCodecContext avctx,
int(*)(AVCodecContext *c, void *arg, int jobnr, int threadnr)  action_func2,
int(*)(AVCodecContext *c main_func,
void *  arg,
int ret,
int  job_count 
)

◆ ff_thread_free()

void ff_thread_free ( AVCodecContext s)

Definition at line 83 of file pthread.c.

Referenced by ff_codec_close().

◆ ff_slice_thread_allocz_entries()

int ff_slice_thread_allocz_entries ( AVCodecContext avctx,
int  count 
)

Definition at line 240 of file pthread_slice.c.

Referenced by hls_slice_data_wpp().

◆ ff_slice_thread_init_progress()

int ff_slice_thread_init_progress ( AVCodecContext avctx)

Definition at line 179 of file pthread_slice.c.

Referenced by hevc_decode_init().

◆ ff_thread_report_progress2()

void ff_thread_report_progress2 ( AVCodecContext avctx,
int  field,
int  thread,
int  n 
)

Definition at line 210 of file pthread_slice.c.

Referenced by hls_decode_entry_wpp().

◆ ff_thread_await_progress2()

void ff_thread_await_progress2 ( AVCodecContext avctx,
int  field,
int  thread,
int  shift 
)

Definition at line 222 of file pthread_slice.c.

Referenced by hls_decode_entry_wpp().

◆ ff_thread_sync_ref()

enum ThreadingStatus ff_thread_sync_ref ( AVCodecContext avctx,
size_t  offset 
)

Allows to synchronize objects whose lifetime is the whole decoding process among all frame threads.

When called from a non-copy thread, do nothing. When called from another thread, place a new RefStruct reference at the given offset in the calling thread's private data from the RefStruct reference in the private data of the first decoding thread. The first thread must have a valid RefStruct reference at the given offset in its private data; the calling thread must not have a reference at this offset in its private data (must be NULL).

Parameters
avctxan AVCodecContext
offsetoffset of the RefStruct reference in avctx's private data
Return values
FF_THREAD_IS_COPYif frame-threading is in use and the calling thread is a copy; in this case, the RefStruct reference will be set.
FF_THREAD_IS_MAIN_THREADif frame-threading is in use and the calling thread is the main thread.
FF_THREAD_NO_FRAME_THREADINGif frame-threading is not in use.

Definition at line 1751 of file decode.c.

Referenced by wavpack_decode_init().