libavcodec/utils.c File Reference

utils. More...

#include "libavutil/avstring.h"
#include "libavutil/integer.h"
#include "libavutil/crc.h"
#include "libavutil/pixdesc.h"
#include "libavutil/audioconvert.h"
#include "libavutil/imgutils.h"
#include "libavutil/samplefmt.h"
#include "avcodec.h"
#include "dsputil.h"
#include "libavutil/opt.h"
#include "imgconvert.h"
#include "thread.h"
#include "audioconvert.h"
#include "internal.h"
#include <stdlib.h>
#include <stdarg.h>
#include <limits.h>
#include <float.h>
#include "libavutil/parseutils.h"

Go to the source code of this file.

Data Structures

struct  InternalBuffer

Defines

#define INTERNAL_BUFFER_SIZE   32
#define SANE_NB_CHANNELS   128U
#define LICENSE_PREFIX   "libavcodec license: "

Functions

void * av_fast_realloc (void *ptr, unsigned int *size, FF_INTERNALC_MEM_TYPE min_size)
 Reallocate the given block if it is not large enough, otherwise do nothing.
void av_fast_malloc (void *ptr, unsigned int *size, FF_INTERNALC_MEM_TYPE min_size)
 Allocate a buffer, reusing the given one if large enough.
AVCodecav_codec_next (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.
void avcodec_register (AVCodec *codec)
 Register the codec codec and initialize libavcodec.
void register_avcodec (AVCodec *codec)
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.
void avcodec_set_dimensions (AVCodecContext *s, int width, int height)
void avcodec_align_dimensions2 (AVCodecContext *s, int *width, int *height, int linesize_align[4])
 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].
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.
int avcodec_check_dimensions (void *av_log_ctx, unsigned int w, unsigned int h)
int avcodec_default_get_buffer (AVCodecContext *s, AVFrame *pic)
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)
enum PixelFormat avcodec_default_get_format (struct AVCodecContext *s, const enum PixelFormat *fmt)
void avcodec_get_frame_defaults (AVFrame *pic)
 Set the fields of the given AVFrame to default values.
AVFrameavcodec_alloc_frame (void)
 Allocate an AVFrame and set its fields to default values.
int attribute_align_arg avcodec_open (AVCodecContext *avctx, AVCodec *codec)
 Initialize the AVCodecContext to use the given AVCodec.
int attribute_align_arg avcodec_encode_audio (AVCodecContext *avctx, uint8_t *buf, int buf_size, const short *samples)
 Encode an audio frame from samples into buf.
int attribute_align_arg avcodec_encode_video (AVCodecContext *avctx, uint8_t *buf, int buf_size, const AVFrame *pict)
 Encode a video frame from pict into buf.
int avcodec_encode_subtitle (AVCodecContext *avctx, uint8_t *buf, int buf_size, const AVSubtitle *sub)
int attribute_align_arg avcodec_decode_video (AVCodecContext *avctx, AVFrame *picture, int *got_picture_ptr, const uint8_t *buf, int buf_size)
 Decode a video frame from buf into picture.
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.
int attribute_align_arg avcodec_decode_audio2 (AVCodecContext *avctx, int16_t *samples, int *frame_size_ptr, const uint8_t *buf, int buf_size)
 Decode an audio frame from buf into samples.
int attribute_align_arg avcodec_decode_audio3 (AVCodecContext *avctx, int16_t *samples, int *frame_size_ptr, AVPacket *avpkt)
 Decode the audio frame of size avpkt->size from avpkt->data into samples.
int avcodec_decode_subtitle (AVCodecContext *avctx, AVSubtitle *sub, int *got_sub_ptr, const uint8_t *buf, int buf_size)
int avcodec_decode_subtitle2 (AVCodecContext *avctx, AVSubtitle *sub, int *got_sub_ptr, AVPacket *avpkt)
 Decode a subtitle message.
void avsubtitle_free (AVSubtitle *sub)
 Frees all allocated data in the given subtitle struct.
