FFmpeg
decode.c
Go to the documentation of this file.
1 /*
2  * generic decoding-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 <stdint.h>
22 #include <string.h>
23 
24 #include "config.h"
25 
26 #if CONFIG_ICONV
27 # include <iconv.h>
28 #endif
29 
30 #include "libavutil/avassert.h"
31 #include "libavutil/avstring.h"
32 #include "libavutil/bprint.h"
34 #include "libavutil/common.h"
35 #include "libavutil/fifo.h"
36 #include "libavutil/frame.h"
37 #include "libavutil/hwcontext.h"
38 #include "libavutil/imgutils.h"
39 #include "libavutil/internal.h"
40 #include "libavutil/intmath.h"
41 #include "libavutil/opt.h"
42 
43 #include "avcodec.h"
44 #include "bytestream.h"
45 #include "bsf.h"
46 #include "codec_internal.h"
47 #include "decode.h"
48 #include "hwconfig.h"
49 #include "internal.h"
50 #include "thread.h"
51 
52 static int apply_param_change(AVCodecContext *avctx, const AVPacket *avpkt)
53 {
54  int ret;
55  size_t size;
56  const uint8_t *data;
57  uint32_t flags;
58  int64_t val;
59 
61  if (!data)
62  return 0;
63 
64  if (!(avctx->codec->capabilities & AV_CODEC_CAP_PARAM_CHANGE)) {
65  av_log(avctx, AV_LOG_ERROR, "This decoder does not support parameter "
66  "changes, but PARAM_CHANGE side data was sent to it.\n");
67  ret = AVERROR(EINVAL);
68  goto fail2;
69  }
70 
71  if (size < 4)
72  goto fail;
73 
74  flags = bytestream_get_le32(&data);
75  size -= 4;
76 
77 #if FF_API_OLD_CHANNEL_LAYOUT
79  if (flags & AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_COUNT) {
80  if (size < 4)
81  goto fail;
82  val = bytestream_get_le32(&data);
83  if (val <= 0 || val > INT_MAX) {
84  av_log(avctx, AV_LOG_ERROR, "Invalid channel count");
86  goto fail2;
87  }
88  avctx->channels = val;
89  size -= 4;
90  }
91  if (flags & AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_LAYOUT) {
92  if (size < 8)
93  goto fail;
94  avctx->channel_layout = bytestream_get_le64(&data);
95  size -= 8;
96  }
98 #endif
100  if (size < 4)
101  goto fail;
102  val = bytestream_get_le32(&data);
103  if (val <= 0 || val > INT_MAX) {
104  av_log(avctx, AV_LOG_ERROR, "Invalid sample rate");
106  goto fail2;
107  }
108  avctx->sample_rate = val;
109  size -= 4;
110  }
112  if (size < 8)
113  goto fail;
114  avctx->width = bytestream_get_le32(&data);
115  avctx->height = bytestream_get_le32(&data);
116  size -= 8;
117  ret = ff_set_dimensions(avctx, avctx->width, avctx->height);
118  if (ret < 0)
119  goto fail2;
120  }
121 
122  return 0;
123 fail:
124  av_log(avctx, AV_LOG_ERROR, "PARAM_CHANGE side data too small.\n");
126 fail2:
127  if (ret < 0) {
128  av_log(avctx, AV_LOG_ERROR, "Error applying parameter changes.\n");
129  if (avctx->err_recognition & AV_EF_EXPLODE)
130  return ret;
131  }
132  return 0;
133 }
134 
136 {
137  int ret = 0;
138 
140  if (pkt) {
142  if (!ret)
143  avci->last_pkt_props->opaque = (void *)(intptr_t)pkt->size; // Needed for ff_decode_frame_props().
144  }
145  return ret;
146 }
147 
149 {
150  AVCodecInternal *avci = avctx->internal;
151  const FFCodec *const codec = ffcodec(avctx->codec);
152  int ret;
153 
154  if (avci->bsf)
155  return 0;
156 
157  ret = av_bsf_list_parse_str(codec->bsfs, &avci->bsf);
158  if (ret < 0) {
159  av_log(avctx, AV_LOG_ERROR, "Error parsing decoder bitstream filters '%s': %s\n", codec->bsfs, av_err2str(ret));
160  if (ret != AVERROR(ENOMEM))
161  ret = AVERROR_BUG;
162  goto fail;
163  }
164 
165  /* We do not currently have an API for passing the input timebase into decoders,
166  * but no filters used here should actually need it.
167  * So we make up some plausible-looking number (the MPEG 90kHz timebase) */
168  avci->bsf->time_base_in = (AVRational){ 1, 90000 };
170  if (ret < 0)
171  goto fail;
172 
173  ret = av_bsf_init(avci->bsf);
174  if (ret < 0)
175  goto fail;
176 
177  return 0;
178 fail:
179  av_bsf_free(&avci->bsf);
180  return ret;
181 }
182 
184 {
185  AVCodecInternal *avci = avctx->internal;
186  int ret;
187 
188  if (avci->draining)
189  return AVERROR_EOF;
190 
191  ret = av_bsf_receive_packet(avci->bsf, pkt);
192  if (ret == AVERROR_EOF)
193  avci->draining = 1;
194  if (ret < 0)
195  return ret;
196 
199  if (ret < 0)
200  goto finish;
201  }
202 
203  ret = apply_param_change(avctx, pkt);
204  if (ret < 0)
205  goto finish;
206 
207  return 0;
208 finish:
210  return ret;
211 }
212 
213 /**
214  * Attempt to guess proper monotonic timestamps for decoded video frames
215  * which might have incorrect times. Input timestamps may wrap around, in
216  * which case the output will as well.
217  *
218  * @param pts the pts field of the decoded AVPacket, as passed through
219  * AVFrame.pts
220  * @param dts the dts field of the decoded AVPacket
221  * @return one of the input values, may be AV_NOPTS_VALUE
222  */
224  int64_t reordered_pts, int64_t dts)
225 {
226  int64_t pts = AV_NOPTS_VALUE;
227 
228  if (dts != AV_NOPTS_VALUE) {
229  ctx->pts_correction_num_faulty_dts += dts <= ctx->pts_correction_last_dts;
230  ctx->pts_correction_last_dts = dts;
231  } else if (reordered_pts != AV_NOPTS_VALUE)
232  ctx->pts_correction_last_dts = reordered_pts;
233 
234  if (reordered_pts != AV_NOPTS_VALUE) {
235  ctx->pts_correction_num_faulty_pts += reordered_pts <= ctx->pts_correction_last_pts;
236  ctx->pts_correction_last_pts = reordered_pts;
237  } else if(dts != AV_NOPTS_VALUE)
238  ctx->pts_correction_last_pts = dts;
239 
240  if ((ctx->pts_correction_num_faulty_pts<=ctx->pts_correction_num_faulty_dts || dts == AV_NOPTS_VALUE)
241  && reordered_pts != AV_NOPTS_VALUE)
242  pts = reordered_pts;
243  else
244  pts = dts;
245 
246  return pts;
247 }
248 
249 /*
250  * The core of the receive_frame_wrapper for the decoders implementing
251  * the simple API. Certain decoders might consume partial packets without
252  * returning any output, so this function needs to be called in a loop until it
253  * returns EAGAIN.
254  **/
255 static inline int decode_simple_internal(AVCodecContext *avctx, AVFrame *frame, int64_t *discarded_samples)
256 {
257  AVCodecInternal *avci = avctx->internal;
258  AVPacket *const pkt = avci->in_pkt;
259  const FFCodec *const codec = ffcodec(avctx->codec);
260  int got_frame, actual_got_frame;
261  int ret;
262 
263  if (!pkt->data && !avci->draining) {
265  ret = ff_decode_get_packet(avctx, pkt);
266  if (ret < 0 && ret != AVERROR_EOF)
267  return ret;
268  }
269 
270  // Some codecs (at least wma lossless) will crash when feeding drain packets
271  // after EOF was signaled.
272  if (avci->draining_done)
273  return AVERROR_EOF;
274 
275  if (!pkt->data &&
276  !(avctx->codec->capabilities & AV_CODEC_CAP_DELAY ||
278  return AVERROR_EOF;
279 
280  got_frame = 0;
281 
282  if (HAVE_THREADS && avctx->active_thread_type & FF_THREAD_FRAME) {
283  ret = ff_thread_decode_frame(avctx, frame, &got_frame, pkt);
284  } else {
285  ret = codec->cb.decode(avctx, frame, &got_frame, pkt);
286 
288  frame->pkt_dts = pkt->dts;
289  if (avctx->codec->type == AVMEDIA_TYPE_VIDEO) {
290  if(!avctx->has_b_frames)
291  frame->pkt_pos = pkt->pos;
292  //FIXME these should be under if(!avctx->has_b_frames)
293  /* get_buffer is supposed to set frame parameters */
294  if (!(avctx->codec->capabilities & AV_CODEC_CAP_DR1)) {
295  if (!frame->sample_aspect_ratio.num) frame->sample_aspect_ratio = avctx->sample_aspect_ratio;
296  if (!frame->width) frame->width = avctx->width;
297  if (!frame->height) frame->height = avctx->height;
298  if (frame->format == AV_PIX_FMT_NONE) frame->format = avctx->pix_fmt;
299  }
300  }
301  }
302  emms_c();
303  actual_got_frame = got_frame;
304 
305  if (avctx->codec->type == AVMEDIA_TYPE_VIDEO) {
306  if (frame->flags & AV_FRAME_FLAG_DISCARD)
307  got_frame = 0;
308  } else if (avctx->codec->type == AVMEDIA_TYPE_AUDIO) {
309  uint8_t *side;
310  size_t side_size;
311  uint32_t discard_padding = 0;
312  uint8_t skip_reason = 0;
313  uint8_t discard_reason = 0;
314 
315  if (ret >= 0 && got_frame) {
316  if (frame->format == AV_SAMPLE_FMT_NONE)
317  frame->format = avctx->sample_fmt;
318  if (!frame->ch_layout.nb_channels) {
319  int ret2 = av_channel_layout_copy(&frame->ch_layout, &avctx->ch_layout);
320  if (ret2 < 0) {
321  ret = ret2;
322  got_frame = 0;
323  }
324  }
325 #if FF_API_OLD_CHANNEL_LAYOUT
327  if (!frame->channel_layout)
328  frame->channel_layout = avctx->ch_layout.order == AV_CHANNEL_ORDER_NATIVE ?
329  avctx->ch_layout.u.mask : 0;
330  if (!frame->channels)
331  frame->channels = avctx->ch_layout.nb_channels;
333 #endif
334  if (!frame->sample_rate)
335  frame->sample_rate = avctx->sample_rate;
336  }
337 
339  if(side && side_size>=10) {
340  avci->skip_samples = AV_RL32(side);
341  avci->skip_samples = FFMAX(0, avci->skip_samples);
342  discard_padding = AV_RL32(side + 4);
343  av_log(avctx, AV_LOG_DEBUG, "skip %d / discard %d samples due to side data\n",
344  avci->skip_samples, (int)discard_padding);
345  skip_reason = AV_RL8(side + 8);
346  discard_reason = AV_RL8(side + 9);
347  }
348 
349  if ((frame->flags & AV_FRAME_FLAG_DISCARD) && got_frame &&
350  !(avctx->flags2 & AV_CODEC_FLAG2_SKIP_MANUAL)) {
351  avci->skip_samples = FFMAX(0, avci->skip_samples - frame->nb_samples);
352  got_frame = 0;
353  *discarded_samples += frame->nb_samples;
354  }
355 
356  if (avci->skip_samples > 0 && got_frame &&
357  !(avctx->flags2 & AV_CODEC_FLAG2_SKIP_MANUAL)) {
358  if(frame->nb_samples <= avci->skip_samples){
359  got_frame = 0;
360  *discarded_samples += frame->nb_samples;
361  avci->skip_samples -= frame->nb_samples;
362  av_log(avctx, AV_LOG_DEBUG, "skip whole frame, skip left: %d\n",
363  avci->skip_samples);
364  } else {
365  av_samples_copy(frame->extended_data, frame->extended_data, 0, avci->skip_samples,
366  frame->nb_samples - avci->skip_samples, avctx->ch_layout.nb_channels, frame->format);
367  if(avctx->pkt_timebase.num && avctx->sample_rate) {
368  int64_t diff_ts = av_rescale_q(avci->skip_samples,
369  (AVRational){1, avctx->sample_rate},
370  avctx->pkt_timebase);
371  if(frame->pts!=AV_NOPTS_VALUE)
372  frame->pts += diff_ts;
373  if(frame->pkt_dts!=AV_NOPTS_VALUE)
374  frame->pkt_dts += diff_ts;
375  if (frame->duration >= diff_ts)
376  frame->duration -= diff_ts;
377  } else {
378  av_log(avctx, AV_LOG_WARNING, "Could not update timestamps for skipped samples.\n");
379  }
380  av_log(avctx, AV_LOG_DEBUG, "skip %d/%d samples\n",
381  avci->skip_samples, frame->nb_samples);
382  *discarded_samples += avci->skip_samples;
383  frame->nb_samples -= avci->skip_samples;
384  avci->skip_samples = 0;
385  }
386  }
387 
388  if (discard_padding > 0 && discard_padding <= frame->nb_samples && got_frame &&
389  !(avctx->flags2 & AV_CODEC_FLAG2_SKIP_MANUAL)) {
390  if (discard_padding == frame->nb_samples) {
391  *discarded_samples += frame->nb_samples;
392  got_frame = 0;
393  } else {
394  if(avctx->pkt_timebase.num && avctx->sample_rate) {
395  int64_t diff_ts = av_rescale_q(frame->nb_samples - discard_padding,
396  (AVRational){1, avctx->sample_rate},
397  avctx->pkt_timebase);
398  frame->duration = diff_ts;
399  } else {
400  av_log(avctx, AV_LOG_WARNING, "Could not update timestamps for discarded samples.\n");
401  }
402  av_log(avctx, AV_LOG_DEBUG, "discard %d/%d samples\n",
403  (int)discard_padding, frame->nb_samples);
404  frame->nb_samples -= discard_padding;
405  }
406  }
407 
408  if ((avctx->flags2 & AV_CODEC_FLAG2_SKIP_MANUAL) && got_frame) {
410  if (fside) {
411  AV_WL32(fside->data, avci->skip_samples);
412  AV_WL32(fside->data + 4, discard_padding);
413  AV_WL8(fside->data + 8, skip_reason);
414  AV_WL8(fside->data + 9, discard_reason);
415  avci->skip_samples = 0;
416  }
417  }
418  }
419 
420  if (avctx->codec->type == AVMEDIA_TYPE_AUDIO &&
422  ret >= 0 && ret != pkt->size && !(avctx->codec->capabilities & AV_CODEC_CAP_SUBFRAMES)) {
423  av_log(avctx, AV_LOG_WARNING, "Multiple frames in a packet.\n");
424  avci->showed_multi_packet_warning = 1;
425  }
426 
427  if (!got_frame)
429 
430 #if FF_API_FLAG_TRUNCATED
431  if (ret >= 0 && avctx->codec->type == AVMEDIA_TYPE_VIDEO && !(avctx->flags & AV_CODEC_FLAG_TRUNCATED))
432 #else
433  if (ret >= 0 && avctx->codec->type == AVMEDIA_TYPE_VIDEO)
434 #endif
435  ret = pkt->size;
436 
437 #if FF_API_AVCTX_TIMEBASE
438  if (avctx->framerate.num > 0 && avctx->framerate.den > 0)
439  avctx->time_base = av_inv_q(av_mul_q(avctx->framerate, (AVRational){avctx->ticks_per_frame, 1}));
440 #endif
441 
442  /* do not stop draining when actual_got_frame != 0 or ret < 0 */
443  /* got_frame == 0 but actual_got_frame != 0 when frame is discarded */
444  if (avci->draining && !actual_got_frame) {
445  if (ret < 0) {
446  /* prevent infinite loop if a decoder wrongly always return error on draining */
447  /* reasonable nb_errors_max = maximum b frames + thread count */
448  int nb_errors_max = 20 + (HAVE_THREADS && avctx->active_thread_type & FF_THREAD_FRAME ?
449  avctx->thread_count : 1);
450 
451  if (avci->nb_draining_errors++ >= nb_errors_max) {
452  av_log(avctx, AV_LOG_ERROR, "Too many errors when draining, this is a bug. "
453  "Stop draining and force EOF.\n");
454  avci->draining_done = 1;
455  ret = AVERROR_BUG;
456  }
457  } else {
458  avci->draining_done = 1;
459  }
460  }
461 
462  if (ret >= pkt->size || ret < 0) {
464  } else {
465  int consumed = ret;
466 
467  pkt->data += consumed;
468  pkt->size -= consumed;
472  // See extract_packet_props() comment.
473  avci->last_pkt_props->opaque = (void *)((intptr_t)avci->last_pkt_props->opaque - consumed);
476  }
477  }
478 
479  if (got_frame)
480  av_assert0(frame->buf[0]);
481 
482  return ret < 0 ? ret : 0;
483 }
484 
485 #if CONFIG_LCMS2
486 static int detect_colorspace(AVCodecContext *avctx, AVFrame *frame)
487 {
488  AVCodecInternal *avci = avctx->internal;
490  AVColorPrimariesDesc coeffs;
491  enum AVColorPrimaries prim;
492  cmsHPROFILE profile;
493  AVFrameSideData *sd;
494  int ret;
495  if (!(avctx->flags2 & AV_CODEC_FLAG2_ICC_PROFILES))
496  return 0;
497 
499  if (!sd || !sd->size)
500  return 0;
501 
502  if (!avci->icc.avctx) {
503  ret = ff_icc_context_init(&avci->icc, avctx);
504  if (ret < 0)
505  return ret;
506  }
507 
508  profile = cmsOpenProfileFromMemTHR(avci->icc.ctx, sd->data, sd->size);
509  if (!profile)
510  return AVERROR_INVALIDDATA;
511 
512  ret = ff_icc_profile_read_primaries(&avci->icc, profile, &coeffs);
513  if (!ret)
514  ret = ff_icc_profile_detect_transfer(&avci->icc, profile, &trc);
515  cmsCloseProfile(profile);
516  if (ret < 0)
517  return ret;
518 
519  prim = av_csp_primaries_id_from_desc(&coeffs);
520  if (prim != AVCOL_PRI_UNSPECIFIED)
521  frame->color_primaries = prim;
522  if (trc != AVCOL_TRC_UNSPECIFIED)
523  frame->color_trc = trc;
524  return 0;
525 }
526 #else /* !CONFIG_LCMS2 */
528 {
529  return 0;
530 }
531 #endif
532 
534 {
535  int ret;
536  int64_t discarded_samples = 0;
537 
538  while (!frame->buf[0]) {
539  if (discarded_samples > avctx->max_samples)
540  return AVERROR(EAGAIN);
541  ret = decode_simple_internal(avctx, frame, &discarded_samples);
542  if (ret < 0)
543  return ret;
544  }
545 
546  return 0;
547 }
548 
550 {
551  AVCodecInternal *avci = avctx->internal;
552  const FFCodec *const codec = ffcodec(avctx->codec);
553  int ret, ok;
554 
555  av_assert0(!frame->buf[0]);
556 
557  if (codec->cb_type == FF_CODEC_CB_TYPE_RECEIVE_FRAME) {
558  ret = codec->cb.receive_frame(avctx, frame);
559  } else
561 
562  if (ret == AVERROR_EOF)
563  avci->draining_done = 1;
564 
565  /* preserve ret */
566  ok = detect_colorspace(avctx, frame);
567  if (ok < 0) {
569  return ok;
570  }
571 
572  if (!ret) {
573  frame->best_effort_timestamp = guess_correct_pts(avctx,
574  frame->pts,
575  frame->pkt_dts);
576 
577 #if FF_API_PKT_DURATION
579  frame->pkt_duration = frame->duration;
581 #endif
582 
583  /* the only case where decode data is not set should be decoders
584  * that do not call ff_get_buffer() */
585  av_assert0((frame->private_ref && frame->private_ref->size == sizeof(FrameDecodeData)) ||
586  !(avctx->codec->capabilities & AV_CODEC_CAP_DR1));
587 
588  if (frame->private_ref) {
589  FrameDecodeData *fdd = (FrameDecodeData*)frame->private_ref->data;
590 
591  if (fdd->post_process) {
592  ret = fdd->post_process(avctx, frame);
593  if (ret < 0) {
595  return ret;
596  }
597  }
598  }
599  }
600 
601  /* free the per-frame decode data */
602  av_buffer_unref(&frame->private_ref);
603 
604  return ret;
605 }
606 
607 int attribute_align_arg avcodec_send_packet(AVCodecContext *avctx, const AVPacket *avpkt)
608 {
609  AVCodecInternal *avci = avctx->internal;
610  int ret;
611 
612  if (!avcodec_is_open(avctx) || !av_codec_is_decoder(avctx->codec))
613  return AVERROR(EINVAL);
614 
615  if (avctx->internal->draining)
616  return AVERROR_EOF;
617 
618  if (avpkt && !avpkt->size && avpkt->data)
619  return AVERROR(EINVAL);
620 
622  if (avpkt && (avpkt->data || avpkt->side_data_elems)) {
623  ret = av_packet_ref(avci->buffer_pkt, avpkt);
624  if (ret < 0)
625  return ret;
626  }
627 
628  ret = av_bsf_send_packet(avci->bsf, avci->buffer_pkt);
629  if (ret < 0) {
631  return ret;
632  }
633 
634  if (!avci->buffer_frame->buf[0]) {
636  if (ret < 0 && ret != AVERROR(EAGAIN) && ret != AVERROR_EOF)
637  return ret;
638  }
639 
640  return 0;
641 }
642 
644 {
645  /* make sure we are noisy about decoders returning invalid cropping data */
646  if (frame->crop_left >= INT_MAX - frame->crop_right ||
647  frame->crop_top >= INT_MAX - frame->crop_bottom ||
648  (frame->crop_left + frame->crop_right) >= frame->width ||
649  (frame->crop_top + frame->crop_bottom) >= frame->height) {
650  av_log(avctx, AV_LOG_WARNING,
651  "Invalid cropping information set by a decoder: "
653  "(frame size %dx%d). This is a bug, please report it\n",
654  frame->crop_left, frame->crop_right, frame->crop_top, frame->crop_bottom,
655  frame->width, frame->height);
656  frame->crop_left = 0;
657  frame->crop_right = 0;
658  frame->crop_top = 0;
659  frame->crop_bottom = 0;
660  return 0;
661  }
662 
663  if (!avctx->apply_cropping)
664  return 0;
665 
668 }
669 
671 {
672  AVCodecInternal *avci = avctx->internal;
673  int ret, changed;
674 
675  if (!avcodec_is_open(avctx) || !av_codec_is_decoder(avctx->codec))
676  return AVERROR(EINVAL);
677 
678  if (avci->buffer_frame->buf[0]) {
680  } else {
682  if (ret < 0)
683  return ret;
684  }
685 
686  if (avctx->codec_type == AVMEDIA_TYPE_VIDEO) {
687  ret = apply_cropping(avctx, frame);
688  if (ret < 0) {
690  return ret;
691  }
692  }
693 
694  avctx->frame_number++;
695 
696  if (avctx->flags & AV_CODEC_FLAG_DROPCHANGED) {
697 
698  if (avctx->frame_number == 1) {
699  avci->initial_format = frame->format;
700  switch(avctx->codec_type) {
701  case AVMEDIA_TYPE_VIDEO:
702  avci->initial_width = frame->width;
703  avci->initial_height = frame->height;
704  break;
705  case AVMEDIA_TYPE_AUDIO:
706  avci->initial_sample_rate = frame->sample_rate ? frame->sample_rate :
707  avctx->sample_rate;
708  ret = av_channel_layout_copy(&avci->initial_ch_layout, &frame->ch_layout);
709  if (ret < 0) {
711  return ret;
712  }
713  break;
714  }
715  }
716 
717  if (avctx->frame_number > 1) {
718  changed = avci->initial_format != frame->format;
719 
720  switch(avctx->codec_type) {
721  case AVMEDIA_TYPE_VIDEO:
722  changed |= avci->initial_width != frame->width ||
723  avci->initial_height != frame->height;
724  break;
725  case AVMEDIA_TYPE_AUDIO:
726  changed |= avci->initial_sample_rate != frame->sample_rate ||
727  avci->initial_sample_rate != avctx->sample_rate ||
729  break;
730  }
731 
732  if (changed) {
733  avci->changed_frames_dropped++;
734  av_log(avctx, AV_LOG_INFO, "dropped changed frame #%d pts %"PRId64
735  " drop count: %d \n",
736  avctx->frame_number, frame->pts,
737  avci->changed_frames_dropped);
739  return AVERROR_INPUT_CHANGED;
740  }
741  }
742  }
743  return 0;
744 }
745 
747 {
748  memset(sub, 0, sizeof(*sub));
749  sub->pts = AV_NOPTS_VALUE;
750 }
751 
752 #define UTF8_MAX_BYTES 4 /* 5 and 6 bytes sequences should not be used */
753 static int recode_subtitle(AVCodecContext *avctx, AVPacket **outpkt,
754  AVPacket *inpkt, AVPacket *buf_pkt)
755 {
756 #if CONFIG_ICONV
757  iconv_t cd = (iconv_t)-1;
758  int ret = 0;
759  char *inb, *outb;
760  size_t inl, outl;
761 #endif
762 
763  if (avctx->sub_charenc_mode != FF_SUB_CHARENC_MODE_PRE_DECODER || inpkt->size == 0) {
764  *outpkt = inpkt;
765  return 0;
766  }
767 
768 #if CONFIG_ICONV
769  inb = inpkt->data;
770  inl = inpkt->size;
771 
772  if (inl >= INT_MAX / UTF8_MAX_BYTES - AV_INPUT_BUFFER_PADDING_SIZE) {
773  av_log(avctx, AV_LOG_ERROR, "Subtitles packet is too big for recoding\n");
774  return AVERROR(ERANGE);
775  }
776 
777  cd = iconv_open("UTF-8", avctx->sub_charenc);
778  av_assert0(cd != (iconv_t)-1);
779 
780  ret = av_new_packet(buf_pkt, inl * UTF8_MAX_BYTES);
781  if (ret < 0)
782  goto end;
783  ret = av_packet_copy_props(buf_pkt, inpkt);
784  if (ret < 0)
785  goto end;
786  outb = buf_pkt->data;
787  outl = buf_pkt->size;
788 
789  if (iconv(cd, &inb, &inl, &outb, &outl) == (size_t)-1 ||
790  iconv(cd, NULL, NULL, &outb, &outl) == (size_t)-1 ||
791  outl >= buf_pkt->size || inl != 0) {
792  ret = FFMIN(AVERROR(errno), -1);
793  av_log(avctx, AV_LOG_ERROR, "Unable to recode subtitle event \"%s\" "
794  "from %s to UTF-8\n", inpkt->data, avctx->sub_charenc);
795  goto end;
796  }
797  buf_pkt->size -= outl;
798  memset(buf_pkt->data + buf_pkt->size, 0, outl);
799  *outpkt = buf_pkt;
800 
801  ret = 0;
802 end:
803  if (ret < 0)
804  av_packet_unref(buf_pkt);
805  if (cd != (iconv_t)-1)
806  iconv_close(cd);
807  return ret;
808 #else
809  av_log(avctx, AV_LOG_ERROR, "requesting subtitles recoding without iconv");
810  return AVERROR(EINVAL);
811 #endif
812 }
813 
814 static int utf8_check(const uint8_t *str)
815 {
816  const uint8_t *byte;
817  uint32_t codepoint, min;
818 
819  while (*str) {
820  byte = str;
821  GET_UTF8(codepoint, *(byte++), return 0;);
822  min = byte - str == 1 ? 0 : byte - str == 2 ? 0x80 :
823  1 << (5 * (byte - str) - 4);
824  if (codepoint < min || codepoint >= 0x110000 ||
825  codepoint == 0xFFFE /* BOM */ ||
826  codepoint >= 0xD800 && codepoint <= 0xDFFF /* surrogates */)
827  return 0;
828  str = byte;
829  }
830  return 1;
831 }
832 
834  int *got_sub_ptr,
835  AVPacket *avpkt)
836 {
837  int ret = 0;
838 
839  if (!avpkt->data && avpkt->size) {
840  av_log(avctx, AV_LOG_ERROR, "invalid packet: NULL data, size != 0\n");
841  return AVERROR(EINVAL);
842  }
843  if (!avctx->codec)
844  return AVERROR(EINVAL);
845  if (avctx->codec->type != AVMEDIA_TYPE_SUBTITLE) {
846  av_log(avctx, AV_LOG_ERROR, "Invalid media type for subtitles\n");
847  return AVERROR(EINVAL);
848  }
849 
850  *got_sub_ptr = 0;
852 
853  if ((avctx->codec->capabilities & AV_CODEC_CAP_DELAY) || avpkt->size) {
854  AVCodecInternal *avci = avctx->internal;
855  AVPacket *pkt;
856 
857  ret = recode_subtitle(avctx, &pkt, avpkt, avci->buffer_pkt);
858  if (ret < 0)
859  return ret;
860 
861  if (avctx->pkt_timebase.num && avpkt->pts != AV_NOPTS_VALUE)
862  sub->pts = av_rescale_q(avpkt->pts,
863  avctx->pkt_timebase, AV_TIME_BASE_Q);
864  ret = ffcodec(avctx->codec)->cb.decode_sub(avctx, sub, got_sub_ptr, pkt);
865  if (pkt == avci->buffer_pkt) // did we recode?
867  if (ret < 0) {
868  *got_sub_ptr = 0;
870  return ret;
871  }
872  av_assert1(!sub->num_rects || *got_sub_ptr);
873 
874  if (sub->num_rects && !sub->end_display_time && avpkt->duration &&
875  avctx->pkt_timebase.num) {
876  AVRational ms = { 1, 1000 };
877  sub->end_display_time = av_rescale_q(avpkt->duration,
878  avctx->pkt_timebase, ms);
879  }
880 
882  sub->format = 0;
883  else if (avctx->codec_descriptor->props & AV_CODEC_PROP_TEXT_SUB)
884  sub->format = 1;
885 
886  for (unsigned i = 0; i < sub->num_rects; i++) {
888  sub->rects[i]->ass && !utf8_check(sub->rects[i]->ass)) {
889  av_log(avctx, AV_LOG_ERROR,
890  "Invalid UTF-8 in decoded subtitles text; "
891  "maybe missing -sub_charenc option\n");
893  *got_sub_ptr = 0;
894  return AVERROR_INVALIDDATA;
895  }
896  }
897 
898  if (*got_sub_ptr)
899  avctx->frame_number++;
900  }
901 
902  return ret;
903 }
904 
906  const enum AVPixelFormat *fmt)
907 {
908  const AVPixFmtDescriptor *desc;
909  const AVCodecHWConfig *config;
910  int i, n;
911 
912  // If a device was supplied when the codec was opened, assume that the
913  // user wants to use it.
914  if (avctx->hw_device_ctx && ffcodec(avctx->codec)->hw_configs) {
915  AVHWDeviceContext *device_ctx =
917  for (i = 0;; i++) {
918  config = &ffcodec(avctx->codec)->hw_configs[i]->public;
919  if (!config)
920  break;
921  if (!(config->methods &
923  continue;
924  if (device_ctx->type != config->device_type)
925  continue;
926  for (n = 0; fmt[n] != AV_PIX_FMT_NONE; n++) {
927  if (config->pix_fmt == fmt[n])
928  return fmt[n];
929  }
930  }
931  }
932  // No device or other setup, so we have to choose from things which
933  // don't any other external information.
934 
935  // If the last element of the list is a software format, choose it
936  // (this should be best software format if any exist).
937  for (n = 0; fmt[n] != AV_PIX_FMT_NONE; n++);
938  desc = av_pix_fmt_desc_get(fmt[n - 1]);
939  if (!(desc->flags & AV_PIX_FMT_FLAG_HWACCEL))
940  return fmt[n - 1];
941 
942  // Finally, traverse the list in order and choose the first entry
943  // with no external dependencies (if there is no hardware configuration
944  // information available then this just picks the first entry).
945  for (n = 0; fmt[n] != AV_PIX_FMT_NONE; n++) {
946  for (i = 0;; i++) {
947  config = avcodec_get_hw_config(avctx->codec, i);
948  if (!config)
949  break;
950  if (config->pix_fmt == fmt[n])
951  break;
952  }
953  if (!config) {
954  // No specific config available, so the decoder must be able
955  // to handle this format without any additional setup.
956  return fmt[n];
957  }
959  // Usable with only internal setup.
960  return fmt[n];
961  }
962  }
963 
964  // Nothing is usable, give up.
965  return AV_PIX_FMT_NONE;
966 }
967 
969  enum AVHWDeviceType dev_type)
970 {
971  AVHWDeviceContext *device_ctx;
972  AVHWFramesContext *frames_ctx;
973  int ret;
974 
975  if (!avctx->hwaccel)
976  return AVERROR(ENOSYS);
977 
978  if (avctx->hw_frames_ctx)
979  return 0;
980  if (!avctx->hw_device_ctx) {
981  av_log(avctx, AV_LOG_ERROR, "A hardware frames or device context is "
982  "required for hardware accelerated decoding.\n");
983  return AVERROR(EINVAL);
984  }
985 
986  device_ctx = (AVHWDeviceContext *)avctx->hw_device_ctx->data;
987  if (device_ctx->type != dev_type) {
988  av_log(avctx, AV_LOG_ERROR, "Device type %s expected for hardware "
989  "decoding, but got %s.\n", av_hwdevice_get_type_name(dev_type),
990  av_hwdevice_get_type_name(device_ctx->type));
991  return AVERROR(EINVAL);
992  }
993 
995  avctx->hw_device_ctx,
996  avctx->hwaccel->pix_fmt,
997  &avctx->hw_frames_ctx);
998  if (ret < 0)
999  return ret;
1000 
1001  frames_ctx = (AVHWFramesContext*)avctx->hw_frames_ctx->data;
1002 
1003 
1004  if (frames_ctx->initial_pool_size) {
1005  // We guarantee 4 base work surfaces. The function above guarantees 1
1006  // (the absolute minimum), so add the missing count.
1007  frames_ctx->initial_pool_size += 3;
1008  }
1009 
1011  if (ret < 0) {
1012  av_buffer_unref(&avctx->hw_frames_ctx);
1013  return ret;
1014  }
1015 
1016  return 0;
1017 }
1018 
1020  AVBufferRef *device_ref,
1022  AVBufferRef **out_frames_ref)
1023 {
1024  AVBufferRef *frames_ref = NULL;
1025  const AVCodecHWConfigInternal *hw_config;
1026  const AVHWAccel *hwa;
1027  int i, ret;
1028 
1029  for (i = 0;; i++) {
1030  hw_config = ffcodec(avctx->codec)->hw_configs[i];
1031  if (!hw_config)
1032  return AVERROR(ENOENT);
1033  if (hw_config->public.pix_fmt == hw_pix_fmt)
1034  break;
1035  }
1036 
1037  hwa = hw_config->hwaccel;
1038  if (!hwa || !hwa->frame_params)
1039  return AVERROR(ENOENT);
1040 
1041  frames_ref = av_hwframe_ctx_alloc(device_ref);
1042  if (!frames_ref)
1043  return AVERROR(ENOMEM);
1044 
1045  ret = hwa->frame_params(avctx, frames_ref);
1046  if (ret >= 0) {
1047  AVHWFramesContext *frames_ctx = (AVHWFramesContext*)frames_ref->data;
1048 
1049  if (frames_ctx->initial_pool_size) {
1050  // If the user has requested that extra output surfaces be
1051  // available then add them here.
1052  if (avctx->extra_hw_frames > 0)
1053  frames_ctx->initial_pool_size += avctx->extra_hw_frames;
1054 
1055  // If frame threading is enabled then an extra surface per thread
1056  // is also required.
1057  if (avctx->active_thread_type & FF_THREAD_FRAME)
1058  frames_ctx->initial_pool_size += avctx->thread_count;
1059  }
1060 
1061  *out_frames_ref = frames_ref;
1062  } else {
1063  av_buffer_unref(&frames_ref);
1064  }
1065  return ret;
1066 }
1067 
1068 static int hwaccel_init(AVCodecContext *avctx,
1069  const AVCodecHWConfigInternal *hw_config)
1070 {
1071  const AVHWAccel *hwaccel;
1072  int err;
1073 
1074  hwaccel = hw_config->hwaccel;
1077  av_log(avctx, AV_LOG_WARNING, "Ignoring experimental hwaccel: %s\n",
1078  hwaccel->name);
1079  return AVERROR_PATCHWELCOME;
1080  }
1081 
1082  if (hwaccel->priv_data_size) {
1083  avctx->internal->hwaccel_priv_data =
1084  av_mallocz(hwaccel->priv_data_size);
1085  if (!avctx->internal->hwaccel_priv_data)
1086  return AVERROR(ENOMEM);
1087  }
1088 
1089  avctx->hwaccel = hwaccel;
1090  if (hwaccel->init) {
1091  err = hwaccel->init(avctx);
1092  if (err < 0) {
1093  av_log(avctx, AV_LOG_ERROR, "Failed setup for format %s: "
1094  "hwaccel initialisation returned error.\n",
1095  av_get_pix_fmt_name(hw_config->public.pix_fmt));
1097  avctx->hwaccel = NULL;
1098  return err;
1099  }
1100  }
1101 
1102  return 0;
1103 }
1104 
1105 static void hwaccel_uninit(AVCodecContext *avctx)
1106 {
1107  if (avctx->hwaccel && avctx->hwaccel->uninit)
1108  avctx->hwaccel->uninit(avctx);
1109 
1111 
1112  avctx->hwaccel = NULL;
1113 
1114  av_buffer_unref(&avctx->hw_frames_ctx);
1115 }
1116 
1117 int ff_get_format(AVCodecContext *avctx, const enum AVPixelFormat *fmt)
1118 {
1119  const AVPixFmtDescriptor *desc;
1120  enum AVPixelFormat *choices;
1121  enum AVPixelFormat ret, user_choice;
1122  const AVCodecHWConfigInternal *hw_config;
1123  const AVCodecHWConfig *config;
1124  int i, n, err;
1125 
1126  // Find end of list.
1127  for (n = 0; fmt[n] != AV_PIX_FMT_NONE; n++);
1128  // Must contain at least one entry.
1129  av_assert0(n >= 1);
1130  // If a software format is available, it must be the last entry.
1131  desc = av_pix_fmt_desc_get(fmt[n - 1]);
1132  if (desc->flags & AV_PIX_FMT_FLAG_HWACCEL) {
1133  // No software format is available.
1134  } else {
1135  avctx->sw_pix_fmt = fmt[n - 1];
1136  }
1137 
1138  choices = av_memdup(fmt, (n + 1) * sizeof(*choices));
1139  if (!choices)
1140  return AV_PIX_FMT_NONE;
1141 
1142  for (;;) {
1143  // Remove the previous hwaccel, if there was one.
1144  hwaccel_uninit(avctx);
1145 
1146  user_choice = avctx->get_format(avctx, choices);
1147  if (user_choice == AV_PIX_FMT_NONE) {
1148  // Explicitly chose nothing, give up.
1149  ret = AV_PIX_FMT_NONE;
1150  break;
1151  }
1152 
1153  desc = av_pix_fmt_desc_get(user_choice);
1154  if (!desc) {
1155  av_log(avctx, AV_LOG_ERROR, "Invalid format returned by "
1156  "get_format() callback.\n");
1157  ret = AV_PIX_FMT_NONE;
1158  break;
1159  }
1160  av_log(avctx, AV_LOG_DEBUG, "Format %s chosen by get_format().\n",
1161  desc->name);
1162 
1163  for (i = 0; i < n; i++) {
1164  if (choices[i] == user_choice)
1165  break;
1166  }
1167  if (i == n) {
1168  av_log(avctx, AV_LOG_ERROR, "Invalid return from get_format(): "
1169  "%s not in possible list.\n", desc->name);
1170  ret = AV_PIX_FMT_NONE;
1171  break;
1172  }
1173 
1174  if (ffcodec(avctx->codec)->hw_configs) {
1175  for (i = 0;; i++) {
1176  hw_config = ffcodec(avctx->codec)->hw_configs[i];
1177  if (!hw_config)
1178  break;
1179  if (hw_config->public.pix_fmt == user_choice)
1180  break;
1181  }
1182  } else {
1183  hw_config = NULL;
1184  }
1185 
1186  if (!hw_config) {
1187  // No config available, so no extra setup required.
1188  ret = user_choice;
1189  break;
1190  }
1191  config = &hw_config->public;
1192 
1193  if (config->methods &
1195  avctx->hw_frames_ctx) {
1196  const AVHWFramesContext *frames_ctx =
1198  if (frames_ctx->format != user_choice) {
1199  av_log(avctx, AV_LOG_ERROR, "Invalid setup for format %s: "
1200  "does not match the format of the provided frames "
1201  "context.\n", desc->name);
1202  goto try_again;
1203  }
1204  } else if (config->methods &
1206  avctx->hw_device_ctx) {
1207  const AVHWDeviceContext *device_ctx =
1209  if (device_ctx->type != config->device_type) {
1210  av_log(avctx, AV_LOG_ERROR, "Invalid setup for format %s: "
1211  "does not match the type of the provided device "
1212  "context.\n", desc->name);
1213  goto try_again;
1214  }
1215  } else if (config->methods &
1217  // Internal-only setup, no additional configuration.
1218  } else if (config->methods &
1220  // Some ad-hoc configuration we can't see and can't check.
1221  } else {
1222  av_log(avctx, AV_LOG_ERROR, "Invalid setup for format %s: "
1223  "missing configuration.\n", desc->name);
1224  goto try_again;
1225  }
1226  if (hw_config->hwaccel) {
1227  av_log(avctx, AV_LOG_DEBUG, "Format %s requires hwaccel "
1228  "initialisation.\n", desc->name);
1229  err = hwaccel_init(avctx, hw_config);
1230  if (err < 0)
1231  goto try_again;
1232  }
1233  ret = user_choice;
1234  break;
1235 
1236  try_again:
1237  av_log(avctx, AV_LOG_DEBUG, "Format %s not usable, retrying "
1238  "get_format() without it.\n", desc->name);
1239  for (i = 0; i < n; i++) {
1240  if (choices[i] == user_choice)
1241  break;
1242  }
1243  for (; i + 1 < n; i++)
1244  choices[i] = choices[i + 1];
1245  --n;
1246  }
1247 
1248  av_freep(&choices);
1249  return ret;
1250 }
1251 
1253 {
1254  size_t size;
1255  const uint8_t *side_metadata;
1256 
1257  AVDictionary **frame_md = &frame->metadata;
1258 
1259  side_metadata = av_packet_get_side_data(avpkt,
1261  return av_packet_unpack_dictionary(side_metadata, size, frame_md);
1262 }
1263 
1265 {
1266  const AVPacket *pkt = avctx->internal->last_pkt_props;
1267  static const struct {
1268  enum AVPacketSideDataType packet;
1270  } sd[] = {
1282  };
1283 
1285  frame->pts = pkt->pts;
1286  frame->pkt_pos = pkt->pos;
1287  frame->duration = pkt->duration;
1288  frame->pkt_size = (int)(intptr_t)pkt->opaque;
1289 
1290  for (int i = 0; i < FF_ARRAY_ELEMS(sd); i++) {
1291  size_t size;
1292  uint8_t *packet_sd = av_packet_get_side_data(pkt, sd[i].packet, &size);
1293  if (packet_sd) {
1295  sd[i].frame,
1296  size);
1297  if (!frame_sd)
1298  return AVERROR(ENOMEM);
1299 
1300  memcpy(frame_sd->data, packet_sd, size);
1301  }
1302  }
1304 
1305  if (pkt->flags & AV_PKT_FLAG_DISCARD) {
1306  frame->flags |= AV_FRAME_FLAG_DISCARD;
1307  } else {
1308  frame->flags = (frame->flags & ~AV_FRAME_FLAG_DISCARD);
1309  }
1310  }
1311  frame->reordered_opaque = avctx->reordered_opaque;
1312 
1313  if (frame->color_primaries == AVCOL_PRI_UNSPECIFIED)
1314  frame->color_primaries = avctx->color_primaries;
1315  if (frame->color_trc == AVCOL_TRC_UNSPECIFIED)
1316  frame->color_trc = avctx->color_trc;
1317  if (frame->colorspace == AVCOL_SPC_UNSPECIFIED)
1318  frame->colorspace = avctx->colorspace;
1319  if (frame->color_range == AVCOL_RANGE_UNSPECIFIED)
1320  frame->color_range = avctx->color_range;
1321  if (frame->chroma_location == AVCHROMA_LOC_UNSPECIFIED)
1322  frame->chroma_location = avctx->chroma_sample_location;
1323 
1324  switch (avctx->codec->type) {
1325  case AVMEDIA_TYPE_VIDEO:
1326  frame->format = avctx->pix_fmt;
1327  if (!frame->sample_aspect_ratio.num)
1328  frame->sample_aspect_ratio = avctx->sample_aspect_ratio;
1329 
1330  if (frame->width && frame->height &&
1331  av_image_check_sar(frame->width, frame->height,
1332  frame->sample_aspect_ratio) < 0) {
1333  av_log(avctx, AV_LOG_WARNING, "ignoring invalid SAR: %u/%u\n",
1334  frame->sample_aspect_ratio.num,
1335  frame->sample_aspect_ratio.den);
1336  frame->sample_aspect_ratio = (AVRational){ 0, 1 };
1337  }
1338 
1339  break;
1340  case AVMEDIA_TYPE_AUDIO:
1341  if (!frame->sample_rate)
1342  frame->sample_rate = avctx->sample_rate;
1343  if (frame->format < 0)
1344  frame->format = avctx->sample_fmt;
1345  if (!frame->ch_layout.nb_channels) {
1346  int ret = av_channel_layout_copy(&frame->ch_layout, &avctx->ch_layout);
1347  if (ret < 0)
1348  return ret;
1349  }
1350 #if FF_API_OLD_CHANNEL_LAYOUT
1352  frame->channels = frame->ch_layout.nb_channels;
1353  frame->channel_layout = frame->ch_layout.order == AV_CHANNEL_ORDER_NATIVE ?
1354  frame->ch_layout.u.mask : 0;
1356 #endif
1357  break;
1358  }
1359  return 0;
1360 }
1361 
1363 {
1364  if (avctx->codec_type == AVMEDIA_TYPE_VIDEO) {
1365  int i;
1366  int num_planes = av_pix_fmt_count_planes(frame->format);
1368  int flags = desc ? desc->flags : 0;
1369  if (num_planes == 1 && (flags & AV_PIX_FMT_FLAG_PAL))
1370  num_planes = 2;
1371  for (i = 0; i < num_planes; i++) {
1372  av_assert0(frame->data[i]);
1373  }
1374  // For formats without data like hwaccel allow unused pointers to be non-NULL.
1375  for (i = num_planes; num_planes > 0 && i < FF_ARRAY_ELEMS(frame->data); i++) {
1376  if (frame->data[i])
1377  av_log(avctx, AV_LOG_ERROR, "Buffer returned by get_buffer2() did not zero unused plane pointers\n");
1378  frame->data[i] = NULL;
1379  }
1380  }
1381 }
1382 
1383 static void decode_data_free(void *opaque, uint8_t *data)
1384 {
1386 
1387  if (fdd->post_process_opaque_free)
1389 
1390  if (fdd->hwaccel_priv_free)
1391  fdd->hwaccel_priv_free(fdd->hwaccel_priv);
1392 
1393  av_freep(&fdd);
1394 }
1395 
1397 {
1398  AVBufferRef *fdd_buf;
1399  FrameDecodeData *fdd;
1400 
1401  av_assert1(!frame->private_ref);
1402  av_buffer_unref(&frame->private_ref);
1403 
1404  fdd = av_mallocz(sizeof(*fdd));
1405  if (!fdd)
1406  return AVERROR(ENOMEM);
1407 
1408  fdd_buf = av_buffer_create((uint8_t*)fdd, sizeof(*fdd), decode_data_free,
1410  if (!fdd_buf) {
1411  av_freep(&fdd);
1412  return AVERROR(ENOMEM);
1413  }
1414 
1415  frame->private_ref = fdd_buf;
1416 
1417  return 0;
1418 }
1419 
1421 {
1422  const AVHWAccel *hwaccel = avctx->hwaccel;
1423  int override_dimensions = 1;
1424  int ret;
1425 
1427 
1428  if (avctx->codec_type == AVMEDIA_TYPE_VIDEO) {
1429  if ((unsigned)avctx->width > INT_MAX - STRIDE_ALIGN ||
1430  (ret = av_image_check_size2(FFALIGN(avctx->width, STRIDE_ALIGN), avctx->height, avctx->max_pixels, AV_PIX_FMT_NONE, 0, avctx)) < 0 || avctx->pix_fmt<0) {
1431  av_log(avctx, AV_LOG_ERROR, "video_get_buffer: image parameters invalid\n");
1432  ret = AVERROR(EINVAL);
1433  goto fail;
1434  }
1435 
1436  if (frame->width <= 0 || frame->height <= 0) {
1437  frame->width = FFMAX(avctx->width, AV_CEIL_RSHIFT(avctx->coded_width, avctx->lowres));
1438  frame->height = FFMAX(avctx->height, AV_CEIL_RSHIFT(avctx->coded_height, avctx->lowres));
1439  override_dimensions = 0;
1440  }
1441 
1442  if (frame->data[0] || frame->data[1] || frame->data[2] || frame->data[3]) {
1443  av_log(avctx, AV_LOG_ERROR, "pic->data[*]!=NULL in get_buffer_internal\n");
1444  ret = AVERROR(EINVAL);
1445  goto fail;
1446  }
1447  } else if (avctx->codec_type == AVMEDIA_TYPE_AUDIO) {
1448 #if FF_API_OLD_CHANNEL_LAYOUT
1450  /* compat layer for old-style get_buffer() implementations */
1451  avctx->channels = avctx->ch_layout.nb_channels;
1452  avctx->channel_layout = (avctx->ch_layout.order == AV_CHANNEL_ORDER_NATIVE) ?
1453  avctx->ch_layout.u.mask : 0;
1455 #endif
1456 
1457  if (frame->nb_samples * (int64_t)avctx->ch_layout.nb_channels > avctx->max_samples) {
1458  av_log(avctx, AV_LOG_ERROR, "samples per frame %d, exceeds max_samples %"PRId64"\n", frame->nb_samples, avctx->max_samples);
1459  ret = AVERROR(EINVAL);
1460  goto fail;
1461  }
1462  }
1463  ret = ff_decode_frame_props(avctx, frame);
1464  if (ret < 0)
1465  goto fail;
1466 
1467  if (hwaccel) {
1468  if (hwaccel->alloc_frame) {
1469  ret = hwaccel->alloc_frame(avctx, frame);
1470  goto end;
1471  }
1472  } else
1473  avctx->sw_pix_fmt = avctx->pix_fmt;
1474 
1475  ret = avctx->get_buffer2(avctx, frame, flags);
1476  if (ret < 0)
1477  goto fail;
1478 
1480 
1482  if (ret < 0)
1483  goto fail;
1484 
1485 end:
1486  if (avctx->codec_type == AVMEDIA_TYPE_VIDEO && !override_dimensions &&
1488  frame->width = avctx->width;
1489  frame->height = avctx->height;
1490  }
1491 
1492 fail:
1493  if (ret < 0) {
1494  av_log(avctx, AV_LOG_ERROR, "get_buffer() failed\n");
1496  }
1497 
1498  return ret;
1499 }
1500 
1502 {
1503  AVFrame *tmp;
1504  int ret;
1505 
1507 
1508  if (frame->data[0] && (frame->width != avctx->width || frame->height != avctx->height || frame->format != avctx->pix_fmt)) {
1509  av_log(avctx, AV_LOG_WARNING, "Picture changed from size:%dx%d fmt:%s to size:%dx%d fmt:%s in reget buffer()\n",
1510  frame->width, frame->height, av_get_pix_fmt_name(frame->format), avctx->width, avctx->height, av_get_pix_fmt_name(avctx->pix_fmt));
1512  }
1513 
1514  if (!frame->data[0])
1515  return ff_get_buffer(avctx, frame, AV_GET_BUFFER_FLAG_REF);
1516 
1518  return ff_decode_frame_props(avctx, frame);
1519 
1520  tmp = av_frame_alloc();
1521  if (!tmp)
1522  return AVERROR(ENOMEM);
1523 
1525 
1527  if (ret < 0) {
1528  av_frame_free(&tmp);
1529  return ret;
1530  }
1531 
1533  av_frame_free(&tmp);
1534 
1535  return 0;
1536 }
1537 
1539 {
1540  int ret = reget_buffer_internal(avctx, frame, flags);
1541  if (ret < 0)
1542  av_log(avctx, AV_LOG_ERROR, "reget_buffer() failed\n");
1543  return ret;
1544 }
1545 
1547 {
1548  AVCodecInternal *avci = avctx->internal;
1549  int ret = 0;
1550 
1551  /* if the decoder init function was already called previously,
1552  * free the already allocated subtitle_header before overwriting it */
1553  av_freep(&avctx->subtitle_header);
1554 
1555 #if FF_API_THREAD_SAFE_CALLBACKS
1557  if ((avctx->thread_type & FF_THREAD_FRAME) &&
1559  !avctx->thread_safe_callbacks) {
1560  av_log(avctx, AV_LOG_WARNING, "Requested frame threading with a "
1561  "custom get_buffer2() implementation which is not marked as "
1562  "thread safe. This is not supported anymore, make your "
1563  "callback thread-safe.\n");
1564  }
1566 #endif
1567 
1568  if (avctx->codec->max_lowres < avctx->lowres || avctx->lowres < 0) {
1569  av_log(avctx, AV_LOG_WARNING, "The maximum value for lowres supported by the decoder is %d\n",
1570  avctx->codec->max_lowres);
1571  avctx->lowres = avctx->codec->max_lowres;
1572  }
1573  if (avctx->sub_charenc) {
1574  if (avctx->codec_type != AVMEDIA_TYPE_SUBTITLE) {
1575  av_log(avctx, AV_LOG_ERROR, "Character encoding is only "
1576  "supported with subtitles codecs\n");
1577  return AVERROR(EINVAL);
1578  } else if (avctx->codec_descriptor->props & AV_CODEC_PROP_BITMAP_SUB) {
1579  av_log(avctx, AV_LOG_WARNING, "Codec '%s' is bitmap-based, "
1580  "subtitles character encoding will be ignored\n",
1581  avctx->codec_descriptor->name);
1583  } else {
1584  /* input character encoding is set for a text based subtitle
1585  * codec at this point */
1588 
1590 #if CONFIG_ICONV
1591  iconv_t cd = iconv_open("UTF-8", avctx->sub_charenc);
1592  if (cd == (iconv_t)-1) {
1593  ret = AVERROR(errno);
1594  av_log(avctx, AV_LOG_ERROR, "Unable to open iconv context "
1595  "with input character encoding \"%s\"\n", avctx->sub_charenc);
1596  return ret;
1597  }
1598  iconv_close(cd);
1599 #else
1600  av_log(avctx, AV_LOG_ERROR, "Character encoding subtitles "
1601  "conversion needs a libavcodec built with iconv support "
1602  "for this codec\n");
1603  return AVERROR(ENOSYS);
1604 #endif
1605  }
1606  }
1607  }
1608 
1610  avctx->pts_correction_num_faulty_dts = 0;
1611  avctx->pts_correction_last_pts =
1612  avctx->pts_correction_last_dts = INT64_MIN;
1613 
1614  if ( !CONFIG_GRAY && avctx->flags & AV_CODEC_FLAG_GRAY
1616  av_log(avctx, AV_LOG_WARNING,
1617  "gray decoding requested but not enabled at configuration time\n");
1618  if (avctx->flags2 & AV_CODEC_FLAG2_EXPORT_MVS) {
1620  }
1621 
1622  avci->in_pkt = av_packet_alloc();
1623  avci->last_pkt_props = av_packet_alloc();
1624  if (!avci->in_pkt || !avci->last_pkt_props)
1625  return AVERROR(ENOMEM);
1626 
1627  ret = decode_bsfs_init(avctx);
1628  if (ret < 0)
1629  return ret;
1630 
1631  return 0;
1632 }
1633 
1634 int ff_copy_palette(void *dst, const AVPacket *src, void *logctx)
1635 {
1636  size_t size;
1637  const void *pal = av_packet_get_side_data(src, AV_PKT_DATA_PALETTE, &size);
1638 
1639  if (pal && size == AVPALETTE_SIZE) {
1640  memcpy(dst, pal, AVPALETTE_SIZE);
1641  return 1;
1642  } else if (pal) {
1643  av_log(logctx, AV_LOG_ERROR,
1644  "Palette size %"SIZE_SPECIFIER" is wrong\n", size);
1645  }
1646  return 0;
1647 }
AVSubtitle
Definition: avcodec.h:2308
AVCodecInternal::initial_sample_rate
int initial_sample_rate
Definition: internal.h:160
hwconfig.h
av_packet_unref
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
Definition: avpacket.c:422
AVCodecContext::hwaccel
const struct AVHWAccel * hwaccel
Hardware accelerator in use.
Definition: avcodec.h:1369
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:82
FFCodec::receive_frame
int(* receive_frame)(struct AVCodecContext *avctx, struct AVFrame *frame)
Decode API with decoupled packet/frame dataflow.
Definition: codec_internal.h:202
AVMEDIA_TYPE_SUBTITLE
@ AVMEDIA_TYPE_SUBTITLE
Definition: avutil.h:204
AVBSFContext::par_in
AVCodecParameters * par_in
Parameters of the input stream.
Definition: bsf.h:90
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
ff_decode_get_packet
int ff_decode_get_packet(AVCodecContext *avctx, AVPacket *pkt)
Called by decoders to get the next packet for decoding.
Definition: decode.c:183
hw_pix_fmt
static enum AVPixelFormat hw_pix_fmt
Definition: hw_decode.c:46
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
AV_EF_EXPLODE
#define AV_EF_EXPLODE
abort decoding on minor error detection
Definition: defs.h:51
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
opt.h
AVCodecContext::get_format
enum AVPixelFormat(* get_format)(struct AVCodecContext *s, const enum AVPixelFormat *fmt)
Callback to negotiate the pixel format.
Definition: avcodec.h:662
ff_icc_profile_read_primaries
int ff_icc_profile_read_primaries(FFIccContext *s, cmsHPROFILE profile, AVColorPrimariesDesc *out_primaries)
Read the color primaries and white point coefficients encoded by an ICC profile, and return the raw v...
Definition: fflcms2.c:205
AV_WL32
#define AV_WL32(p, v)
Definition: intreadwrite.h:426
AVCodecContext::colorspace
enum AVColorSpace colorspace
YUV colorspace type.
Definition: avcodec.h:975
AVColorTransferCharacteristic
AVColorTransferCharacteristic
Color Transfer Characteristic.
Definition: pixfmt.h:558
ff_get_format
int ff_get_format(AVCodecContext *avctx, const enum AVPixelFormat *fmt)
Select the (possibly hardware accelerated) pixel format.
Definition: decode.c:1117
apply_cropping
static int apply_cropping(AVCodecContext *avctx, AVFrame *frame)
Definition: decode.c:643
AVCodecContext::sample_rate
int sample_rate
samples per second
Definition: avcodec.h:1007
av_frame_get_side_data
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Definition: frame.c:691
av_frame_new_side_data
AVFrameSideData * av_frame_new_side_data(AVFrame *frame, enum AVFrameSideDataType type, size_t size)
Add a new side data to a frame.
Definition: frame.c:679
AV_PKT_DATA_PARAM_CHANGE
@ AV_PKT_DATA_PARAM_CHANGE
An AV_PKT_DATA_PARAM_CHANGE side data packet is laid out as follows:
Definition: packet.h:73
AVColorPrimariesDesc
Struct that contains both white point location and primaries location, providing the complete descrip...
Definition: csp.h:74
sub
static float sub(float src0, float src1)
Definition: dnn_backend_native_layer_mathbinary.c:31
av_pix_fmt_desc_get
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2858
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:57
AVBufferRef::data
uint8_t * data
The data buffer.
Definition: buffer.h:90
AV_HWACCEL_CODEC_CAP_EXPERIMENTAL
#define AV_HWACCEL_CODEC_CAP_EXPERIMENTAL
HWAccel is experimental and is thus avoided in favor of non experimental codecs.
Definition: avcodec.h:2224
AV_FRAME_DATA_A53_CC
@ AV_FRAME_DATA_A53_CC
ATSC A53 Part 4 Closed Captions.
Definition: frame.h:59
AV_CODEC_HW_CONFIG_METHOD_INTERNAL
@ AV_CODEC_HW_CONFIG_METHOD_INTERNAL
The codec supports this format by some internal method.
Definition: codec.h:346
avcodec_parameters_from_context
int avcodec_parameters_from_context(AVCodecParameters *par, const AVCodecContext *codec)
Fill the parameters struct based on the values from the supplied codec context.
Definition: codec_par.c:99
AV_PKT_FLAG_DISCARD
#define AV_PKT_FLAG_DISCARD
Flag is used to discard packets which are required to maintain valid decoder state but are not requir...
Definition: packet.h:436
AVHWFramesContext::format
enum AVPixelFormat format
The pixel format identifying the underlying HW surface type.
Definition: hwcontext.h:209
AVCodecInternal::skip_samples
int skip_samples
Number of audio samples to skip at the start of the next decoded frame.
Definition: internal.h:132
AVCodecContext::err_recognition
int err_recognition
Error recognition; may misdetect some more or less valid parts as errors.
Definition: avcodec.h:1351
AV_CODEC_FLAG_UNALIGNED
#define AV_CODEC_FLAG_UNALIGNED
Allow decoders to produce frames with data planes that are not aligned to CPU requirements (e....
Definition: avcodec.h:212
AV_TIME_BASE_Q
#define AV_TIME_BASE_Q
Internal time base represented as fractional value.
Definition: avutil.h:260
AVCodecDescriptor::name
const char * name
Name of the codec described by this descriptor.
Definition: codec_desc.h:46
AV_WL8
#define AV_WL8(p, d)
Definition: intreadwrite.h:399
av_unused
#define av_unused
Definition: attributes.h:131
decode_simple_receive_frame
static int decode_simple_receive_frame(AVCodecContext *avctx, AVFrame *frame)
Definition: decode.c:533
AV_FRAME_DATA_S12M_TIMECODE
@ AV_FRAME_DATA_S12M_TIMECODE
Timecode which conforms to SMPTE ST 12-1.
Definition: frame.h:152
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:116
FrameDecodeData
This struct stores per-frame lavc-internal data and is attached to it via private_ref.
Definition: decode.h:34
av_hwframe_ctx_init
int av_hwframe_ctx_init(AVBufferRef *ref)
Finalize the context before use.
Definition: hwcontext.c:334
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:325
tmp
static uint8_t tmp[11]
Definition: aes_ctr.c:28
AVCodecContext::color_trc
enum AVColorTransferCharacteristic color_trc
Color Transfer Characteristic.
Definition: avcodec.h:968
AVCodec::capabilities
int capabilities
Codec capabilities.
Definition: codec.h:223
avcodec_decode_subtitle2
int avcodec_decode_subtitle2(AVCodecContext *avctx, AVSubtitle *sub, int *got_sub_ptr, AVPacket *avpkt)
Decode a subtitle message.
Definition: decode.c:833
av_hwframe_ctx_alloc
AVBufferRef * av_hwframe_ctx_alloc(AVBufferRef *device_ref_in)
Allocate an AVHWFramesContext tied to a given device context.
Definition: hwcontext.c:248
internal.h
AVPacket::data
uint8_t * data
Definition: packet.h:374
AVHWAccel::capabilities
int capabilities
Hardware accelerated codec capabilities.
Definition: avcodec.h:2103
AVCOL_TRC_UNSPECIFIED
@ AVCOL_TRC_UNSPECIFIED
Definition: pixfmt.h:561
AV_PKT_DATA_PALETTE
@ AV_PKT_DATA_PALETTE
An AV_PKT_DATA_PALETTE side data packet contains exactly AVPALETTE_SIZE bytes worth of palette.
Definition: packet.h:47
data
const char data[16]
Definition: mxf.c:146
AVHWAccel::init
int(* init)(AVCodecContext *avctx)
Initialize the hwaccel private data.
Definition: avcodec.h:2188
FFCodec
Definition: codec_internal.h:119
AVCodecContext::subtitle_header
uint8_t * subtitle_header
Header containing style information for text subtitles.
Definition: avcodec.h:1708
AV_SIDE_DATA_PARAM_CHANGE_SAMPLE_RATE
@ AV_SIDE_DATA_PARAM_CHANGE_SAMPLE_RATE
Definition: packet.h:458
FrameDecodeData::hwaccel_priv_free
void(* hwaccel_priv_free)(void *priv)
Definition: decode.h:53
AV_FRAME_DATA_DISPLAYMATRIX
@ AV_FRAME_DATA_DISPLAYMATRIX
This side data contains a 3x3 transformation matrix describing an affine transformation that needs to...
Definition: frame.h:85
AVPacket::duration
int64_t duration
Duration of this packet in AVStream->time_base units, 0 if unknown.
Definition: packet.h:392
FF_COMPLIANCE_EXPERIMENTAL
#define FF_COMPLIANCE_EXPERIMENTAL
Allow nonstandardized experimental things.
Definition: defs.h:62
FF_SUB_CHARENC_MODE_PRE_DECODER
#define FF_SUB_CHARENC_MODE_PRE_DECODER
the AVPacket data needs to be recoded to UTF-8 before being fed to the decoder, requires iconv
Definition: avcodec.h:1784
AVDictionary
Definition: dict.c:32
AVChannelLayout::order
enum AVChannelOrder order
Channel order used in this layout.
Definition: channel_layout.h:306
FFMAX
#define FFMAX(a, b)
Definition: macros.h:47
AVColorPrimaries
AVColorPrimaries
Chromaticity coordinates of the source primaries.
Definition: pixfmt.h:533
avcodec_default_get_format
enum AVPixelFormat avcodec_default_get_format(struct AVCodecContext *avctx, const enum AVPixelFormat *fmt)
Definition: decode.c:905
avcodec_is_open
int avcodec_is_open(AVCodecContext *s)
Definition: avcodec.c:704
AVChannelLayout::mask
uint64_t mask
This member must be used for AV_CHANNEL_ORDER_NATIVE, and may be used for AV_CHANNEL_ORDER_AMBISONIC ...
Definition: channel_layout.h:333
AV_PKT_DATA_SPHERICAL
@ AV_PKT_DATA_SPHERICAL
This side data should be associated with a video stream and corresponds to the AVSphericalMapping str...
Definition: packet.h:229
AVChannelLayout::nb_channels
int nb_channels
Number of channels in this layout.
Definition: channel_layout.h:311
AVFrame::buf
AVBufferRef * buf[AV_NUM_DATA_POINTERS]
AVBuffer references backing the data for this frame.
Definition: frame.h:525
AV_RL8
#define AV_RL8(x)
Definition: intreadwrite.h:398
ff_set_dimensions
int ff_set_dimensions(AVCodecContext *s, int width, int height)
Check that the provided frame dimensions are valid and set them on the codec context.
Definition: utils.c:91
av_bsf_free
void av_bsf_free(AVBSFContext **pctx)
Free a bitstream filter context and everything associated with it; write NULL into the supplied point...
Definition: bsf.c:53
FF_SUB_CHARENC_MODE_AUTOMATIC
#define FF_SUB_CHARENC_MODE_AUTOMATIC
libavcodec will select the mode itself
Definition: avcodec.h:1783
tf_sess_config.config
config
Definition: tf_sess_config.py:33
thread.h
av_frame_apply_cropping
int av_frame_apply_cropping(AVFrame *frame, int flags)
Crop the given video AVFrame according to its crop_left/crop_top/crop_right/ crop_bottom fields.
Definition: frame.c:870
av_memdup
void * av_memdup(const void *p, size_t size)
Duplicate a buffer with av_malloc().
Definition: mem.c:312
AVCodecContext::framerate
AVRational framerate
Definition: avcodec.h:1735
AVCodec::max_lowres
uint8_t max_lowres
maximum value for lowres supported by the decoder
Definition: codec.h:224
av_pix_fmt_count_planes
int av_pix_fmt_count_planes(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2898
AVHWAccel
Definition: avcodec.h:2070
fifo.h
finish
static void finish(void)
Definition: movenc.c:342
bsf.h
AVCodecContext::codec
const struct AVCodec * codec
Definition: avcodec.h:407
STRIDE_ALIGN
#define STRIDE_ALIGN
Definition: internal.h:49
AVCodecContext::ch_layout
AVChannelLayout ch_layout
Audio channel layout.
Definition: avcodec.h:2059
fail
#define fail()
Definition: checkasm.h:134
AVCodecInternal::showed_multi_packet_warning
int showed_multi_packet_warning
Definition: internal.h:151
ff_icc_context_init
int ff_icc_context_init(FFIccContext *s, void *avctx)
Initializes an FFIccContext.
Definition: fflcms2.c:31
AVCodecContext::thread_count
int thread_count
thread count is used to decide how many independent tasks should be passed to execute()
Definition: avcodec.h:1466
AV_PIX_FMT_FLAG_HWACCEL
#define AV_PIX_FMT_FLAG_HWACCEL
Pixel format is an HW accelerated format.
Definition: pixdesc.h:128
FF_SUB_CHARENC_MODE_DO_NOTHING
#define FF_SUB_CHARENC_MODE_DO_NOTHING
do nothing (demuxer outputs a stream supposed to be already in UTF-8, or the codec is bitmap for inst...
Definition: avcodec.h:1782
AVCodecContext::flags
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:478
val
static double val(void *priv, double ch)
Definition: aeval.c:77
FrameDecodeData::post_process_opaque_free
void(* post_process_opaque_free)(void *opaque)
Definition: decode.h:47
pts
static int64_t pts
Definition: transcode_aac.c:654
add_metadata_from_side_data
static int add_metadata_from_side_data(const AVPacket *avpkt, AVFrame *frame)
Definition: decode.c:1252
AVCodecContext::coded_height
int coded_height
Definition: avcodec.h:586
AV_PKT_DATA_DISPLAYMATRIX
@ AV_PKT_DATA_DISPLAYMATRIX
This side data contains a 3x3 transformation matrix describing an affine transformation that needs to...
Definition: packet.h:109
guess_correct_pts
static int64_t guess_correct_pts(AVCodecContext *ctx, int64_t reordered_pts, int64_t dts)
Attempt to guess proper monotonic timestamps for decoded video frames which might have incorrect time...
Definition: decode.c:223
AVCodecContext::max_samples
int64_t max_samples
The number of samples per frame to maximally accept.
Definition: avcodec.h:1999
AVRational::num
int num
Numerator.
Definition: rational.h:59
AVFrameSideDataType
AVFrameSideDataType
Definition: frame.h:49
AVHWAccel::priv_data_size
int priv_data_size
Size of the private data to allocate in AVCodecInternal.hwaccel_priv_data.
Definition: avcodec.h:2202
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
avsubtitle_free
void avsubtitle_free(AVSubtitle *sub)
Free all allocated data in the given subtitle struct.
Definition: avcodec.c:409
AVHWDeviceContext
This struct aggregates all the (hardware/vendor-specific) "high-level" state, i.e.
Definition: hwcontext.h:61
av_frame_alloc
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
Definition: frame.c:104
AV_PKT_DATA_STRINGS_METADATA
@ AV_PKT_DATA_STRINGS_METADATA
A list of zero terminated key/value strings.
Definition: packet.h:173
AV_PKT_DATA_REPLAYGAIN
@ AV_PKT_DATA_REPLAYGAIN
This side data should be associated with an audio stream and contains ReplayGain information in form ...
Definition: packet.h:100
AVCodecContext::get_buffer2
int(* get_buffer2)(struct AVCodecContext *s, AVFrame *frame, int flags)
This callback is called at the beginning of each frame to get data buffer(s) for it.
Definition: avcodec.h:1176
GET_UTF8
#define GET_UTF8(val, GET_BYTE, ERROR)
Convert a UTF-8 character (up to 4 bytes) to its 32-bit UCS-4 encoded form.
Definition: common.h:469
AV_CODEC_FLAG_DROPCHANGED
#define AV_CODEC_FLAG_DROPCHANGED
Don't output frames whose parameters differ from first decoded frame in stream.
Definition: avcodec.h:233
avassert.h
AVCodecContext::color_primaries
enum AVColorPrimaries color_primaries
Chromaticity coordinates of the source primaries.
Definition: avcodec.h:961
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
AVFrameSideData::size
size_t size
Definition: frame.h:234
FF_ARRAY_ELEMS
#define FF_ARRAY_ELEMS(a)
Definition: sinewin_tablegen.c:29
AVCodecContext::pts_correction_num_faulty_pts
int64_t pts_correction_num_faulty_pts
Current statistics for PTS correction.
Definition: avcodec.h:1763
ff_decode_receive_frame
int ff_decode_receive_frame(AVCodecContext *avctx, AVFrame *frame)
avcodec_receive_frame() implementation for decoders.
Definition: decode.c:670
hwaccel_uninit
static void hwaccel_uninit(AVCodecContext *avctx)
Definition: decode.c:1105
AVHWAccel::alloc_frame
int(* alloc_frame)(AVCodecContext *avctx, AVFrame *frame)
Allocate a custom buffer.
Definition: avcodec.h:2116
AV_PKT_DATA_AUDIO_SERVICE_TYPE
@ AV_PKT_DATA_AUDIO_SERVICE_TYPE
This side data should be associated with an audio stream and corresponds to enum AVAudioServiceType.
Definition: packet.h:121
AVCodecContext::has_b_frames
int has_b_frames
Size of the frame reordering buffer in the decoder.
Definition: avcodec.h:694
AV_SIDE_DATA_PARAM_CHANGE_DIMENSIONS
@ AV_SIDE_DATA_PARAM_CHANGE_DIMENSIONS
Definition: packet.h:459
AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX
@ AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX
The codec supports this format via the hw_frames_ctx interface.
Definition: codec.h:339
get_subtitle_defaults
static void get_subtitle_defaults(AVSubtitle *sub)
Definition: decode.c:746
FrameDecodeData::post_process_opaque
void * post_process_opaque
Definition: decode.h:46
av_new_packet
int av_new_packet(AVPacket *pkt, int size)
Allocate the payload of a packet and initialize its fields with default values.
Definition: avpacket.c:97
validate_avframe_allocation
static void validate_avframe_allocation(AVCodecContext *avctx, AVFrame *frame)
Definition: decode.c:1362
AV_PKT_DATA_STEREO3D
@ AV_PKT_DATA_STEREO3D
This side data should be associated with a video stream and contains Stereoscopic 3D information in f...
Definition: packet.h:115
AVCodecInternal::buffer_pkt
AVPacket * buffer_pkt
Temporary buffers for newly received or not yet output packets/frames.
Definition: internal.h:147
AV_CEIL_RSHIFT
#define AV_CEIL_RSHIFT(a, b)
Definition: common.h:50
AV_BUFFER_FLAG_READONLY
#define AV_BUFFER_FLAG_READONLY
Always treat the buffer as read-only, even when it has only one reference.
Definition: buffer.h:114
AV_PKT_DATA_MASTERING_DISPLAY_METADATA
@ AV_PKT_DATA_MASTERING_DISPLAY_METADATA
Mastering display metadata (based on SMPTE-2086:2014).
Definition: packet.h:223
AVHWAccel::uninit
int(* uninit)(AVCodecContext *avctx)
Uninitialize the hwaccel private data.
Definition: avcodec.h:2196
AV_GET_BUFFER_FLAG_REF
#define AV_GET_BUFFER_FLAG_REF
The decoder will keep a reference to the frame and may reuse it later.
Definition: avcodec.h:376
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
AVERROR_INPUT_CHANGED
#define AVERROR_INPUT_CHANGED
Input changed between calls. Reconfiguration is required. (can be OR-ed with AVERROR_OUTPUT_CHANGED)
Definition: error.h:75
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_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
AVHWDeviceType
AVHWDeviceType
Definition: hwcontext.h:27
AVCodecDescriptor::type
enum AVMediaType type
Definition: codec_desc.h:40
AVCodecContext::thread_type
int thread_type
Which multithreading methods to use.
Definition: avcodec.h:1476
AV_PKT_DATA_ICC_PROFILE
@ AV_PKT_DATA_ICC_PROFILE
ICC profile data consisting of an opaque octet buffer following the format described by ISO 15076-1.
Definition: packet.h:275
AV_LOG_DEBUG
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:201
ctx
AVFormatContext * ctx
Definition: movenc.c:48
decode.h
AVBSFContext::time_base_in
AVRational time_base_in
The timebase used for the timestamps of the input packets.
Definition: bsf.h:102
AV_PKT_DATA_DYNAMIC_HDR10_PLUS
@ AV_PKT_DATA_DYNAMIC_HDR10_PLUS
HDR10+ dynamic metadata associated with a video frame.
Definition: packet.h:300
av_rescale_q
int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq)
Rescale a 64-bit integer by 2 rational numbers.
Definition: mathematics.c:142
AVCodecHWConfig::pix_fmt
enum AVPixelFormat pix_fmt
For decoders, a hardware pixel format which that decoder may be able to decode to if suitable hardwar...
Definition: codec.h:367
av_csp_primaries_id_from_desc
enum AVColorPrimaries av_csp_primaries_id_from_desc(const AVColorPrimariesDesc *prm)
Detects which enum AVColorPrimaries constant corresponds to the given complete gamut description.
Definition: csp.c:105
AVCodecContext::max_pixels
int64_t max_pixels
The number of pixels per image to maximally accept.
Definition: avcodec.h:1911
av_hwdevice_get_type_name
const char * av_hwdevice_get_type_name(enum AVHWDeviceType type)
Get the string name of an AVHWDeviceType.
Definition: hwcontext.c:93
AVPacket::opaque
void * opaque
for some private data of the user
Definition: packet.h:399
AVCOL_PRI_UNSPECIFIED
@ AVCOL_PRI_UNSPECIFIED
Definition: pixfmt.h:536
FFCodec::decode
int(* decode)(struct AVCodecContext *avctx, struct AVFrame *frame, int *got_frame_ptr, struct AVPacket *avpkt)
Decode to an AVFrame.
Definition: codec_internal.h:185
decode_data_free
static void decode_data_free(void *opaque, uint8_t *data)
Definition: decode.c:1383
ff_decode_get_hw_frames_ctx
int ff_decode_get_hw_frames_ctx(AVCodecContext *avctx, enum AVHWDeviceType dev_type)
Make sure avctx.hw_frames_ctx is set.
Definition: decode.c:968
AVChannelLayout::u
union AVChannelLayout::@313 u
Details about which channels are present in this layout.
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
AVCodecInternal::changed_frames_dropped
int changed_frames_dropped
Definition: internal.h:157
AVCodecContext::sub_charenc
char * sub_charenc
DTS of the last frame.
Definition: avcodec.h:1773
AV_CODEC_FLAG2_SKIP_MANUAL
#define AV_CODEC_FLAG2_SKIP_MANUAL
Do not skip samples and export skip information as frame side data.
Definition: avcodec.h:339
av_bsf_init
int av_bsf_init(AVBSFContext *ctx)
Prepare the filter for use, after all the parameters and options have been set.
Definition: bsf.c:150
utf8_check
static int utf8_check(const uint8_t *str)
Definition: decode.c:814
AV_FRAME_DATA_SPHERICAL
@ AV_FRAME_DATA_SPHERICAL
The data represents the AVSphericalMapping structure defined in libavutil/spherical....
Definition: frame.h:131
NULL
#define NULL
Definition: coverity.c:32
AVERROR_PATCHWELCOME
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:64
AVCodecContext::apply_cropping
int apply_cropping
Video decoding only.
Definition: avcodec.h:1969
AVCodecContext::color_range
enum AVColorRange color_range
MPEG vs JPEG YUV range.
Definition: avcodec.h:982
av_buffer_unref
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it.
Definition: buffer.c:139
av_bsf_receive_packet
int av_bsf_receive_packet(AVBSFContext *ctx, AVPacket *pkt)
Retrieve a filtered packet.
Definition: bsf.c:231
AVCodec::type
enum AVMediaType type
Definition: codec.h:217
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
AVCodecContext::internal
struct AVCodecInternal * internal
Private context used for internal data.
Definition: avcodec.h:433
AVPALETTE_SIZE
#define AVPALETTE_SIZE
Definition: pixfmt.h:32
AV_CODEC_PROP_BITMAP_SUB
#define AV_CODEC_PROP_BITMAP_SUB
Subtitle codec is bitmap based Decoded AVSubtitle data can be read from the AVSubtitleRect->pict fiel...
Definition: codec_desc.h:97
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
AV_CODEC_FLAG_TRUNCATED
#define AV_CODEC_FLAG_TRUNCATED
Input bitstream might be truncated at a random location instead of only at frame boundaries.
Definition: avcodec.h:271
AV_FRAME_DATA_MASTERING_DISPLAY_METADATA
@ AV_FRAME_DATA_MASTERING_DISPLAY_METADATA
Mastering display metadata associated with a video frame.
Definition: frame.h:120
AVCodecInternal::initial_height
int initial_height
Definition: internal.h:159
AVCodecContext::thread_safe_callbacks
attribute_deprecated int thread_safe_callbacks
Set by the client if its custom get_buffer() callback can be called synchronously from another thread...
Definition: avcodec.h:1505
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:349
ff_icc_profile_detect_transfer
int ff_icc_profile_detect_transfer(FFIccContext *s, cmsHPROFILE profile, enum AVColorTransferCharacteristic *out_trc)
Attempt detecting the transfer characteristic that best approximates the transfer function encoded by...
Definition: fflcms2.c:252
av_packet_ref
int av_packet_ref(AVPacket *dst, const AVPacket *src)
Setup a new reference to the data described by a given packet.
Definition: avpacket.c:430
AVCodecInternal::draining_done
int draining_done
Definition: internal.h:149
UTF8_MAX_BYTES
#define UTF8_MAX_BYTES
Definition: decode.c:752
AVCOL_RANGE_UNSPECIFIED
@ AVCOL_RANGE_UNSPECIFIED
Definition: pixfmt.h:627
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
AVCodecInternal::last_pkt_props
AVPacket * last_pkt_props
Properties (timestamps+side data) extracted from the last packet passed for decoding.
Definition: internal.h:90
av_buffer_create
AVBufferRef * av_buffer_create(uint8_t *data, size_t size, void(*free)(void *opaque, uint8_t *data), void *opaque, int flags)
Create an AVBuffer from an existing array.
Definition: buffer.c:55
FFCodec::cb
union FFCodec::@50 cb
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:521
av_codec_is_decoder
int av_codec_is_decoder(const AVCodec *codec)
Definition: utils.c:83
AVCodecContext::lowres
int lowres
low resolution decoding, 1-> 1/2 size, 2->1/4 size
Definition: avcodec.h:1458
f
f
Definition: af_crystalizer.c:122
AVCodecContext::flags2
int flags2
AV_CODEC_FLAG2_*.
Definition: avcodec.h:485
ff_get_buffer
int ff_get_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Get a buffer for a frame.
Definition: decode.c:1420
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:52
AV_FRAME_DATA_REPLAYGAIN
@ AV_FRAME_DATA_REPLAYGAIN
ReplayGain information in the form of the AVReplayGain struct.
Definition: frame.h:77
AV_CODEC_FLAG_GRAY
#define AV_CODEC_FLAG_GRAY
Only decode/encode grayscale.
Definition: avcodec.h:259
AVPacket::size
int size
Definition: packet.h:375
ff_thread_decode_frame
int ff_thread_decode_frame(AVCodecContext *avctx, AVFrame *picture, int *got_picture_ptr, AVPacket *avpkt)
Submit a new frame to a decoding thread.
Definition: pthread_frame.c:547
byte
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_WL32 unsigned int_TMPL AV_WL24 unsigned int_TMPL AV_WL16 uint64_t_TMPL AV_WB64 unsigned int_TMPL AV_WB32 unsigned int_TMPL AV_WB24 unsigned int_TMPL AV_WB16 unsigned int_TMPL byte
Definition: bytestream.h:99
AVCodecContext::extra_hw_frames
int extra_hw_frames
Definition: avcodec.h:1983
codec_internal.h
FrameDecodeData::post_process
int(* post_process)(void *logctx, AVFrame *frame)
The callback to perform some delayed processing on the frame right before it is returned to the calle...
Definition: decode.h:45
AVCodecInternal::hwaccel_priv_data
void * hwaccel_priv_data
hwaccel-specific private data
Definition: internal.h:137
av_frame_copy
int av_frame_copy(AVFrame *dst, const AVFrame *src)
Copy the frame data from src to dst.
Definition: frame.c:771
av_bsf_send_packet
int av_bsf_send_packet(AVBSFContext *ctx, AVPacket *pkt)
Submit a packet for filtering.
Definition: bsf.c:203
av_err2str
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
Definition: error.h:121
for
for(k=2;k<=8;++k)
Definition: h264pred_template.c:425
FF_CODEC_CAP_SETS_FRAME_PROPS
#define FF_CODEC_CAP_SETS_FRAME_PROPS
Codec handles output frame properties internally instead of letting the internal logic derive them fr...
Definition: codec_internal.h:78
AVCodecInternal::initial_format
int initial_format
Definition: internal.h:158
AVCodecInternal::bsf
struct AVBSFContext * bsf
Definition: internal.h:84
AVCodecContext::sample_fmt
enum AVSampleFormat sample_fmt
audio sample format
Definition: avcodec.h:1023
AVCodecContext::pkt_timebase
AVRational pkt_timebase
Timebase in which pkt_dts/pts and AVPacket.dts/pts are.
Definition: avcodec.h:1749
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:56
FF_CODEC_CAP_EXPORTS_CROPPING
#define FF_CODEC_CAP_EXPORTS_CROPPING
The decoder sets the cropping fields in the output frames manually.
Definition: codec_internal.h:60
size
int size
Definition: twinvq_data.h:10344
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
AVFrameSideData::data
uint8_t * data
Definition: frame.h:233
ffcodec
static const av_always_inline FFCodec * ffcodec(const AVCodec *codec)
Definition: codec_internal.h:317
av_frame_is_writable
int av_frame_is_writable(AVFrame *frame)
Check if the frame data is writable.
Definition: frame.c:533
AVCHROMA_LOC_UNSPECIFIED
@ AVCHROMA_LOC_UNSPECIFIED
Definition: pixfmt.h:681
AVCodecHWConfigInternal
Definition: hwconfig.h:29
frame.h
av_packet_unpack_dictionary
int av_packet_unpack_dictionary(const uint8_t *data, size_t size, AVDictionary **dict)
Unpack a dictionary from side_data.
Definition: avpacket.c:342
AVPacket::dts
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed.
Definition: packet.h:373
AVCodecContext::pts_correction_num_faulty_dts
int64_t pts_correction_num_faulty_dts
Number of incorrect PTS values so far.
Definition: avcodec.h:1764
AVCodecContext::pts_correction_last_pts
int64_t pts_correction_last_pts
Number of incorrect DTS values so far.
Definition: avcodec.h:1765
hwaccel_init
static int hwaccel_init(AVCodecContext *avctx, const AVCodecHWConfigInternal *hw_config)
Definition: decode.c:1068
AVPacketSideDataType
AVPacketSideDataType
Definition: packet.h:41
AV_PKT_DATA_CONTENT_LIGHT_LEVEL
@ AV_PKT_DATA_CONTENT_LIGHT_LEVEL
Content light level (based on CTA-861.3).
Definition: packet.h:236
AV_CHANNEL_ORDER_NATIVE
@ AV_CHANNEL_ORDER_NATIVE
The native channel order, i.e.
Definition: channel_layout.h:118
AVPacket::flags
int flags
A combination of AV_PKT_FLAG values.
Definition: packet.h:380
av_packet_alloc
AVPacket * av_packet_alloc(void)
Allocate an AVPacket and set its fields to default values.
Definition: avpacket.c:62
AVCodecInternal
Definition: internal.h:52
FFCodec::hw_configs
const struct AVCodecHWConfigInternal *const * hw_configs
Array of pointers to hardware configurations supported by the codec, or NULL if no hardware supported...
Definition: codec_internal.h:253
detect_colorspace
static int detect_colorspace(av_unused AVCodecContext *c, av_unused AVFrame *f)
Definition: decode.c:527
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:932
AV_LOG_INFO
#define AV_LOG_INFO
Standard information.
Definition: log.h:191
FF_THREAD_FRAME
#define FF_THREAD_FRAME
Decode more than one frame at once.
Definition: avcodec.h:1477
AV_FRAME_DATA_SKIP_SAMPLES
@ AV_FRAME_DATA_SKIP_SAMPLES
Recommmends skipping the specified number of samples.
Definition: frame.h:109
AVHWAccel::name
const char * name
Name of the hardware accelerated codec.
Definition: avcodec.h:2076
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:282
avcodec_send_packet
int attribute_align_arg avcodec_send_packet(AVCodecContext *avctx, const AVPacket *avpkt)
Supply raw packet data as input to a decoder.
Definition: decode.c:607
av_samples_copy
int av_samples_copy(uint8_t **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
FFCodec::caps_internal
unsigned caps_internal
Internal codec capabilities FF_CODEC_CAP_*.
Definition: codec_internal.h:128
extract_packet_props
static int extract_packet_props(AVCodecInternal *avci, const AVPacket *pkt)
Definition: decode.c:135
av_packet_copy_props
int av_packet_copy_props(AVPacket *dst, const AVPacket *src)
Copy only "properties" fields from src to dst.
Definition: avpacket.c:385
bprint.h
AV_FRAME_DATA_CONTENT_LIGHT_LEVEL
@ AV_FRAME_DATA_CONTENT_LIGHT_LEVEL
Content light level (based on CTA-861.3).
Definition: frame.h:137
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:269
AVPacket::pts
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: packet.h:367
AVCodecInternal::initial_width
int initial_width
Definition: internal.h:159
reget_buffer_internal
static int reget_buffer_internal(AVCodecContext *avctx, AVFrame *frame, int flags)
Definition: decode.c:1501
av_packet_get_side_data
uint8_t * av_packet_get_side_data(const AVPacket *pkt, enum AVPacketSideDataType type, size_t *size)
Get side information from packet.
Definition: avpacket.c:251
decode_receive_frame_internal
static int decode_receive_frame_internal(AVCodecContext *avctx, AVFrame *frame)
Definition: decode.c:549
internal.h
common.h
AVCodecInternal::in_pkt
AVPacket * in_pkt
This packet is used to hold the packet given to decoders implementing the .decode API; it is unused b...
Definition: internal.h:83
av_assert1
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
Definition: avassert.h:53
AV_PKT_DATA_A53_CC
@ AV_PKT_DATA_A53_CC
ATSC A53 Part 4 Closed Captions.
Definition: packet.h:243
AVCodecContext::pts_correction_last_dts
int64_t pts_correction_last_dts
PTS of the last frame.
Definition: avcodec.h:1766
ff_decode_preinit
int ff_decode_preinit(AVCodecContext *avctx)
Perform decoder initialization and validation.
Definition: decode.c:1546
AV_FRAME_DATA_STEREO3D
@ AV_FRAME_DATA_STEREO3D
Stereoscopic 3d metadata.
Definition: frame.h:64
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
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:516
av_frame_unref
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition: frame.c:487
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:264
av_inv_q
static av_always_inline AVRational av_inv_q(AVRational q)
Invert a rational.
Definition: rational.h:159
AVCodecContext::hw_device_ctx
AVBufferRef * hw_device_ctx
A reference to the AVHWDeviceContext describing the device which will be used by a hardware encoder/d...
Definition: avcodec.h:1933
AV_PKT_DATA_SKIP_SAMPLES
@ AV_PKT_DATA_SKIP_SAMPLES
Recommmends skipping the specified number of samples.
Definition: packet.h:157
AVCodecContext::chroma_sample_location
enum AVChromaLocation chroma_sample_location
This defines the location of chroma samples.
Definition: avcodec.h:989
FF_CODEC_CAP_SETS_PKT_DTS
#define FF_CODEC_CAP_SETS_PKT_DTS
Decoders marked with FF_CODEC_CAP_SETS_PKT_DTS want to set AVFrame.pkt_dts manually.
Definition: codec_internal.h:49
profile
int profile
Definition: mxfenc.c:2006
AVCOL_SPC_UNSPECIFIED
@ AVCOL_SPC_UNSPECIFIED
Definition: pixfmt.h:590
AVCodecContext::height
int height
Definition: avcodec.h:571
decode_simple_internal
static int decode_simple_internal(AVCodecContext *avctx, AVFrame *frame, int64_t *discarded_samples)
Definition: decode.c:255
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:608
AVCodecInternal::nb_draining_errors
int nb_draining_errors
Definition: internal.h:154
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:1883
avcodec.h
FFCodec::decode_sub
int(* decode_sub)(struct AVCodecContext *avctx, struct AVSubtitle *sub, int *got_frame_ptr, const struct AVPacket *avpkt)
Decode subtitle data to an AVSubtitle.
Definition: codec_internal.h:193
AVCodecContext::sub_charenc_mode
int sub_charenc_mode
Subtitles character encoding mode.
Definition: avcodec.h:1781
AVHWFramesContext
This struct describes a set or pool of "hardware" frames (i.e.
Definition: hwcontext.h:124
avcodec_get_hw_frames_parameters
int avcodec_get_hw_frames_parameters(AVCodecContext *avctx, AVBufferRef *device_ref, enum AVPixelFormat hw_pix_fmt, AVBufferRef **out_frames_ref)
Create and return a AVHWFramesContext with values adequate for hardware decoding.
Definition: decode.c:1019
ff_reget_buffer
int ff_reget_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Identical in function to ff_get_buffer(), except it reuses the existing buffer if available.
Definition: decode.c:1538
ret
ret
Definition: filter_design.txt:187
AVHWDeviceContext::type
enum AVHWDeviceType type
This field identifies the underlying API used for hardware access.
Definition: hwcontext.h:79
frame
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
Definition: filter_design.txt:264
AV_CODEC_HW_CONFIG_METHOD_AD_HOC
@ AV_CODEC_HW_CONFIG_METHOD_AD_HOC
The codec supports this format by some ad-hoc method.
Definition: codec.h:355
AVCodecContext::strict_std_compliance
int strict_std_compliance
strictly follow the standard (MPEG-4, ...).
Definition: avcodec.h:1310
AV_CODEC_PROP_TEXT_SUB
#define AV_CODEC_PROP_TEXT_SUB
Subtitle codec is text based.
Definition: codec_desc.h:102
AV_PKT_DATA_S12M_TIMECODE
@ AV_PKT_DATA_S12M_TIMECODE
Timecode which conforms to SMPTE ST 12-1:2014.
Definition: packet.h:292
AV_INPUT_BUFFER_PADDING_SIZE
#define AV_INPUT_BUFFER_PADDING_SIZE
Definition: defs.h:40
AV_RL32
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_RL32
Definition: bytestream.h:92
SIZE_SPECIFIER
#define SIZE_SPECIFIER
Definition: internal.h:150
apply_param_change
static int apply_param_change(AVCodecContext *avctx, const AVPacket *avpkt)
Definition: decode.c:52
ff_decode_frame_props
int ff_decode_frame_props(AVCodecContext *avctx, AVFrame *frame)
Set various frame properties from the codec context / packet data.
Definition: decode.c:1264
AV_FRAME_DATA_DYNAMIC_HDR_PLUS
@ AV_FRAME_DATA_DYNAMIC_HDR_PLUS
HDR dynamic metadata associated with a video frame.
Definition: frame.h:159
AVCodecContext
main external API structure.
Definition: avcodec.h:398
AVCodecContext::active_thread_type
int active_thread_type
Which multithreading methods are in use by the codec.
Definition: avcodec.h:1485
AVCodecContext::codec_descriptor
const AVCodecDescriptor * codec_descriptor
AVCodecDescriptor.
Definition: avcodec.h:1756
AV_FRAME_CROP_UNALIGNED
@ AV_FRAME_CROP_UNALIGNED
Apply the maximum possible cropping, even if it requires setting the AVFrame.data[] entries to unalig...
Definition: frame.h:929
channel_layout.h
AVRational::den
int den
Denominator.
Definition: rational.h:60
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:65
AVCodecContext::export_side_data
int export_side_data
Bit set of AV_CODEC_EXPORT_DATA_* flags, which affects the kind of metadata exported in frame,...
Definition: avcodec.h:2009
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:82
FF_CODEC_CB_TYPE_RECEIVE_FRAME
@ FF_CODEC_CB_TYPE_RECEIVE_FRAME
Definition: codec_internal.h:107
av_mul_q
AVRational av_mul_q(AVRational b, AVRational c)
Multiply two rationals.
Definition: rational.c:80
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:135
avcodec_get_hw_config
const AVCodecHWConfig * avcodec_get_hw_config(const AVCodec *codec, int index)
Retrieve supported hardware configurations for a codec.
Definition: utils.c:873
AVCodecInternal::buffer_frame
AVFrame * buffer_frame
Definition: internal.h:148
AV_CODEC_CAP_PARAM_CHANGE
#define AV_CODEC_CAP_PARAM_CHANGE
Codec supports changed parameters at any point.
Definition: codec.h:121
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:639
AVCodecInternal::draining
int draining
checks API usage: after codec draining, flush is required to resume operation
Definition: internal.h:142
FFCodec::bsfs
const char * bsfs
Decoding only, a comma-separated list of bitstream filters to apply to packets before decoding.
Definition: codec_internal.h:244
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:81
AVCodecContext::coded_width
int coded_width
Bitstream width / height, may be different from width/height e.g.
Definition: avcodec.h:586
AVHWFramesContext::initial_pool_size
int initial_pool_size
Initial size of the frame pool.
Definition: hwcontext.h:199
AVCodecContext::codec_type
enum AVMediaType codec_type
Definition: avcodec.h:406
AV_FRAME_FLAG_DISCARD
#define AV_FRAME_FLAG_DISCARD
A flag to mark the frames which need to be decoded, but shouldn't be output.
Definition: frame.h:563
desc
const char * desc
Definition: libsvtav1.c:83
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
av_bsf_list_parse_str
int av_bsf_list_parse_str(const char *str, AVBSFContext **bsf_lst)
Parse string describing list of bitstream filters and create single AVBSFContext describing the whole...
Definition: bsf.c:527
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:82
AV_CODEC_EXPORT_DATA_MVS
#define AV_CODEC_EXPORT_DATA_MVS
Export motion vectors through frame side data.
Definition: avcodec.h:357
AV_CODEC_CAP_SUBFRAMES
#define AV_CODEC_CAP_SUBFRAMES
Codec can output multiple frames per AVPacket Normally demuxers return one frame at a time,...
Definition: codec.h:100
ff_attach_decode_data
int ff_attach_decode_data(AVFrame *frame)
Definition: decode.c:1396
AVCodecInternal::initial_ch_layout
AVChannelLayout initial_ch_layout
Definition: internal.h:161
AVCodecContext::frame_number
int frame_number
Frame counter, set by libavcodec.
Definition: avcodec.h:1046
recode_subtitle
static int recode_subtitle(AVCodecContext *avctx, AVPacket **outpkt, AVPacket *inpkt, AVPacket *buf_pkt)
Definition: decode.c:753
AVFrameSideData
Structure to hold side data for an AVFrame.
Definition: frame.h:231
AVPixFmtDescriptor
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:69
AV_CODEC_FLAG2_EXPORT_MVS
#define AV_CODEC_FLAG2_EXPORT_MVS
Export motion vectors through frame side data.
Definition: avcodec.h:335
FFALIGN
#define FFALIGN(x, a)
Definition: macros.h:78
AVPacket
This structure stores compressed data.
Definition: packet.h:351
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:34
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
AVHWAccel::frame_params
int(* frame_params)(AVCodecContext *avctx, AVBufferRef *hw_frames_ctx)
Fill the given hw_frames context with current codec parameters.
Definition: avcodec.h:2217
AVPacket::pos
int64_t pos
byte position in stream, -1 if unknown
Definition: packet.h:394
AVCodecContext::reordered_opaque
int64_t reordered_opaque
opaque 64-bit number (generally a PTS) that will be reordered and output in AVFrame....
Definition: avcodec.h:1362
AVCodecContext::width
int width
picture width / height.
Definition: avcodec.h:571
bytestream.h
convert_header.str
string str
Definition: convert_header.py:20
FrameDecodeData::hwaccel_priv
void * hwaccel_priv
Per-frame private data for hwaccels.
Definition: decode.h:52
imgutils.h
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
hwcontext.h
AVERROR_BUG
#define AVERROR_BUG
Internal bug, also see AVERROR_BUG2.
Definition: error.h:52
AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX
@ AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX
The codec supports this format via the hw_device_ctx interface.
Definition: codec.h:326
AVCodecHWConfigInternal::hwaccel
const AVHWAccel * hwaccel
If this configuration uses a hwaccel, a pointer to it.
Definition: hwconfig.h:39
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
AVCodecHWConfig
Definition: codec.h:358
AVCodecContext::sw_pix_fmt
enum AVPixelFormat sw_pix_fmt
Nominal unaccelerated pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:1742
av_image_check_sar
int av_image_check_sar(unsigned int w, unsigned int h, AVRational sar)
Check if the given sample aspect ratio of an image is valid.
Definition: imgutils.c:323
avstring.h
ff_copy_palette
int ff_copy_palette(void *dst, const AVPacket *src, void *logctx)
Check whether the side-data of src contains a palette of size AVPALETTE_SIZE; if so,...
Definition: decode.c:1634
AVCodecHWConfigInternal::public
AVCodecHWConfig public
This is the structure which will be returned to the user by avcodec_get_hw_config().
Definition: hwconfig.h:34
decode_bsfs_init
static int decode_bsfs_init(AVCodecContext *avctx)
Definition: decode.c:148
int
int
Definition: ffmpeg_filter.c:156
AV_PIX_FMT_FLAG_PAL
#define AV_PIX_FMT_FLAG_PAL
Pixel format has a palette in data[1], values are indexes in this palette.
Definition: pixdesc.h:120
AVHWAccel::pix_fmt
enum AVPixelFormat pix_fmt
Supported pixel format.
Definition: avcodec.h:2097
AVCodecContext::sample_aspect_ratio
AVRational sample_aspect_ratio
sample aspect ratio (0 if unknown) That is the width of a pixel divided by the height of the pixel.
Definition: avcodec.h:768
FF_REGET_BUFFER_FLAG_READONLY
#define FF_REGET_BUFFER_FLAG_READONLY
the returned buffer does not need to be writable
Definition: decode.h:134
AVPacket::side_data_elems
int side_data_elems
Definition: packet.h:386
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:2778
FF_SUB_CHARENC_MODE_IGNORE
#define FF_SUB_CHARENC_MODE_IGNORE
neither convert the subtitles, nor check them for valid UTF-8
Definition: avcodec.h:1785
min
float min
Definition: vorbis_enc_data.h:429
intmath.h