FFmpeg
encode.c
Go to the documentation of this file.
1 /*
2  * generic encoding-related code
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #include "libavutil/attributes.h"
22 #include "libavutil/avassert.h"
23 #include "libavutil/frame.h"
24 #include "libavutil/imgutils.h"
25 #include "libavutil/internal.h"
26 #include "libavutil/samplefmt.h"
27 
28 #include "avcodec.h"
29 #include "encode.h"
30 #include "frame_thread_encoder.h"
31 #include "internal.h"
32 
33 int ff_alloc_packet2(AVCodecContext *avctx, AVPacket *avpkt, int64_t size, int64_t min_size)
34 {
36  av_log(avctx, AV_LOG_ERROR, "Invalid minimum required packet size %"PRId64" (max allowed is %d)\n",
37  size, INT_MAX - AV_INPUT_BUFFER_PADDING_SIZE);
38  return AVERROR(EINVAL);
39  }
40 
41  av_assert0(!avpkt->data);
42 
43  if (avctx && 2*min_size < size) { // FIXME The factor needs to be finetuned
45  avpkt->data = avctx->internal->byte_buffer;
46  avpkt->size = size;
47  }
48 
49  if (!avpkt->data) {
50  int ret = av_new_packet(avpkt, size);
51  if (ret < 0)
52  av_log(avctx, AV_LOG_ERROR, "Failed to allocate packet of size %"PRId64"\n", size);
53  return ret;
54  }
55 
56  return 0;
57 }
58 
59 /**
60  * Pad last frame with silence.
61  */
63 {
64  int ret;
65 
66  frame->format = src->format;
67  frame->channel_layout = src->channel_layout;
68  frame->channels = src->channels;
69  frame->nb_samples = s->frame_size;
70  ret = av_frame_get_buffer(frame, 0);
71  if (ret < 0)
72  goto fail;
73 
74  ret = av_frame_copy_props(frame, src);
75  if (ret < 0)
76  goto fail;
77 
78  if ((ret = av_samples_copy(frame->extended_data, src->extended_data, 0, 0,
79  src->nb_samples, s->channels, s->sample_fmt)) < 0)
80  goto fail;
81  if ((ret = av_samples_set_silence(frame->extended_data, src->nb_samples,
82  frame->nb_samples - src->nb_samples,
83  s->channels, s->sample_fmt)) < 0)
84  goto fail;
85 
86  return 0;
87 
88 fail:
89  av_frame_unref(frame);
90  return ret;
91 }
92 
93 int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
94  const AVSubtitle *sub)
95 {
96  int ret;
97  if (sub->start_display_time) {
98  av_log(avctx, AV_LOG_ERROR, "start_display_time must be 0.\n");
99  return -1;
100  }
101 
102  ret = avctx->codec->encode_sub(avctx, buf, buf_size, sub);
103  avctx->frame_number++;
104  return ret;
105 }
106 
108 {
109  AVCodecInternal *avci = avctx->internal;
110 
111  if (avci->draining)
112  return AVERROR_EOF;
113 
114  if (!avci->buffer_frame->buf[0])
115  return AVERROR(EAGAIN);
116 
117  av_frame_move_ref(frame, avci->buffer_frame);
118 
119  return 0;
120 }
121 
123 {
124  AVCodecInternal *avci = avctx->internal;
125  EncodeSimpleContext *es = &avci->es;
126  AVFrame *frame = es->in_frame;
127  int got_packet;
128  int ret;
129 
130  if (avci->draining_done)
131  return AVERROR_EOF;
132 
133  if (!frame->buf[0] && !avci->draining) {
134  av_frame_unref(frame);
135  ret = ff_encode_get_frame(avctx, frame);
136  if (ret < 0 && ret != AVERROR_EOF)
137  return ret;
138  }
139 
140  if (!frame->buf[0]) {
141  if (!(avctx->codec->capabilities & AV_CODEC_CAP_DELAY ||
143  return AVERROR_EOF;
144 
145  // Flushing is signaled with a NULL frame
146  frame = NULL;
147  }
148 
149  got_packet = 0;
150 
151  av_assert0(avctx->codec->encode2);
152 
153  if (CONFIG_FRAME_THREAD_ENCODER &&
155  ret = ff_thread_video_encode_frame(avctx, avpkt, frame, &got_packet);
156  else {
157  ret = avctx->codec->encode2(avctx, avpkt, frame, &got_packet);
158  if (avctx->codec->type == AVMEDIA_TYPE_VIDEO && !ret && got_packet &&
160  avpkt->pts = avpkt->dts = frame->pts;
161  }
162 
163  av_assert0(ret <= 0);
164 
165  emms_c();
166 
167  if (!ret && got_packet) {
168  if (avpkt->data) {
169  ret = av_packet_make_refcounted(avpkt);
170  if (ret < 0)
171  goto end;
172  }
173 
174  if (frame && !(avctx->codec->capabilities & AV_CODEC_CAP_DELAY)) {
175  if (avctx->codec->type == AVMEDIA_TYPE_AUDIO) {
176  if (avpkt->pts == AV_NOPTS_VALUE)
177  avpkt->pts = frame->pts;
178  if (!avpkt->duration)
179  avpkt->duration = ff_samples_to_time_base(avctx,
180  frame->nb_samples);
181  }
182  }
183  if (avctx->codec->type == AVMEDIA_TYPE_AUDIO) {
184  /* NOTE: if we add any audio encoders which output non-keyframe packets,
185  * this needs to be moved to the encoders, but for now we can do it
186  * here to simplify things */
187  avpkt->flags |= AV_PKT_FLAG_KEY;
188  avpkt->dts = avpkt->pts;
189  }
190  }
191 
192  if (avci->draining && !got_packet)
193  avci->draining_done = 1;
194 
195 end:
196  if (ret < 0 || !got_packet)
197  av_packet_unref(avpkt);
198 
199  if (frame) {
200  if (!ret)
201  avctx->frame_number++;
202  av_frame_unref(frame);
203  }
204 
205  if (got_packet)
206  // Encoders must always return ref-counted buffers.
207  // Side-data only packets have no data and can be not ref-counted.
208  av_assert0(!avpkt->data || avpkt->buf);
209 
210  return ret;
211 }
212 
214 {
215  int ret;
216 
217  while (!avpkt->data && !avpkt->side_data) {
218  ret = encode_simple_internal(avctx, avpkt);
219  if (ret < 0)
220  return ret;
221  }
222 
223  return 0;
224 }
225 
227 {
228  AVCodecInternal *avci = avctx->internal;
229  int ret;
230 
231  if (avci->draining_done)
232  return AVERROR_EOF;
233 
234  av_assert0(!avpkt->data && !avpkt->side_data);
235 
236  if (avctx->codec->type == AVMEDIA_TYPE_VIDEO) {
237  if ((avctx->flags & AV_CODEC_FLAG_PASS1) && avctx->stats_out)
238  avctx->stats_out[0] = '\0';
239  if (av_image_check_size2(avctx->width, avctx->height, avctx->max_pixels, AV_PIX_FMT_NONE, 0, avctx))
240  return AVERROR(EINVAL);
241  }
242 
243  if (avctx->codec->receive_packet) {
244  ret = avctx->codec->receive_packet(avctx, avpkt);
245  if (!ret)
246  // Encoders must always return ref-counted buffers.
247  // Side-data only packets have no data and can be not ref-counted.
248  av_assert0(!avpkt->data || avpkt->buf);
249  } else
250  ret = encode_simple_receive_packet(avctx, avpkt);
251 
252  if (ret == AVERROR_EOF)
253  avci->draining_done = 1;
254 
255  return ret;
256 }
257 
259 {
260  AVCodecInternal *avci = avctx->internal;
261  AVFrame *dst = avci->buffer_frame;
262  int ret;
263 
264  if (avctx->codec->type == AVMEDIA_TYPE_AUDIO) {
265  /* extract audio service type metadata */
267  if (sd && sd->size >= sizeof(enum AVAudioServiceType))
268  avctx->audio_service_type = *(enum AVAudioServiceType*)sd->data;
269 
270  /* check for valid frame size */
272  if (src->nb_samples > avctx->frame_size) {
273  av_log(avctx, AV_LOG_ERROR, "more samples than frame size\n");
274  return AVERROR(EINVAL);
275  }
276  } else if (!(avctx->codec->capabilities & AV_CODEC_CAP_VARIABLE_FRAME_SIZE)) {
277  /* if we already got an undersized frame, that must have been the last */
278  if (avctx->internal->last_audio_frame) {
279  av_log(avctx, AV_LOG_ERROR, "frame_size (%d) was not respected for a non-last frame\n", avctx->frame_size);
280  return AVERROR(EINVAL);
281  }
282 
283  if (src->nb_samples < avctx->frame_size) {
284  ret = pad_last_frame(avctx, dst, src);
285  if (ret < 0)
286  return ret;
287 
288  avctx->internal->last_audio_frame = 1;
289  } else if (src->nb_samples > avctx->frame_size) {
290  av_log(avctx, AV_LOG_ERROR, "nb_samples (%d) != frame_size (%d)\n", src->nb_samples, avctx->frame_size);
291  return AVERROR(EINVAL);
292  }
293  }
294  }
295 
296  if (!dst->data[0]) {
297  ret = av_frame_ref(dst, src);
298  if (ret < 0)
299  return ret;
300  }
301 
302  return 0;
303 }
304 
305 int attribute_align_arg avcodec_send_frame(AVCodecContext *avctx, const AVFrame *frame)
306 {
307  AVCodecInternal *avci = avctx->internal;
308  int ret;
309 
310  if (!avcodec_is_open(avctx) || !av_codec_is_encoder(avctx->codec))
311  return AVERROR(EINVAL);
312 
313  if (avci->draining)
314  return AVERROR_EOF;
315 
316  if (avci->buffer_frame->data[0])
317  return AVERROR(EAGAIN);
318 
319  if (!frame) {
320  avci->draining = 1;
321  } else {
322  ret = encode_send_frame_internal(avctx, frame);
323  if (ret < 0)
324  return ret;
325  }
326 
327  if (!avci->buffer_pkt->data && !avci->buffer_pkt->side_data) {
328  ret = encode_receive_packet_internal(avctx, avci->buffer_pkt);
329  if (ret < 0 && ret != AVERROR(EAGAIN) && ret != AVERROR_EOF)
330  return ret;
331  }
332 
333  return 0;
334 }
335 
336 int attribute_align_arg avcodec_receive_packet(AVCodecContext *avctx, AVPacket *avpkt)
337 {
338  AVCodecInternal *avci = avctx->internal;
339  int ret;
340 
341  av_packet_unref(avpkt);
342 
343  if (!avcodec_is_open(avctx) || !av_codec_is_encoder(avctx->codec))
344  return AVERROR(EINVAL);
345 
346  if (avci->buffer_pkt->data || avci->buffer_pkt->side_data) {
347  av_packet_move_ref(avpkt, avci->buffer_pkt);
348  } else {
349  ret = encode_receive_packet_internal(avctx, avpkt);
350  if (ret < 0)
351  return ret;
352  }
353 
354  return 0;
355 }
356 
357 static int compat_encode(AVCodecContext *avctx, AVPacket *avpkt,
358  int *got_packet, const AVFrame *frame)
359 {
360  AVCodecInternal *avci = avctx->internal;
361  AVPacket user_pkt;
362  int ret;
363 
364  *got_packet = 0;
365 
366  if (frame && avctx->codec->type == AVMEDIA_TYPE_VIDEO) {
367  if (frame->format == AV_PIX_FMT_NONE)
368  av_log(avctx, AV_LOG_WARNING, "AVFrame.format is not set\n");
369  if (frame->width == 0 || frame->height == 0)
370  av_log(avctx, AV_LOG_WARNING, "AVFrame.width or height is not set\n");
371  }
372 
373  ret = avcodec_send_frame(avctx, frame);
374  if (ret == AVERROR_EOF)
375  ret = 0;
376  else if (ret == AVERROR(EAGAIN)) {
377  /* we fully drain all the output in each encode call, so this should not
378  * ever happen */
379  return AVERROR_BUG;
380  } else if (ret < 0)
381  return ret;
382 
383  av_packet_move_ref(&user_pkt, avpkt);
384  while (ret >= 0) {
385  ret = avcodec_receive_packet(avctx, avpkt);
386  if (ret < 0) {
387  if (ret == AVERROR(EAGAIN) || ret == AVERROR_EOF)
388  ret = 0;
389  goto finish;
390  }
391 
392  if (avpkt != avci->compat_encode_packet) {
393  if (avpkt->data && user_pkt.data) {
394  if (user_pkt.size >= avpkt->size) {
395  memcpy(user_pkt.data, avpkt->data, avpkt->size);
396  av_buffer_unref(&avpkt->buf);
397  avpkt->buf = user_pkt.buf;
398  avpkt->data = user_pkt.data;
399  av_init_packet(&user_pkt);
400  } else {
401  av_log(avctx, AV_LOG_ERROR, "Provided packet is too small, needs to be %d\n", avpkt->size);
402  av_packet_unref(avpkt);
403  ret = AVERROR(EINVAL);
404  goto finish;
405  }
406  }
407 
408  *got_packet = 1;
409  avpkt = avci->compat_encode_packet;
410  } else {
411  if (!avci->compat_decode_warned) {
412  av_log(avctx, AV_LOG_WARNING, "The deprecated avcodec_encode_* "
413  "API cannot return all the packets for this encoder. "
414  "Some packets will be dropped. Update your code to the "
415  "new encoding API to fix this.\n");
416  avci->compat_decode_warned = 1;
417  av_packet_unref(avpkt);
418  }
419  }
420 
421  if (avci->draining)
422  break;
423  }
424 
425 finish:
426  if (ret < 0)
427  av_packet_unref(&user_pkt);
428 
429  return ret;
430 }
431 
432 int attribute_align_arg avcodec_encode_audio2(AVCodecContext *avctx,
433  AVPacket *avpkt,
434  const AVFrame *frame,
435  int *got_packet_ptr)
436 {
437  int ret = compat_encode(avctx, avpkt, got_packet_ptr, frame);
438 
439  if (ret < 0)
440  av_packet_unref(avpkt);
441 
442  return ret;
443 }
444 
445 int attribute_align_arg avcodec_encode_video2(AVCodecContext *avctx,
446  AVPacket *avpkt,
447  const AVFrame *frame,
448  int *got_packet_ptr)
449 {
450  int ret = compat_encode(avctx, avpkt, got_packet_ptr, frame);
451 
452  if (ret < 0)
453  av_packet_unref(avpkt);
454 
455  return ret;
456 }
static int compat_encode(AVCodecContext *avctx, AVPacket *avpkt, int *got_packet, const AVFrame *frame)
Definition: encode.c:357
#define NULL
Definition: coverity.c:32
const struct AVCodec * codec
Definition: avcodec.h:535
int(* receive_packet)(struct AVCodecContext *avctx, struct AVPacket *avpkt)
Encode API with decoupled frame/packet dataflow.
Definition: codec.h:289
int ff_thread_video_encode_frame(AVCodecContext *avctx, AVPacket *pkt, const AVFrame *frame, int *got_packet_ptr)
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:125
This structure describes decoded (raw) audio or video data.
Definition: frame.h:308
int av_codec_is_encoder(const AVCodec *codec)
Definition: utils.c:95
This side data must be associated with an audio frame and corresponds to enum AVAudioServiceType defi...
Definition: frame.h:113
misc image utilities
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:200
AVBufferRef * buf[AV_NUM_DATA_POINTERS]
AVBuffer references backing the data for this frame.
Definition: frame.h:499
int attribute_align_arg avcodec_receive_packet(AVCodecContext *avctx, AVPacket *avpkt)
Read encoded data from the encoder.
Definition: encode.c:336
int size
Definition: packet.h:356
int attribute_align_arg avcodec_encode_audio2(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
Encode a frame of audio.
Definition: encode.c:432
void av_fast_padded_malloc(void *ptr, unsigned int *size, size_t min_size)
Same behaviour av_fast_malloc but the buffer has additional AV_INPUT_BUFFER_PADDING_SIZE at the end w...
Definition: utils.c:71
void av_frame_move_ref(AVFrame *dst, AVFrame *src)
Move everything contained in src to dst and reset src.
Definition: frame.c:583
enum AVMediaType type
Definition: codec.h:203
Macro definitions for various function/variable attributes.
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Definition: frame.c:739
enum AVAudioServiceType audio_service_type
Type of service that the audio stream conveys.
Definition: avcodec.h:1251
#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:75
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
int ff_alloc_packet2(AVCodecContext *avctx, AVPacket *avpkt, int64_t size, int64_t min_size)
Check AVPacket size and/or allocate data.
Definition: encode.c:33
enum AVSampleFormat sample_fmt
audio sample format
Definition: avcodec.h:1194
uint8_t
static av_cold int end(AVCodecContext *avctx)
Definition: avrndec.c:90
int64_t duration
Duration of this packet in AVStream->time_base units, 0 if unknown.
Definition: packet.h:373
int av_frame_ref(AVFrame *dst, const AVFrame *src)
Set up a new reference to the data described by the source frame.
Definition: frame.c:444
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:401
int(* encode2)(struct AVCodecContext *avctx, struct AVPacket *avpkt, const struct AVFrame *frame, int *got_packet_ptr)
Encode data to an AVPacket.
Definition: codec.h:280
static int encode_send_frame_internal(AVCodecContext *avctx, const AVFrame *src)
Definition: encode.c:258
void * frame_thread_encoder
Definition: internal.h:155
Structure to hold side data for an AVFrame.
Definition: frame.h:214
static void finish(void)
Definition: movenc.c:345
uint8_t * data
Definition: packet.h:355
void av_packet_move_ref(AVPacket *dst, AVPacket *src)
Move every field in src to dst and reset src.
Definition: avpacket.c:663
#define AVERROR_EOF
End of file.
Definition: error.h:55
ptrdiff_t size
Definition: opengl_enc.c:100
char * stats_out
pass1 encoding statistics output buffer
Definition: avcodec.h:1545
#define av_log(a,...)
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
Definition: packet.h:388
static int encode_simple_internal(AVCodecContext *avctx, AVPacket *avpkt)
Definition: encode.c:122
#define src
Definition: vp8dsp.c:254
int av_new_packet(AVPacket *pkt, int size)
Allocate the payload of a packet and initialize its fields with default values.
Definition: avpacket.c:88
int width
Definition: frame.h:366
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:194
int av_samples_set_silence(uint8_t **audio_data, int offset, int nb_samples, int nb_channels, enum AVSampleFormat sample_fmt)
Fill an audio buffer with silence.
Definition: samplefmt.c:237
AVAudioServiceType
Definition: avcodec.h:239
AVFrame * in_frame
Definition: internal.h:116
int active_thread_type
Which multithreading methods are in use by the codec.
Definition: avcodec.h:1804
int avcodec_is_open(AVCodecContext *s)
Definition: utils.c:1926
AVFrame * buffer_frame
Definition: internal.h:178
int capabilities
Codec capabilities.
Definition: codec.h:209
AVBufferRef * buf
A reference to the reference-counted buffer where the packet data is stored.
Definition: packet.h:338
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:606
simple assert() macros that are a bit more flexible than ISO C assert().
int64_t max_pixels
The number of pixels per image to maximally accept.
Definition: avcodec.h:2256
#define fail()
Definition: checkasm.h:123
#define AV_CODEC_CAP_VARIABLE_FRAME_SIZE
Audio encoder supports receiving a different number of samples in each call.
Definition: codec.h:122
int flags
A combination of AV_PKT_FLAG values.
Definition: packet.h:361
reference-counted frame API
uint64_t channel_layout
Channel layout of the audio data.
Definition: frame.h:485
common internal API header
int channels
number of audio channels, only used for audio.
Definition: frame.h:614
#define FF_THREAD_FRAME
Decode more than one frame at once.
Definition: avcodec.h:1796
#define AV_CODEC_CAP_SMALL_LAST_FRAME
Codec can be fed a final frame with a smaller size.
Definition: codec.h:80
int width
picture width / height.
Definition: avcodec.h:699
int av_packet_make_refcounted(AVPacket *pkt)
Ensure the data described by a given packet is reference counted.
Definition: avpacket.c:671
#define AV_CODEC_FLAG_PASS1
Use internal 2pass ratecontrol in first pass mode.
Definition: avcodec.h:296
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
#define s(width, name)
Definition: cbs_vp9.c:257
int draining
checks API usage: after codec draining, flush is required to resume operation
Definition: internal.h:172
if(ret)
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames...
Definition: frame.h:381
int frame_size
Number of samples per channel in an audio frame.
Definition: avcodec.h:1206
static int encode_receive_packet_internal(AVCodecContext *avctx, AVPacket *avpkt)
Definition: encode.c:226
Libavcodec external API header.
int compat_decode_warned
Definition: internal.h:180
EncodeSimpleContext es
Definition: internal.h:157
main external API structure.
Definition: avcodec.h:526
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
Definition: avpacket.c:605
uint8_t * data
Definition: frame.h:216
int attribute_align_arg avcodec_send_frame(AVCodecContext *avctx, const AVFrame *frame)
Supply a raw video or audio frame to the encoder.
Definition: encode.c:305
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:213
#define AVERROR_BUG
Internal bug, also see AVERROR_BUG2.
Definition: error.h:50
AVPacket * compat_encode_packet
Definition: internal.h:188
int attribute_align_arg avcodec_encode_video2(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
Encode a frame of video.
Definition: encode.c:445
int av_frame_get_buffer(AVFrame *frame, int align)
Allocate new buffer(s) for audio or video data.
Definition: frame.c:325
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition: frame.c:554
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:322
AVPacket * buffer_pkt
buffers for using new encode/decode API through legacy API
Definition: internal.h:177
AVPacketSideData * side_data
Additional packet data that can be provided by the container.
Definition: packet.h:366
common internal api header.
int(* encode_sub)(struct AVCodecContext *, uint8_t *buf, int buf_size, const struct AVSubtitle *sub)
Definition: codec.h:268
uint32_t start_display_time
Definition: avcodec.h:2696
void av_init_packet(AVPacket *pkt)
Initialize optional fields of a packet with default values.
Definition: avpacket.c:35
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:253
#define AV_INPUT_BUFFER_PADDING_SIZE
Required number of additionally allocated bytes at the end of the input bitstream for decoding...
Definition: avcodec.h:215
static int pad_last_frame(AVCodecContext *s, AVFrame *frame, const AVFrame *src)
Pad last frame with silence.
Definition: encode.c:62
int channels
number of audio channels
Definition: avcodec.h:1187
struct AVCodecInternal * internal
Private context used for internal data.
Definition: avcodec.h:561
unsigned int byte_buffer_size
Definition: internal.h:153
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed...
Definition: packet.h:354
int frame_number
Frame counter, set by libavcodec.
Definition: avcodec.h:1217
int height
Definition: frame.h:366
static av_always_inline int64_t ff_samples_to_time_base(AVCodecContext *avctx, int64_t samples)
Rescale from sample rate to AVCodecContext.time_base.
Definition: internal.h:261
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
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:355
static int encode_simple_receive_packet(AVCodecContext *avctx, AVPacket *avpkt)
Definition: encode.c:213
This structure stores compressed data.
Definition: packet.h:332
uint8_t * byte_buffer
temporary buffer used for encoders to store their bitstream
Definition: internal.h:152
int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size, const AVSubtitle *sub)
Definition: encode.c:93
int nb_samples
number of audio samples (per channel) described by this frame
Definition: frame.h:374
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: packet.h:348
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:659
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
int ff_encode_get_frame(AVCodecContext *avctx, AVFrame *frame)
Called by encoders to get the next frame for encoding.
Definition: encode.c:107
int last_audio_frame
An audio frame with less than required samples has been submitted and padded with silence...
Definition: internal.h:132