av_cold int avcodec_close (AVCodecContext *avctx)
AVCodecavcodec_find_encoder (enum CodecID id)
 Find a registered encoder with a matching codec ID.
AVCodecavcodec_find_encoder_by_name (const char *name)
 Find a registered encoder with the specified name.
AVCodecavcodec_find_decoder (enum CodecID id)
 Find a registered decoder with a matching codec ID.
AVCodecavcodec_find_decoder_by_name (const char *name)
 Find a registered decoder with the specified name.
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.
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.
unsigned avcodec_version (void)
 Return the LIBAVCODEC_VERSION_INT constant.
const char * avcodec_configuration (void)
 Return the libavcodec build-time configuration.
const char * avcodec_license (void)
 Return the libavcodec license.
void avcodec_init (void)
 Initialize libavcodec.
void avcodec_flush_buffers (AVCodecContext *avctx)
 Flush buffers, should be called when seeking or when switching to a different stream.
void avcodec_default_free_buffers (AVCodecContext *s)
char av_get_pict_type_char (int pict_type)
 Return a single letter to describe the given picture type pict_type.
int av_get_bits_per_sample (enum CodecID codec_id)
 Return codec bits per sample.
int av_get_bits_per_sample_format (enum AVSampleFormat sample_fmt)
int ff_thread_init (AVCodecContext *s, int thread_count)
unsigned int av_xiphlacing (unsigned char *s, unsigned int v)
 Encode extradata length to a buffer.
int av_parse_video_frame_size (int *width_ptr, int *height_ptr, const char *str)
 Parse str and put in width_ptr and height_ptr the detected values.
int av_parse_video_frame_rate (AVRational *frame_rate, const char *arg)
 Parse str and store the detected values in *frame_rate.
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.
void av_log_missing_feature (void *avc, const char *feature, int want_sample)
 Logs a generic warning message about a missing feature.
void av_log_ask_for_sample (void *avc, const char *msg)
 Log a generic warning message asking for a sample.
void av_register_hwaccel (AVHWAccel *hwaccel)
 Register the hardware accelerator hwaccel.
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.
AVHWAccelff_find_hwaccel (enum CodecID codec_id, enum PixelFormat pix_fmt)
 Return the hardware accelerated codec for codec codec_id and pixel format pix_fmt.
int av_lockmgr_register (int(*cb)(void **mutex, enum AVLockOp op))
 Register a user provided lock manager supporting the operations specified by AVLockOp.
unsigned int ff_toupper4 (unsigned int x)
int ff_thread_get_buffer (AVCodecContext *avctx, AVFrame *f)
 Wrapper around get_buffer() for frame-multithreaded codecs.
void ff_thread_release_buffer (AVCodecContext *avctx, AVFrame *f)
 Wrapper around release_buffer() frame-for multithreaded codecs.
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.
void ff_thread_report_progress (AVFrame *f, int progress, int field)
 Notifies later decoding threads when part of their reference picture is ready.
void ff_thread_await_progress (AVFrame *f, int progress, int field)
 Waits 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.
int avcodec_thread_init (AVCodecContext *s, int thread_count)
void avcodec_thread_free (AVCodecContext *s)

Variables

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


Detailed Description

utils.

Definition in file utils.c.


Define Documentation

#define INTERNAL_BUFFER_SIZE   32

Definition at line 125 of file utils.c.

Referenced by avcodec_default_free_buffers(), and avcodec_default_get_buffer().

#define LICENSE_PREFIX   "libavcodec license: "

#define SANE_NB_CHANNELS   128U

Referenced by avcodec_open().


Function Documentation

