utils.c File Reference

utils. More...

#include "libavutil/avassert.h"
#include "libavutil/avstring.h"
#include "libavutil/channel_layout.h"
#include "libavutil/crc.h"
#include "libavutil/mathematics.h"
#include "libavutil/pixdesc.h"
#include "libavutil/imgutils.h"
#include "libavutil/samplefmt.h"
#include "libavutil/dict.h"
#include "avcodec.h"
#include "dsputil.h"
#include "libavutil/opt.h"
#include "thread.h"
#include "internal.h"
#include "bytestream.h"
#include <stdlib.h>
#include <stdarg.h>
#include <limits.h>
#include <float.h>

Go to the source code of this file.

Macros

#define INTERNAL_BUFFER_SIZE   (32 + 1)
 
#define LICENSE_PREFIX   "libavcodec license: "
 

Functions

voidav_fast_realloc (void *ptr, unsigned int *size, size_t min_size)
 Reallocate the given block if it is not large enough, otherwise do nothing. More...
 
void av_fast_malloc (void *ptr, unsigned int *size, size_t min_size)
 Allocate a buffer, reusing the given one if large enough. More...
 
void av_fast_padded_malloc (void *ptr, unsigned int *size, size_t min_size)
 Allocate a buffer with padding, reusing the given one if large enough. More...
 
AVCodecav_codec_next (const AVCodec *c)
 If c is NULL, returns the first registered codec, if c is non-NULL, returns the next registered codec after c, or NULL if c is the last one. More...
 
static void avcodec_init (void)
 
int av_codec_is_encoder (const AVCodec *codec)
 
int av_codec_is_decoder (const AVCodec *codec)
 
void avcodec_register (AVCodec *codec)
 Register the codec codec and initialize libavcodec. More...
 
unsigned avcodec_get_edge_width (void)
 Return the amount of padding in pixels which the get_buffer callback must provide around the edge of the image for codecs which do not have the CODEC_FLAG_EMU_EDGE flag. More...
 
void avcodec_set_dimensions (AVCodecContext *s, int width, int height)
 
void avcodec_align_dimensions2 (AVCodecContext *s, int *width, int *height, int linesize_align[AV_NUM_DATA_POINTERS])
 Modify width and height values so that they will result in a memory buffer that is acceptable for the codec if you also ensure that all line sizes are a multiple of the respective linesize_align[i]. More...
 
void avcodec_align_dimensions (AVCodecContext *s, int *width, int *height)
 Modify width and height values so that they will result in a memory buffer that is acceptable for the codec if you do not use any horizontal padding. More...
 
int avcodec_fill_audio_frame (AVFrame *frame, int nb_channels, enum AVSampleFormat sample_fmt, const uint8_t *buf, int buf_size, int align)
 Fill audio frame data and linesize. More...
 
static int audio_get_buffer (AVCodecContext *avctx, AVFrame *frame)
 
static int video_get_buffer (AVCodecContext *s, AVFrame *pic)
 
int avcodec_default_get_buffer (AVCodecContext *avctx, AVFrame *frame)
 
int ff_get_buffer (AVCodecContext *avctx, AVFrame *frame)
 Get a buffer for a frame. More...
 
void avcodec_default_release_buffer (AVCodecContext *s, AVFrame *pic)
 
int avcodec_default_reget_buffer (AVCodecContext *s, AVFrame *pic)
 
int avcodec_default_execute (AVCodecContext *c, int(*func)(AVCodecContext *c2, void *arg2), void *arg, int *ret, int count, int size)
 
int avcodec_default_execute2 (AVCodecContext *c, int(*func)(AVCodecContext *c2, void *arg2, int jobnr, int threadnr), void *arg, int *ret, int count)
 
static int is_hwaccel_pix_fmt (enum AVPixelFormat pix_fmt)
 
enum AVPixelFormat avcodec_default_get_format (struct AVCodecContext *s, const enum AVPixelFormat *fmt)
 
void avcodec_get_frame_defaults (AVFrame *frame)
 Set the fields of the given AVFrame to default values. More...
 
AVFrameavcodec_alloc_frame (void)
 Allocate an AVFrame and set its fields to default values. More...
 
void avcodec_free_frame (AVFrame **frame)
 Free the frame and any dynamically allocated objects in it, e.g. More...
 
