Definition at line 216 of file decode.c.

Definition at line 217 of file decode.c.

Definition at line 828 of file decode.c.

Definition at line 103 of file decode.c.

Referenced by attach_post_process_data(), avcodec_send_packet(), decode_receive_frame_internal(), decode_simple_internal(), ff_decode_flush_buffers(), ff_decode_get_packet(), ff_decode_internal_sync(), ff_decode_internal_uninit(), ff_decode_preinit(), ff_decode_receive_frame_internal(), side_data_pref(), and update_frame_props().

Definition at line 108 of file decode.c.

Referenced by decode_get_packet().

Definition at line 169 of file decode.c.

Referenced by decode_get_packet().

Definition at line 180 of file decode.c.

Referenced by ff_decode_preinit().

Definition at line 220 of file decode.c.

Referenced by ff_decode_get_packet().

Called by decoders to get the next packet for decoding.

Parameters

pkt An empty packet to be filled with data.

Returns

0 if a new reference has been successfully written to pkt AVERROR(EAGAIN) if no data is currently available AVERROR_EOF if and end of stream has been reached, so no more data will be available

Definition at line 245 of file decode.c.

Referenced by amf_decode_frame(), apv_receive_frame(), av1_receive_frame(), binkaudio_receive_frame(), cuvid_output_frame(), decode_simple_internal(), ff_thread_receive_frame(), ffmmal_receive_frame(), hevc_receive_frame(), libdav1d_receive_frame_internal(), libjxl_receive_frame(), libxevd_receive_frame(), mediacodec_receive_frame(), oh_decode_receive_frame(), osq_receive_frame(), rkmpp_receive_frame(), and v4l2_receive_frame().

Attempt to guess proper monotonic timestamps for decoded video frames which might have incorrect times.

Input timestamps may wrap around, in which case the output will as well.

Parameters

pts the pts field of the decoded AVPacket, as passed through AVFrame.pts

dts the dts field of the decoded AVPacket

Returns

one of the input values, may be AV_NOPTS_VALUE

Definition at line 287 of file decode.c.

Referenced by decode_receive_frame_internal().

Definition at line 313 of file decode.c.

Referenced by decode_simple_internal(), and ff_decode_receive_frame_internal().

Definition at line 411 of file decode.c.

Referenced by decode_simple_receive_frame().

Definition at line 551 of file decode.c.

Referenced by decode_receive_frame_internal().

Definition at line 557 of file decode.c.

Referenced by decode_receive_frame_internal(), and ff_decode_frame_props().

Definition at line 592 of file decode.c.

Referenced by ff_decode_receive_frame_internal().

Do the actual decoding and obtain a decoded frame from the decoder, if available.

When frame threading is used, this is invoked by the worker threads, otherwise by the top layer directly.

Definition at line 608 of file decode.c.

Referenced by decode_receive_frame_internal(), and frame_worker_thread().

Definition at line 644 of file decode.c.

Referenced by avcodec_send_packet(), and ff_decode_receive_frame().

Definition at line 737 of file decode.c.

Referenced by ff_decode_receive_frame(), and ist_add().

Definition at line 765 of file decode.c.

Referenced by ff_decode_receive_frame().

avcodec_receive_frame() implementation for decoders.

Definition at line 791 of file decode.c.

Referenced by avcodec_receive_frame().

Definition at line 822 of file decode.c.

Referenced by avcodec_decode_subtitle2().

Definition at line 829 of file decode.c.

Referenced by avcodec_decode_subtitle2().

Definition at line 890 of file decode.c.

Referenced by avcodec_decode_subtitle2().

Make sure avctx.hw_frames_ctx is set.

If it's not set, the function will try to allocate it from hw_device_ctx. If that is not possible, an error message is printed, and an error code is returned.

Definition at line 1043 of file decode.c.

Referenced by ff_d3d12va_decode_init(), ff_dxva2_decode_init(), ff_vaapi_decode_init(), ff_vdpau_common_init(), and ff_vk_decode_init().

Definition at line 1156 of file decode.c.

Referenced by ff_get_format().

Definition at line 1191 of file decode.c.

Referenced by ff_codec_close(), ff_frame_thread_free(), ff_get_format(), and update_context_from_thread().

Select the (possibly hardware accelerated) pixel format.

This is a wrapper around AVCodecContext.get_format() and should be used instead of calling get_format() directly.

The list of pixel formats must contain at least one valid entry, and is terminated with AV_PIX_FMT_NONE. If it is possible to decode to software, the last entry in the list must be the most accurate software format. If it is not possible to decode to software, AVCodecContext.sw_pix_fmt must be set before calling this function.