AVCodec* av_codec_next ( 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.

Definition at line 82 of file utils.c.

Referenced by opt_default(), show_codecs(), and show_help().

void av_fast_malloc ( void *  ptr,
unsigned int *  size,
FF_INTERNALC_MEM_TYPE  min_size 
)

Allocate a buffer, reusing the given one if large enough.

Contrary to av_fast_realloc the current buffer contents might not be preserved and on error the old buffer is freed, thus no special handling to avoid memleaks is necessary.

Parameters:
ptr pointer to pointer to already allocated buffer, overwritten with pointer to new buffer
size size of the buffer *ptr points to
min_size minimum size of *ptr buffer after returning, *ptr will be NULL and *size 0 if an error occurred.

Definition at line 67 of file utils.c.

Referenced by codec_reinit(), decode_frame(), decode_i_frame(), decode_p_frame(), do_audio_out(), ff_h263_decode_frame(), ff_h264_decode_nal(), ff_id3v2_parse(), ljpeg_decode_rgb_scan(), mimic_decode_frame(), mp_decode_frame(), parse_picture_segment(), spdif_header_dts4(), spdif_write_packet(), submit_packet(), tqi_decode_frame(), truemotion1_decode_header(), and truemotion1_decode_init().

void* av_fast_realloc ( void *  ptr,
unsigned int *  size,
FF_INTERNALC_MEM_TYPE  min_size 
)

int av_get_bits_per_sample ( enum CodecID  codec_id  ) 

int av_get_bits_per_sample_format ( enum AVSampleFormat  sample_fmt  ) 

Deprecated:
Use av_get_bits_per_sample_fmt() instead.

Definition at line 1134 of file utils.c.

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.

Parameters:
buf_size size in bytes of buf
Returns:
the length of the string that would have been generated if enough space had been available, excluding the trailing null

Definition at line 877 of file utils.c.

Referenced by av_write_header(), avcodec_string(), and show_stream().

char av_get_pict_type_char ( int  pict_type  ) 

Return a single letter to describe the given picture type pict_type.

Parameters:
[in] pict_type the picture type
Returns:
A single character representing the picture type.

Definition at line 1075 of file utils.c.

Referenced by decode_slice_header(), do_video_stats(), ff_flv_decode_picture_header(), ff_h263_show_pict_info(), ff_h264_decode_mb_cavlc(), ff_rate_estimate_qscale(), output_picture2(), and svq3_decode_frame().

const char* av_get_profile_name ( const AVCodec codec,
int  profile 
)

Return a name for the specified profile, if available.

Parameters:
codec the codec that is searched for the given profile
profile the profile value for which a name is requested
Returns:
A name for the profile if found, NULL otherwise.

Definition at line 1008 of file utils.c.

Referenced by avcodec_string().

AVHWAccel* av_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.

Definition at line 1212 of file utils.c.

Referenced by ff_find_hwaccel().

int av_lockmgr_register ( int(*)(void **mutex, enum AVLockOp op)  cb  ) 

Register a user provided lock manager supporting the operations specified by AVLockOp.

mutex points to a (void *) where the lockmgr should store/get a pointer to a user allocated mutex. It's NULL upon AV_LOCK_CREATE and != NULL for all other ops.

Parameters:
cb User defined callback. Note: FFmpeg may invoke calls to this callback during the call to av_lockmgr_register(). Thus, the application must be prepared to handle that. If cb is set to NULL the lockmgr will be unregistered. Also note that during unregistration the previously registered lockmgr callback may also be invoked.

Definition at line 1229 of file utils.c.

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

Log a generic warning message asking for a sample.

This function is intended to be used internally by FFmpeg (libavcodec, libavformat, etc.) only, and would normally not be used by applications.

Parameters:
[in] avc a pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct
[in] msg string containing an optional message, or NULL if no message

Definition at line 1192 of file utils.c.

Referenced by au_read_header(), av_log_missing_feature(), dca_exss_parse_header(), decode_channel_transform(), decode_frame(), decode_init(), decode_subframe(), determine_bitrate(), execute_code(), ff_parse_mpeg2_descriptor(), read_header(), rso_read_header(), save_bits(), spdif_header_dts(), spdif_header_truehd(), and spdif_read_packet().

void av_log_missing_feature ( void *  avc,
const char *  feature,
int  want_sample 
)

Logs a generic warning message about a missing feature.

This function is intended to be used internally by FFmpeg (libavcodec, libavformat, etc.) only, and would normally not be used by applications.

Parameters:
[in] avc a pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct
[in] feature string containing the name of the missing feature
[in] want_sample indicates if samples are wanted which exhibit this feature. If want_sample is non-zero, additional verbage will be added to the log message which tells the user how to report samples to the development mailing list.

Definition at line 1180 of file utils.c.

Referenced by aac_adtstoasc_filter(), amrnb_decode_frame(), amrwb_decode_frame(), avcodec_default_get_buffer(), decode_audio_block(), decode_frame_header(), decode_ga_specific_config(), decode_ics(), decode_subframe(), ff_eac3_parse_header(), latm_decode_audio_specific_config(), mpc8_decode_init(), parse_adts_frame_header(), parse_fmtp(), qt_rtp_parse_packet(), read_sbr_extension(), read_stream_mux_config(), spdif_get_offset_and_codec(), spdif_read_packet(), and synth_superframe().

int av_parse_video_frame_rate ( AVRational frame_rate,
const char *  str 
)

Parse str and store the detected values in *frame_rate.

Deprecated:
Deprecated in favor of av_parse_video_rate().

Definition at line 1168 of file utils.c.

int av_parse_video_frame_size ( int *  width_ptr,
int *  height_ptr,
const char *  str 
)

Parse str and put in width_ptr and height_ptr the detected values.

Deprecated:
Deprecated in favor of av_parse_video_size().

Definition at line 1163 of file utils.c.

void av_register_hwaccel ( AVHWAccel hwaccel  ) 

Register the hardware accelerator hwaccel.

Definition at line 1203 of file utils.c.

unsigned int av_xiphlacing ( unsigned char *  s,
unsigned int  v 
)

Encode extradata length to a buffer.

Used by xiph codecs.

Parameters:
s buffer to write to; must be at least (v/255+1) bytes long
v size of extradata in bytes
Returns:
number of bytes written to the buffer.

Definition at line 1146 of file utils.c.

Referenced by fixup_vorbis_headers(), oggvorbis_encode_init(), parse_packed_headers(), and put_main_header().

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.

May only be used if a codec with CODEC_CAP_DR1 has been opened. If CODEC_FLAG_EMU_EDGE is not set, the dimensions must have been increased according to avcodec_get_edge_width() before.

Definition at line 211 of file utils.c.

void avcodec_align_dimensions2 ( AVCodecContext s,
int *  width,
int *  height,
int  linesize_align[4] 
)

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].

