]> git.sesse.net Git - ffmpeg/blob - libavcodec/avcodec.c
avcodec: Remove deprecated AVCodecContext.coded_frame
[ffmpeg] / libavcodec / avcodec.c
1 /*
2  * AVCodecContext functions for libavcodec
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20
21 /**
22  * @file
23  * AVCodecContext functions for libavcodec
24  */
25
26 #include "config.h"
27 #include "libavutil/avassert.h"
28 #include "libavutil/avstring.h"
29 #include "libavutil/bprint.h"
30 #include "libavutil/imgutils.h"
31 #include "libavutil/mem.h"
32 #include "libavutil/opt.h"
33 #include "libavutil/thread.h"
34 #include "avcodec.h"
35 #include "decode.h"
36 #include "encode.h"
37 #include "frame_thread_encoder.h"
38 #include "internal.h"
39 #include "thread.h"
40
41 #include "libavutil/ffversion.h"
42 const char av_codec_ffversion[] = "FFmpeg version " FFMPEG_VERSION;
43
44 unsigned avcodec_version(void)
45 {
46     av_assert0(AV_CODEC_ID_PCM_S8_PLANAR==65563);
47     av_assert0(AV_CODEC_ID_ADPCM_G722==69660);
48     av_assert0(AV_CODEC_ID_SRT==94216);
49     av_assert0(LIBAVCODEC_VERSION_MICRO >= 100);
50
51     return LIBAVCODEC_VERSION_INT;
52 }
53
54 const char *avcodec_configuration(void)
55 {
56     return FFMPEG_CONFIGURATION;
57 }
58
59 const char *avcodec_license(void)
60 {
61 #define LICENSE_PREFIX "libavcodec license: "
62     return &LICENSE_PREFIX FFMPEG_LICENSE[sizeof(LICENSE_PREFIX) - 1];
63 }
64
65 int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2), void *arg, int *ret, int count, int size)
66 {
67     int i;
68
69     for (i = 0; i < count; i++) {
70         int r = func(c, (char *)arg + i * size);
71         if (ret)
72             ret[i] = r;
73     }
74     emms_c();
75     return 0;
76 }
77
78 int avcodec_default_execute2(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2, int jobnr, int threadnr), void *arg, int *ret, int count)
79 {
80     int i;
81
82     for (i = 0; i < count; i++) {
83         int r = func(c, arg, i, 0);
84         if (ret)
85             ret[i] = r;
86     }
87     emms_c();
88     return 0;
89 }
90
91 static AVMutex codec_mutex = AV_MUTEX_INITIALIZER;
92
93 static void lock_avcodec(const AVCodec *codec)
94 {
95     if (!(codec->caps_internal & FF_CODEC_CAP_INIT_THREADSAFE) && codec->init)
96         ff_mutex_lock(&codec_mutex);
97 }
98
99 static void unlock_avcodec(const AVCodec *codec)
100 {
101     if (!(codec->caps_internal & FF_CODEC_CAP_INIT_THREADSAFE) && codec->init)
102         ff_mutex_unlock(&codec_mutex);
103 }
104
105 static int64_t get_bit_rate(AVCodecContext *ctx)
106 {
107     int64_t bit_rate;
108     int bits_per_sample;
109
110     switch (ctx->codec_type) {
111     case AVMEDIA_TYPE_VIDEO:
112     case AVMEDIA_TYPE_DATA:
113     case AVMEDIA_TYPE_SUBTITLE:
114     case AVMEDIA_TYPE_ATTACHMENT:
115         bit_rate = ctx->bit_rate;
116         break;
117     case AVMEDIA_TYPE_AUDIO:
118         bits_per_sample = av_get_bits_per_sample(ctx->codec_id);
119         if (bits_per_sample) {
120             bit_rate = ctx->sample_rate * (int64_t)ctx->channels;
121             if (bit_rate > INT64_MAX / bits_per_sample) {
122                 bit_rate = 0;
123             } else
124                 bit_rate *= bits_per_sample;
125         } else
126             bit_rate = ctx->bit_rate;
127         break;
128     default:
129         bit_rate = 0;
130         break;
131     }
132     return bit_rate;
133 }
134
135 int attribute_align_arg avcodec_open2(AVCodecContext *avctx, const AVCodec *codec, AVDictionary **options)
136 {
137     int ret = 0;
138     int codec_init_ok = 0;
139     AVDictionary *tmp = NULL;
140     AVCodecInternal *avci;
141
142     if (avcodec_is_open(avctx))
143         return 0;
144
145     if (!codec && !avctx->codec) {
146         av_log(avctx, AV_LOG_ERROR, "No codec provided to avcodec_open2()\n");
147         return AVERROR(EINVAL);
148     }
149     if (codec && avctx->codec && codec != avctx->codec) {
150         av_log(avctx, AV_LOG_ERROR, "This AVCodecContext was allocated for %s, "
151                                     "but %s passed to avcodec_open2()\n", avctx->codec->name, codec->name);
152         return AVERROR(EINVAL);
153     }
154     if (!codec)
155         codec = avctx->codec;
156
157     if ((avctx->codec_type == AVMEDIA_TYPE_UNKNOWN || avctx->codec_type == codec->type) &&
158         avctx->codec_id == AV_CODEC_ID_NONE) {
159         avctx->codec_type = codec->type;
160         avctx->codec_id   = codec->id;
161     }
162     if (avctx->codec_id != codec->id || (avctx->codec_type != codec->type &&
163                                          avctx->codec_type != AVMEDIA_TYPE_ATTACHMENT)) {
164         av_log(avctx, AV_LOG_ERROR, "Codec type or id mismatches\n");
165         return AVERROR(EINVAL);
166     }
167     avctx->codec = codec;
168
169     if (avctx->extradata_size < 0 || avctx->extradata_size >= FF_MAX_EXTRADATA_SIZE)
170         return AVERROR(EINVAL);
171
172     if (options)
173         av_dict_copy(&tmp, *options, 0);
174
175     lock_avcodec(codec);
176
177     avci = av_mallocz(sizeof(*avci));
178     if (!avci) {
179         ret = AVERROR(ENOMEM);
180         goto end;
181     }
182     avctx->internal = avci;
183
184 #if FF_API_OLD_ENCDEC
185     avci->to_free = av_frame_alloc();
186     avci->compat_decode_frame = av_frame_alloc();
187     avci->compat_encode_packet = av_packet_alloc();
188     if (!avci->to_free || !avci->compat_decode_frame || !avci->compat_encode_packet) {
189         ret = AVERROR(ENOMEM);
190         goto free_and_end;
191     }
192 #endif
193     avci->buffer_frame = av_frame_alloc();
194     avci->buffer_pkt = av_packet_alloc();
195     avci->es.in_frame = av_frame_alloc();
196     avci->ds.in_pkt = av_packet_alloc();
197     avci->last_pkt_props = av_packet_alloc();
198     avci->pkt_props = av_fifo_alloc(sizeof(*avci->last_pkt_props));
199     if (!avci->buffer_frame || !avci->buffer_pkt          ||
200         !avci->es.in_frame  || !avci->ds.in_pkt           ||
201         !avci->last_pkt_props || !avci->pkt_props) {
202         ret = AVERROR(ENOMEM);
203         goto free_and_end;
204     }
205
206     avci->skip_samples_multiplier = 1;
207
208     if (codec->priv_data_size > 0) {
209         if (!avctx->priv_data) {
210             avctx->priv_data = av_mallocz(codec->priv_data_size);
211             if (!avctx->priv_data) {
212                 ret = AVERROR(ENOMEM);
213                 goto free_and_end;
214             }
215             if (codec->priv_class) {
216                 *(const AVClass **)avctx->priv_data = codec->priv_class;
217                 av_opt_set_defaults(avctx->priv_data);
218             }
219         }
220         if (codec->priv_class && (ret = av_opt_set_dict(avctx->priv_data, &tmp)) < 0)
221             goto free_and_end;
222     } else {
223         avctx->priv_data = NULL;
224     }
225     if ((ret = av_opt_set_dict(avctx, &tmp)) < 0)
226         goto free_and_end;
227
228     if (avctx->codec_whitelist && av_match_list(codec->name, avctx->codec_whitelist, ',') <= 0) {
229         av_log(avctx, AV_LOG_ERROR, "Codec (%s) not on whitelist \'%s\'\n", codec->name, avctx->codec_whitelist);
230         ret = AVERROR(EINVAL);
231         goto free_and_end;
232     }
233
234     // only call ff_set_dimensions() for non H.264/VP6F/DXV codecs so as not to overwrite previously setup dimensions
235     if (!(avctx->coded_width && avctx->coded_height && avctx->width && avctx->height &&
236           (avctx->codec_id == AV_CODEC_ID_H264 || avctx->codec_id == AV_CODEC_ID_VP6F || avctx->codec_id == AV_CODEC_ID_DXV))) {
237         if (avctx->coded_width && avctx->coded_height)
238             ret = ff_set_dimensions(avctx, avctx->coded_width, avctx->coded_height);
239         else if (avctx->width && avctx->height)
240             ret = ff_set_dimensions(avctx, avctx->width, avctx->height);
241         if (ret < 0)
242             goto free_and_end;
243     }
244
245     if ((avctx->coded_width || avctx->coded_height || avctx->width || avctx->height)
246         && (  av_image_check_size2(avctx->coded_width, avctx->coded_height, avctx->max_pixels, AV_PIX_FMT_NONE, 0, avctx) < 0
247            || av_image_check_size2(avctx->width,       avctx->height,       avctx->max_pixels, AV_PIX_FMT_NONE, 0, avctx) < 0)) {
248         av_log(avctx, AV_LOG_WARNING, "Ignoring invalid width/height values\n");
249         ff_set_dimensions(avctx, 0, 0);
250     }
251
252     if (avctx->width > 0 && avctx->height > 0) {
253         if (av_image_check_sar(avctx->width, avctx->height,
254                                avctx->sample_aspect_ratio) < 0) {
255             av_log(avctx, AV_LOG_WARNING, "ignoring invalid SAR: %u/%u\n",
256                    avctx->sample_aspect_ratio.num,
257                    avctx->sample_aspect_ratio.den);
258             avctx->sample_aspect_ratio = (AVRational){ 0, 1 };
259         }
260     }
261
262     if (avctx->channels > FF_SANE_NB_CHANNELS || avctx->channels < 0) {
263         av_log(avctx, AV_LOG_ERROR, "Too many or invalid channels: %d\n", avctx->channels);
264         ret = AVERROR(EINVAL);
265         goto free_and_end;
266     }
267
268     if (avctx->sample_rate < 0) {
269         av_log(avctx, AV_LOG_ERROR, "Invalid sample rate: %d\n", avctx->sample_rate);
270         ret = AVERROR(EINVAL);
271         goto free_and_end;
272     }
273     if (avctx->block_align < 0) {
274         av_log(avctx, AV_LOG_ERROR, "Invalid block align: %d\n", avctx->block_align);
275         ret = AVERROR(EINVAL);
276         goto free_and_end;
277     }
278
279     avctx->frame_number = 0;
280     avctx->codec_descriptor = avcodec_descriptor_get(avctx->codec_id);
281
282     if ((avctx->codec->capabilities & AV_CODEC_CAP_EXPERIMENTAL) &&
283         avctx->strict_std_compliance > FF_COMPLIANCE_EXPERIMENTAL) {
284         const char *codec_string = av_codec_is_encoder(codec) ? "encoder" : "decoder";
285         const AVCodec *codec2;
286         av_log(avctx, AV_LOG_ERROR,
287                "The %s '%s' is experimental but experimental codecs are not enabled, "
288                "add '-strict %d' if you want to use it.\n",
289                codec_string, codec->name, FF_COMPLIANCE_EXPERIMENTAL);
290         codec2 = av_codec_is_encoder(codec) ? avcodec_find_encoder(codec->id) : avcodec_find_decoder(codec->id);
291         if (!(codec2->capabilities & AV_CODEC_CAP_EXPERIMENTAL))
292             av_log(avctx, AV_LOG_ERROR, "Alternatively use the non experimental %s '%s'.\n",
293                 codec_string, codec2->name);
294         ret = AVERROR_EXPERIMENTAL;
295         goto free_and_end;
296     }
297
298     if (avctx->codec_type == AVMEDIA_TYPE_AUDIO &&
299         (!avctx->time_base.num || !avctx->time_base.den)) {
300         avctx->time_base.num = 1;
301         avctx->time_base.den = avctx->sample_rate;
302     }
303
304     if (av_codec_is_encoder(avctx->codec))
305         ret = ff_encode_preinit(avctx);
306     else
307         ret = ff_decode_preinit(avctx);
308     if (ret < 0)
309         goto free_and_end;
310
311     if (!HAVE_THREADS)
312         av_log(avctx, AV_LOG_WARNING, "Warning: not compiled with thread support, using thread emulation\n");
313
314     if (CONFIG_FRAME_THREAD_ENCODER && av_codec_is_encoder(avctx->codec)) {
315         unlock_avcodec(codec); //we will instantiate a few encoders thus kick the counter to prevent false detection of a problem
316         ret = ff_frame_thread_encoder_init(avctx, options ? *options : NULL);
317         lock_avcodec(codec);
318         if (ret < 0)
319             goto free_and_end;
320     }
321
322     if (HAVE_THREADS
323         && !(avci->frame_thread_encoder && (avctx->active_thread_type&FF_THREAD_FRAME))) {
324         ret = ff_thread_init(avctx);
325         if (ret < 0) {
326             goto free_and_end;
327         }
328     }
329     if (!HAVE_THREADS && !(codec->caps_internal & FF_CODEC_CAP_AUTO_THREADS))
330         avctx->thread_count = 1;
331
332     if (   avctx->codec->init && (!(avctx->active_thread_type&FF_THREAD_FRAME)
333         || avci->frame_thread_encoder)) {
334         ret = avctx->codec->init(avctx);
335         if (ret < 0) {
336             codec_init_ok = -1;
337             goto free_and_end;
338         }
339         codec_init_ok = 1;
340     }
341
342     ret=0;
343
344     if (av_codec_is_decoder(avctx->codec)) {
345         if (!avctx->bit_rate)
346             avctx->bit_rate = get_bit_rate(avctx);
347         /* validate channel layout from the decoder */
348         if (avctx->channel_layout) {
349             int channels = av_get_channel_layout_nb_channels(avctx->channel_layout);
350             if (!avctx->channels)
351                 avctx->channels = channels;
352             else if (channels != avctx->channels) {
353                 char buf[512];
354                 av_get_channel_layout_string(buf, sizeof(buf), -1, avctx->channel_layout);
355                 av_log(avctx, AV_LOG_WARNING,
356                        "Channel layout '%s' with %d channels does not match specified number of channels %d: "
357                        "ignoring specified channel layout\n",
358                        buf, channels, avctx->channels);
359                 avctx->channel_layout = 0;
360             }
361         }
362         if (avctx->channels && avctx->channels < 0 ||
363             avctx->channels > FF_SANE_NB_CHANNELS) {
364             ret = AVERROR(EINVAL);
365             goto free_and_end;
366         }
367         if (avctx->bits_per_coded_sample < 0) {
368             ret = AVERROR(EINVAL);
369             goto free_and_end;
370         }
371
372 #if FF_API_AVCTX_TIMEBASE
373         if (avctx->framerate.num > 0 && avctx->framerate.den > 0)
374             avctx->time_base = av_inv_q(av_mul_q(avctx->framerate, (AVRational){avctx->ticks_per_frame, 1}));
375 #endif
376     }
377     if (codec->priv_data_size > 0 && avctx->priv_data && codec->priv_class) {
378         av_assert0(*(const AVClass **)avctx->priv_data == codec->priv_class);
379     }
380
381 end:
382     unlock_avcodec(codec);
383     if (options) {
384         av_dict_free(options);
385         *options = tmp;
386     }
387
388     return ret;
389 free_and_end:
390     if (avctx->codec && avctx->codec->close &&
391         (codec_init_ok > 0 || (codec_init_ok < 0 &&
392          avctx->codec->caps_internal & FF_CODEC_CAP_INIT_CLEANUP)))
393         avctx->codec->close(avctx);
394
395     if (HAVE_THREADS && avci->thread_ctx)
396         ff_thread_free(avctx);
397
398     if (codec->priv_class && avctx->priv_data)
399         av_opt_free(avctx->priv_data);
400     av_opt_free(avctx);
401
402     if (av_codec_is_encoder(avctx->codec)) {
403         av_freep(&avctx->extradata);
404         avctx->extradata_size = 0;
405     }
406
407     av_dict_free(&tmp);
408     av_freep(&avctx->priv_data);
409     if (av_codec_is_decoder(avctx->codec))
410         av_freep(&avctx->subtitle_header);
411
412 #if FF_API_OLD_ENCDEC
413     av_frame_free(&avci->to_free);
414     av_frame_free(&avci->compat_decode_frame);
415     av_packet_free(&avci->compat_encode_packet);
416 #endif
417     av_frame_free(&avci->buffer_frame);
418     av_packet_free(&avci->buffer_pkt);
419     av_packet_free(&avci->last_pkt_props);
420     av_fifo_freep(&avci->pkt_props);
421
422     av_packet_free(&avci->ds.in_pkt);
423     av_frame_free(&avci->es.in_frame);
424     av_bsf_free(&avci->bsf);
425
426     av_buffer_unref(&avci->pool);
427     av_freep(&avci);
428     avctx->internal = NULL;
429     avctx->codec = NULL;
430     goto end;
431 }
432
433 void avcodec_flush_buffers(AVCodecContext *avctx)
434 {
435     AVCodecInternal *avci = avctx->internal;
436
437     if (av_codec_is_encoder(avctx->codec)) {
438         int caps = avctx->codec->capabilities;
439
440         if (!(caps & AV_CODEC_CAP_ENCODER_FLUSH)) {
441             // Only encoders that explicitly declare support for it can be
442             // flushed. Otherwise, this is a no-op.
443             av_log(avctx, AV_LOG_WARNING, "Ignoring attempt to flush encoder "
444                    "that doesn't support it\n");
445             return;
446         }
447
448         // We haven't implemented flushing for frame-threaded encoders.
449         av_assert0(!(caps & AV_CODEC_CAP_FRAME_THREADS));
450     }
451
452     avci->draining      = 0;
453     avci->draining_done = 0;
454     avci->nb_draining_errors = 0;
455     av_frame_unref(avci->buffer_frame);
456 #if FF_API_OLD_ENCDEC
457     av_frame_unref(avci->compat_decode_frame);
458     av_packet_unref(avci->compat_encode_packet);
459 #endif
460     av_packet_unref(avci->buffer_pkt);
461
462     av_packet_unref(avci->last_pkt_props);
463     while (av_fifo_size(avci->pkt_props) >= sizeof(*avci->last_pkt_props)) {
464         av_fifo_generic_read(avci->pkt_props,
465                              avci->last_pkt_props, sizeof(*avci->last_pkt_props),
466                              NULL);
467         av_packet_unref(avci->last_pkt_props);
468     }
469     av_fifo_reset(avci->pkt_props);
470
471     av_frame_unref(avci->es.in_frame);
472     av_packet_unref(avci->ds.in_pkt);
473
474     if (HAVE_THREADS && avctx->active_thread_type & FF_THREAD_FRAME)
475         ff_thread_flush(avctx);
476     else if (avctx->codec->flush)
477         avctx->codec->flush(avctx);
478
479     avctx->pts_correction_last_pts =
480     avctx->pts_correction_last_dts = INT64_MIN;
481
482     if (av_codec_is_decoder(avctx->codec))
483         av_bsf_flush(avci->bsf);
484
485 #if FF_API_OLD_ENCDEC
486 FF_DISABLE_DEPRECATION_WARNINGS
487     if (!avctx->refcounted_frames)
488         av_frame_unref(avci->to_free);
489 FF_ENABLE_DEPRECATION_WARNINGS
490 #endif
491 }
492
493 void avsubtitle_free(AVSubtitle *sub)
494 {
495     int i;
496
497     for (i = 0; i < sub->num_rects; i++) {
498         av_freep(&sub->rects[i]->data[0]);
499         av_freep(&sub->rects[i]->data[1]);
500         av_freep(&sub->rects[i]->data[2]);
501         av_freep(&sub->rects[i]->data[3]);
502         av_freep(&sub->rects[i]->text);
503         av_freep(&sub->rects[i]->ass);
504         av_freep(&sub->rects[i]);
505     }
506
507     av_freep(&sub->rects);
508
509     memset(sub, 0, sizeof(*sub));
510 }
511
512 av_cold int avcodec_close(AVCodecContext *avctx)
513 {
514     int i;
515
516     if (!avctx)
517         return 0;
518
519     if (avcodec_is_open(avctx)) {
520         AVCodecInternal *avci = avctx->internal;
521
522         if (CONFIG_FRAME_THREAD_ENCODER &&
523             avci->frame_thread_encoder && avctx->thread_count > 1) {
524             ff_frame_thread_encoder_free(avctx);
525         }
526         if (HAVE_THREADS && avci->thread_ctx)
527             ff_thread_free(avctx);
528         if (avctx->codec && avctx->codec->close)
529             avctx->codec->close(avctx);
530         avci->byte_buffer_size = 0;
531         av_freep(&avci->byte_buffer);
532 #if FF_API_OLD_ENCDEC
533         av_frame_free(&avci->to_free);
534         av_frame_free(&avci->compat_decode_frame);
535         av_packet_free(&avci->compat_encode_packet);
536 #endif
537         av_frame_free(&avci->buffer_frame);
538         av_packet_free(&avci->buffer_pkt);
539         av_packet_unref(avci->last_pkt_props);
540         while (av_fifo_size(avci->pkt_props) >= sizeof(*avci->last_pkt_props)) {
541             av_fifo_generic_read(avci->pkt_props, avci->last_pkt_props,
542                                  sizeof(*avci->last_pkt_props), NULL);
543             av_packet_unref(avci->last_pkt_props);
544         }
545         av_packet_free(&avci->last_pkt_props);
546         av_fifo_freep(&avci->pkt_props);
547
548         av_packet_free(&avci->ds.in_pkt);
549         av_frame_free(&avci->es.in_frame);
550
551         av_buffer_unref(&avci->pool);
552
553         if (avctx->hwaccel && avctx->hwaccel->uninit)
554             avctx->hwaccel->uninit(avctx);
555         av_freep(&avci->hwaccel_priv_data);
556
557         av_bsf_free(&avci->bsf);
558
559         av_freep(&avctx->internal);
560     }
561
562     for (i = 0; i < avctx->nb_coded_side_data; i++)
563         av_freep(&avctx->coded_side_data[i].data);
564     av_freep(&avctx->coded_side_data);
565     avctx->nb_coded_side_data = 0;
566
567     av_buffer_unref(&avctx->hw_frames_ctx);
568     av_buffer_unref(&avctx->hw_device_ctx);
569
570     if (avctx->priv_data && avctx->codec && avctx->codec->priv_class)
571         av_opt_free(avctx->priv_data);
572     av_opt_free(avctx);
573     av_freep(&avctx->priv_data);
574     if (av_codec_is_encoder(avctx->codec)) {
575         av_freep(&avctx->extradata);
576     } else if (av_codec_is_decoder(avctx->codec))
577         av_freep(&avctx->subtitle_header);
578
579     avctx->codec = NULL;
580     avctx->active_thread_type = 0;
581
582     return 0;
583 }
584
585 static const char *unknown_if_null(const char *str)
586 {
587     return str ? str : "unknown";
588 }
589
590 void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode)
591 {
592     const char *codec_type;
593     const char *codec_name;
594     const char *profile = NULL;
595     AVBPrint bprint;
596     int64_t bitrate;
597     int new_line = 0;
598     AVRational display_aspect_ratio;
599     const char *separator = enc->dump_separator ? (const char *)enc->dump_separator : ", ";
600     const char *str;
601
602     if (!buf || buf_size <= 0)
603         return;
604     av_bprint_init_for_buffer(&bprint, buf, buf_size);
605     codec_type = av_get_media_type_string(enc->codec_type);
606     codec_name = avcodec_get_name(enc->codec_id);
607     profile = avcodec_profile_name(enc->codec_id, enc->profile);
608
609     av_bprintf(&bprint, "%s: %s", codec_type ? codec_type : "unknown",
610                codec_name);
611     buf[0] ^= 'a' ^ 'A'; /* first letter in uppercase */
612
613     if (enc->codec && strcmp(enc->codec->name, codec_name))
614         av_bprintf(&bprint, " (%s)", enc->codec->name);
615
616     if (profile)
617         av_bprintf(&bprint, " (%s)", profile);
618     if (   enc->codec_type == AVMEDIA_TYPE_VIDEO
619         && av_log_get_level() >= AV_LOG_VERBOSE
620         && enc->refs)
621         av_bprintf(&bprint, ", %d reference frame%s",
622                    enc->refs, enc->refs > 1 ? "s" : "");
623
624     if (enc->codec_tag)
625         av_bprintf(&bprint, " (%s / 0x%04X)",
626                    av_fourcc2str(enc->codec_tag), enc->codec_tag);
627
628     switch (enc->codec_type) {
629     case AVMEDIA_TYPE_VIDEO:
630         {
631             unsigned len;
632
633             av_bprintf(&bprint, "%s%s", separator,
634                        enc->pix_fmt == AV_PIX_FMT_NONE ? "none" :
635                        unknown_if_null(av_get_pix_fmt_name(enc->pix_fmt)));
636
637             av_bprint_chars(&bprint, '(', 1);
638             len = bprint.len;
639
640             /* The following check ensures that '(' has been written
641              * and therefore allows us to erase it if it turns out
642              * to be unnecessary. */
643             if (!av_bprint_is_complete(&bprint))
644                 return;
645
646             if (enc->bits_per_raw_sample && enc->pix_fmt != AV_PIX_FMT_NONE &&
647                 enc->bits_per_raw_sample < av_pix_fmt_desc_get(enc->pix_fmt)->comp[0].depth)
648                 av_bprintf(&bprint, "%d bpc, ", enc->bits_per_raw_sample);
649             if (enc->color_range != AVCOL_RANGE_UNSPECIFIED &&
650                 (str = av_color_range_name(enc->color_range)))
651                 av_bprintf(&bprint, "%s, ", str);
652
653             if (enc->colorspace != AVCOL_SPC_UNSPECIFIED ||
654                 enc->color_primaries != AVCOL_PRI_UNSPECIFIED ||
655                 enc->color_trc != AVCOL_TRC_UNSPECIFIED) {
656                 const char *col = unknown_if_null(av_color_space_name(enc->colorspace));
657                 const char *pri = unknown_if_null(av_color_primaries_name(enc->color_primaries));
658                 const char *trc = unknown_if_null(av_color_transfer_name(enc->color_trc));
659                 if (strcmp(col, pri) || strcmp(col, trc)) {
660                     new_line = 1;
661                     av_bprintf(&bprint, "%s/%s/%s, ", col, pri, trc);
662                 } else
663                     av_bprintf(&bprint, "%s, ", col);
664             }
665
666             if (enc->field_order != AV_FIELD_UNKNOWN) {
667                 const char *field_order = "progressive";
668                 if (enc->field_order == AV_FIELD_TT)
669                     field_order = "top first";
670                 else if (enc->field_order == AV_FIELD_BB)
671                     field_order = "bottom first";
672                 else if (enc->field_order == AV_FIELD_TB)
673                     field_order = "top coded first (swapped)";
674                 else if (enc->field_order == AV_FIELD_BT)
675                     field_order = "bottom coded first (swapped)";
676
677                 av_bprintf(&bprint, "%s, ", field_order);
678             }
679
680             if (av_log_get_level() >= AV_LOG_VERBOSE &&
681                 enc->chroma_sample_location != AVCHROMA_LOC_UNSPECIFIED &&
682                 (str = av_chroma_location_name(enc->chroma_sample_location)))
683                 av_bprintf(&bprint, "%s, ", str);
684
685             if (len == bprint.len) {
686                 bprint.str[len - 1] = '\0';
687                 bprint.len--;
688             } else {
689                 if (bprint.len - 2 < bprint.size) {
690                     /* Erase the last ", " */
691                     bprint.len -= 2;
692                     bprint.str[bprint.len] = '\0';
693                 }
694                 av_bprint_chars(&bprint, ')', 1);
695             }
696         }
697
698         if (enc->width) {
699             av_bprintf(&bprint, "%s%dx%d", new_line ? separator : ", ",
700                        enc->width, enc->height);
701
702             if (av_log_get_level() >= AV_LOG_VERBOSE &&
703                 (enc->width != enc->coded_width ||
704                  enc->height != enc->coded_height))
705                 av_bprintf(&bprint, " (%dx%d)",
706                            enc->coded_width, enc->coded_height);
707
708             if (enc->sample_aspect_ratio.num) {
709                 av_reduce(&display_aspect_ratio.num, &display_aspect_ratio.den,
710                           enc->width * (int64_t)enc->sample_aspect_ratio.num,
711                           enc->height * (int64_t)enc->sample_aspect_ratio.den,
712                           1024 * 1024);
713                 av_bprintf(&bprint, " [SAR %d:%d DAR %d:%d]",
714                          enc->sample_aspect_ratio.num, enc->sample_aspect_ratio.den,
715                          display_aspect_ratio.num, display_aspect_ratio.den);
716             }
717             if (av_log_get_level() >= AV_LOG_DEBUG) {
718                 int g = av_gcd(enc->time_base.num, enc->time_base.den);
719                 av_bprintf(&bprint, ", %d/%d",
720                            enc->time_base.num / g, enc->time_base.den / g);
721             }
722         }
723         if (encode) {
724             av_bprintf(&bprint, ", q=%d-%d", enc->qmin, enc->qmax);
725         } else {
726             if (enc->properties & FF_CODEC_PROPERTY_CLOSED_CAPTIONS)
727                 av_bprintf(&bprint, ", Closed Captions");
728             if (enc->properties & FF_CODEC_PROPERTY_LOSSLESS)
729                 av_bprintf(&bprint, ", lossless");
730         }
731         break;
732     case AVMEDIA_TYPE_AUDIO:
733         av_bprintf(&bprint, "%s", separator);
734
735         if (enc->sample_rate) {
736             av_bprintf(&bprint, "%d Hz, ", enc->sample_rate);
737         }
738         av_bprint_channel_layout(&bprint, enc->channels, enc->channel_layout);
739         if (enc->sample_fmt != AV_SAMPLE_FMT_NONE &&
740             (str = av_get_sample_fmt_name(enc->sample_fmt))) {
741             av_bprintf(&bprint, ", %s", str);
742         }
743         if (   enc->bits_per_raw_sample > 0
744             && enc->bits_per_raw_sample != av_get_bytes_per_sample(enc->sample_fmt) * 8)
745             av_bprintf(&bprint, " (%d bit)", enc->bits_per_raw_sample);
746         if (av_log_get_level() >= AV_LOG_VERBOSE) {
747             if (enc->initial_padding)
748                 av_bprintf(&bprint, ", delay %d", enc->initial_padding);
749             if (enc->trailing_padding)
750                 av_bprintf(&bprint, ", padding %d", enc->trailing_padding);
751         }
752         break;
753     case AVMEDIA_TYPE_DATA:
754         if (av_log_get_level() >= AV_LOG_DEBUG) {
755             int g = av_gcd(enc->time_base.num, enc->time_base.den);
756             if (g)
757                 av_bprintf(&bprint, ", %d/%d",
758                            enc->time_base.num / g, enc->time_base.den / g);
759         }
760         break;
761     case AVMEDIA_TYPE_SUBTITLE:
762         if (enc->width)
763             av_bprintf(&bprint, ", %dx%d", enc->width, enc->height);
764         break;
765     default:
766         return;
767     }
768     if (encode) {
769         if (enc->flags & AV_CODEC_FLAG_PASS1)
770             av_bprintf(&bprint, ", pass 1");
771         if (enc->flags & AV_CODEC_FLAG_PASS2)
772             av_bprintf(&bprint, ", pass 2");
773     }
774     bitrate = get_bit_rate(enc);
775     if (bitrate != 0) {
776         av_bprintf(&bprint, ", %"PRId64" kb/s", bitrate / 1000);
777     } else if (enc->rc_max_rate > 0) {
778         av_bprintf(&bprint, ", max. %"PRId64" kb/s", enc->rc_max_rate / 1000);
779     }
780 }
781
782 int avcodec_is_open(AVCodecContext *s)
783 {
784     return !!s->internal;
785 }