Definition at line 1203 of file decode.c.

Referenced by cuvid_decode_init(), decode_frame_header(), ff_mjpeg_decode_sof(), ffmmal_init_decoder(), get_format(), get_pixel_format(), h263_get_format(), mediacodec_dec_get_video_codec(), mpeg_get_pixelformat(), qsv_decode_preinit(), update_size(), and vc1_get_format().

Definition at line 1342 of file decode.c.

Referenced by ff_get_coded_side_data(), and side_data_map().

Get side data of the given type from a decoding context.

Definition at line 1352 of file decode.c.

Referenced by av1_decode_init(), hevc_decode_init(), and libdav1d_init().

Definition at line 1358 of file decode.c.

Referenced by side_data_map().

Definition at line 1394 of file decode.c.

Referenced by side_data_map().

Definition at line 1466 of file decode.c.

Referenced by ff_decode_frame_props(), and ff_decode_frame_props_from_pkt().

Definition at line 1512 of file decode.c.

Referenced by ff_decode_frame_props_from_pkt().

Set various frame properties from the provided packet.

Definition at line 1524 of file decode.c.

Referenced by ff_decode_frame_props(), libdav1d_receive_frame(), and libxevd_return_frame().

Set various frame properties from the codec context / packet data.

Definition at line 1566 of file decode.c.

Referenced by amf_amfsurface_to_avframe(), cuvid_output_frame(), ff_get_buffer(), ff_h263_decode_frame(), ffmal_copy_frame(), libdav1d_receive_frame(), oh_decode_wrap_hw_buffer(), qsv_get_continuous_buffer(), qtrle_decode_frame(), raw_decode(), reget_buffer_internal(), vpx_decode(), and wrapped_avframe_decode().

Definition at line 1611 of file decode.c.

Referenced by attach_post_process_data(), and ff_get_buffer().

Definition at line 1632 of file decode.c.

Referenced by ff_attach_decode_data().

Definition at line 1643 of file decode.c.

Referenced by amf_amfsurface_to_avframe(), ff_get_buffer(), ff_videotoolbox_alloc_frame(), and qsv_get_continuous_buffer().

Definition at line 1659 of file decode.c.

Referenced by ff_get_buffer().

Definition at line 1675 of file decode.c.

Referenced by ff_get_buffer().

Get a buffer for a frame.

This is a wrapper around AVCodecContext.get_buffer() and should be used instead calling get_buffer() directly.

Definition at line 1720 of file decode.c.