May only be used if a codec with CODEC_CAP_DR1 has been opened. If CODEC_FLAG_EMU_EDGE is not set, the dimensions must have been increased according to avcodec_get_edge_width() before.

Definition at line 127 of file utils.c.

Referenced by avcodec_align_dimensions(), and avcodec_default_get_buffer().

AVFrame* avcodec_alloc_frame ( void   ) 

int avcodec_check_dimensions ( void *  av_log_ctx,
unsigned int  w,
unsigned int  h 
)

Deprecated:
Deprecated in favor of av_check_image_size().

Definition at line 224 of file utils.c.

av_cold int avcodec_close ( AVCodecContext avctx  ) 

const char* avcodec_configuration ( void   ) 

Return the libavcodec build-time configuration.

Definition at line 1026 of file utils.c.

int attribute_align_arg avcodec_decode_audio2 ( AVCodecContext avctx,
int16_t *  samples,
int *  frame_size_ptr,
const uint8_t *  buf,
int  buf_size 
)

Decode an audio frame from buf into samples.

Wrapper function which calls avcodec_decode_audio3.

Deprecated:
Use avcodec_decode_audio3 instead.
Parameters:
avctx the codec context
[out] samples the output buffer
[in,out] frame_size_ptr the output buffer size in bytes
[in] buf the input buffer
[in] buf_size the input buffer size in bytes
Returns:
On error a negative value is returned, otherwise the number of bytes used or zero if no frame could be decompressed.

Definition at line 673 of file utils.c.

