FFmpeg: libavcodec/thread.h File Reference

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 AVCodec.decode. This means the decoder has to consume the full packet.

Parameters are the same as AVCodec.decode.

Definition at line 503 of file pthread_frame.c.

Referenced by decode_simple_internal().

◆ 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: avctx The context.

Definition at line 632 of file pthread_frame.c.

Referenced by frame_worker_thread(), and thread_get_buffer_internal().

◆ ff_thread_report_progress()

void ff_thread_report_progress ( ThreadFrame * f,

int progress,

int field

)

Notify later decoding threads when part of their reference picture is ready.

Call this when some part of the picture is finished decoding. Later calls with lower values of progress have no effect.

Parameters: f The picture being decoded.

progress Value, in arbitrary units, of how much of the picture has decoded.

field The field being decoded, for field-picture codecs. 0 for top field or frame pictures, 1 for bottom field.

Definition at line 588 of file pthread_frame.c.

Referenced by decode(), decode_finish_row(), decode_frame(), decode_frame_common(), decode_nal_units(), decode_slice(), decode_tiles(), ff_h264_field_end(), ff_h264_queue_decode_slice(), ff_hevc_hls_filter(), ff_mpv_frame_end(), ff_mpv_frame_start(), ff_mpv_report_decode_progress(), ff_rv34_decode_frame(), finish_frame(), generate_missing_ref(), h264_field_start(), mimic_decode_frame(), rv34_decode_slice(), vp3_draw_horiz_band(), vp78_decode_frame(), vp78_decode_mb_row_sliced(), vp9_decode_frame(), and wavpack_decode_frame().

◆ ff_thread_await_progress()

void ff_thread_await_progress ( ThreadFrame * f,

int progress,

int field

)

Wait for earlier decoding threads to finish reference pictures.

Call this before accessing some part of a picture, with a given value for progress, and it will return after the responsible decoding thread calls ff_thread_report_progress() with the same or higher value for progress.

Parameters: f The picture being referenced.

progress Value, in arbitrary units, to wait for.

field The field being referenced, for field-picture codecs. 0 for top field or frame pictures, 1 for bottom field.

Definition at line 611 of file pthread_frame.c.

◆ ff_thread_get_format()

enum AVPixelFormat ff_thread_get_format ( AVCodecContext * avctx,

const enum AVPixelFormat * fmt

)

Wrapper around get_format() for frame-multithreaded codecs.

Call this function instead of avctx->get_format(). Cannot be called after the codec has called ff_thread_finish_setup().

Parameters: avctx The current context.

fmt The list of available formats.

Definition at line 1020 of file pthread_frame.c.

Referenced by decode_frame_header(), get_format(), get_pixel_format(), mpeg_get_pixelformat(), and update_size().

◆ ff_thread_get_buffer()

int ff_thread_get_buffer ( AVCodecContext * avctx,

ThreadFrame * f,

int flags

)

Wrapper around get_buffer() for frame-multithreaded codecs.

Call this function instead of ff_get_buffer(f). Cannot be called after the codec has called ff_thread_finish_setup().

Parameters: avctx The current context.

f The frame to write into.

Definition at line 1048 of file pthread_frame.c.

◆ ff_thread_release_buffer()

void ff_thread_release_buffer ( AVCodecContext * avctx,

ThreadFrame * f

)

Wrapper around release_buffer() frame-for multithreaded codecs.

Call this function instead of avctx->release_buffer(f). The AVFrame will be copied and the actual release_buffer() call will be performed later. The contents of data pointed to by the AVFrame should not be changed until ff_thread_get_buffer() is called on it.