Referenced by ac3_decode_frame(), adpcm_decode_frame(), adx_decode_frame(), alloc_frame(), amrnb_decode_frame(), amrwb_decode_frame(), aom_decode(), apac_decode(), ape_decode_frame(), aptx_decode_frame(), atrac1_decode_frame(), atrac3_decode_frame(), atrac3al_decode_frame(), atrac3p_decode_frame(), atrac9_decode_frame(), aura_decode_frame(), avui_decode_frame(), bfi_decode_frame(), binkaudio_receive_frame(), bmp_decode_frame(), bmv_aud_decode_frame(), bonk_decode(), cdg_decode_frame(), cdxl_decode_frame(), cinaudio_decode_frame(), cmv_decode_frame(), cng_decode_frame(), cook_decode_frame(), copy_output(), cuvid_output_frame(), cyuv_decode_frame(), dds_decode(), decode_frame(), decode_pic(), decode_tag(), dfa_decode_frame(), dfpwm_dec_frame(), dpcm_decode_frame(), dss_sp_decode_frame(), eightsvx_decode_frame(), escape124_decode_frame(), escape130_decode_frame(), evrc_decode_frame(), execute_code(), fastaudio_decode(), fdk_aac_decode_frame(), ff_dca_lbr_filter_frame(), ff_dca_xll_filter_frame(), ff_ivi_decode_frame(), ff_mjpeg_decode_sof(), ff_thread_get_buffer(), ff_thread_get_ext_buffer(), ff_twinvq_decode_frame(), ff_vp56_decode_frame(), ffat_decode(), ffmal_copy_frame(), filter_frame(), filter_frame_fixed(), filter_frame_float(), fits_decode_frame(), frame_configure_elements(), ftr_decode_frame(), g2m_decode_frame(), g722_decode_frame(), g723_1_decode_frame(), g728_decode_frame(), gdv_decode_frame(), gem_decode_frame(), get_buffer(), get_buffer_with_edge(), gsm_decode_frame(), hcom_decode(), hnm_decode_frame(), hq_decode_frame(), hqa_decode_frame(), idcin_decode_frame(), ilbc_decode_frame(), imc_decode_frame(), init_frames(), ipu_decode_frame(), ipvideo_decode_frame(), lead_decode_frame(), libcelt_dec_decode(), libcodec2_decode(), libgsm_decode_frame(), libjxl_receive_frame(), liblc3_decode(), libopus_decode(), librsvg_decode_frame(), libspeex_decode_frame(), libuavs3d_decode_frame(), libxevd_image_copy(), m101_decode_frame(), mace_decode_frame(), mediacodec_wrap_sw_audio_buffer(), mediacodec_wrap_sw_video_buffer(), misc4_decode(), mp_decode_frame(), mpc7_decode_frame(), mpc8_decode_frame(), mpegh3dadec_decode_frame(), msp2_decode_frame(), mss2_decode_frame(), mvc_decode_frame(), mxpeg_decode_frame(), oggvorbis_decode_frame(), oh_decode_wrap_sw_buffer(), on2avc_decode_frame(), opus_decode_packet(), osq_receive_frame(), output_data(), paf_audio_decode(), pcm_bluray_decode_frame(), pcm_decode_frame(), pcm_dvd_decode_frame(), pcx_decode_frame(), pgx_decode_frame(), pix_decode_frame(), pnm_decode_frame(), ptx_decode_frame(), qcelp_decode_frame(), qdm2_decode_frame(), qdmc_decode_frame(), qoa_decode_frame(), ra144_decode_frame(), ra288_decode_frame(), reget_buffer_internal(), rka_decode_frame(), rl2_decode_frame(), rv60_decode_frame(), s302m_decode_frame(), sbc_decode_frame(), sga_decode_frame(), sgirle_decode_frame(), shorten_decode_frame(), sipr_decode_frame(), siren_decode(), smka_decode_frame(), speex_decode_frame(), sunrast_decode_frame(), svc_decode_frame(), svq1_decode_frame(), synth_superframe(), tdsc_decode_frame(), tgq_decode_frame(), tgv_decode_frame(), thread_get_buffer_internal(), tmv_decode_frame(), tqi_decode_frame(), truemotion2rt_decode_frame(), truespeech_decode_frame(), txd_decode_frame(), v308_decode_frame(), v408_decode_frame(), vbn_decode_frame(), vcr1_decode_frame(), vmdaudio_decode_frame(), vmdvideo_decode_frame(), vorbis_decode_frame(), vpx_decode(), wavarc_decode(), wavesynth_decode(), wma_decode_superframe(), wmapro_decode_packet(), ws_snd_decode_frame(), xan_decode_frame(), xbm_decode_frame(), xface_decode_frame(), xma_decode_packet(), xpm_decode_frame(), xwd_decode_frame(), y216_decode_frame(), y41p_decode_frame(), yuv4_decode_frame(), zero12v_decode_frame(), and zerocodec_decode_frame().

Definition at line 1798 of file decode.c.

Referenced by ff_reget_buffer().

Identical in function to ff_get_buffer(), except it reuses the existing buffer if available.

Definition at line 1840 of file decode.c.

Referenced by aasc_decode_frame(), avs_decode_frame(), bethsoftvid_decode_frame(), cdg_decode_frame(), cdtoons_decode_frame(), cinepak_decode_frame(), cinvideo_decode_frame(), clv_decode_frame(), cpia_decode_frame(), decode_frame(), decode_frame_lscr(), fic_decode_frame(), flashsv_decode_frame(), flic_decode_frame_15_16BPP(), flic_decode_frame_1BPP(), flic_decode_frame_24BPP(), flic_decode_frame_8BPP(), gif_decode_frame(), imx_decode_frame(), ir2_decode_frame(), mm_decode_frame(), mobiclip_decode(), mp_decode_frame(), msrle_decode_frame(), mss1_decode_frame(), mss2_decode_frame(), mss3_decode_frame(), mss4_decode_frame(), msvideo1_decode_frame(), paf_video_decode(), qtrle_decode_frame(), roq_decode_frame(), rpza_decode_stream(), rscc_decode_frame(), screenpresso_decode_frame(), seqvideo_decode_frame(), smc_decode_frame(), truemotion1_decode_frame(), tscc2_decode_frame(), ulti_decode_frame(), vqa_decode_frame(), vqc_decode_frame(), xan_decode_frame(), and yop_decode_frame().

Definition at line 1853 of file decode.c.

Referenced by ff_progress_frame_replace(), and ff_progress_frame_unref().

This function sets up the ProgressFrame, i.e.

ProgressFrame.f and ProgressFrame.progress. ProgressFrame.f will be blank (as if from av_frame_alloc() or av_frame_unref()) on success.