int attribute_align_arg avcodec_decode_audio3 ( AVCodecContext avctx,
int16_t *  samples,
int *  frame_size_ptr,
AVPacket avpkt 
)

Decode the audio frame of size avpkt->size from avpkt->data into samples.

Some decoders may support multiple frames in a single AVPacket, such decoders would then just decode the first frame. In this case, avcodec_decode_audio3 has to be called again with an AVPacket that contains the remaining data in order to decode the second frame etc. If no frame could be outputted, frame_size_ptr is zero. Otherwise, it is the decompressed frame size in bytes.

Warning:
You must set frame_size_ptr to the allocated size of the output buffer before calling avcodec_decode_audio3().

The input buffer must be FF_INPUT_BUFFER_PADDING_SIZE larger than the actual read bytes because some optimized bitstream readers read 32 or 64 bits at once and could read over the end.

The end of the input buffer avpkt->data should be set to 0 to ensure that no overreading happens for damaged MPEG streams.

Note:
You might have to align the input buffer avpkt->data and output buffer samples. The alignment requirements depend on the CPU: On some CPUs it isn't necessary at all, on others it won't work at all if not aligned and on others it will work but it will have an impact on performance.
In practice, avpkt->data should have 4 byte alignment at minimum and samples should be 16 byte aligned unless the CPU doesn't need it (AltiVec and SSE do).

Parameters:
avctx the codec context
[out] samples the output buffer, sample type in avctx->sample_fmt
[in,out] frame_size_ptr the output buffer size in bytes
[in] avpkt The input AVPacket containing the input buffer. You can create such packet with av_init_packet() and by then setting data and size, some decoders might in addition need other fields. All decoders are designed to use the least fields possible though.
Returns:
On error a negative value is returned, otherwise the number of bytes used or zero if no frame data was decompressed (used) from the input AVPacket.

Definition at line 686 of file utils.c.

Referenced by audio_decode_example(), audio_decode_frame(), avcodec_decode_audio2(), output_packet(), and try_decode_frame().

int avcodec_decode_subtitle ( AVCodecContext avctx,
AVSubtitle sub,
int *  got_sub_ptr,
const uint8_t *  buf,
int  buf_size 
)

Definition at line 716 of file utils.c.

int avcodec_decode_subtitle2 ( AVCodecContext avctx,
AVSubtitle sub,
int *  got_sub_ptr,
AVPacket avpkt 
)

Decode a subtitle message.

Return a negative value on error, otherwise return the number of bytes used. If no subtitle could be decompressed, got_sub_ptr is zero. Otherwise, the subtitle is stored in *sub. Note that CODEC_CAP_DR1 is not available for subtitle codecs. This is for simplicity, because the performance difference is expect to be negligible and reusing a get_buffer written for video codecs would probably perform badly due to a potentially very different allocation pattern.

Parameters:
avctx the codec context
[out] sub The AVSubtitle in which the decoded subtitle will be stored, must be freed with avsubtitle_free if *got_sub_ptr is set.
[in,out] got_sub_ptr Zero if no subtitle could be decompressed, otherwise, it is nonzero.
[in] avpkt The input AVPacket containing the input buffer.

Definition at line 729 of file utils.c.

Referenced by avcodec_decode_subtitle(), output_packet(), and subtitle_thread().

int attribute_align_arg avcodec_decode_video ( AVCodecContext avctx,
AVFrame picture,
int *  got_picture_ptr,
const uint8_t *  buf,
int  buf_size 
)

Decode a video frame from buf into picture.

Wrapper function which calls avcodec_decode_video2.

Deprecated:
Use avcodec_decode_video2 instead.
Parameters:
avctx the codec context
[out] picture The AVFrame in which the decoded video frame will be stored.
[in] buf the input buffer
[in] buf_size the size of the input buffer in bytes
[in,out] got_picture_ptr Zero if no frame could be decompressed, otherwise, it is nonzero.
Returns:
On error a negative value is returned, otherwise the number of bytes used or zero if no frame could be decompressed.

Definition at line 625 of file utils.c.

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.