int attribute_align_arg avcodec_open2 (AVCodecContext *avctx, const AVCodec *codec, AVDictionary **options)
 Initialize the AVCodecContext to use the given AVCodec. More...
 
int ff_alloc_packet (AVPacket *avpkt, int size)
 Check AVPacket size and/or allocate data. More...
 
static int pad_last_frame (AVCodecContext *s, AVFrame **dst, const AVFrame *src)
 Pad last frame with silence. More...
 
int attribute_align_arg avcodec_encode_audio2 (AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
 Encode a frame of audio. More...
 
int attribute_align_arg avcodec_encode_video2 (AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
 Encode a frame of video. More...
 
int avcodec_encode_subtitle (AVCodecContext *avctx, uint8_t *buf, int buf_size, const AVSubtitle *sub)
 
static void apply_param_change (AVCodecContext *avctx, AVPacket *avpkt)
 
int attribute_align_arg avcodec_decode_video2 (AVCodecContext *avctx, AVFrame *picture, int *got_picture_ptr, AVPacket *avpkt)
 Decode the video frame of size avpkt->size from avpkt->data into picture. More...
 
int attribute_align_arg avcodec_decode_audio4 (AVCodecContext *avctx, AVFrame *frame, int *got_frame_ptr, AVPacket *avpkt)
 Decode the audio frame of size avpkt->size from avpkt->data into frame. More...
 
int avcodec_decode_subtitle2 (AVCodecContext *avctx, AVSubtitle *sub, int *got_sub_ptr, AVPacket *avpkt)
 Decode a subtitle message. More...
 
void avsubtitle_free (AVSubtitle *sub)
 Free all allocated data in the given subtitle struct. More...
 
av_cold int avcodec_close (AVCodecContext *avctx)
 Close a given AVCodecContext and free all the data associated with it (but not the AVCodecContext itself). More...
 
static AVCodecfind_encdec (enum AVCodecID id, int encoder)
 
AVCodecavcodec_find_encoder (enum AVCodecID id)
 Find a registered encoder with a matching codec ID. More...
 
AVCodecavcodec_find_encoder_by_name (const char *name)
 Find a registered encoder with the specified name. More...
 
AVCodecavcodec_find_decoder (enum AVCodecID id)
 Find a registered decoder with a matching codec ID. More...
 
AVCodecavcodec_find_decoder_by_name (const char *name)
 Find a registered decoder with the specified name. More...
 
static int get_bit_rate (AVCodecContext *ctx)
 
size_t av_get_codec_tag_string (char *buf, size_t buf_size, unsigned int codec_tag)
 Put a string representing the codec tag codec_tag in buf. More...
 
void avcodec_string (char *buf, int buf_size, AVCodecContext *enc, int encode)
 
const char * av_get_profile_name (const AVCodec *codec, int profile)
 Return a name for the specified profile, if available. More...
 
unsigned avcodec_version (void)
 Return the LIBAVCODEC_VERSION_INT constant. More...
 
const char * avcodec_configuration (void)
 Return the libavcodec build-time configuration. More...
 
const char * avcodec_license (void)
 Return the libavcodec license. More...
 
void avcodec_flush_buffers (AVCodecContext *avctx)
 Flush buffers, should be called when seeking or when switching to a different stream. More...
 
static void video_free_buffers (AVCodecContext *s)
 
static void audio_free_buffers (AVCodecContext *avctx)
 
void avcodec_default_free_buffers (AVCodecContext *avctx)
 
int av_get_exact_bits_per_sample (enum AVCodecID codec_id)
 Return codec bits per sample. More...
 
int av_get_bits_per_sample (enum AVCodecID codec_id)
 Return codec bits per sample. More...
 
int av_get_audio_frame_duration (AVCodecContext *avctx, int frame_bytes)
 Return audio frame duration. More...
 
int ff_thread_init (AVCodecContext *s)
 
unsigned int av_xiphlacing (unsigned char *s, unsigned int v)
 Encode extradata length to a buffer. More...
 
int ff_match_2uint16 (const uint16_t(*tab)[2], int size, int a, int b)
 Return the index into tab at which {a,b} match elements {[0],[1]} of tab. More...
 
void av_log_missing_feature (void *avc, const char *feature, int want_sample)
 Log a generic warning message about a missing feature. More...
 
void av_log_ask_for_sample (void *avc, const char *msg,...)
 
void av_register_hwaccel (AVHWAccel *hwaccel)
 Register the hardware accelerator hwaccel. More...
 
AVHWAccelav_hwaccel_next (AVHWAccel *hwaccel)
 If hwaccel is NULL, returns the first registered hardware accelerator, if hwaccel is non-NULL, returns the next registered hardware accelerator after hwaccel, or NULL if hwaccel is the last one. More...
 
AVHWAccelff_find_hwaccel (enum AVCodecID codec_id, enum AVPixelFormat pix_fmt)
 Return the hardware accelerated codec for codec codec_id and pixel format pix_fmt. More...
 
int av_lockmgr_register (int(*cb)(void **mutex, enum AVLockOp op))
 Register a user provided lock manager supporting the operations specified by AVLockOp. More...
 
int avpriv_lock_avformat (void)
 
int avpriv_unlock_avformat (void)
 
unsigned int avpriv_toupper4 (unsigned int x)
 
int ff_thread_get_buffer (AVCodecContext *avctx, AVFrame *f)
 Wrapper around get_buffer() for frame-multithreaded codecs. More...
 
void ff_thread_release_buffer (AVCodecContext *avctx, AVFrame *f)
 Wrapper around release_buffer() frame-for multithreaded codecs. More...
 
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...
 
void ff_thread_report_progress (AVFrame *f, int progress, int field)
 Notify later decoding threads when part of their reference picture is ready. More...
 
void ff_thread_await_progress (AVFrame *f, int progress, int field)
 Wait for earlier decoding threads to finish reference pictures. More...
 
enum AVMediaType avcodec_get_type (enum AVCodecID codec_id)
 Get the type of the given codec. More...
 
int avcodec_is_open (AVCodecContext *s)
 

Variables

static int volatile entangled_thread_counter = 0
 
static int(* ff_lockmgr_cb )(void **mutex, enum AVLockOp op)
 
static voidcodec_mutex
 
static voidavformat_mutex
 
static AVCodecfirst_avcodec = NULL
 
static AVHWAccelfirst_hwaccel = NULL
 

Detailed Description

utils.

Definition in file utils.c.

Macro Definition Documentation

#define INTERNAL_BUFFER_SIZE   (32 + 1)

Definition at line 157 of file utils.c.

Referenced by video_free_buffers(), and video_get_buffer().

#define LICENSE_PREFIX   "libavcodec license: "

Referenced by avcodec_license().

Function Documentation

static void apply_param_change ( AVCodecContext avctx,
AVPacket avpkt 
)
static

Definition at line 1226 of file utils.c.

Referenced by avcodec_decode_audio4(), and avcodec_decode_video2().

static void audio_free_buffers ( AVCodecContext avctx)
static

Definition at line 1750 of file utils.c.

Referenced by avcodec_default_free_buffers().

static int audio_get_buffer ( AVCodecContext avctx,
AVFrame frame 
)
static

Definition at line 300 of file utils.c.

Referenced by avcodec_default_get_buffer().

void av_log_ask_for_sample ( void avc,
const char *  msg,
  ... 
)

Definition at line 2017 of file utils.c.

Referenced by av_log_missing_feature().

int avcodec_default_execute2 ( AVCodecContext c,
int(*)(AVCodecContext *c2, void *arg2, int jobnr, int threadnr)  func,
void arg,
int *  ret,
int  count 
)

Definition at line 579 of file utils.c.

static void avcodec_init ( void  )
static

Definition at line 109 of file utils.c.

Referenced by avcodec_register().

int avpriv_lock_avformat ( void  )

Definition at line 2079 of file utils.c.

Referenced by ff_tls_deinit(), and ff_tls_init().

unsigned int avpriv_toupper4 ( unsigned int  x)

Definition at line 2097 of file utils.c.

Referenced by ff_codec_get_id(), ff_MPV_common_init(), and validate_codec_tag().

int avpriv_unlock_avformat ( void  )

Definition at line 2088 of file utils.c.

Referenced by ff_tls_deinit(), and ff_tls_init().

int ff_alloc_packet ( AVPacket avpkt,
int  size 
)

Check AVPacket size and/or allocate data.

Encoders supporting AVCodec.encode2() can use this as a convenience to ensure the output packet data is large enough, whether provided by the user or allocated in this function.

Parameters
avpktthe AVPacket If avpkt->data is already set, avpkt->size is checked to ensure it is large enough. If avpkt->data is NULL, a new buffer is allocated. avpkt->size is set to the specified size. All other AVPacket fields will be reset with av_init_packet().
sizethe minimum required packet size
Returns
0 on success, negative error code on failure

Definition at line 880 of file utils.c.

Referenced by a64multi_encode_frame(), aac_encode_frame(), adpcm_encode_frame(), adx_encode_frame(), alac_encode_frame(), amr_wb_encode_frame(), bmp_encode_frame(), cng_encode_frame(), dnxhd_encode_picture(), encode_frame(), encode_nals(), encode_picture_lossless(), encode_picture_ls(), encode_superframe(), Faac_encode_frame(), ff_MPV_encode_picture(), ffv1_encode_frame(), flac_encode_frame(), flashsv_encode_frame(), g722_encode_frame(), gif_encode_frame(), ilbc_encode_frame(), libgsm_encode_frame(), libopenjpeg_encode_frame(), libopus_encode(), libschroedinger_encode_frame(), mp3lame_encode_frame(), MPA_encode_frame(), oggvorbis_encode_frame(), pam_encode_frame(), pcm_encode_frame(), pcx_encode_frame(), pnm_encode_frame(), qtrle_encode_frame(), ra144_encode_frame(), raw_encode(), roq_dpcm_encode_frame(), roq_encode_frame(), storeframe(), sunrast_encode_frame(), targa_encode_frame(), utvideo_encode_frame(), v410_encode_frame(), vorbis_encode_frame(), XAVS_frame(), xbm_encode_frame(), and xwd_encode_frame().

AVHWAccel* ff_find_hwaccel ( enum AVCodecID  codec_id,
enum AVPixelFormat  pix_fmt 
)

Return the hardware accelerated codec for codec codec_id and pixel format pix_fmt.

Parameters
codec_idthe codec to match
pix_fmtthe pixel format to match
Returns
the hardware accelerated codec, or NULL if none was found.

Definition at line 2048 of file utils.c.

Referenced by ff_h263_decode_init(), h264_slice_header_init(), vc1_decode_init(), and vcr2_init_sequence().

int ff_get_buffer ( AVCodecContext avctx,
AVFrame frame 
)

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 464 of file utils.c.

Referenced by ac3_decode_frame(), adpcm_decode_frame(), adx_decode_frame(), amrnb_decode_frame(), amrwb_decode_frame(), ape_decode_frame(), atrac1_decode_frame(), atrac3_decode_frame(), aura_decode_frame(), avcodec_default_reget_buffer(), bfi_decode_frame(), bmp_decode_frame(), bmv_aud_decode_frame(), cdg_decode_frame(), cdxl_decode_frame(), cinaudio_decode_frame(), cllc_decode_frame(), cmv_decode_frame(), cng_decode_frame(), cook_decode_frame(), cyuv_decode_frame(), dca_decode_frame(), decode_element(), decode_frame(), decode_frame_byterun1(), decode_frame_ilbm(), decode_p_frame(), decode_pic(), decode_tag(), dfa_decode_frame(), dnxhd_decode_frame(), dpcm_decode_frame(), dvvideo_decode_frame(), eightsvx_decode_frame(), encode_init(), escape124_decode_frame(), execute_code(), ff_ivi_decode_frame(), ff_mjpeg_decode_sof(), ff_snow_frame_start(), ff_thread_get_buffer(), ff_vp56_decode_frame(), ffv1_decode_frame(), flac_decode_frame(), frame_configure_elements(), g722_decode_frame(), g723_1_decode_frame(), get_buffer(), gif_decode_frame(), gsm_decode_frame(), idcin_decode_frame(), ilbc_decode_frame(), imc_decode_frame(), init_image(), ipvideo_decode_frame(), libgsm_decode_frame(), libopus_decode(), libschroedinger_decode_frame(), libspeex_decode_frame(), mace_decode_frame(), mca(), mp_decode_frame(), mpc7_decode_frame(), mpc8_decode_frame(), mss2_decode_frame(), mxpeg_decode_frame(), output_data(), pcm_bluray_decode_frame(), pcm_decode_frame(), pcx_decode_frame(), pnm_decode_frame(), ptx_decode_frame(), qcelp_decode_frame(), qdm2_decode_frame(), ra144_decode_frame(), ra288_decode_frame(), rl2_decode_frame(), roq_encode_frame(), s302m_decode_frame(), shorten_decode_frame(), sipr_decode_frame(), smka_decode_frame(), submit_packet(), sunrast_decode_frame(), svq1_decode_frame(), svq1_encode_frame(), synth_superframe(), tak_decode_frame(), tgq_decode_frame(), tmv_decode_frame(), tqi_decode_frame(), truespeech_decode_frame(), tta_decode_frame(), twin_decode_frame(), txd_decode_frame(), v410_decode_frame(), vble_decode_frame(), vcr1_decode_frame(), vmdaudio_decode_frame(), vmdvideo_decode_frame(), vorbis_decode_frame(), vqa_decode_frame(), wavpack_decode_frame(), wma_decode_superframe(), ws_snd_decode_frame(), xan_decode_frame(), xwd_decode_frame(), yop_decode_frame(), and zerocodec_decode_frame().

int ff_match_2uint16 ( const uint16_t(*)  tab[2],
int  size,
int  a,
int  b 
)

Return the index into tab at which {a,b} match elements {[0],[1]} of tab.

If there is no such matching pair then size is returned.

Definition at line 2000 of file utils.c.

Referenced by ff_h263_encode_picture_header(), ff_MPV_encode_init(), and svq1_write_header().

void ff_thread_await_progress ( AVFrame 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
fThe picture being referenced.
progressValue, in arbitrary units, to wait for.
fieldThe field being referenced, for field-picture codecs. 0 for top field or frame pictures, 1 for bottom field.

Definition at line 2126 of file utils.c.

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 2118 of file utils.c.

int ff_thread_get_buffer ( AVCodecContext avctx,
AVFrame f 
)

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
avctxThe current context.
fThe frame to write into.

Definition at line 2107 of file utils.c.

int ff_thread_init ( AVCodecContext s)

Definition at line 1979 of file utils.c.

Referenced by avcodec_open2().

void ff_thread_release_buffer ( AVCodecContext avctx,
AVFrame 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.

Parameters
avctxThe current context.
fThe picture being released.

Definition at line 2113 of file utils.c.

void ff_thread_report_progress ( AVFrame 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
fThe picture being decoded.
progressValue, in arbitrary units, of how much of the picture has decoded.
fieldThe field being decoded, for field-picture codecs. 0 for top field or frame pictures, 1 for bottom field.

Definition at line 2122 of file utils.c.

static AVCodec* find_encdec ( enum AVCodecID  id,
int  encoder 
)
static

Definition at line 1479 of file utils.c.

Referenced by avcodec_find_decoder(), and avcodec_find_encoder().

static int get_bit_rate ( AVCodecContext ctx)
static

Definition at line 1534 of file utils.c.

Referenced by avcodec_string().

static int is_hwaccel_pix_fmt ( enum AVPixelFormat  pix_fmt)
static

Definition at line 591 of file utils.c.

Referenced by avcodec_default_get_format().

static int pad_last_frame ( AVCodecContext s,
AVFrame **  dst,
const AVFrame src 
)
static

Pad last frame with silence.

Definition at line 903 of file utils.c.

Referenced by avcodec_encode_audio2().

static void video_free_buffers ( AVCodecContext s)
static

Definition at line 1727 of file utils.c.

Referenced by avcodec_default_free_buffers().

static int video_get_buffer ( AVCodecContext s,
AVFrame pic 
)
static

Definition at line 331 of file utils.c.

Referenced by avcodec_default_get_buffer().

Variable Documentation

void* avformat_mutex
static

Definition at line 51 of file utils.c.

Referenced by av_lockmgr_register(), avpriv_lock_avformat(), and avpriv_unlock_avformat().

void* codec_mutex
static

Definition at line 50 of file utils.c.

Referenced by av_lockmgr_register(), avcodec_close(), and avcodec_open2().

int volatile entangled_thread_counter = 0
static

Definition at line 48 of file utils.c.

Referenced by avcodec_close(), and avcodec_open2().

int(* ff_lockmgr_cb)(void **mutex, enum AVLockOp op)
static
AVCodec* first_avcodec = NULL
static
AVHWAccel* first_hwaccel = NULL
static

Definition at line 2032 of file utils.c.

Referenced by av_hwaccel_next(), and av_register_hwaccel().