Note

: This must only be called by codecs with the FF_CODEC_CAP_USES_PROGRESSFRAMES internal cap.

Definition at line 1859 of file decode.c.

Referenced by alloc_frame(), and ff_progress_frame_get_buffer().

Wrapper around ff_progress_frame_alloc() and ff_thread_get_buffer().

Note

: This must only be called by codecs with the FF_CODEC_CAP_USES_PROGRESSFRAMES internal cap.

See also

ff_progress_frame_alloc

Definition at line 1873 of file decode.c.

Referenced by av1_frame_alloc(), decode_frame(), decode_idat_chunk(), mimic_decode_frame(), vp8_alloc_frame(), and vp9_frame_alloc().

Set dst->f to src->f and make dst a co-owner of src->f.

dst can then be used to wait on progress of the underlying frame.

Note

: There is no underlying av_frame_ref() here. dst->f and src->f really point to the same AVFrame. Typically this means that the decoding thread is allowed to set all the properties of the AVFrame until it has indicated to have finished decoding. Afterwards later threads may read all of these fields. Access to the frame's data is governed by ff_thread_progress_report/await().

Definition at line 1888 of file decode.c.

Referenced by ff_progress_frame_replace(), and hevc_ref_frame().

Give up a reference to the underlying frame contained in a ProgressFrame and reset the ProgressFrame, setting all pointers to NULL.

Note

: This implies that when using this API the check for whether a frame exists is by checking ProgressFrame.f and not ProgressFrame.f->data[0] or ProgressFrame.f->buf[0].

Definition at line 1896 of file decode.c.

Referenced by av1_frame_unref(), decode_frame(), decode_idat_chunk(), ff_hevc_unref_frame(), ff_progress_frame_replace(), ffv1_decode_close(), mimic_decode_end(), mimic_decode_frame(), png_dec_end(), update_frames(), vp3_decode_flush(), vp8_alloc_frame(), vp8_release_frame(), vp9_decode_flush(), vp9_decode_free(), and vp9_frame_unref().

Do nothing if dst and src already refer to the same AVFrame; otherwise unreference dst and if src is not blank, put a reference to src's AVFrame in its place (in case src is not blank).

Definition at line 1903 of file decode.c.

Referenced by av1_frame_replace(), update_frames(), vp9_decode_frame(), and vp9_frame_replace().

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

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

Parameters

f The frame being decoded.

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

Warning

Calling this on a blank ProgressFrame causes undefined behaviour

Definition at line 1913 of file decode.c.

Referenced by decode(), decode_frame(), decode_frame_common(), decode_nal_units(), decode_slice(), decode_tiles(), ff_hevc_hls_filter(), find_next_slice(), generate_missing_ref(), mimic_decode_frame(), vp3_draw_horiz_band(), vp78_decode_frame(), vp78_decode_mb_row_sliced(), and vp9_decode_frame().

Wait for earlier decoding threads to finish reference frames.

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

Parameters

f The frame being referenced.

progress Value, in arbitrary units, to wait for.

Warning

Calling this on a blank ProgressFrame causes undefined behaviour

Definition at line 1918 of file decode.c.

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

avctx an AVCodecContext

offset offset of the RefStruct reference in avctx's private data

Return values

FF_THREAD_IS_COPY if 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_THREAD if frame-threading is in use and the calling thread is the main thread.

FF_THREAD_NO_FRAME_THREADING if frame-threading is not in use.

Definition at line 1924 of file decode.c.

Referenced by ff_mpv_decode_init(), and wavpack_decode_init().

Definition at line 1930 of file decode.c.

Referenced by ff_decode_preinit().

Definition at line 1947 of file decode.c.

Referenced by ff_decode_preinit().

Definition at line 1955 of file decode.c.

Referenced by ff_decode_preinit().

Perform decoder initialization and validation.

Called when opening the decoder, before the FFCodec.init() call.

Definition at line 1963 of file decode.c.

Referenced by avcodec_open2().

Check side data preference and clear existing side data from frame if needed.

Return values

0 side data of this type can be added to frame

1 side data of this type should not be added to frame

Definition at line 2098 of file decode.c.

Referenced by ff_decode_content_light_new(), ff_decode_content_light_new_ext(), ff_decode_mastering_display_new(), ff_decode_mastering_display_new_ext(), ff_frame_new_side_data(), and ff_frame_new_side_data_from_buf_ext().

Wrapper around av_frame_new_side_data, which rejects side data overridden by the demuxer.

Returns 0 on success, and a negative error code otherwise. If successful and sd is not NULL, *sd may either contain a pointer to the new side data, or NULL in case the side data was already present.