Some decoders may support multiple frames in a single AVPacket, such decoders would then just decode the first frame.

Warning:
The input buffer must be FF_INPUT_BUFFER_PADDING_SIZE larger than the actual read bytes because some optimized bitstream readers read 32 or 64 bits at once and could read over the end.

The end of the input buffer buf should be set to 0 to ensure that no overreading happens for damaged MPEG streams.

Note:
You might have to align the input buffer avpkt->data. The alignment requirements depend on the CPU: on some CPUs it isn't necessary at all, on others it won't work at all if not aligned and on others it will work but it will have an impact on performance.
In practice, avpkt->data should have 4 byte alignment at minimum.

Note:
Some codecs have a delay between input and output, these need to be fed with avpkt->data=NULL, avpkt->size=0 at the end to return the remaining frames.
Parameters:
avctx the codec context
[out] picture The AVFrame in which the decoded video frame will be stored. Use avcodec_alloc_frame to get an AVFrame, the codec will allocate memory for the actual bitmap. with default get/release_buffer(), the decoder frees/reuses the bitmap as it sees fit. with overridden get/release_buffer() (needs CODEC_CAP_DR1) the user decides into what buffer the decoder decodes and the decoder tells the user once it does not need the data anymore, the user app can at this point free/reuse/keep the memory as it sees fit.
[in] avpkt The input AVpacket containing the input buffer. You can create such packet with av_init_packet() and by then setting data and size, some decoders might in addition need other fields like flags&AV_PKT_FLAG_KEY. All decoders are designed to use the least fields possible.
[in,out] got_picture_ptr Zero if no frame could be decompressed, otherwise, it is nonzero.
Returns:
On error a negative value is returned, otherwise the number of bytes used or zero if no frame could be decompressed.

Definition at line 640 of file utils.c.

Referenced by avcodec_decode_video(), get_video_frame(), movie_get_frame(), output_packet(), try_decode_frame(), and video_decode_example().

int avcodec_default_execute ( AVCodecContext c,
int(*)(AVCodecContext *c2, void *arg2)  func,
void *  arg,
int *  ret,
int  count,
int  size 
)

Definition at line 427 of file utils.c.

Referenced by avcodec_get_context_defaults2(), and avcodec_thread_execute().

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

void avcodec_default_free_buffers ( AVCodecContext s  ) 

Definition at line 1056 of file utils.c.

Referenced by avcodec_close(), frame_thread_free(), and MPV_common_end().

int avcodec_default_get_buffer ( AVCodecContext s,
AVFrame pic 
)

Definition at line 229 of file utils.c.

Referenced by avcodec_get_context_defaults2(), ff_thread_get_buffer(), and submit_packet().

enum PixelFormat avcodec_default_get_format ( struct AVCodecContext s,
const enum PixelFormat fmt 
)

Definition at line 447 of file utils.c.

Referenced by avcodec_get_context_defaults2().

int avcodec_default_reget_buffer ( AVCodecContext s,
AVFrame pic 
)

Definition at line 391 of file utils.c.

Referenced by avcodec_get_context_defaults2().

void avcodec_default_release_buffer ( AVCodecContext s,
AVFrame pic 
)

Definition at line 362 of file utils.c.

Referenced by avcodec_get_context_defaults2().

int attribute_align_arg avcodec_encode_audio ( AVCodecContext avctx,
uint8_t *  buf,
int  buf_size,
const short *  samples 
)

Encode an audio frame from samples into buf.

Note:
The output buffer should be at least FF_MIN_BUFFER_SIZE bytes large. However, for PCM audio the user will know how much space is needed because it depends on the value passed in buf_size as described below. In that case a lower value can be used.
Parameters:
avctx the codec context
[out] buf the output buffer
[in] buf_size the output buffer size
[in] samples the input buffer containing the samples The number of samples read from this buffer is frame_size*channels, both of which are defined in avctx. For PCM audio the number of samples read from samples is equal to buf_size * input_sample_size / output_sample_size.
Returns:
On error a negative value is returned, on success zero or the number of bytes used to encode the data read from the input buffer.

