FFmpeg
encode.c
Go to the documentation of this file.
1 /*
2  * generic encoding-related code
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 #include "libavutil/attributes.h"
22 #include "libavutil/avassert.h"
24 #include "libavutil/emms.h"
25 #include "libavutil/frame.h"
26 #include "libavutil/imgutils.h"
27 #include "libavutil/internal.h"
28 #include "libavutil/pixdesc.h"
29 #include "libavutil/samplefmt.h"
30 
31 #include "avcodec.h"
32 #include "avcodec_internal.h"
33 #include "codec_desc.h"
34 #include "codec_internal.h"
35 #include "encode.h"
36 #include "frame_thread_encoder.h"
37 #include "internal.h"
38 
39 typedef struct EncodeContext {
41 
42  /**
43  * This is set to AV_PKT_FLAG_KEY for encoders that encode intra-only
44  * formats (i.e. whose codec descriptor has AV_CODEC_PROP_INTRA_ONLY set).
45  * This is used to set said flag generically for said encoders.
46  */
48 
49  /**
50  * An audio frame with less than required samples has been submitted (and
51  * potentially padded with silence). Reject all subsequent frames.
52  */
55 
57 {
58  return (EncodeContext*)avci;
59 }
60 
62 {
63  if (size < 0 || size > INT_MAX - AV_INPUT_BUFFER_PADDING_SIZE) {
64  av_log(avctx, AV_LOG_ERROR, "Invalid minimum required packet size %"PRId64" (max allowed is %d)\n",
66  return AVERROR(EINVAL);
67  }
68 
69  av_assert0(!avpkt->data);
70 
72  &avctx->internal->byte_buffer_size, size);
73  avpkt->data = avctx->internal->byte_buffer;
74  if (!avpkt->data) {
75  av_log(avctx, AV_LOG_ERROR, "Failed to allocate packet of size %"PRId64"\n", size);
76  return AVERROR(ENOMEM);
77  }
78  avpkt->size = size;
79 
80  return 0;
81 }
82 
84 {
85  int ret;
86 
87  if (avpkt->size < 0 || avpkt->size > INT_MAX - AV_INPUT_BUFFER_PADDING_SIZE)
88  return AVERROR(EINVAL);
89 
90  if (avpkt->data || avpkt->buf) {
91  av_log(avctx, AV_LOG_ERROR, "avpkt->{data,buf} != NULL in avcodec_default_get_encode_buffer()\n");
92  return AVERROR(EINVAL);
93  }
94 
96  if (ret < 0) {
97  av_log(avctx, AV_LOG_ERROR, "Failed to allocate packet of size %d\n", avpkt->size);
98  return ret;
99  }
100  avpkt->data = avpkt->buf->data;
101 
102  return 0;
103 }
104 
106 {
107  int ret;
108 
109  if (size < 0 || size > INT_MAX - AV_INPUT_BUFFER_PADDING_SIZE)
110  return AVERROR(EINVAL);
111 
112  av_assert0(!avpkt->data && !avpkt->buf);
113 
114  avpkt->size = size;
115  ret = avctx->get_encode_buffer(avctx, avpkt, flags);
116  if (ret < 0)
117  goto fail;
118 
119  if (!avpkt->data || !avpkt->buf) {
120  av_log(avctx, AV_LOG_ERROR, "No buffer returned by get_encode_buffer()\n");
121  ret = AVERROR(EINVAL);
122  goto fail;
123  }
124  memset(avpkt->data + avpkt->size, 0, AV_INPUT_BUFFER_PADDING_SIZE);
125 
126  ret = 0;
127 fail:
128  if (ret < 0) {
129  av_log(avctx, AV_LOG_ERROR, "get_encode_buffer() failed\n");
130  av_packet_unref(avpkt);
131  }
132 
133  return ret;
134 }
135 
137 {
138  uint8_t *data = avpkt->data;
139  int ret;
140 
141  if (avpkt->buf)
142  return 0;
143 
144  avpkt->data = NULL;
145  ret = ff_get_encode_buffer(avctx, avpkt, avpkt->size, 0);
146  if (ret < 0)
147  return ret;
148  memcpy(avpkt->data, data, avpkt->size);
149 
150  return 0;
151 }
152 
153 /**
154  * Pad last frame with silence.
155  */
156 static int pad_last_frame(AVCodecContext *s, AVFrame *frame, const AVFrame *src, int out_samples)
157 {
158  int ret;
159 
160  frame->format = src->format;
161  frame->nb_samples = out_samples;
162  ret = av_channel_layout_copy(&frame->ch_layout, &s->ch_layout);
163  if (ret < 0)
164  goto fail;
166  if (ret < 0)
167  goto fail;
168 
170  if (ret < 0)
171  goto fail;
172 
173  if ((ret = av_samples_copy(frame->extended_data, src->extended_data, 0, 0,
174  src->nb_samples, s->ch_layout.nb_channels,
175  s->sample_fmt)) < 0)
176  goto fail;
177  if ((ret = av_samples_set_silence(frame->extended_data, src->nb_samples,
178  frame->nb_samples - src->nb_samples,
179  s->ch_layout.nb_channels, s->sample_fmt)) < 0)
180  goto fail;
181 
182  return 0;
183 
184 fail:
186  encode_ctx(s->internal)->last_audio_frame = 0;
187  return ret;
188 }
189 
190 int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
191  const AVSubtitle *sub)
192 {
193  int ret;
194  if (sub->start_display_time) {
195  av_log(avctx, AV_LOG_ERROR, "start_display_time must be 0.\n");
196  return -1;
197  }
198 
199  ret = ffcodec(avctx->codec)->cb.encode_sub(avctx, buf, buf_size, sub);
200  avctx->frame_num++;
201  return ret;
202 }
203 
205 {
206  AVCodecInternal *avci = avctx->internal;
207 
208  if (avci->draining)
209  return AVERROR_EOF;
210 
211  if (!avci->buffer_frame->buf[0])
212  return AVERROR(EAGAIN);
213 
215 
216 #if FF_API_FRAME_KEY
218  if (frame->key_frame)
221 #endif
222 #if FF_API_INTERLACED_FRAME
224  if (frame->interlaced_frame)
226  if (frame->top_field_first)
229 #endif
230 
231  return 0;
232 }
233 
235  AVPacket *pkt, const AVFrame *frame)
236 {
237  if (avctx->flags & AV_CODEC_FLAG_COPY_OPAQUE) {
239  if (ret < 0)
240  return ret;
241  pkt->opaque = frame->opaque;
242  }
243 
244  return 0;
245 }
246 
248  AVFrame *frame, int *got_packet)
249 {
250  const FFCodec *const codec = ffcodec(avctx->codec);
251  int ret;
252 
253  ret = codec->cb.encode(avctx, avpkt, frame, got_packet);
254  emms_c();
255  av_assert0(ret <= 0);
256 
257  if (!ret && *got_packet) {
258  if (avpkt->data) {
259  ret = encode_make_refcounted(avctx, avpkt);
260  if (ret < 0)
261  goto unref;
262  // Date returned by encoders must always be ref-counted
263  av_assert0(avpkt->buf);
264  }
265 
266  // set the timestamps for the simple no-delay case
267  // encoders with delay have to set the timestamps themselves
268  if (!(avctx->codec->capabilities & AV_CODEC_CAP_DELAY) ||
269  (frame && (codec->caps_internal & FF_CODEC_CAP_EOF_FLUSH))) {
270  if (avpkt->pts == AV_NOPTS_VALUE)
271  avpkt->pts = frame->pts;
272 
273  if (!avpkt->duration) {
274  if (frame->duration)
275  avpkt->duration = frame->duration;
276  else if (avctx->codec->type == AVMEDIA_TYPE_AUDIO) {
277  avpkt->duration = ff_samples_to_time_base(avctx,
278  frame->nb_samples);
279  }
280  }
281 
282  ret = ff_encode_reordered_opaque(avctx, avpkt, frame);
283  if (ret < 0)
284  goto unref;
285  }
286 
287  // dts equals pts unless there is reordering
288  // there can be no reordering if there is no encoder delay
289  if (!(avctx->codec_descriptor->props & AV_CODEC_PROP_REORDER) ||
290  !(avctx->codec->capabilities & AV_CODEC_CAP_DELAY) ||
292  avpkt->dts = avpkt->pts;
293  } else {
294 unref:
295  av_packet_unref(avpkt);
296  }
297 
298  if (frame)
300 
301  return ret;
302 }
303 
305 {
306  AVCodecInternal *avci = avctx->internal;
307  AVFrame *frame = avci->in_frame;
308  const FFCodec *const codec = ffcodec(avctx->codec);
309  int got_packet;
310  int ret;
311 
312  if (avci->draining_done)
313  return AVERROR_EOF;
314 
315  if (!frame->buf[0] && !avci->draining) {
317  ret = ff_encode_get_frame(avctx, frame);
318  if (ret < 0 && ret != AVERROR_EOF)
319  return ret;
320  }
321 
322  if (!frame->buf[0]) {
323  if (!(avctx->codec->capabilities & AV_CODEC_CAP_DELAY ||
324  avci->frame_thread_encoder))
325  return AVERROR_EOF;
326 
327  // Flushing is signaled with a NULL frame
328  frame = NULL;
329  }
330 
331  got_packet = 0;
332 
334 
335  if (CONFIG_FRAME_THREAD_ENCODER && avci->frame_thread_encoder)
336  /* This will unref frame. */
337  ret = ff_thread_video_encode_frame(avctx, avpkt, frame, &got_packet);
338  else {
339  ret = ff_encode_encode_cb(avctx, avpkt, frame, &got_packet);
340  }
341 
342  if (avci->draining && !got_packet)
343  avci->draining_done = 1;
344 
345  return ret;
346 }
347 
349 {
350  int ret;
351 
352  while (!avpkt->data && !avpkt->side_data) {
353  ret = encode_simple_internal(avctx, avpkt);
354  if (ret < 0)
355  return ret;
356  }
357 
358  return 0;
359 }
360 
362 {
363  AVCodecInternal *avci = avctx->internal;
364  int ret;
365 
366  if (avci->draining_done)
367  return AVERROR_EOF;
368 
369  av_assert0(!avpkt->data && !avpkt->side_data);
370 
371  if (avctx->codec->type == AVMEDIA_TYPE_VIDEO) {
372  if ((avctx->flags & AV_CODEC_FLAG_PASS1) && avctx->stats_out)
373  avctx->stats_out[0] = '\0';
374  if (av_image_check_size2(avctx->width, avctx->height, avctx->max_pixels, AV_PIX_FMT_NONE, 0, avctx))
375  return AVERROR(EINVAL);
376  }
377 
379  ret = ffcodec(avctx->codec)->cb.receive_packet(avctx, avpkt);
380  if (ret < 0)
381  av_packet_unref(avpkt);
382  else
383  // Encoders must always return ref-counted buffers.
384  // Side-data only packets have no data and can be not ref-counted.
385  av_assert0(!avpkt->data || avpkt->buf);
386  } else
387  ret = encode_simple_receive_packet(avctx, avpkt);
388  if (ret >= 0)
389  avpkt->flags |= encode_ctx(avci)->intra_only_flag;
390 
391  if (ret == AVERROR_EOF)
392  avci->draining_done = 1;
393 
394  return ret;
395 }
396 
397 #if CONFIG_LCMS2
399 {
402  const FFCodec *const codec = ffcodec(avctx->codec);
403  AVCodecInternal *avci = avctx->internal;
404  cmsHPROFILE profile;
405  int ret;
406 
407  /* don't generate ICC profiles if disabled or unsupported */
408  if (!(avctx->flags2 & AV_CODEC_FLAG2_ICC_PROFILES))
409  return 0;
411  return 0;
412 
413  if (trc == AVCOL_TRC_UNSPECIFIED)
414  trc = avctx->color_trc;
415  if (prim == AVCOL_PRI_UNSPECIFIED)
416  prim = avctx->color_primaries;
417  if (trc == AVCOL_TRC_UNSPECIFIED || prim == AVCOL_PRI_UNSPECIFIED)
418  return 0; /* can't generate ICC profile with missing csp tags */
419 
421  return 0; /* don't overwrite existing ICC profile */
422 
423  if (!avci->icc.avctx) {
424  ret = ff_icc_context_init(&avci->icc, avctx);
425  if (ret < 0)
426  return ret;
427  }
428 
429  ret = ff_icc_profile_generate(&avci->icc, prim, trc, &profile);
430  if (ret < 0)
431  return ret;
432 
433  ret = ff_icc_profile_attach(&avci->icc, profile, frame);
434  cmsCloseProfile(profile);
435  return ret;
436 }
437 #else /* !CONFIG_LCMS2 */
439 {
440  return 0;
441 }
442 #endif
443 
445 {
446  AVCodecInternal *avci = avctx->internal;
447  EncodeContext *ec = encode_ctx(avci);
448  AVFrame *dst = avci->buffer_frame;
449  int ret;
450 
451  if (avctx->codec->type == AVMEDIA_TYPE_AUDIO) {
452  /* extract audio service type metadata */
454  if (sd && sd->size >= sizeof(enum AVAudioServiceType))
455  avctx->audio_service_type = *(enum AVAudioServiceType*)sd->data;
456 
457  /* check for valid frame size */
459  /* if we already got an undersized frame, that must have been the last */
460  if (ec->last_audio_frame) {
461  av_log(avctx, AV_LOG_ERROR, "frame_size (%d) was not respected for a non-last frame\n", avctx->frame_size);
462  return AVERROR(EINVAL);
463  }
464  if (src->nb_samples > avctx->frame_size) {
465  av_log(avctx, AV_LOG_ERROR, "nb_samples (%d) > frame_size (%d)\n", src->nb_samples, avctx->frame_size);
466  return AVERROR(EINVAL);
467  }
468  if (src->nb_samples < avctx->frame_size) {
469  ec->last_audio_frame = 1;
471  int pad_samples = avci->pad_samples ? avci->pad_samples : avctx->frame_size;
472  int out_samples = (src->nb_samples + pad_samples - 1) / pad_samples * pad_samples;
473 
474  if (out_samples != src->nb_samples) {
475  ret = pad_last_frame(avctx, dst, src, out_samples);
476  if (ret < 0)
477  return ret;
478  goto finish;
479  }
480  }
481  }
482  }
483  }
484 
485  ret = av_frame_ref(dst, src);
486  if (ret < 0)
487  return ret;
488 
489 finish:
490 
491  if (avctx->codec->type == AVMEDIA_TYPE_VIDEO) {
492  ret = encode_generate_icc_profile(avctx, dst);
493  if (ret < 0)
494  return ret;
495  }
496 
497  // unset frame duration unless AV_CODEC_FLAG_FRAME_DURATION is set,
498  // since otherwise we cannot be sure that whatever value it has is in the
499  // right timebase, so we would produce an incorrect value, which is worse
500  // than none at all
501  if (!(avctx->flags & AV_CODEC_FLAG_FRAME_DURATION))
502  dst->duration = 0;
503 
504  return 0;
505 }
506 
508 {
509  AVCodecInternal *avci = avctx->internal;
510  int ret;
511 
512  if (!avcodec_is_open(avctx) || !av_codec_is_encoder(avctx->codec))
513  return AVERROR(EINVAL);
514 
515  if (avci->draining)
516  return AVERROR_EOF;
517 
518  if (avci->buffer_frame->buf[0])
519  return AVERROR(EAGAIN);
520 
521  if (!frame) {
522  avci->draining = 1;
523  } else {
525  if (ret < 0)
526  return ret;
527  }
528 
529  if (!avci->buffer_pkt->data && !avci->buffer_pkt->side_data) {
531  if (ret < 0 && ret != AVERROR(EAGAIN) && ret != AVERROR_EOF)
532  return ret;
533  }
534 
535  avctx->frame_num++;
536 
537  return 0;
538 }
539 
541 {
542  AVCodecInternal *avci = avctx->internal;
543  int ret;
544 
545  av_packet_unref(avpkt);
546 
547  if (!avcodec_is_open(avctx) || !av_codec_is_encoder(avctx->codec))
548  return AVERROR(EINVAL);
549 
550  if (avci->buffer_pkt->data || avci->buffer_pkt->side_data) {
551  av_packet_move_ref(avpkt, avci->buffer_pkt);
552  } else {
553  ret = encode_receive_packet_internal(avctx, avpkt);
554  if (ret < 0)
555  return ret;
556  }
557 
558  return 0;
559 }
560 
562 {
563  const AVCodec *c = avctx->codec;
564  const AVPixFmtDescriptor *pixdesc = av_pix_fmt_desc_get(avctx->pix_fmt);
565  int i;
566 
567  if (!av_get_pix_fmt_name(avctx->pix_fmt)) {
568  av_log(avctx, AV_LOG_ERROR, "Invalid video pixel format: %d\n",
569  avctx->pix_fmt);
570  return AVERROR(EINVAL);
571  }
572 
573  if (c->pix_fmts) {
574  for (i = 0; c->pix_fmts[i] != AV_PIX_FMT_NONE; i++)
575  if (avctx->pix_fmt == c->pix_fmts[i])
576  break;
577  if (c->pix_fmts[i] == AV_PIX_FMT_NONE) {
578  av_log(avctx, AV_LOG_ERROR,
579  "Specified pixel format %s is not supported by the %s encoder.\n",
580  av_get_pix_fmt_name(avctx->pix_fmt), c->name);
581 
582  av_log(avctx, AV_LOG_ERROR, "Supported pixel formats:\n");
583  for (int p = 0; c->pix_fmts[p] != AV_PIX_FMT_NONE; p++) {
584  av_log(avctx, AV_LOG_ERROR, " %s\n",
585  av_get_pix_fmt_name(c->pix_fmts[p]));
586  }
587 
588  return AVERROR(EINVAL);
589  }
590  if (c->pix_fmts[i] == AV_PIX_FMT_YUVJ420P ||
591  c->pix_fmts[i] == AV_PIX_FMT_YUVJ411P ||
592  c->pix_fmts[i] == AV_PIX_FMT_YUVJ422P ||
593  c->pix_fmts[i] == AV_PIX_FMT_YUVJ440P ||
594  c->pix_fmts[i] == AV_PIX_FMT_YUVJ444P)
595  avctx->color_range = AVCOL_RANGE_JPEG;
596  }
597 
598  if ( avctx->bits_per_raw_sample < 0
599  || (avctx->bits_per_raw_sample > 8 && pixdesc->comp[0].depth <= 8)) {
600  av_log(avctx, AV_LOG_WARNING, "Specified bit depth %d not possible with the specified pixel formats depth %d\n",
601  avctx->bits_per_raw_sample, pixdesc->comp[0].depth);
602  avctx->bits_per_raw_sample = pixdesc->comp[0].depth;
603  }
604  if (avctx->width <= 0 || avctx->height <= 0) {
605  av_log(avctx, AV_LOG_ERROR, "dimensions not set\n");
606  return AVERROR(EINVAL);
607  }
608 
609 #if FF_API_TICKS_PER_FRAME
611  if (avctx->ticks_per_frame && avctx->time_base.num &&
612  avctx->ticks_per_frame > INT_MAX / avctx->time_base.num) {
613  av_log(avctx, AV_LOG_ERROR,
614  "ticks_per_frame %d too large for the timebase %d/%d.",
615  avctx->ticks_per_frame,
616  avctx->time_base.num,
617  avctx->time_base.den);
618  return AVERROR(EINVAL);
619  }
621 #endif
622 
623  if (avctx->hw_frames_ctx) {
624  AVHWFramesContext *frames_ctx = (AVHWFramesContext*)avctx->hw_frames_ctx->data;
625  if (frames_ctx->format != avctx->pix_fmt) {
626  av_log(avctx, AV_LOG_ERROR,
627  "Mismatching AVCodecContext.pix_fmt and AVHWFramesContext.format\n");
628  return AVERROR(EINVAL);
629  }
630  if (avctx->sw_pix_fmt != AV_PIX_FMT_NONE &&
631  avctx->sw_pix_fmt != frames_ctx->sw_format) {
632  av_log(avctx, AV_LOG_ERROR,
633  "Mismatching AVCodecContext.sw_pix_fmt (%s) "
634  "and AVHWFramesContext.sw_format (%s)\n",
636  av_get_pix_fmt_name(frames_ctx->sw_format));
637  return AVERROR(EINVAL);
638  }
639  avctx->sw_pix_fmt = frames_ctx->sw_format;
640  }
641 
642  return 0;
643 }
644 
646 {
647  const AVCodec *c = avctx->codec;
648  int i;
649 
650  if (!av_get_sample_fmt_name(avctx->sample_fmt)) {
651  av_log(avctx, AV_LOG_ERROR, "Invalid audio sample format: %d\n",
652  avctx->sample_fmt);
653  return AVERROR(EINVAL);
654  }
655  if (avctx->sample_rate <= 0) {
656  av_log(avctx, AV_LOG_ERROR, "Invalid audio sample rate: %d\n",
657  avctx->sample_rate);
658  return AVERROR(EINVAL);
659  }
660 
661  if (c->sample_fmts) {
662  for (i = 0; c->sample_fmts[i] != AV_SAMPLE_FMT_NONE; i++) {
663  if (avctx->sample_fmt == c->sample_fmts[i])
664  break;
665  if (avctx->ch_layout.nb_channels == 1 &&
667  av_get_planar_sample_fmt(c->sample_fmts[i])) {
668  avctx->sample_fmt = c->sample_fmts[i];
669  break;
670  }
671  }
672  if (c->sample_fmts[i] == AV_SAMPLE_FMT_NONE) {
673  av_log(avctx, AV_LOG_ERROR,
674  "Specified sample format %s is not supported by the %s encoder\n",
675  av_get_sample_fmt_name(avctx->sample_fmt), c->name);
676 
677  av_log(avctx, AV_LOG_ERROR, "Supported sample formats:\n");
678  for (int p = 0; c->sample_fmts[p] != AV_SAMPLE_FMT_NONE; p++) {
679  av_log(avctx, AV_LOG_ERROR, " %s\n",
680  av_get_sample_fmt_name(c->sample_fmts[p]));
681  }
682 
683  return AVERROR(EINVAL);
684  }
685  }
686  if (c->supported_samplerates) {
687  for (i = 0; c->supported_samplerates[i] != 0; i++)
688  if (avctx->sample_rate == c->supported_samplerates[i])
689  break;
690  if (c->supported_samplerates[i] == 0) {
691  av_log(avctx, AV_LOG_ERROR,
692  "Specified sample rate %d is not supported by the %s encoder\n",
693  avctx->sample_rate, c->name);
694 
695  av_log(avctx, AV_LOG_ERROR, "Supported sample rates:\n");
696  for (int p = 0; c->supported_samplerates[p]; p++)
697  av_log(avctx, AV_LOG_ERROR, " %d\n", c->supported_samplerates[p]);
698 
699  return AVERROR(EINVAL);
700  }
701  }
702  if (c->ch_layouts) {
703  for (i = 0; c->ch_layouts[i].nb_channels; i++) {
704  if (!av_channel_layout_compare(&avctx->ch_layout, &c->ch_layouts[i]))
705  break;
706  }
707  if (!c->ch_layouts[i].nb_channels) {
708  char buf[512];
709  int ret = av_channel_layout_describe(&avctx->ch_layout, buf, sizeof(buf));
710  av_log(avctx, AV_LOG_ERROR,
711  "Specified channel layout '%s' is not supported by the %s encoder\n",
712  ret > 0 ? buf : "?", c->name);
713 
714  av_log(avctx, AV_LOG_ERROR, "Supported channel layouts:\n");
715  for (int p = 0; c->ch_layouts[p].nb_channels; p++) {
716  ret = av_channel_layout_describe(&c->ch_layouts[p], buf, sizeof(buf));
717  av_log(avctx, AV_LOG_ERROR, " %s\n", ret > 0 ? buf : "?");
718  }
719  return AVERROR(EINVAL);
720  }
721  }
722 
723  if (!avctx->bits_per_raw_sample)
725  if (!avctx->bits_per_raw_sample)
727 
728  return 0;
729 }
730 
732 {
733  AVCodecInternal *avci = avctx->internal;
734  EncodeContext *ec = encode_ctx(avci);
735  int ret = 0;
736 
737  if (avctx->time_base.num <= 0 || avctx->time_base.den <= 0) {
738  av_log(avctx, AV_LOG_ERROR, "The encoder timebase is not set.\n");
739  return AVERROR(EINVAL);
740  }
741 
742  if (avctx->flags & AV_CODEC_FLAG_COPY_OPAQUE &&
744  av_log(avctx, AV_LOG_ERROR, "The copy_opaque flag is set, but the "
745  "encoder does not support it.\n");
746  return AVERROR(EINVAL);
747  }
748 
749  switch (avctx->codec_type) {
750  case AVMEDIA_TYPE_VIDEO: ret = encode_preinit_video(avctx); break;
751  case AVMEDIA_TYPE_AUDIO: ret = encode_preinit_audio(avctx); break;
752  }
753  if (ret < 0)
754  return ret;
755 
756  if ( (avctx->codec_type == AVMEDIA_TYPE_VIDEO || avctx->codec_type == AVMEDIA_TYPE_AUDIO)
757  && avctx->bit_rate>0 && avctx->bit_rate<1000) {
758  av_log(avctx, AV_LOG_WARNING, "Bitrate %"PRId64" is extremely low, maybe you mean %"PRId64"k\n", avctx->bit_rate, avctx->bit_rate);
759  }
760 
761  if (!avctx->rc_initial_buffer_occupancy)
762  avctx->rc_initial_buffer_occupancy = avctx->rc_buffer_size * 3LL / 4;
763 
766 
767  if (ffcodec(avctx->codec)->cb_type == FF_CODEC_CB_TYPE_ENCODE) {
768  avci->in_frame = av_frame_alloc();
769  if (!avci->in_frame)
770  return AVERROR(ENOMEM);
771  }
772 
773  if ((avctx->flags & AV_CODEC_FLAG_RECON_FRAME)) {
775  av_log(avctx, AV_LOG_ERROR, "Reconstructed frame output requested "
776  "from an encoder not supporting it\n");
777  return AVERROR(ENOSYS);
778  }
779 
780  avci->recon_frame = av_frame_alloc();
781  if (!avci->recon_frame)
782  return AVERROR(ENOMEM);
783  }
784 
785  if (CONFIG_FRAME_THREAD_ENCODER) {
787  if (ret < 0)
788  return ret;
789  }
790 
791  return 0;
792 }
793 
795 {
796  int ret;
797 
798  switch (avctx->codec->type) {
799  case AVMEDIA_TYPE_VIDEO:
800  frame->format = avctx->pix_fmt;
801  if (frame->width <= 0 || frame->height <= 0) {
802  frame->width = FFMAX(avctx->width, avctx->coded_width);
803  frame->height = FFMAX(avctx->height, avctx->coded_height);
804  }
805 
806  break;
807  case AVMEDIA_TYPE_AUDIO:
808  frame->sample_rate = avctx->sample_rate;
809  frame->format = avctx->sample_fmt;
810  if (!frame->ch_layout.nb_channels) {
812  if (ret < 0)
813  return ret;
814  }
815  break;
816  }
817 
819  if (ret < 0) {
820  av_log(avctx, AV_LOG_ERROR, "get_buffer() failed\n");
822  return ret;
823  }
824 
825  return 0;
826 }
827 
829 {
830  AVCodecInternal *avci = avctx->internal;
831 
832  if (!avci->recon_frame)
833  return AVERROR(EINVAL);
834  if (!avci->recon_frame->buf[0])
835  return avci->draining_done ? AVERROR_EOF : AVERROR(EAGAIN);
836 
838  return 0;
839 }
840 
842 {
843  AVCodecInternal *avci = avctx->internal;
844 
845  if (avci->in_frame)
846  av_frame_unref(avci->in_frame);
847  if (avci->recon_frame)
849 }
850 
852 {
853  return av_mallocz(sizeof(EncodeContext));
854 }
855 
857 {
859  AVCPBProperties *props;
860  size_t size;
861  int i;
862 
863  for (i = 0; i < avctx->nb_coded_side_data; i++)
865  return (AVCPBProperties *)avctx->coded_side_data[i].data;
866 
867  props = av_cpb_properties_alloc(&size);
868  if (!props)
869  return NULL;
870 
871  tmp = av_realloc_array(avctx->coded_side_data, avctx->nb_coded_side_data + 1, sizeof(*tmp));
872  if (!tmp) {
873  av_freep(&props);
874  return NULL;
875  }
876 
877  avctx->coded_side_data = tmp;
878  avctx->nb_coded_side_data++;
879 
881  avctx->coded_side_data[avctx->nb_coded_side_data - 1].data = (uint8_t*)props;
882  avctx->coded_side_data[avctx->nb_coded_side_data - 1].size = size;
883 
884  return props;
885 }
AVSubtitle
Definition: avcodec.h:2227
AVFrame::color_trc
enum AVColorTransferCharacteristic color_trc
Definition: frame.h:627
avcodec_encode_subtitle
int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size, const AVSubtitle *sub)
Definition: encode.c:190
ff_encode_reordered_opaque
int ff_encode_reordered_opaque(AVCodecContext *avctx, AVPacket *pkt, const AVFrame *frame)
Propagate user opaque values from the frame to avctx/pkt as needed.
Definition: encode.c:234
av_samples_copy
int av_samples_copy(uint8_t *const *dst, uint8_t *const *src, int dst_offset, int src_offset, int nb_samples, int nb_channels, enum AVSampleFormat sample_fmt)
Copy samples from src to dst.
Definition: samplefmt.c:222
AVCodecContext::frame_size
int frame_size
Number of samples per channel in an audio frame.
Definition: avcodec.h:1077
av_packet_unref
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
Definition: avpacket.c:427
AVCodec
AVCodec.
Definition: codec.h:187
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:73
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
avcodec_receive_packet
int attribute_align_arg avcodec_receive_packet(AVCodecContext *avctx, AVPacket *avpkt)
Read encoded data from the encoder.
Definition: encode.c:540
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
AVCodecContext::audio_service_type
enum AVAudioServiceType audio_service_type
Type of service that the audio stream conveys.
Definition: avcodec.h:1097
FF_CODEC_CB_TYPE_RECEIVE_PACKET
@ FF_CODEC_CB_TYPE_RECEIVE_PACKET
Definition: codec_internal.h:124
AVColorTransferCharacteristic
AVColorTransferCharacteristic
Color Transfer Characteristic.
Definition: pixfmt.h:580
av_frame_get_buffer
int av_frame_get_buffer(AVFrame *frame, int align)
Allocate new buffer(s) for audio or video data.
Definition: frame.c:258
AVCodecContext::sample_rate
int sample_rate
samples per second
Definition: avcodec.h:1050
av_frame_get_side_data
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Definition: frame.c:838
AVFrame::duration
int64_t duration
Duration of the frame, in the same units as pts.
Definition: frame.h:750
av_pix_fmt_desc_get
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2962
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:57
AVBufferRef::data
uint8_t * data
The data buffer.
Definition: buffer.h:90
AVHWFramesContext::format
enum AVPixelFormat format
The pixel format identifying the underlying HW surface type.
Definition: hwcontext.h:197
FF_CODEC_CAP_EOF_FLUSH
#define FF_CODEC_CAP_EOF_FLUSH
The encoder has AV_CODEC_CAP_DELAY set, but does not actually have delay - it only wants to be flushe...
Definition: codec_internal.h:90
AVCodecContext::codec_descriptor
const struct AVCodecDescriptor * codec_descriptor
AVCodecDescriptor.
Definition: avcodec.h:1861
AVCodecContext::coded_side_data
AVPacketSideData * coded_side_data
Additional data associated with the entire coded stream.
Definition: avcodec.h:1915
int64_t
long long int64_t
Definition: coverity.c:34
encode_make_refcounted
static int encode_make_refcounted(AVCodecContext *avctx, AVPacket *avpkt)
Definition: encode.c:136
AV_CODEC_CAP_ENCODER_RECON_FRAME
#define AV_CODEC_CAP_ENCODER_RECON_FRAME
The encoder is able to output reconstructed frame data, i.e.
Definition: codec.h:174
AVFrame::color_primaries
enum AVColorPrimaries color_primaries
Definition: frame.h:625
av_unused
#define av_unused
Definition: attributes.h:131
AVFrame::opaque
void * opaque
Frame owner's private data.
Definition: frame.h:492
ff_encode_receive_frame
int ff_encode_receive_frame(AVCodecContext *avctx, AVFrame *frame)
avcodec_receive_frame() implementation for encoders.
Definition: encode.c:828
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:344
tmp
static uint8_t tmp[11]
Definition: aes_ctr.c:28
pixdesc.h
AVFrame::pts
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:456
AVCodecContext::color_trc
enum AVColorTransferCharacteristic color_trc
Color Transfer Characteristic.
Definition: avcodec.h:678
AVFrame::width
int width
Definition: frame.h:416
AVPacketSideData
This structure stores auxiliary information for decoding, presenting, or otherwise processing the cod...
Definition: packet.h:373
AVCodec::capabilities
int capabilities
Codec capabilities.
Definition: codec.h:206
AVCOL_RANGE_JPEG
@ AVCOL_RANGE_JPEG
Full range content.
Definition: pixfmt.h:683
internal.h
av_samples_set_silence
int av_samples_set_silence(uint8_t *const *audio_data, int offset, int nb_samples, int nb_channels, enum AVSampleFormat sample_fmt)
Fill an audio buffer with silence.
Definition: samplefmt.c:246
AVPacket::data
uint8_t * data
Definition: packet.h:522
AVComponentDescriptor::depth
int depth
Number of bits in the component.
Definition: pixdesc.h:57
AVCodecInternal::frame_thread_encoder
void * frame_thread_encoder
Definition: internal.h:89
AVCodecInternal::in_frame
AVFrame * in_frame
The input frame is stored here for encoders implementing the simple encode API.
Definition: internal.h:97
encode.h
AVCOL_TRC_UNSPECIFIED
@ AVCOL_TRC_UNSPECIFIED
Definition: pixfmt.h:583
data
const char data[16]
Definition: mxf.c:148
FFCodec
Definition: codec_internal.h:127
FFCodec::encode
int(* encode)(struct AVCodecContext *avctx, struct AVPacket *avpkt, const struct AVFrame *frame, int *got_packet_ptr)
Encode data to an AVPacket.
Definition: codec_internal.h:222
ff_encode_encode_cb
int ff_encode_encode_cb(AVCodecContext *avctx, AVPacket *avpkt, AVFrame *frame, int *got_packet)
Definition: encode.c:247
AVPacket::duration
int64_t duration
Duration of this packet in AVStream->time_base units, 0 if unknown.
Definition: packet.h:540
AVFrame::flags
int flags
Frame flags, a combination of AV_FRAME_FLAGS.
Definition: frame.h:616
FFMAX
#define FFMAX(a, b)
Definition: macros.h:47
AVColorPrimaries
AVColorPrimaries
Chromaticity coordinates of the source primaries.
Definition: pixfmt.h:555
avcodec_is_open
int avcodec_is_open(AVCodecContext *s)
Definition: avcodec.c:676
AVChannelLayout::nb_channels
int nb_channels
Number of channels in this layout.
Definition: channel_layout.h:313
ff_icc_profile_attach
int ff_icc_profile_attach(FFIccContext *s, cmsHPROFILE profile, AVFrame *frame)
Attach an ICC profile to a frame.
Definition: fflcms2.c:172
AVFrame::buf
AVBufferRef * buf[AV_NUM_DATA_POINTERS]
AVBuffer references backing the data for this frame.
Definition: frame.h:557
AV_PKT_FLAG_KEY
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
Definition: packet.h:577
AV_FRAME_FLAG_TOP_FIELD_FIRST
#define AV_FRAME_FLAG_TOP_FIELD_FIRST
A flag to mark frames where the top field is displayed first if the content is interlaced.
Definition: frame.h:608
AVFrame::opaque_ref
AVBufferRef * opaque_ref
Frame owner's private data.
Definition: frame.h:711
AVPacketSideData::size
size_t size
Definition: packet.h:375
AV_CODEC_FLAG_COPY_OPAQUE
#define AV_CODEC_FLAG_COPY_OPAQUE
Definition: avcodec.h:299
finish
static void finish(void)
Definition: movenc.c:342
AVCodecContext::codec
const struct AVCodec * codec
Definition: avcodec.h:454
AVPacket::opaque_ref
AVBufferRef * opaque_ref
AVBufferRef for free use by the API user.
Definition: packet.h:558
AV_CODEC_FLAG_FRAME_DURATION
#define AV_CODEC_FLAG_FRAME_DURATION
Signal to the encoder that the values of AVFrame.duration are valid and should be used (typically for...
Definition: avcodec.h:306
AVCodecContext::ch_layout
AVChannelLayout ch_layout
Audio channel layout.
Definition: avcodec.h:1065
fail
#define fail()
Definition: checkasm.h:179
ff_icc_context_init
int ff_icc_context_init(FFIccContext *s, void *avctx)
Initializes an FFIccContext.
Definition: fflcms2.c:30
encode_receive_packet_internal
static int encode_receive_packet_internal(AVCodecContext *avctx, AVPacket *avpkt)
Definition: encode.c:361
samplefmt.h
AVCodecContext::flags
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:502
AVFrame::ch_layout
AVChannelLayout ch_layout
Channel layout of the audio data.
Definition: frame.h:745
AVCodecContext::coded_height
int coded_height
Definition: avcodec.h:633
encode_preinit_video
static int encode_preinit_video(AVCodecContext *avctx)
Definition: encode.c:561
AVRational::num
int num
Numerator.
Definition: rational.h:59
av_image_check_size2
int av_image_check_size2(unsigned int w, unsigned int h, int64_t max_pixels, enum AVPixelFormat pix_fmt, int log_offset, void *log_ctx)
Check if the given dimension of an image is valid, meaning that all bytes of a plane of an image with...
Definition: imgutils.c:289
av_get_planar_sample_fmt
enum AVSampleFormat av_get_planar_sample_fmt(enum AVSampleFormat sample_fmt)
Get the planar alternative form of the given sample format.
Definition: samplefmt.c:86
av_frame_alloc
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
Definition: frame.c:118
AV_PIX_FMT_YUVJ411P
@ AV_PIX_FMT_YUVJ411P
planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples) full scale (JPEG), deprecated in favor ...
Definition: pixfmt.h:283
AVFrame::interlaced_frame
attribute_deprecated int interlaced_frame
The content of the picture is interlaced.
Definition: frame.h:521
avassert.h
AVCodecContext::color_primaries
enum AVColorPrimaries color_primaries
Chromaticity coordinates of the source primaries.
Definition: avcodec.h:671
pkt
AVPacket * pkt
Definition: movenc.c:59
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
encode_send_frame_internal
static int encode_send_frame_internal(AVCodecContext *avctx, const AVFrame *src)
Definition: encode.c:444
frame_thread_encoder.h
AVFrameSideData::size
size_t size
Definition: frame.h:253
encode_simple_internal
static int encode_simple_internal(AVCodecContext *avctx, AVPacket *avpkt)
Definition: encode.c:304
AVCodecContext::rc_initial_buffer_occupancy
int rc_initial_buffer_occupancy
Number of bits which should be loaded into the rc buffer before decoding starts.
Definition: avcodec.h:1320
AV_FRAME_FLAG_KEY
#define AV_FRAME_FLAG_KEY
A flag to mark frames that are keyframes.
Definition: frame.h:595
av_channel_layout_describe
int av_channel_layout_describe(const AVChannelLayout *channel_layout, char *buf, size_t buf_size)
Get a human-readable string describing the channel layout properties.
Definition: channel_layout.c:644
AV_PIX_FMT_YUVJ422P
@ AV_PIX_FMT_YUVJ422P
planar YUV 4:2:2, 16bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV422P and setting col...
Definition: pixfmt.h:86
emms_c
#define emms_c()
Definition: emms.h:63
ff_frame_thread_encoder_init
av_cold int ff_frame_thread_encoder_init(AVCodecContext *avctx)
Initialize frame thread encoder.
Definition: frame_thread_encoder.c:119
s
#define s(width, name)
Definition: cbs_vp9.c:198
AVCodecInternal::buffer_pkt
AVPacket * buffer_pkt
Temporary buffers for newly received or not yet output packets/frames.
Definition: internal.h:131
av_realloc_array
void * av_realloc_array(void *ptr, size_t nmemb, size_t size)
Definition: mem.c:215
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
AV_FRAME_DATA_AUDIO_SERVICE_TYPE
@ AV_FRAME_DATA_AUDIO_SERVICE_TYPE
This side data must be associated with an audio frame and corresponds to enum AVAudioServiceType defi...
Definition: frame.h:114
AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE
#define AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE
This encoder can reorder user opaque values from input AVFrames and return them with corresponding ou...
Definition: codec.h:159
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:40
AVCodecContext::bits_per_raw_sample
int bits_per_raw_sample
Bits per sample/pixel of internal libavcodec pixel/sample format.
Definition: avcodec.h:1574
EncodeContext::avci
AVCodecInternal avci
Definition: encode.c:40
AVPacketSideData::data
uint8_t * data
Definition: packet.h:374
FF_CODEC_CB_TYPE_ENCODE
@ FF_CODEC_CB_TYPE_ENCODE
Definition: codec_internal.h:118
AVCodecContext::max_pixels
int64_t max_pixels
The number of pixels per image to maximally accept.
Definition: avcodec.h:1934
av_get_sample_fmt_name
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
Definition: samplefmt.c:51
FFCodec::encode_sub
int(* encode_sub)(struct AVCodecContext *avctx, uint8_t *buf, int buf_size, const struct AVSubtitle *sub)
Encode subtitles to a raw buffer.
Definition: codec_internal.h:228
AVPacket::opaque
void * opaque
for some private data of the user
Definition: packet.h:547
AVCOL_PRI_UNSPECIFIED
@ AVCOL_PRI_UNSPECIFIED
Definition: pixfmt.h:558
AVCPBProperties
This structure describes the bitrate properties of an encoded bitstream.
Definition: defs.h:269
AVFrame::key_frame
attribute_deprecated int key_frame
1 -> keyframe, 0-> not
Definition: frame.h:440
AV_PIX_FMT_YUVJ444P
@ AV_PIX_FMT_YUVJ444P
planar YUV 4:4:4, 24bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV444P and setting col...
Definition: pixfmt.h:87
frame
static AVFrame * frame
Definition: demux_decode.c:54
AVCodecContext::codec_id
enum AVCodecID codec_id
Definition: avcodec.h:455
ff_thread_video_encode_frame
int ff_thread_video_encode_frame(AVCodecContext *avctx, AVPacket *pkt, AVFrame *frame, int *got_packet_ptr)
Definition: frame_thread_encoder.c:268
AVCodecDescriptor::props
int props
Codec properties, a combination of AV_CODEC_PROP_* flags.
Definition: codec_desc.h:54
if
if(ret)
Definition: filter_design.txt:179
AVCodecContext::rc_buffer_size
int rc_buffer_size
decoder bitstream buffer size
Definition: avcodec.h:1277
AV_CODEC_PROP_INTRA_ONLY
#define AV_CODEC_PROP_INTRA_ONLY
Codec uses only intra compression.
Definition: codec_desc.h:72
AVPacket::buf
AVBufferRef * buf
A reference to the reference-counted buffer where the packet data is stored.
Definition: packet.h:505
NULL
#define NULL
Definition: coverity.c:32
AVHWFramesContext::sw_format
enum AVPixelFormat sw_format
The pixel format identifying the actual data layout of the hardware frames.
Definition: hwcontext.h:210
av_frame_copy_props
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:679
AVCodecContext::color_range
enum AVColorRange color_range
MPEG vs JPEG YUV range.
Definition: avcodec.h:695
AVCodec::type
enum AVMediaType type
Definition: codec.h:200
AVCodecContext::nb_coded_side_data
int nb_coded_side_data
Definition: avcodec.h:1916
ff_samples_to_time_base
static av_always_inline int64_t ff_samples_to_time_base(const AVCodecContext *avctx, int64_t samples)
Rescale from sample rate to AVCodecContext.time_base.
Definition: encode.h:90
AVCodecContext::internal
struct AVCodecInternal * internal
Private context used for internal data.
Definition: avcodec.h:480
AV_PIX_FMT_YUVJ420P
@ AV_PIX_FMT_YUVJ420P
planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV420P and setting col...
Definition: pixfmt.h:85
AVCodecContext::bit_rate
int64_t bit_rate
the average bitrate
Definition: avcodec.h:495
AVPacketSideData::type
enum AVPacketSideDataType type
Definition: packet.h:376
AV_FRAME_DATA_ICC_PROFILE
@ AV_FRAME_DATA_ICC_PROFILE
The data contains an ICC profile as an opaque octet buffer following the format described by ISO 1507...
Definition: frame.h:144
ff_encode_internal_alloc
AVCodecInternal * ff_encode_internal_alloc(void)
Definition: encode.c:851
AV_CODEC_CAP_VARIABLE_FRAME_SIZE
#define AV_CODEC_CAP_VARIABLE_FRAME_SIZE
Audio encoder supports receiving a different number of samples in each call.
Definition: codec.h:128
AV_CODEC_FLAG2_ICC_PROFILES
#define AV_CODEC_FLAG2_ICC_PROFILES
Generate/parse ICC profiles on encode/decode, as appropriate for the type of file.
Definition: avcodec.h:398
av_packet_move_ref
void av_packet_move_ref(AVPacket *dst, AVPacket *src)
Move every field in src to dst and reset src.
Definition: avpacket.c:484
AVCodecInternal::draining_done
int draining_done
Definition: internal.h:133
c
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
Definition: undefined.txt:32
AVAudioServiceType
AVAudioServiceType
Definition: defs.h:222
ff_icc_profile_generate
int ff_icc_profile_generate(FFIccContext *s, enum AVColorPrimaries color_prim, enum AVColorTransferCharacteristic color_trc, cmsHPROFILE *out_profile)
Generate an ICC profile for a given combination of color primaries and transfer function.
Definition: fflcms2.c:145
attribute_align_arg
#define attribute_align_arg
Definition: internal.h:50
AVCodecContext::time_base
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented.
Definition: avcodec.h:544
ff_encode_alloc_frame
int ff_encode_alloc_frame(AVCodecContext *avctx, AVFrame *frame)
Allocate buffers for a frame.
Definition: encode.c:794
AVCodecContext::stats_out
char * stats_out
pass1 encoding statistics output buffer
Definition: avcodec.h:1334
av_get_exact_bits_per_sample
int av_get_exact_bits_per_sample(enum AVCodecID codec_id)
Return codec bits per sample.
Definition: utils.c:457
pad_last_frame
static int pad_last_frame(AVCodecContext *s, AVFrame *frame, const AVFrame *src, int out_samples)
Pad last frame with silence.
Definition: encode.c:156
f
f
Definition: af_crystalizer.c:121
AVCodecContext::flags2
int flags2
AV_CODEC_FLAG2_*.
Definition: avcodec.h:509
AVPacket::size
int size
Definition: packet.h:523
av_frame_ref
int av_frame_ref(AVFrame *dst, const AVFrame *src)
Set up a new reference to the data described by the source frame.
Definition: frame.c:354
codec_internal.h
AV_CODEC_PROP_REORDER
#define AV_CODEC_PROP_REORDER
Codec supports frame reordering.
Definition: codec_desc.h:92
FFCodec::receive_packet
int(* receive_packet)(struct AVCodecContext *avctx, struct AVPacket *avpkt)
Encode API with decoupled frame/packet dataflow.
Definition: codec_internal.h:237
AVFrame::sample_rate
int sample_rate
Sample rate of the audio data.
Definition: frame.h:543
EncodeContext
Definition: encode.c:39
AVCodecContext::sample_fmt
enum AVSampleFormat sample_fmt
audio sample format
Definition: avcodec.h:1057
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:56
size
int size
Definition: twinvq_data.h:10344
EncodeContext::last_audio_frame
int last_audio_frame
An audio frame with less than required samples has been submitted (and potentially padded with silenc...
Definition: encode.c:53
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
AVFrameSideData::data
uint8_t * data
Definition: frame.h:252
ffcodec
static const av_always_inline FFCodec * ffcodec(const AVCodec *codec)
Definition: codec_internal.h:306
AVCodecInternal::byte_buffer
uint8_t * byte_buffer
temporary buffer used for encoders to store their bitstream
Definition: internal.h:86
AVFrame::format
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
Definition: frame.h:431
frame.h
AVPacket::dts
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed.
Definition: packet.h:521
attributes.h
AVPacket::flags
int flags
A combination of AV_PKT_FLAG values.
Definition: packet.h:528
AVCodecInternal
Definition: internal.h:49
AVCodecInternal::byte_buffer_size
unsigned int byte_buffer_size
Definition: internal.h:87
encode_ctx
static EncodeContext * encode_ctx(AVCodecInternal *avci)
Definition: encode.c:56
ff_encode_preinit
int ff_encode_preinit(AVCodecContext *avctx)
Definition: encode.c:731
av_channel_layout_compare
int av_channel_layout_compare(const AVChannelLayout *chl, const AVChannelLayout *chl1)
Check whether two channel layouts are semantically the same, i.e.
Definition: channel_layout.c:800
av_codec_is_encoder
int av_codec_is_encoder(const AVCodec *codec)
Definition: utils.c:78
emms.h
avcodec_default_get_buffer2
int avcodec_default_get_buffer2(AVCodecContext *s, AVFrame *frame, int flags)
The default callback for AVCodecContext.get_buffer2().
Definition: get_buffer.c:254
FFCodec::caps_internal
unsigned caps_internal
Internal codec capabilities FF_CODEC_CAP_*.
Definition: codec_internal.h:136
AV_PKT_DATA_CPB_PROPERTIES
@ AV_PKT_DATA_CPB_PROPERTIES
This side data corresponds to the AVCPBProperties struct.
Definition: packet.h:146
AVFrame::nb_samples
int nb_samples
number of audio samples (per channel) described by this frame
Definition: frame.h:424
AV_CODEC_FLAG_RECON_FRAME
#define AV_CODEC_FLAG_RECON_FRAME
Request the encoder to output reconstructed frames, i.e. frames that would be produced by decoding th...
Definition: avcodec.h:264
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:255
AVPacket::pts
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: packet.h:515
av_get_bytes_per_sample
int av_get_bytes_per_sample(enum AVSampleFormat sample_fmt)
Return number of bytes per sample.
Definition: samplefmt.c:108
AVFrame::top_field_first
attribute_deprecated int top_field_first
If the content is interlaced, is top field displayed first.
Definition: frame.h:529
internal.h
AVFrame::extended_data
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:405
EncodeContext::intra_only_flag
int intra_only_flag
This is set to AV_PKT_FLAG_KEY for encoders that encode intra-only formats (i.e.
Definition: encode.c:47
av_fast_padded_malloc
void av_fast_padded_malloc(void *ptr, unsigned int *size, size_t min_size)
Same behaviour av_fast_malloc but the buffer has additional AV_INPUT_BUFFER_PADDING_SIZE at the end w...
Definition: utils.c:52
av_frame_move_ref
void av_frame_move_ref(AVFrame *dst, AVFrame *src)
Move everything contained in src to dst and reset src.
Definition: frame.c:603
AV_PIX_FMT_YUVJ440P
@ AV_PIX_FMT_YUVJ440P
planar YUV 4:4:0 full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV440P and setting color_range
Definition: pixfmt.h:107
av_frame_unref
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition: frame.c:576
av_mallocz
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
Definition: mem.c:254
av_buffer_replace
int av_buffer_replace(AVBufferRef **pdst, const AVBufferRef *src)
Ensure dst refers to the same data as src.
Definition: buffer.c:233
profile
int profile
Definition: mxfenc.c:2226
AVCodecContext::height
int height
Definition: avcodec.h:618
avcodec_send_frame
int attribute_align_arg avcodec_send_frame(AVCodecContext *avctx, const AVFrame *frame)
Supply a raw video or audio frame to the encoder.
Definition: encode.c:507
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:657
AV_FRAME_FLAG_INTERLACED
#define AV_FRAME_FLAG_INTERLACED
A flag to mark frames whose content is interlaced.
Definition: frame.h:603
FF_CODEC_CAP_ICC_PROFILES
#define FF_CODEC_CAP_ICC_PROFILES
Codec supports embedded ICC profiles (AV_FRAME_DATA_ICC_PROFILE).
Definition: codec_internal.h:82
AVCodecContext::hw_frames_ctx
AVBufferRef * hw_frames_ctx
A reference to the AVHWFramesContext describing the input (for encoding) or output (decoding) frames.
Definition: avcodec.h:1475
avcodec.h
AVHWFramesContext
This struct describes a set or pool of "hardware" frames (i.e.
Definition: hwcontext.h:115
AVCodecContext::frame_num
int64_t frame_num
Frame counter, set by libavcodec.
Definition: avcodec.h:2030
ret
ret
Definition: filter_design.txt:187
ff_encode_flush_buffers
void ff_encode_flush_buffers(AVCodecContext *avctx)
Definition: encode.c:841
AVPacket::side_data
AVPacketSideData * side_data
Additional packet data that can be provided by the container.
Definition: packet.h:533
AVCodecInternal::recon_frame
AVFrame * recon_frame
When the AV_CODEC_FLAG_RECON_FRAME flag is used.
Definition: internal.h:105
AV_INPUT_BUFFER_PADDING_SIZE
#define AV_INPUT_BUFFER_PADDING_SIZE
Definition: defs.h:40
AVCodecContext
main external API structure.
Definition: avcodec.h:445
AVFrame::height
int height
Definition: frame.h:416
channel_layout.h
avcodec_internal.h
ff_get_encode_buffer
int ff_get_encode_buffer(AVCodecContext *avctx, AVPacket *avpkt, int64_t size, int flags)
Get a buffer for a packet.
Definition: encode.c:105
AVRational::den
int den
Denominator.
Definition: rational.h:60
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:72
AVCodecInternal::pad_samples
int pad_samples
Audio encoders can set this flag during init to indicate that they want the small last frame to be pa...
Definition: internal.h:60
AVCodecContext::get_encode_buffer
int(* get_encode_buffer)(struct AVCodecContext *s, AVPacket *pkt, int flags)
This callback is called at the beginning of each packet to get a data buffer for it.
Definition: avcodec.h:2019
encode_simple_receive_packet
static int encode_simple_receive_packet(AVCodecContext *avctx, AVPacket *avpkt)
Definition: encode.c:348
AVPixFmtDescriptor::comp
AVComponentDescriptor comp[4]
Parameters that describe how pixels are packed.
Definition: pixdesc.h:105
AVCodecContext::ticks_per_frame
attribute_deprecated int ticks_per_frame
For some codecs, the time base is closer to the field rate than the frame rate.
Definition: avcodec.h:576
AV_CODEC_CAP_DELAY
#define AV_CODEC_CAP_DELAY
Encoder or decoder requires flushing with NULL input at the end in order to give the complete and cor...
Definition: codec.h:76
FFCodec::cb_type
unsigned cb_type
This field determines the type of the codec (decoder/encoder) and also the exact callback cb implemen...
Definition: codec_internal.h:143
av_buffer_realloc
int av_buffer_realloc(AVBufferRef **pbuf, size_t size)
Reallocate a given buffer.
Definition: buffer.c:183
AVCodecInternal::buffer_frame
AVFrame * buffer_frame
Definition: internal.h:132
av_channel_layout_copy
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
Definition: channel_layout.c:439
AVCodecInternal::draining
int draining
checks API usage: after codec draining, flush is required to resume operation
Definition: internal.h:126
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:72
AVCodecContext::coded_width
int coded_width
Bitstream width / height, may be different from width/height e.g.
Definition: avcodec.h:633
AVCodecContext::codec_type
enum AVMediaType codec_type
Definition: avcodec.h:453
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
encode_preinit_audio
static int encode_preinit_audio(AVCodecContext *avctx)
Definition: encode.c:645
ff_encode_get_frame
int ff_encode_get_frame(AVCodecContext *avctx, AVFrame *frame)
Called by encoders to get the next frame for encoding.
Definition: encode.c:204
FFCodec::cb
union FFCodec::@65 cb
AVFrameSideData
Structure to hold side data for an AVFrame.
Definition: frame.h:250
AVPixFmtDescriptor
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:69
AVPacket
This structure stores compressed data.
Definition: packet.h:499
avcodec_default_get_encode_buffer
int avcodec_default_get_encode_buffer(AVCodecContext *avctx, AVPacket *avpkt, int flags)
The default callback for AVCodecContext.get_encode_buffer().
Definition: encode.c:83
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:34
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
AVCodecContext::width
int width
picture width / height.
Definition: avcodec.h:618
encode_generate_icc_profile
static int encode_generate_icc_profile(av_unused AVCodecContext *c, av_unused AVFrame *f)
Definition: encode.c:438
imgutils.h
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:482
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
ff_encode_add_cpb_side_data
AVCPBProperties * ff_encode_add_cpb_side_data(AVCodecContext *avctx)
Add a CPB properties side data to an encoding context.
Definition: encode.c:856
AVCodecContext::sw_pix_fmt
enum AVPixelFormat sw_pix_fmt
Nominal unaccelerated pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:664
AV_CODEC_CAP_SMALL_LAST_FRAME
#define AV_CODEC_CAP_SMALL_LAST_FRAME
Codec can be fed a final frame with a smaller size.
Definition: codec.h:81
codec_desc.h
ff_alloc_packet
int ff_alloc_packet(AVCodecContext *avctx, AVPacket *avpkt, int64_t size)
Check AVPacket size and allocate data.
Definition: encode.c:61
AVSubtitle::start_display_time
uint32_t start_display_time
Definition: avcodec.h:2229
av_get_pix_fmt_name
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
Definition: pixdesc.c:2882
av_cpb_properties_alloc
AVCPBProperties * av_cpb_properties_alloc(size_t *size)
Allocate a CPB properties structure and initialize its fields to default values.
Definition: utils.c:978
AV_CODEC_FLAG_PASS1
#define AV_CODEC_FLAG_PASS1
Use internal 2pass ratecontrol in first pass mode.
Definition: avcodec.h:310