Definition at line 2114 of file decode.c.

Referenced by attach_displaymatrix(), cri_decode_frame(), decode_frame(), ff_mjpeg_decode_frame_from_buf(), h264_export_frame_props(), mpeg_field_start(), populate_avctx_color_fields(), set_side_data(), tiff_decode_tag(), and webp_decode_frame().

Same as ff_frame_new_side_data_from_buf, but taking a AVFrameSideData array directly instead of an AVFrame.

Definition at line 2133 of file decode.c.

Referenced by ff_frame_new_side_data_from_buf(), h2645_sei_to_side_data(), and hevc_sei_to_context().

Similar to ff_frame_new_side_data, but using an existing buffer ref.

*buf is ALWAYS consumed by this function and NULL written in its place, even on failure.

Definition at line 2152 of file decode.c.

Referenced by alloc_frame(), alloc_picture(), exif_attach_ifd(), export_itut_t35(), ff_h2645_sei_to_frame(), libjxl_attach_sidedata(), mpeg_field_start(), parse_itut_t35_metadata(), and set_side_data().

Same as ff_decode_mastering_display_new, but taking a AVFrameSideData array directly instead of an AVFrame.

Definition at line 2161 of file decode.c.

Referenced by h2645_sei_to_side_data().

Wrapper around av_mastering_display_metadata_create_side_data(), which rejects side data overridden by the demuxer.

Returns 0 on success, and a negative error code otherwise. If successful, *mdm may either be a pointer to the new side data, or NULL in case the side data was already present.

Definition at line 2193 of file decode.c.

Referenced by apv_decode_metadata(), export_metadata(), libdav1d_receive_frame(), and populate_avctx_color_fields().

Same as ff_decode_content_light_new, but taking a AVFrameSideData array directly instead of an AVFrame.

Definition at line 2206 of file decode.c.

Referenced by h2645_sei_to_side_data().

Wrapper around av_content_light_metadata_create_side_data(), which rejects side data overridden by the demuxer.

Returns 0 on success, and a negative error code otherwise. If successful, *clm may either be a pointer to the new side data, or NULL in case the side data was already present.

Definition at line 2238 of file decode.c.

Referenced by apv_decode_metadata(), export_metadata(), libdav1d_receive_frame(), and populate_avctx_color_fields().

Check whether the side-data of src contains a palette of size AVPALETTE_SIZE; if so, copy it to dst and return 1; else return 0.

Also emit an error message upon encountering a palette with invalid size.

Definition at line 2251 of file decode.c.

Referenced by cinepak_decode_frame(), decode_frame(), gdv_decode_frame(), idcin_decode_frame(), imx_decode_frame(), ipvideo_decode_frame(), msrle_decode_frame(), msvideo1_decode_frame(), qtrle_decode_frame(), raw_decode(), rscc_decode_frame(), and smc_decode_frame().

Allocate a hwaccel frame private data if the provided avctx uses a hwaccel method that needs it.

The returned data is a RefStruct reference (if allocated).

Parameters

avctx The codec context

hwaccel_picture_private Pointer to return hwaccel_picture_private

Returns

0 on success, < 0 on error

Definition at line 2266 of file decode.c.

Referenced by alloc_frame(), alloc_picture(), av1_frame_alloc(), decode_frame(), vp8_alloc_frame(), and vp9_frame_alloc().

Definition at line 2295 of file decode.c.

Referenced by avcodec_flush_buffers().

Definition at line 2313 of file decode.c.

Referenced by avcodec_open2(), and init_thread().

Definition at line 2318 of file decode.c.

Definition at line 2328 of file decode.c.

Referenced by ff_codec_close(), and ff_frame_thread_free().

Definition at line 2336 of file decode.c.

Referenced by exif_attach_ifd().

Definition at line 2357 of file decode.c.

Referenced by ff_decode_exif_attach_buffer(), and ff_decode_exif_attach_ifd().

Definition at line 2412 of file decode.c.

Referenced by decode_frame(), ff_mjpeg_decode_frame_from_buf(), and libjxl_attach_sidedata().

Attach the data buffer to the frame.

This is mostly a wrapper for av_side_data_new_from_buffer, but it checks if the orientation tag is present in the provided EXIF buffer. If it is, it zeroes it out and attaches that information as an AV_FRAME_DATA_DISPLAYMATRIX instead of including it in the AV_FRAME_DATA_EXIF side data buffer.

*buf is ALWAYS consumed by this function and NULL written in its place, even on failure.

Definition at line 2418 of file decode.c.

Referenced by decode_frame_common(), and webp_decode_frame().