Definition at line 575 of file utils.c.

Referenced by audio_encode_example(), do_audio_out(), output_packet(), and write_audio_frame().

int avcodec_encode_subtitle ( AVCodecContext avctx,
uint8_t *  buf,
int  buf_size,
const AVSubtitle sub 
)

Definition at line 609 of file utils.c.

Referenced by do_subtitle_out().

int attribute_align_arg avcodec_encode_video ( AVCodecContext avctx,
uint8_t *  buf,
int  buf_size,
const AVFrame pict 
)

Encode a video frame from pict into buf.

The input picture should be stored using a specific format, namely avctx.pix_fmt.

Parameters:
avctx the codec context
[out] buf the output buffer for the bitstream of encoded frame
[in] buf_size the size of the output buffer in bytes
[in] pict the input picture to encode
Returns:
On error a negative value is returned, on success zero or the number of bytes used from the output buffer.

Definition at line 590 of file utils.c.

Referenced by do_video_out(), estimate_best_b_count(), output_packet(), video_encode_example(), and write_video_frame().

AVCodec* avcodec_find_decoder ( enum CodecID  id  ) 

Find a registered decoder with a matching codec ID.

Parameters:
id CodecID of the requested decoder
Returns:
A decoder if one was found, NULL otherwise.

Definition at line 828 of file utils.c.

Referenced by audio_decode_example(), av_find_best_stream(), av_find_stream_info(), avcodec_string(), find_codec_or_die(), movie_init(), open_input_file(), open_parser(), stream_component_open(), transcode(), try_decode_frame(), and video_decode_example().

AVCodec* avcodec_find_decoder_by_name ( const char *  name  ) 

Find a registered decoder with the specified name.

Parameters:
name name of the requested decoder
Returns:
A decoder if one was found, NULL otherwise.

Definition at line 840 of file utils.c.

Referenced by find_codec_or_die(), and opt_input_file().

AVCodec* avcodec_find_encoder ( enum CodecID  id  ) 

Find a registered encoder with a matching codec ID.

Parameters:
id CodecID of the requested encoder
Returns:
An encoder if one was found, NULL otherwise.

Definition at line 798 of file utils.c.

Referenced by asf_write_header1(), audio_encode_example(), avcodec_string(), compute_status(), estimate_best_b_count(), ffserver_opt_preset(), find_codec_or_die(), new_audio_stream(), new_subtitle_stream(), new_video_stream(), open_audio(), open_video(), read_ffserver_streams(), transcode(), and video_encode_example().

AVCodec* avcodec_find_encoder_by_name ( const char *  name  ) 

Find a registered encoder with the specified name.

Parameters:
name name of the requested encoder
Returns:
An encoder if one was found, NULL otherwise.

Definition at line 814 of file utils.c.

Referenced by find_codec_or_die(), new_audio_stream(), new_subtitle_stream(), new_video_stream(), opt_audio_codec(), and opt_video_codec().

void avcodec_flush_buffers ( AVCodecContext avctx  ) 

Flush buffers, should be called when seeking or when switching to a different stream.

Definition at line 1048 of file utils.c.

Referenced by audio_decode_frame(), get_video_frame(), and subtitle_thread().

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.

Returns:
Required padding in pixels.

Definition at line 104 of file utils.c.

void avcodec_get_frame_defaults ( AVFrame pic  ) 

void avcodec_init ( void   ) 

Initialize libavcodec.

Warning:
This function must be called before any other libavcodec function.

Definition at line 1037 of file utils.c.

Referenced by avcodec_register(), and main().

const char* avcodec_license ( void   ) 

Return the libavcodec license.

Definition at line 1031 of file utils.c.

int attribute_align_arg avcodec_open ( AVCodecContext avctx,
AVCodec codec 
)

Initialize the AVCodecContext to use the given AVCodec.

Prior to using this function the context has to be allocated.

