Show profile in avcodec_string().
[ffmpeg.git] / libavcodec / utils.c
1 /*
2  * utils for libavcodec
3  * Copyright (c) 2001 Fabrice Bellard
4  * Copyright (c) 2002-2004 Michael Niedermayer <michaelni@gmx.at>
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22
23 /**
24  * @file
25  * utils.
26  */
27
28 #include "libavutil/avstring.h"
29 #include "libavutil/integer.h"
30 #include "libavutil/crc.h"
31 #include "libavutil/pixdesc.h"
32 #include "libavcore/audioconvert.h"
33 #include "libavcore/imgutils.h"
34 #include "libavcore/internal.h"
35 #include "libavcore/samplefmt.h"
36 #include "avcodec.h"
37 #include "dsputil.h"
38 #include "libavutil/opt.h"
39 #include "imgconvert.h"
40 #include "audioconvert.h"
41 #include "internal.h"
42 #include <stdlib.h>
43 #include <stdarg.h>
44 #include <limits.h>
45 #include <float.h>
46
47 static int volatile entangled_thread_counter=0;
48 int (*ff_lockmgr_cb)(void **mutex, enum AVLockOp op);
49 static void *codec_mutex;
50
51 void *av_fast_realloc(void *ptr, unsigned int *size, FF_INTERNALC_MEM_TYPE min_size)
52 {
53     if(min_size < *size)
54         return ptr;
55
56     min_size= FFMAX(17*min_size/16 + 32, min_size);
57
58     ptr= av_realloc(ptr, min_size);
59     if(!ptr) //we could set this to the unmodified min_size but this is safer if the user lost the ptr and uses NULL now
60         min_size= 0;
61
62     *size= min_size;
63
64     return ptr;
65 }
66
67 void av_fast_malloc(void *ptr, unsigned int *size, FF_INTERNALC_MEM_TYPE min_size)
68 {
69     void **p = ptr;
70     if (min_size < *size)
71         return;
72     min_size= FFMAX(17*min_size/16 + 32, min_size);
73     av_free(*p);
74     *p = av_malloc(min_size);
75     if (!*p) min_size = 0;
76     *size= min_size;
77 }
78
79 /* encoder management */
80 static AVCodec *first_avcodec = NULL;
81
82 AVCodec *av_codec_next(AVCodec *c){
83     if(c) return c->next;
84     else  return first_avcodec;
85 }
86
87 void avcodec_register(AVCodec *codec)
88 {
89     AVCodec **p;
90     avcodec_init();
91     p = &first_avcodec;
92     while (*p != NULL) p = &(*p)->next;
93     *p = codec;
94     codec->next = NULL;
95 }
96
97 #if LIBAVCODEC_VERSION_MAJOR < 53
98 void register_avcodec(AVCodec *codec)
99 {
100     avcodec_register(codec);
101 }
102 #endif
103
104 unsigned avcodec_get_edge_width(void)
105 {
106     return EDGE_WIDTH;
107 }
108
109 void avcodec_set_dimensions(AVCodecContext *s, int width, int height){
110     s->coded_width = width;
111     s->coded_height= height;
112     s->width = -((-width )>>s->lowres);
113     s->height= -((-height)>>s->lowres);
114 }
115
116 typedef struct InternalBuffer{
117     int last_pic_num;
118     uint8_t *base[4];
119     uint8_t *data[4];
120     int linesize[4];
121     int width, height;
122     enum PixelFormat pix_fmt;
123 }InternalBuffer;
124
125 #define INTERNAL_BUFFER_SIZE 32
126
127 void avcodec_align_dimensions2(AVCodecContext *s, int *width, int *height, int linesize_align[4]){
128     int w_align= 1;
129     int h_align= 1;
130
131     switch(s->pix_fmt){
132     case PIX_FMT_YUV420P:
133     case PIX_FMT_YUYV422:
134     case PIX_FMT_UYVY422:
135     case PIX_FMT_YUV422P:
136     case PIX_FMT_YUV440P:
137     case PIX_FMT_YUV444P:
138     case PIX_FMT_GRAY8:
139     case PIX_FMT_GRAY16BE:
140     case PIX_FMT_GRAY16LE:
141     case PIX_FMT_YUVJ420P:
142     case PIX_FMT_YUVJ422P:
143     case PIX_FMT_YUVJ440P:
144     case PIX_FMT_YUVJ444P:
145     case PIX_FMT_YUVA420P:
146         w_align= 16; //FIXME check for non mpeg style codecs and use less alignment
147         h_align= 16;
148         if(s->codec_id == CODEC_ID_MPEG2VIDEO || s->codec_id == CODEC_ID_MJPEG || s->codec_id == CODEC_ID_AMV || s->codec_id == CODEC_ID_THP || s->codec_id == CODEC_ID_H264)
149             h_align= 32; // interlaced is rounded up to 2 MBs
150         break;
151     case PIX_FMT_YUV411P:
152     case PIX_FMT_UYYVYY411:
153         w_align=32;
154         h_align=8;
155         break;
156     case PIX_FMT_YUV410P:
157         if(s->codec_id == CODEC_ID_SVQ1){
158             w_align=64;
159             h_align=64;
160         }
161     case PIX_FMT_RGB555:
162         if(s->codec_id == CODEC_ID_RPZA){
163             w_align=4;
164             h_align=4;
165         }
166     case PIX_FMT_PAL8:
167     case PIX_FMT_BGR8:
168     case PIX_FMT_RGB8:
169         if(s->codec_id == CODEC_ID_SMC){
170             w_align=4;
171             h_align=4;
172         }
173         break;
174     case PIX_FMT_BGR24:
175         if((s->codec_id == CODEC_ID_MSZH) || (s->codec_id == CODEC_ID_ZLIB)){
176             w_align=4;
177             h_align=4;
178         }
179         break;
180     default:
181         w_align= 1;
182         h_align= 1;
183         break;
184     }
185
186     *width = FFALIGN(*width , w_align);
187     *height= FFALIGN(*height, h_align);
188     if(s->codec_id == CODEC_ID_H264 || s->lowres)
189         *height+=2; // some of the optimized chroma MC reads one line too much
190                     // which is also done in mpeg decoders with lowres > 0
191
192     linesize_align[0] =
193     linesize_align[1] =
194     linesize_align[2] =
195     linesize_align[3] = STRIDE_ALIGN;
196 //STRIDE_ALIGN is 8 for SSE* but this does not work for SVQ1 chroma planes
197 //we could change STRIDE_ALIGN to 16 for x86/sse but it would increase the
198 //picture size unneccessarily in some cases. The solution here is not
199 //pretty and better ideas are welcome!
200 #if HAVE_MMX
201     if(s->codec_id == CODEC_ID_SVQ1 || s->codec_id == CODEC_ID_VP5 ||
202        s->codec_id == CODEC_ID_VP6 || s->codec_id == CODEC_ID_VP6F ||
203        s->codec_id == CODEC_ID_VP6A) {
204         linesize_align[0] =
205         linesize_align[1] =
206         linesize_align[2] = 16;
207     }
208 #endif
209 }
210
211 void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height){
212     int chroma_shift = av_pix_fmt_descriptors[s->pix_fmt].log2_chroma_w;
213     int linesize_align[4];
214     int align;
215     avcodec_align_dimensions2(s, width, height, linesize_align);
216     align = FFMAX(linesize_align[0], linesize_align[3]);
217     linesize_align[1] <<= chroma_shift;
218     linesize_align[2] <<= chroma_shift;
219     align = FFMAX3(align, linesize_align[1], linesize_align[2]);
220     *width=FFALIGN(*width, align);
221 }
222
223 #if LIBAVCODEC_VERSION_MAJOR < 53
224 int avcodec_check_dimensions(void *av_log_ctx, unsigned int w, unsigned int h){
225     return av_image_check_size(w, h, 0, av_log_ctx);
226 }
227 #endif
228
229 int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic){
230     int i;
231     int w= s->width;
232     int h= s->height;
233     InternalBuffer *buf;
234     int *picture_number;
235
236     if(pic->data[0]!=NULL) {
237         av_log(s, AV_LOG_ERROR, "pic->data[0]!=NULL in avcodec_default_get_buffer\n");
238         return -1;
239     }
240     if(s->internal_buffer_count >= INTERNAL_BUFFER_SIZE) {
241         av_log(s, AV_LOG_ERROR, "internal_buffer_count overflow (missing release_buffer?)\n");
242         return -1;
243     }
244
245     if(av_image_check_size(w, h, 0, s))
246         return -1;
247
248     if(s->internal_buffer==NULL){
249         s->internal_buffer= av_mallocz((INTERNAL_BUFFER_SIZE+1)*sizeof(InternalBuffer));
250     }
251 #if 0
252     s->internal_buffer= av_fast_realloc(
253         s->internal_buffer,
254         &s->internal_buffer_size,
255         sizeof(InternalBuffer)*FFMAX(99,  s->internal_buffer_count+1)/*FIXME*/
256         );
257 #endif
258
259     buf= &((InternalBuffer*)s->internal_buffer)[s->internal_buffer_count];
260     picture_number= &(((InternalBuffer*)s->internal_buffer)[INTERNAL_BUFFER_SIZE]).last_pic_num; //FIXME ugly hack
261     (*picture_number)++;
262
263     if(buf->base[0] && (buf->width != w || buf->height != h || buf->pix_fmt != s->pix_fmt)){
264         for(i=0; i<4; i++){
265             av_freep(&buf->base[i]);
266             buf->data[i]= NULL;
267         }
268     }
269
270     if(buf->base[0]){
271         pic->age= *picture_number - buf->last_pic_num;
272         buf->last_pic_num= *picture_number;
273     }else{
274         int h_chroma_shift, v_chroma_shift;
275         int size[4] = {0};
276         int tmpsize;
277         int unaligned;
278         AVPicture picture;
279         int stride_align[4];
280
281         avcodec_get_chroma_sub_sample(s->pix_fmt, &h_chroma_shift, &v_chroma_shift);
282
283         avcodec_align_dimensions2(s, &w, &h, stride_align);
284
285         if(!(s->flags&CODEC_FLAG_EMU_EDGE)){
286             w+= EDGE_WIDTH*2;
287             h+= EDGE_WIDTH*2;
288         }
289
290         do {
291             // NOTE: do not align linesizes individually, this breaks e.g. assumptions
292             // that linesize[0] == 2*linesize[1] in the MPEG-encoder for 4:2:2
293             av_image_fill_linesizes(picture.linesize, s->pix_fmt, w);
294             // increase alignment of w for next try (rhs gives the lowest bit set in w)
295             w += w & ~(w-1);
296
297             unaligned = 0;
298             for (i=0; i<4; i++){
299                 unaligned |= picture.linesize[i] % stride_align[i];
300             }
301         } while (unaligned);
302
303         tmpsize = av_image_fill_pointers(picture.data, s->pix_fmt, h, NULL, picture.linesize);
304         if (tmpsize < 0)
305             return -1;
306
307         for (i=0; i<3 && picture.data[i+1]; i++)
308             size[i] = picture.data[i+1] - picture.data[i];
309         size[i] = tmpsize - (picture.data[i] - picture.data[0]);
310
311         buf->last_pic_num= -256*256*256*64;
312         memset(buf->base, 0, sizeof(buf->base));
313         memset(buf->data, 0, sizeof(buf->data));
314
315         for(i=0; i<4 && size[i]; i++){
316             const int h_shift= i==0 ? 0 : h_chroma_shift;
317             const int v_shift= i==0 ? 0 : v_chroma_shift;
318
319             buf->linesize[i]= picture.linesize[i];
320
321             buf->base[i]= av_malloc(size[i]+16); //FIXME 16
322             if(buf->base[i]==NULL) return -1;
323             memset(buf->base[i], 128, size[i]);
324
325             // no edge if EDGE EMU or not planar YUV
326             if((s->flags&CODEC_FLAG_EMU_EDGE) || !size[2])
327                 buf->data[i] = buf->base[i];
328             else
329                 buf->data[i] = buf->base[i] + FFALIGN((buf->linesize[i]*EDGE_WIDTH>>v_shift) + (EDGE_WIDTH>>h_shift), stride_align[i]);
330         }
331         if(size[1] && !size[2])
332             ff_set_systematic_pal2((uint32_t*)buf->data[1], s->pix_fmt);
333         buf->width  = s->width;
334         buf->height = s->height;
335         buf->pix_fmt= s->pix_fmt;
336         pic->age= 256*256*256*64;
337     }
338     pic->type= FF_BUFFER_TYPE_INTERNAL;
339
340     for(i=0; i<4; i++){
341         pic->base[i]= buf->base[i];
342         pic->data[i]= buf->data[i];
343         pic->linesize[i]= buf->linesize[i];
344     }
345     s->internal_buffer_count++;
346
347     if(s->pkt) pic->pkt_pts= s->pkt->pts;
348     else       pic->pkt_pts= AV_NOPTS_VALUE;
349     pic->reordered_opaque= s->reordered_opaque;
350
351     if(s->debug&FF_DEBUG_BUFFERS)
352         av_log(s, AV_LOG_DEBUG, "default_get_buffer called on pic %p, %d buffers used\n", pic, s->internal_buffer_count);
353
354     return 0;
355 }
356
357 void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic){
358     int i;
359     InternalBuffer *buf, *last;
360
361     assert(pic->type==FF_BUFFER_TYPE_INTERNAL);
362     assert(s->internal_buffer_count);
363
364     buf = NULL; /* avoids warning */
365     for(i=0; i<s->internal_buffer_count; i++){ //just 3-5 checks so is not worth to optimize
366         buf= &((InternalBuffer*)s->internal_buffer)[i];
367         if(buf->data[0] == pic->data[0])
368             break;
369     }
370     assert(i < s->internal_buffer_count);
371     s->internal_buffer_count--;
372     last = &((InternalBuffer*)s->internal_buffer)[s->internal_buffer_count];
373
374     FFSWAP(InternalBuffer, *buf, *last);
375
376     for(i=0; i<4; i++){
377         pic->data[i]=NULL;
378 //        pic->base[i]=NULL;
379     }
380 //printf("R%X\n", pic->opaque);
381
382     if(s->debug&FF_DEBUG_BUFFERS)
383         av_log(s, AV_LOG_DEBUG, "default_release_buffer called on pic %p, %d buffers used\n", pic, s->internal_buffer_count);
384 }
385
386 int avcodec_default_reget_buffer(AVCodecContext *s, AVFrame *pic){
387     AVFrame temp_pic;
388     int i;
389
390     /* If no picture return a new buffer */
391     if(pic->data[0] == NULL) {
392         /* We will copy from buffer, so must be readable */
393         pic->buffer_hints |= FF_BUFFER_HINTS_READABLE;
394         return s->get_buffer(s, pic);
395     }
396
397     /* If internal buffer type return the same buffer */
398     if(pic->type == FF_BUFFER_TYPE_INTERNAL) {
399         pic->reordered_opaque= s->reordered_opaque;
400         return 0;
401     }
402
403     /*
404      * Not internal type and reget_buffer not overridden, emulate cr buffer
405      */
406     temp_pic = *pic;
407     for(i = 0; i < 4; i++)
408         pic->data[i] = pic->base[i] = NULL;
409     pic->opaque = NULL;
410     /* Allocate new frame */
411     if (s->get_buffer(s, pic))
412         return -1;
413     /* Copy image data from old buffer to new buffer */
414     av_picture_copy((AVPicture*)pic, (AVPicture*)&temp_pic, s->pix_fmt, s->width,
415              s->height);
416     s->release_buffer(s, &temp_pic); // Release old frame
417     return 0;
418 }
419
420 int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void *arg, int *ret, int count, int size){
421     int i;
422
423     for(i=0; i<count; i++){
424         int r= func(c, (char*)arg + i*size);
425         if(ret) ret[i]= r;
426     }
427     return 0;
428 }
429
430 int avcodec_default_execute2(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2, int jobnr, int threadnr),void *arg, int *ret, int count){
431     int i;
432
433     for(i=0; i<count; i++){
434         int r= func(c, arg, i, 0);
435         if(ret) ret[i]= r;
436     }
437     return 0;
438 }
439
440 enum PixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum PixelFormat *fmt){
441     while (*fmt != PIX_FMT_NONE && ff_is_hwaccel_pix_fmt(*fmt))
442         ++fmt;
443     return fmt[0];
444 }
445
446 void avcodec_get_frame_defaults(AVFrame *pic){
447     memset(pic, 0, sizeof(AVFrame));
448
449     pic->pts= AV_NOPTS_VALUE;
450     pic->key_frame= 1;
451 }
452
453 AVFrame *avcodec_alloc_frame(void){
454     AVFrame *pic= av_malloc(sizeof(AVFrame));
455
456     if(pic==NULL) return NULL;
457
458     avcodec_get_frame_defaults(pic);
459
460     return pic;
461 }
462
463 int attribute_align_arg avcodec_open(AVCodecContext *avctx, AVCodec *codec)
464 {
465     int ret= -1;
466
467     /* If there is a user-supplied mutex locking routine, call it. */
468     if (ff_lockmgr_cb) {
469         if ((*ff_lockmgr_cb)(&codec_mutex, AV_LOCK_OBTAIN))
470             return -1;
471     }
472
473     entangled_thread_counter++;
474     if(entangled_thread_counter != 1){
475         av_log(avctx, AV_LOG_ERROR, "insufficient thread locking around avcodec_open/close()\n");
476         goto end;
477     }
478
479     if(avctx->codec || !codec)
480         goto end;
481
482     if (codec->priv_data_size > 0) {
483       if(!avctx->priv_data){
484         avctx->priv_data = av_mallocz(codec->priv_data_size);
485         if (!avctx->priv_data) {
486             ret = AVERROR(ENOMEM);
487             goto end;
488         }
489         if(codec->priv_class){ //this can be droped once all user apps use   avcodec_get_context_defaults3()
490             *(AVClass**)avctx->priv_data= codec->priv_class;
491             av_opt_set_defaults(avctx->priv_data);
492         }
493       }
494     } else {
495         avctx->priv_data = NULL;
496     }
497
498     if(avctx->coded_width && avctx->coded_height)
499         avcodec_set_dimensions(avctx, avctx->coded_width, avctx->coded_height);
500     else if(avctx->width && avctx->height)
501         avcodec_set_dimensions(avctx, avctx->width, avctx->height);
502
503     if ((avctx->coded_width || avctx->coded_height || avctx->width || avctx->height)
504         && (  av_image_check_size(avctx->coded_width, avctx->coded_height, 0, avctx) < 0
505            || av_image_check_size(avctx->width,       avctx->height,       0, avctx) < 0)) {
506         av_log(avctx, AV_LOG_WARNING, "ignoring invalid width/height values\n");
507         avcodec_set_dimensions(avctx, 0, 0);
508     }
509
510     /* if the decoder init function was already called previously,
511        free the already allocated subtitle_header before overwriting it */
512     if (codec->decode)
513         av_freep(&avctx->subtitle_header);
514
515 #define SANE_NB_CHANNELS 128U
516     if (avctx->channels > SANE_NB_CHANNELS) {
517         ret = AVERROR(EINVAL);
518         goto free_and_end;
519     }
520
521     avctx->codec = codec;
522     if ((avctx->codec_type == AVMEDIA_TYPE_UNKNOWN || avctx->codec_type == codec->type) &&
523         avctx->codec_id == CODEC_ID_NONE) {
524         avctx->codec_type = codec->type;
525         avctx->codec_id   = codec->id;
526     }
527     if(avctx->codec_id != codec->id || avctx->codec_type != codec->type){
528         av_log(avctx, AV_LOG_ERROR, "codec type or id mismatches\n");
529         goto free_and_end;
530     }
531     avctx->frame_number = 0;
532     if (avctx->codec->max_lowres < avctx->lowres) {
533         av_log(avctx, AV_LOG_ERROR, "The maximum value for lowres supported by the decoder is %d\n",
534                avctx->codec->max_lowres);
535         goto free_and_end;
536     }
537
538     if(avctx->codec->init){
539         ret = avctx->codec->init(avctx);
540         if (ret < 0) {
541             goto free_and_end;
542         }
543     }
544     ret=0;
545 end:
546     entangled_thread_counter--;
547
548     /* Release any user-supplied mutex. */
549     if (ff_lockmgr_cb) {
550         (*ff_lockmgr_cb)(&codec_mutex, AV_LOCK_RELEASE);
551     }
552     return ret;
553 free_and_end:
554     av_freep(&avctx->priv_data);
555     avctx->codec= NULL;
556     goto end;
557 }
558
559 int attribute_align_arg avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size,
560                          const short *samples)
561 {
562     if(buf_size < FF_MIN_BUFFER_SIZE && 0){
563         av_log(avctx, AV_LOG_ERROR, "buffer smaller than minimum size\n");
564         return -1;
565     }
566     if((avctx->codec->capabilities & CODEC_CAP_DELAY) || samples){
567         int ret = avctx->codec->encode(avctx, buf, buf_size, samples);
568         avctx->frame_number++;
569         return ret;
570     }else
571         return 0;
572 }
573
574 int attribute_align_arg avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size,
575                          const AVFrame *pict)
576 {
577     if(buf_size < FF_MIN_BUFFER_SIZE){
578         av_log(avctx, AV_LOG_ERROR, "buffer smaller than minimum size\n");
579         return -1;
580     }
581     if(av_image_check_size(avctx->width, avctx->height, 0, avctx))
582         return -1;
583     if((avctx->codec->capabilities & CODEC_CAP_DELAY) || pict){
584         int ret = avctx->codec->encode(avctx, buf, buf_size, pict);
585         avctx->frame_number++;
586         emms_c(); //needed to avoid an emms_c() call before every return;
587
588         return ret;
589     }else
590         return 0;
591 }
592
593 int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
594                             const AVSubtitle *sub)
595 {
596     int ret;
597     if(sub->start_display_time) {
598         av_log(avctx, AV_LOG_ERROR, "start_display_time must be 0.\n");
599         return -1;
600     }
601     if(sub->num_rects == 0 || !sub->rects)
602         return -1;
603     ret = avctx->codec->encode(avctx, buf, buf_size, sub);
604     avctx->frame_number++;
605     return ret;
606 }
607
608 #if FF_API_VIDEO_OLD
609 int attribute_align_arg avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture,
610                          int *got_picture_ptr,
611                          const uint8_t *buf, int buf_size)
612 {
613     AVPacket avpkt;
614     av_init_packet(&avpkt);
615     avpkt.data = buf;
616     avpkt.size = buf_size;
617     // HACK for CorePNG to decode as normal PNG by default
618     avpkt.flags = AV_PKT_FLAG_KEY;
619
620     return avcodec_decode_video2(avctx, picture, got_picture_ptr, &avpkt);
621 }
622 #endif
623
624 int attribute_align_arg avcodec_decode_video2(AVCodecContext *avctx, AVFrame *picture,
625                          int *got_picture_ptr,
626                          AVPacket *avpkt)
627 {
628     int ret;
629
630     *got_picture_ptr= 0;
631     if((avctx->coded_width||avctx->coded_height) && av_image_check_size(avctx->coded_width, avctx->coded_height, 0, avctx))
632         return -1;
633
634     avctx->pkt = avpkt;
635
636     if((avctx->codec->capabilities & CODEC_CAP_DELAY) || avpkt->size){
637         ret = avctx->codec->decode(avctx, picture, got_picture_ptr,
638                                 avpkt);
639
640         emms_c(); //needed to avoid an emms_c() call before every return;
641
642         picture->pkt_dts= avpkt->dts;
643
644         if (*got_picture_ptr)
645             avctx->frame_number++;
646     }else
647         ret= 0;
648
649     return ret;
650 }
651
652 #if FF_API_AUDIO_OLD
653 int attribute_align_arg avcodec_decode_audio2(AVCodecContext *avctx, int16_t *samples,
654                          int *frame_size_ptr,
655                          const uint8_t *buf, int buf_size)
656 {
657     AVPacket avpkt;
658     av_init_packet(&avpkt);
659     avpkt.data = buf;
660     avpkt.size = buf_size;
661
662     return avcodec_decode_audio3(avctx, samples, frame_size_ptr, &avpkt);
663 }
664 #endif
665
666 int attribute_align_arg avcodec_decode_audio3(AVCodecContext *avctx, int16_t *samples,
667                          int *frame_size_ptr,
668                          AVPacket *avpkt)
669 {
670     int ret;
671
672     avctx->pkt = avpkt;
673
674     if((avctx->codec->capabilities & CODEC_CAP_DELAY) || avpkt->size){
675         //FIXME remove the check below _after_ ensuring that all audio check that the available space is enough
676         if(*frame_size_ptr < AVCODEC_MAX_AUDIO_FRAME_SIZE){
677             av_log(avctx, AV_LOG_ERROR, "buffer smaller than AVCODEC_MAX_AUDIO_FRAME_SIZE\n");
678             return -1;
679         }
680         if(*frame_size_ptr < FF_MIN_BUFFER_SIZE ||
681         *frame_size_ptr < avctx->channels * avctx->frame_size * sizeof(int16_t)){
682             av_log(avctx, AV_LOG_ERROR, "buffer %d too small\n", *frame_size_ptr);
683             return -1;
684         }
685
686         ret = avctx->codec->decode(avctx, samples, frame_size_ptr, avpkt);
687         avctx->frame_number++;
688     }else{
689         ret= 0;
690         *frame_size_ptr=0;
691     }
692     return ret;
693 }
694
695 #if FF_API_SUBTITLE_OLD
696 int avcodec_decode_subtitle(AVCodecContext *avctx, AVSubtitle *sub,
697                             int *got_sub_ptr,
698                             const uint8_t *buf, int buf_size)
699 {
700     AVPacket avpkt;
701     av_init_packet(&avpkt);
702     avpkt.data = buf;
703     avpkt.size = buf_size;
704
705     return avcodec_decode_subtitle2(avctx, sub, got_sub_ptr, &avpkt);
706 }
707 #endif
708
709 int avcodec_decode_subtitle2(AVCodecContext *avctx, AVSubtitle *sub,
710                             int *got_sub_ptr,
711                             AVPacket *avpkt)
712 {
713     int ret;
714
715     avctx->pkt = avpkt;
716     *got_sub_ptr = 0;
717     ret = avctx->codec->decode(avctx, sub, got_sub_ptr, avpkt);
718     if (*got_sub_ptr)
719         avctx->frame_number++;
720     return ret;
721 }
722
723 void avsubtitle_free(AVSubtitle *sub)
724 {
725     int i;
726
727     for (i = 0; i < sub->num_rects; i++)
728     {
729         av_freep(&sub->rects[i]->pict.data[0]);
730         av_freep(&sub->rects[i]->pict.data[1]);
731         av_freep(&sub->rects[i]->pict.data[2]);
732         av_freep(&sub->rects[i]->pict.data[3]);
733         av_freep(&sub->rects[i]->text);
734         av_freep(&sub->rects[i]->ass);
735         av_freep(&sub->rects[i]);
736     }
737
738     av_freep(&sub->rects);
739
740     memset(sub, 0, sizeof(AVSubtitle));
741 }
742
743 av_cold int avcodec_close(AVCodecContext *avctx)
744 {
745     /* If there is a user-supplied mutex locking routine, call it. */
746     if (ff_lockmgr_cb) {
747         if ((*ff_lockmgr_cb)(&codec_mutex, AV_LOCK_OBTAIN))
748             return -1;
749     }
750
751     entangled_thread_counter++;
752     if(entangled_thread_counter != 1){
753         av_log(avctx, AV_LOG_ERROR, "insufficient thread locking around avcodec_open/close()\n");
754         entangled_thread_counter--;
755         return -1;
756     }
757
758     if (HAVE_THREADS && avctx->thread_opaque)
759         avcodec_thread_free(avctx);
760     if (avctx->codec && avctx->codec->close)
761         avctx->codec->close(avctx);
762     avcodec_default_free_buffers(avctx);
763     avctx->coded_frame = NULL;
764     av_freep(&avctx->priv_data);
765     if(avctx->codec && avctx->codec->encode)
766         av_freep(&avctx->extradata);
767     avctx->codec = NULL;
768     entangled_thread_counter--;
769
770     /* Release any user-supplied mutex. */
771     if (ff_lockmgr_cb) {
772         (*ff_lockmgr_cb)(&codec_mutex, AV_LOCK_RELEASE);
773     }
774     return 0;
775 }
776
777 AVCodec *avcodec_find_encoder(enum CodecID id)
778 {
779     AVCodec *p, *experimental=NULL;
780     p = first_avcodec;
781     while (p) {
782         if (p->encode != NULL && p->id == id) {
783             if (p->capabilities & CODEC_CAP_EXPERIMENTAL && !experimental) {
784                 experimental = p;
785             } else
786                 return p;
787         }
788         p = p->next;
789     }
790     return experimental;
791 }
792
793 AVCodec *avcodec_find_encoder_by_name(const char *name)
794 {
795     AVCodec *p;
796     if (!name)
797         return NULL;
798     p = first_avcodec;
799     while (p) {
800         if (p->encode != NULL && strcmp(name,p->name) == 0)
801             return p;
802         p = p->next;
803     }
804     return NULL;
805 }
806
807 AVCodec *avcodec_find_decoder(enum CodecID id)
808 {
809     AVCodec *p;
810     p = first_avcodec;
811     while (p) {
812         if (p->decode != NULL && p->id == id)
813             return p;
814         p = p->next;
815     }
816     return NULL;
817 }
818
819 AVCodec *avcodec_find_decoder_by_name(const char *name)
820 {
821     AVCodec *p;
822     if (!name)
823         return NULL;
824     p = first_avcodec;
825     while (p) {
826         if (p->decode != NULL && strcmp(name,p->name) == 0)
827             return p;
828         p = p->next;
829     }
830     return NULL;
831 }
832
833 static int get_bit_rate(AVCodecContext *ctx)
834 {
835     int bit_rate;
836     int bits_per_sample;
837
838     switch(ctx->codec_type) {
839     case AVMEDIA_TYPE_VIDEO:
840     case AVMEDIA_TYPE_DATA:
841     case AVMEDIA_TYPE_SUBTITLE:
842     case AVMEDIA_TYPE_ATTACHMENT:
843         bit_rate = ctx->bit_rate;
844         break;
845     case AVMEDIA_TYPE_AUDIO:
846         bits_per_sample = av_get_bits_per_sample(ctx->codec_id);
847         bit_rate = bits_per_sample ? ctx->sample_rate * ctx->channels * bits_per_sample : ctx->bit_rate;
848         break;
849     default:
850         bit_rate = 0;
851         break;
852     }
853     return bit_rate;
854 }
855
856 size_t av_get_codec_tag_string(char *buf, size_t buf_size, unsigned int codec_tag)
857 {
858     int i, len, ret = 0;
859
860     for (i = 0; i < 4; i++) {
861         len = snprintf(buf, buf_size,
862                        isprint(codec_tag&0xFF) ? "%c" : "[%d]", codec_tag&0xFF);
863         buf      += len;
864         buf_size  = buf_size > len ? buf_size - len : 0;
865         ret      += len;
866         codec_tag>>=8;
867     }
868     return ret;
869 }
870
871 void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode)
872 {
873     const char *codec_name;
874     const char *profile = NULL;
875     AVCodec *p;
876     char buf1[32];
877     int bitrate;
878     AVRational display_aspect_ratio;
879
880     if (encode)
881         p = avcodec_find_encoder(enc->codec_id);
882     else
883         p = avcodec_find_decoder(enc->codec_id);
884
885     if (p) {
886         codec_name = p->name;
887         profile = av_get_profile_name(p, enc->profile);
888     } else if (enc->codec_id == CODEC_ID_MPEG2TS) {
889         /* fake mpeg2 transport stream codec (currently not
890            registered) */
891         codec_name = "mpeg2ts";
892     } else if (enc->codec_name[0] != '\0') {
893         codec_name = enc->codec_name;
894     } else {
895         /* output avi tags */
896         char tag_buf[32];
897         av_get_codec_tag_string(tag_buf, sizeof(tag_buf), enc->codec_tag);
898         snprintf(buf1, sizeof(buf1), "%s / 0x%04X", tag_buf, enc->codec_tag);
899         codec_name = buf1;
900     }
901
902     switch(enc->codec_type) {
903     case AVMEDIA_TYPE_VIDEO:
904         snprintf(buf, buf_size,
905                  "Video: %s%s",
906                  codec_name, enc->mb_decision ? " (hq)" : "");
907         if (profile)
908             snprintf(buf + strlen(buf), buf_size - strlen(buf),
909                      " (%s)", profile);
910         if (enc->pix_fmt != PIX_FMT_NONE) {
911             snprintf(buf + strlen(buf), buf_size - strlen(buf),
912                      ", %s",
913                      avcodec_get_pix_fmt_name(enc->pix_fmt));
914         }
915         if (enc->width) {
916             snprintf(buf + strlen(buf), buf_size - strlen(buf),
917                      ", %dx%d",
918                      enc->width, enc->height);
919             if (enc->sample_aspect_ratio.num) {
920                 av_reduce(&display_aspect_ratio.num, &display_aspect_ratio.den,
921                           enc->width*enc->sample_aspect_ratio.num,
922                           enc->height*enc->sample_aspect_ratio.den,
923                           1024*1024);
924                 snprintf(buf + strlen(buf), buf_size - strlen(buf),
925                          " [PAR %d:%d DAR %d:%d]",
926                          enc->sample_aspect_ratio.num, enc->sample_aspect_ratio.den,
927                          display_aspect_ratio.num, display_aspect_ratio.den);
928             }
929             if(av_log_get_level() >= AV_LOG_DEBUG){
930                 int g= av_gcd(enc->time_base.num, enc->time_base.den);
931                 snprintf(buf + strlen(buf), buf_size - strlen(buf),
932                      ", %d/%d",
933                      enc->time_base.num/g, enc->time_base.den/g);
934             }
935         }
936         if (encode) {
937             snprintf(buf + strlen(buf), buf_size - strlen(buf),
938                      ", q=%d-%d", enc->qmin, enc->qmax);
939         }
940         break;
941     case AVMEDIA_TYPE_AUDIO:
942         snprintf(buf, buf_size,
943                  "Audio: %s",
944                  codec_name);
945         if (profile)
946             snprintf(buf + strlen(buf), buf_size - strlen(buf),
947                      " (%s)", profile);
948         if (enc->sample_rate) {
949             snprintf(buf + strlen(buf), buf_size - strlen(buf),
950                      ", %d Hz", enc->sample_rate);
951         }
952         av_strlcat(buf, ", ", buf_size);
953         av_get_channel_layout_string(buf + strlen(buf), buf_size - strlen(buf), enc->channels, enc->channel_layout);
954         if (enc->sample_fmt != AV_SAMPLE_FMT_NONE) {
955             snprintf(buf + strlen(buf), buf_size - strlen(buf),
956                      ", %s", av_get_sample_fmt_name(enc->sample_fmt));
957         }
958         break;
959     case AVMEDIA_TYPE_DATA:
960         snprintf(buf, buf_size, "Data: %s", codec_name);
961         break;
962     case AVMEDIA_TYPE_SUBTITLE:
963         snprintf(buf, buf_size, "Subtitle: %s", codec_name);
964         break;
965     case AVMEDIA_TYPE_ATTACHMENT:
966         snprintf(buf, buf_size, "Attachment: %s", codec_name);
967         break;
968     default:
969         snprintf(buf, buf_size, "Invalid Codec type %d", enc->codec_type);
970         return;
971     }
972     if (encode) {
973         if (enc->flags & CODEC_FLAG_PASS1)
974             snprintf(buf + strlen(buf), buf_size - strlen(buf),
975                      ", pass 1");
976         if (enc->flags & CODEC_FLAG_PASS2)
977             snprintf(buf + strlen(buf), buf_size - strlen(buf),
978                      ", pass 2");
979     }
980     bitrate = get_bit_rate(enc);
981     if (bitrate != 0) {
982         snprintf(buf + strlen(buf), buf_size - strlen(buf),
983                  ", %d kb/s", bitrate / 1000);
984     }
985 }
986
987 const char *av_get_profile_name(const AVCodec *codec, int profile)
988 {
989     const AVProfile *p;
990     if (profile == FF_PROFILE_UNKNOWN || !codec->profiles)
991         return NULL;
992
993     for (p = codec->profiles; p->profile != FF_PROFILE_UNKNOWN; p++)
994         if (p->profile == profile)
995             return p->name;
996
997     return NULL;
998 }
999
1000 unsigned avcodec_version( void )
1001 {
1002   return LIBAVCODEC_VERSION_INT;
1003 }
1004
1005 const char *avcodec_configuration(void)
1006 {
1007     return FFMPEG_CONFIGURATION;
1008 }
1009
1010 const char *avcodec_license(void)
1011 {
1012 #define LICENSE_PREFIX "libavcodec license: "
1013     return LICENSE_PREFIX FFMPEG_LICENSE + sizeof(LICENSE_PREFIX) - 1;
1014 }
1015
1016 void avcodec_init(void)
1017 {
1018     static int initialized = 0;
1019
1020     if (initialized != 0)
1021         return;
1022     initialized = 1;
1023
1024     dsputil_static_init();
1025 }
1026
1027 void avcodec_flush_buffers(AVCodecContext *avctx)
1028 {
1029     if(avctx->codec->flush)
1030         avctx->codec->flush(avctx);
1031 }
1032
1033 void avcodec_default_free_buffers(AVCodecContext *s){
1034     int i, j;
1035
1036     if(s->internal_buffer==NULL) return;
1037
1038     if (s->internal_buffer_count)
1039         av_log(s, AV_LOG_WARNING, "Found %i unreleased buffers!\n", s->internal_buffer_count);
1040     for(i=0; i<INTERNAL_BUFFER_SIZE; i++){
1041         InternalBuffer *buf= &((InternalBuffer*)s->internal_buffer)[i];
1042         for(j=0; j<4; j++){
1043             av_freep(&buf->base[j]);
1044             buf->data[j]= NULL;
1045         }
1046     }
1047     av_freep(&s->internal_buffer);
1048
1049     s->internal_buffer_count=0;
1050 }
1051
1052 char av_get_pict_type_char(int pict_type){
1053     switch(pict_type){
1054     case FF_I_TYPE: return 'I';
1055     case FF_P_TYPE: return 'P';
1056     case FF_B_TYPE: return 'B';
1057     case FF_S_TYPE: return 'S';
1058     case FF_SI_TYPE:return 'i';
1059     case FF_SP_TYPE:return 'p';
1060     case FF_BI_TYPE:return 'b';
1061     default:        return '?';
1062     }
1063 }
1064
1065 int av_get_bits_per_sample(enum CodecID codec_id){
1066     switch(codec_id){
1067     case CODEC_ID_ADPCM_SBPRO_2:
1068         return 2;
1069     case CODEC_ID_ADPCM_SBPRO_3:
1070         return 3;
1071     case CODEC_ID_ADPCM_SBPRO_4:
1072     case CODEC_ID_ADPCM_CT:
1073     case CODEC_ID_ADPCM_IMA_WAV:
1074     case CODEC_ID_ADPCM_MS:
1075     case CODEC_ID_ADPCM_YAMAHA:
1076         return 4;
1077     case CODEC_ID_PCM_ALAW:
1078     case CODEC_ID_PCM_MULAW:
1079     case CODEC_ID_PCM_S8:
1080     case CODEC_ID_PCM_U8:
1081     case CODEC_ID_PCM_ZORK:
1082         return 8;
1083     case CODEC_ID_PCM_S16BE:
1084     case CODEC_ID_PCM_S16LE:
1085     case CODEC_ID_PCM_S16LE_PLANAR:
1086     case CODEC_ID_PCM_U16BE:
1087     case CODEC_ID_PCM_U16LE:
1088         return 16;
1089     case CODEC_ID_PCM_S24DAUD:
1090     case CODEC_ID_PCM_S24BE:
1091     case CODEC_ID_PCM_S24LE:
1092     case CODEC_ID_PCM_U24BE:
1093     case CODEC_ID_PCM_U24LE:
1094         return 24;
1095     case CODEC_ID_PCM_S32BE:
1096     case CODEC_ID_PCM_S32LE:
1097     case CODEC_ID_PCM_U32BE:
1098     case CODEC_ID_PCM_U32LE:
1099     case CODEC_ID_PCM_F32BE:
1100     case CODEC_ID_PCM_F32LE:
1101         return 32;
1102     case CODEC_ID_PCM_F64BE:
1103     case CODEC_ID_PCM_F64LE:
1104         return 64;
1105     default:
1106         return 0;
1107     }
1108 }
1109
1110 #if FF_API_OLD_SAMPLE_FMT
1111 int av_get_bits_per_sample_format(enum AVSampleFormat sample_fmt) {
1112     return av_get_bits_per_sample_fmt(sample_fmt);
1113 }
1114 #endif
1115
1116 #if !HAVE_THREADS
1117 int avcodec_thread_init(AVCodecContext *s, int thread_count){
1118     s->thread_count = thread_count;
1119     return -1;
1120 }
1121 #endif
1122
1123 unsigned int av_xiphlacing(unsigned char *s, unsigned int v)
1124 {
1125     unsigned int n = 0;
1126
1127     while(v >= 0xff) {
1128         *s++ = 0xff;
1129         v -= 0xff;
1130         n++;
1131     }
1132     *s = v;
1133     n++;
1134     return n;
1135 }
1136
1137 #if LIBAVCODEC_VERSION_MAJOR < 53
1138 #include "libavcore/parseutils.h"
1139
1140 int av_parse_video_frame_size(int *width_ptr, int *height_ptr, const char *str)
1141 {
1142     return av_parse_video_size(width_ptr, height_ptr, str);
1143 }
1144
1145 int av_parse_video_frame_rate(AVRational *frame_rate, const char *arg)
1146 {
1147     return av_parse_video_rate(frame_rate, arg);
1148 }
1149 #endif
1150
1151 int ff_match_2uint16(const uint16_t (*tab)[2], int size, int a, int b){
1152     int i;
1153     for(i=0; i<size && !(tab[i][0]==a && tab[i][1]==b); i++);
1154     return i;
1155 }
1156
1157 void av_log_missing_feature(void *avc, const char *feature, int want_sample)
1158 {
1159     av_log(avc, AV_LOG_WARNING, "%s not implemented. Update your FFmpeg "
1160             "version to the newest one from SVN. If the problem still "
1161             "occurs, it means that your file has a feature which has not "
1162             "been implemented.", feature);
1163     if(want_sample)
1164         av_log_ask_for_sample(avc, NULL);
1165     else
1166         av_log(avc, AV_LOG_WARNING, "\n");
1167 }
1168
1169 void av_log_ask_for_sample(void *avc, const char *msg)
1170 {
1171     if (msg)
1172         av_log(avc, AV_LOG_WARNING, "%s ", msg);
1173     av_log(avc, AV_LOG_WARNING, "If you want to help, upload a sample "
1174             "of this file to ftp://upload.ffmpeg.org/MPlayer/incoming/ "
1175             "and contact the ffmpeg-devel mailing list.\n");
1176 }
1177
1178 static AVHWAccel *first_hwaccel = NULL;
1179
1180 void av_register_hwaccel(AVHWAccel *hwaccel)
1181 {
1182     AVHWAccel **p = &first_hwaccel;
1183     while (*p)
1184         p = &(*p)->next;
1185     *p = hwaccel;
1186     hwaccel->next = NULL;
1187 }
1188
1189 AVHWAccel *av_hwaccel_next(AVHWAccel *hwaccel)
1190 {
1191     return hwaccel ? hwaccel->next : first_hwaccel;
1192 }
1193
1194 AVHWAccel *ff_find_hwaccel(enum CodecID codec_id, enum PixelFormat pix_fmt)
1195 {
1196     AVHWAccel *hwaccel=NULL;
1197
1198     while((hwaccel= av_hwaccel_next(hwaccel))){
1199         if (   hwaccel->id      == codec_id
1200             && hwaccel->pix_fmt == pix_fmt)
1201             return hwaccel;
1202     }
1203     return NULL;
1204 }
1205
1206 int av_lockmgr_register(int (*cb)(void **mutex, enum AVLockOp op))
1207 {
1208     if (ff_lockmgr_cb) {
1209         if (ff_lockmgr_cb(&codec_mutex, AV_LOCK_DESTROY))
1210             return -1;
1211     }
1212
1213     ff_lockmgr_cb = cb;
1214
1215     if (ff_lockmgr_cb) {
1216         if (ff_lockmgr_cb(&codec_mutex, AV_LOCK_CREATE))
1217             return -1;
1218     }
1219     return 0;
1220 }
1221
1222 unsigned int ff_toupper4(unsigned int x)
1223 {
1224     return     toupper( x     &0xFF)
1225             + (toupper((x>>8 )&0xFF)<<8 )
1226             + (toupper((x>>16)&0xFF)<<16)
1227             + (toupper((x>>24)&0xFF)<<24);
1228 }