The functions avcodec_find_decoder_by_name(), avcodec_find_encoder_by_name(), avcodec_find_decoder() and avcodec_find_encoder() provide an easy way for retrieving a codec.

Warning:
This function is not thread safe!
 avcodec_register_all();
 codec = avcodec_find_decoder(CODEC_ID_H264);
 if (!codec)
     exit(1);

 context = avcodec_alloc_context();

 if (avcodec_open(context, codec) < 0)
     exit(1);

Parameters:
avctx The context which will be set up to use the given codec.
codec The codec to use within the context.
Returns:
zero on success, a negative value on error
See also:
avcodec_alloc_context, avcodec_find_decoder, avcodec_find_encoder

Definition at line 470 of file utils.c.

Referenced by audio_decode_example(), audio_encode_example(), av_find_stream_info(), estimate_best_b_count(), movie_init(), open_audio(), open_input_file(), open_parser(), open_video(), stream_component_open(), transcode(), try_decode_frame(), video_decode_example(), and video_encode_example().

void avcodec_register ( AVCodec codec  ) 

Register the codec codec and initialize libavcodec.

See also:
avcodec_init()

Definition at line 87 of file utils.c.

Referenced by register_avcodec().

void avcodec_set_dimensions ( AVCodecContext s,
int  width,
int  height 
)

void avcodec_string ( char *  buf,
int  buf_size,
AVCodecContext enc,
int  encode 
)

Definition at line 892 of file utils.c.

Referenced by av_find_stream_info(), and dump_stream_format().

void avcodec_thread_free ( AVCodecContext s  ) 

Definition at line 1287 of file utils.c.

int avcodec_thread_init ( AVCodecContext s,
int  thread_count 
)

Deprecated:
Set s->thread_count before calling avcodec_open() instead of calling this.

Definition at line 1282 of file utils.c.

unsigned avcodec_version ( void   ) 

Return the LIBAVCODEC_VERSION_INT constant.

Definition at line 1021 of file utils.c.

void avsubtitle_free ( AVSubtitle sub  ) 

Frees all allocated data in the given subtitle struct.

Parameters:
sub AVSubtitle to free.

Definition at line 743 of file utils.c.

Referenced by free_subpicture(), and output_packet().

AVHWAccel* ff_find_hwaccel ( enum CodecID  codec_id,
enum PixelFormat  pix_fmt 
)

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

Parameters:
codec_id the codec to match
pix_fmt the pixel format to match
Returns:
the hardware accelerated codec, or NULL if none was found.

Definition at line 1217 of file utils.c.

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

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

Referenced by h263_encode_picture_header(), MPV_encode_init(), and svq1_write_header().

void ff_thread_await_progress ( AVFrame f,
int  progress,
int  field 
)

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

Definition at line 1266 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 avctx->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 1255 of file utils.c.

int ff_thread_init ( AVCodecContext s,
int  thread_count 
)

Definition at line 1140 of file utils.c.

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:
avctx The current context.
f The picture being released.

Definition at line 1261 of file utils.c.

void ff_thread_report_progress ( AVFrame f,
int  progress,
int  field 
)

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

unsigned int ff_toupper4 ( unsigned int  x  ) 

Definition at line 1245 of file utils.c.

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

static int get_bit_rate ( AVCodecContext ctx  )  [static]

Definition at line 854 of file utils.c.

Referenced by avcodec_string().

void register_avcodec ( AVCodec codec  ) 

Deprecated:
Deprecated in favor of avcodec_register().

Definition at line 98 of file utils.c.


Variable Documentation

void* codec_mutex [static]

Definition at line 49 of file utils.c.

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

int volatile entangled_thread_counter = 0 [static]

Definition at line 47 of file utils.c.

Referenced by avcodec_close(), and avcodec_open().

int(* ff_lockmgr_cb)(void **mutex, enum AVLockOp op) [static]

AVCodec* first_avcodec = NULL [static]

Definition at line 80 of file utils.c.

Definition at line 1201 of file utils.c.


Generated on Mon May 2 19:50:23 2011 for FFmpeg by  doxygen 1.5.6