FFmpeg
packet.h
Go to the documentation of this file.
1 /*
2  * AVPacket public API
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 #ifndef AVCODEC_PACKET_H
22 #define AVCODEC_PACKET_H
23 
24 #include <stddef.h>
25 #include <stdint.h>
26 
27 #include "libavutil/attributes.h"
28 #include "libavutil/buffer.h"
29 #include "libavutil/dict.h"
30 #include "libavutil/rational.h"
31 #include "libavutil/version.h"
32 
34 
35 /**
36  * @defgroup lavc_packet AVPacket
37  *
38  * Types and functions for working with AVPacket.
39  * @{
40  */
42  /**
43  * An AV_PKT_DATA_PALETTE side data packet contains exactly AVPALETTE_SIZE
44  * bytes worth of palette. This side data signals that a new palette is
45  * present.
46  */
48 
49  /**
50  * The AV_PKT_DATA_NEW_EXTRADATA is used to notify the codec or the format
51  * that the extradata buffer was changed and the receiving side should
52  * act upon it appropriately. The new extradata is embedded in the side
53  * data buffer and should be immediately used for processing the current
54  * frame or packet.
55  */
57 
58  /**
59  * An AV_PKT_DATA_PARAM_CHANGE side data packet is laid out as follows:
60  * @code
61  * u32le param_flags
62  * if (param_flags & AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_COUNT)
63  * s32le channel_count
64  * if (param_flags & AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_LAYOUT)
65  * u64le channel_layout
66  * if (param_flags & AV_SIDE_DATA_PARAM_CHANGE_SAMPLE_RATE)
67  * s32le sample_rate
68  * if (param_flags & AV_SIDE_DATA_PARAM_CHANGE_DIMENSIONS)
69  * s32le width
70  * s32le height
71  * @endcode
72  */
74 
75  /**
76  * An AV_PKT_DATA_H263_MB_INFO side data packet contains a number of
77  * structures with info about macroblocks relevant to splitting the
78  * packet into smaller packets on macroblock edges (e.g. as for RFC 2190).
79  * That is, it does not necessarily contain info about all macroblocks,
80  * as long as the distance between macroblocks in the info is smaller
81  * than the target payload size.
82  * Each MB info structure is 12 bytes, and is laid out as follows:
83  * @code
84  * u32le bit offset from the start of the packet
85  * u8 current quantizer at the start of the macroblock
86  * u8 GOB number
87  * u16le macroblock address within the GOB
88  * u8 horizontal MV predictor
89  * u8 vertical MV predictor
90  * u8 horizontal MV predictor for block number 3
91  * u8 vertical MV predictor for block number 3
92  * @endcode
93  */
95 
96  /**
97  * This side data should be associated with an audio stream and contains
98  * ReplayGain information in form of the AVReplayGain struct.
99  */
101 
102  /**
103  * This side data contains a 3x3 transformation matrix describing an affine
104  * transformation that needs to be applied to the decoded video frames for
105  * correct presentation.
106  *
107  * See libavutil/display.h for a detailed description of the data.
108  */
110 
111  /**
112  * This side data should be associated with a video stream and contains
113  * Stereoscopic 3D information in form of the AVStereo3D struct.
114  */
116 
117  /**
118  * This side data should be associated with an audio stream and corresponds
119  * to enum AVAudioServiceType.
120  */
122 
123  /**
124  * This side data contains quality related information from the encoder.
125  * @code
126  * u32le quality factor of the compressed frame. Allowed range is between 1 (good) and FF_LAMBDA_MAX (bad).
127  * u8 picture type
128  * u8 error count
129  * u16 reserved
130  * u64le[error count] sum of squared differences between encoder in and output
131  * @endcode
132  */
134 
135  /**
136  * This side data contains an integer value representing the stream index
137  * of a "fallback" track. A fallback track indicates an alternate
138  * track to use when the current track can not be decoded for some reason.
139  * e.g. no decoder available for codec.
140  */
142 
143  /**
144  * This side data corresponds to the AVCPBProperties struct.
145  */
147 
148  /**
149  * Recommmends skipping the specified number of samples
150  * @code
151  * u32le number of samples to skip from start of this packet
152  * u32le number of samples to skip from end of this packet
153  * u8 reason for start skip
154  * u8 reason for end skip (0=padding silence, 1=convergence)
155  * @endcode
156  */
158 
159  /**
160  * An AV_PKT_DATA_JP_DUALMONO side data packet indicates that
161  * the packet may contain "dual mono" audio specific to Japanese DTV
162  * and if it is true, recommends only the selected channel to be used.
163  * @code
164  * u8 selected channels (0=mail/left, 1=sub/right, 2=both)
165  * @endcode
166  */
168 
169  /**
170  * A list of zero terminated key/value strings. There is no end marker for
171  * the list, so it is required to rely on the side data size to stop.
172  */
174 
175  /**
176  * Subtitle event position
177  * @code
178  * u32le x1
179  * u32le y1
180  * u32le x2
181  * u32le y2
182  * @endcode
183  */
185 
186  /**
187  * Data found in BlockAdditional element of matroska container. There is
188  * no end marker for the data, so it is required to rely on the side data
189  * size to recognize the end. 8 byte id (as found in BlockAddId) followed
190  * by data.
191  */
193 
194  /**
195  * The optional first identifier line of a WebVTT cue.
196  */
198 
199  /**
200  * The optional settings (rendering instructions) that immediately
201  * follow the timestamp specifier of a WebVTT cue.
202  */
204 
205  /**
206  * A list of zero terminated key/value strings. There is no end marker for
207  * the list, so it is required to rely on the side data size to stop. This
208  * side data includes updated metadata which appeared in the stream.
209  */
211 
212  /**
213  * MPEGTS stream ID as uint8_t, this is required to pass the stream ID
214  * information from the demuxer to the corresponding muxer.
215  */
217 
218  /**
219  * Mastering display metadata (based on SMPTE-2086:2014). This metadata
220  * should be associated with a video stream and contains data in the form
221  * of the AVMasteringDisplayMetadata struct.
222  */
224 
225  /**
226  * This side data should be associated with a video stream and corresponds
227  * to the AVSphericalMapping structure.
228  */
230 
231  /**
232  * Content light level (based on CTA-861.3). This metadata should be
233  * associated with a video stream and contains data in the form of the
234  * AVContentLightMetadata struct.
235  */
237 
238  /**
239  * ATSC A53 Part 4 Closed Captions. This metadata should be associated with
240  * a video stream. A53 CC bitstream is stored as uint8_t in AVPacketSideData.data.
241  * The number of bytes of CC data is AVPacketSideData.size.
242  */
244 
245  /**
246  * This side data is encryption initialization data.
247  * The format is not part of ABI, use av_encryption_init_info_* methods to
248  * access.
249  */
251 
252  /**
253  * This side data contains encryption info for how to decrypt the packet.
254  * The format is not part of ABI, use av_encryption_info_* methods to access.
255  */
257 
258  /**
259  * Active Format Description data consisting of a single byte as specified
260  * in ETSI TS 101 154 using AVActiveFormatDescription enum.
261  */
263 
264  /**
265  * Producer Reference Time data corresponding to the AVProducerReferenceTime struct,
266  * usually exported by some encoders (on demand through the prft flag set in the
267  * AVCodecContext export_side_data field).
268  */
270 
271  /**
272  * ICC profile data consisting of an opaque octet buffer following the
273  * format described by ISO 15076-1.
274  */
276 
277  /**
278  * DOVI configuration
279  * ref:
280  * dolby-vision-bitstreams-within-the-iso-base-media-file-format-v2.1.2, section 2.2
281  * dolby-vision-bitstreams-in-mpeg-2-transport-stream-multiplex-v1.2, section 3.3
282  * Tags are stored in struct AVDOVIDecoderConfigurationRecord.
283  */
285 
286  /**
287  * Timecode which conforms to SMPTE ST 12-1:2014. The data is an array of 4 uint32_t
288  * where the first uint32_t describes how many (1-3) of the other timecodes are used.
289  * The timecode format is described in the documentation of av_timecode_get_smpte_from_framenum()
290  * function in libavutil/timecode.h.
291  */
293 
294  /**
295  * HDR10+ dynamic metadata associated with a video frame. The metadata is in
296  * the form of the AVDynamicHDRPlus struct and contains
297  * information for color volume transform - application 4 of
298  * SMPTE 2094-40:2016 standard.
299  */
301 
302  /**
303  * The number of side data types.
304  * This is not part of the public API/ABI in the sense that it may
305  * change when new side data types are added.
306  * This must stay the last enum value.
307  * If its value becomes huge, some code using it
308  * needs to be updated as it assumes it to be smaller than other limits.
309  */
311 };
312 
313 #define AV_PKT_DATA_QUALITY_FACTOR AV_PKT_DATA_QUALITY_STATS //DEPRECATED
314 
315 typedef struct AVPacketSideData {
316  uint8_t *data;
317  size_t size;
320 
321 /**
322  * This structure stores compressed data. It is typically exported by demuxers
323  * and then passed as input to decoders, or received as output from encoders and
324  * then passed to muxers.
325  *
326  * For video, it should typically contain one compressed frame. For audio it may
327  * contain several compressed frames. Encoders are allowed to output empty
328  * packets, with no compressed data, containing only side data
329  * (e.g. to update some stream parameters at the end of encoding).
330  *
331  * The semantics of data ownership depends on the buf field.
332  * If it is set, the packet data is dynamically allocated and is
333  * valid indefinitely until a call to av_packet_unref() reduces the
334  * reference count to 0.
335  *
336  * If the buf field is not set av_packet_ref() would make a copy instead
337  * of increasing the reference count.
338  *
339  * The side data is always allocated with av_malloc(), copied by
340  * av_packet_ref() and freed by av_packet_unref().
341  *
342  * sizeof(AVPacket) being a part of the public ABI is deprecated. once
343  * av_init_packet() is removed, new packets will only be able to be allocated
344  * with av_packet_alloc(), and new fields may be added to the end of the struct
345  * with a minor bump.
346  *
347  * @see av_packet_alloc
348  * @see av_packet_ref
349  * @see av_packet_unref
350  */
351 typedef struct AVPacket {
352  /**
353  * A reference to the reference-counted buffer where the packet data is
354  * stored.
355  * May be NULL, then the packet data is not reference-counted.
356  */
358  /**
359  * Presentation timestamp in AVStream->time_base units; the time at which
360  * the decompressed packet will be presented to the user.
361  * Can be AV_NOPTS_VALUE if it is not stored in the file.
362  * pts MUST be larger or equal to dts as presentation cannot happen before
363  * decompression, unless one wants to view hex dumps. Some formats misuse
364  * the terms dts and pts/cts to mean something different. Such timestamps
365  * must be converted to true pts/dts before they are stored in AVPacket.
366  */
367  int64_t pts;
368  /**
369  * Decompression timestamp in AVStream->time_base units; the time at which
370  * the packet is decompressed.
371  * Can be AV_NOPTS_VALUE if it is not stored in the file.
372  */
373  int64_t dts;
374  uint8_t *data;
375  int size;
377  /**
378  * A combination of AV_PKT_FLAG values
379  */
380  int flags;
381  /**
382  * Additional packet data that can be provided by the container.
383  * Packet can contain several types of side information.
384  */
387 
388  /**
389  * Duration of this packet in AVStream->time_base units, 0 if unknown.
390  * Equals next_pts - this_pts in presentation order.
391  */
392  int64_t duration;
393 
394  int64_t pos; ///< byte position in stream, -1 if unknown
395 
396  /**
397  * for some private data of the user
398  */
399  void *opaque;
400 
401  /**
402  * AVBufferRef for free use by the API user. FFmpeg will never check the
403  * contents of the buffer ref. FFmpeg calls av_buffer_unref() on it when
404  * the packet is unreferenced. av_packet_copy_props() calls create a new
405  * reference with av_buffer_ref() for the target packet's opaque_ref field.
406  *
407  * This is unrelated to the opaque field, although it serves a similar
408  * purpose.
409  */
411 
412  /**
413  * Time base of the packet's timestamps.
414  * In the future, this field may be set on packets output by encoders or
415  * demuxers, but its value will be by default ignored on input to decoders
416  * or muxers.
417  */
419 } AVPacket;
420 
421 #if FF_API_INIT_PACKET
423 typedef struct AVPacketList {
424  AVPacket pkt;
425  struct AVPacketList *next;
426 } AVPacketList;
427 #endif
428 
429 #define AV_PKT_FLAG_KEY 0x0001 ///< The packet contains a keyframe
430 #define AV_PKT_FLAG_CORRUPT 0x0002 ///< The packet content is corrupted
431 /**
432  * Flag is used to discard packets which are required to maintain valid
433  * decoder state but are not required for output and should be dropped
434  * after decoding.
435  **/
436 #define AV_PKT_FLAG_DISCARD 0x0004
437 /**
438  * The packet comes from a trusted source.
439  *
440  * Otherwise-unsafe constructs such as arbitrary pointers to data
441  * outside the packet may be followed.
442  */
443 #define AV_PKT_FLAG_TRUSTED 0x0008
444 /**
445  * Flag is used to indicate packets that contain frames that can
446  * be discarded by the decoder. I.e. Non-reference frames.
447  */
448 #define AV_PKT_FLAG_DISPOSABLE 0x0010
449 
451 #if FF_API_OLD_CHANNEL_LAYOUT
452  /**
453  * @deprecated those are not used by any decoder
454  */
455  AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_COUNT = 0x0001,
456  AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_LAYOUT = 0x0002,
457 #endif
460 };
461 
462 /**
463  * Allocate an AVPacket and set its fields to default values. The resulting
464  * struct must be freed using av_packet_free().
465  *
466  * @return An AVPacket filled with default values or NULL on failure.
467  *
468  * @note this only allocates the AVPacket itself, not the data buffers. Those
469  * must be allocated through other means such as av_new_packet.
470  *
471  * @see av_new_packet
472  */
474 
475 /**
476  * Create a new packet that references the same data as src.
477  *
478  * This is a shortcut for av_packet_alloc()+av_packet_ref().
479  *
480  * @return newly created AVPacket on success, NULL on error.
481  *
482  * @see av_packet_alloc
483  * @see av_packet_ref
484  */
486 
487 /**
488  * Free the packet, if the packet is reference counted, it will be
489  * unreferenced first.
490  *
491  * @param pkt packet to be freed. The pointer will be set to NULL.
492  * @note passing NULL is a no-op.
493  */
494 void av_packet_free(AVPacket **pkt);
495 
496 #if FF_API_INIT_PACKET
497 /**
498  * Initialize optional fields of a packet with default values.
499  *
500  * Note, this does not touch the data and size members, which have to be
501  * initialized separately.
502  *
503  * @param pkt packet
504  *
505  * @see av_packet_alloc
506  * @see av_packet_unref
507  *
508  * @deprecated This function is deprecated. Once it's removed,
509  sizeof(AVPacket) will not be a part of the ABI anymore.
510  */
512 void av_init_packet(AVPacket *pkt);
513 #endif
514 
515 /**
516  * Allocate the payload of a packet and initialize its fields with
517  * default values.
518  *
519  * @param pkt packet
520  * @param size wanted payload size
521  * @return 0 if OK, AVERROR_xxx otherwise
522  */
523 int av_new_packet(AVPacket *pkt, int size);
524 
525 /**
526  * Reduce packet size, correctly zeroing padding
527  *
528  * @param pkt packet
529  * @param size new size
530  */
531 void av_shrink_packet(AVPacket *pkt, int size);
532 
533 /**
534  * Increase packet size, correctly zeroing padding
535  *
536  * @param pkt packet
537  * @param grow_by number of bytes by which to increase the size of the packet
538  */
539 int av_grow_packet(AVPacket *pkt, int grow_by);
540 
541 /**
542  * Initialize a reference-counted packet from av_malloc()ed data.
543  *
544  * @param pkt packet to be initialized. This function will set the data, size,
545  * and buf fields, all others are left untouched.
546  * @param data Data allocated by av_malloc() to be used as packet data. If this
547  * function returns successfully, the data is owned by the underlying AVBuffer.
548  * The caller may not access the data through other means.
549  * @param size size of data in bytes, without the padding. I.e. the full buffer
550  * size is assumed to be size + AV_INPUT_BUFFER_PADDING_SIZE.
551  *
552  * @return 0 on success, a negative AVERROR on error
553  */
554 int av_packet_from_data(AVPacket *pkt, uint8_t *data, int size);
555 
556 /**
557  * Allocate new information of a packet.
558  *
559  * @param pkt packet
560  * @param type side information type
561  * @param size side information size
562  * @return pointer to fresh allocated data or NULL otherwise
563  */
565  size_t size);
566 
567 /**
568  * Wrap an existing array as a packet side data.
569  *
570  * @param pkt packet
571  * @param type side information type
572  * @param data the side data array. It must be allocated with the av_malloc()
573  * family of functions. The ownership of the data is transferred to
574  * pkt.
575  * @param size side information size
576  * @return a non-negative number on success, a negative AVERROR code on
577  * failure. On failure, the packet is unchanged and the data remains
578  * owned by the caller.
579  */
581  uint8_t *data, size_t size);
582 
583 /**
584  * Shrink the already allocated side data buffer
585  *
586  * @param pkt packet
587  * @param type side information type
588  * @param size new side information size
589  * @return 0 on success, < 0 on failure
590  */
592  size_t size);
593 
594 /**
595  * Get side information from packet.
596  *
597  * @param pkt packet
598  * @param type desired side information type
599  * @param size If supplied, *size will be set to the size of the side data
600  * or to zero if the desired side data is not present.
601  * @return pointer to data if present or NULL otherwise
602  */
604  size_t *size);
605 
607 
608 /**
609  * Pack a dictionary for use in side_data.
610  *
611  * @param dict The dictionary to pack.
612  * @param size pointer to store the size of the returned data
613  * @return pointer to data if successful, NULL otherwise
614  */
615 uint8_t *av_packet_pack_dictionary(AVDictionary *dict, size_t *size);
616 /**
617  * Unpack a dictionary from side_data.
618  *
619  * @param data data from side_data
620  * @param size size of the data
621  * @param dict the metadata storage dictionary
622  * @return 0 on success, < 0 on failure
623  */
624 int av_packet_unpack_dictionary(const uint8_t *data, size_t size,
625  AVDictionary **dict);
626 
627 /**
628  * Convenience function to free all the side data stored.
629  * All the other fields stay untouched.
630  *
631  * @param pkt packet
632  */
634 
635 /**
636  * Setup a new reference to the data described by a given packet
637  *
638  * If src is reference-counted, setup dst as a new reference to the
639  * buffer in src. Otherwise allocate a new buffer in dst and copy the
640  * data from src into it.
641  *
642  * All the other fields are copied from src.
643  *
644  * @see av_packet_unref
645  *
646  * @param dst Destination packet. Will be completely overwritten.
647  * @param src Source packet
648  *
649  * @return 0 on success, a negative AVERROR on error. On error, dst
650  * will be blank (as if returned by av_packet_alloc()).
651  */
652 int av_packet_ref(AVPacket *dst, const AVPacket *src);
653 
654 /**
655  * Wipe the packet.
656  *
657  * Unreference the buffer referenced by the packet and reset the
658  * remaining packet fields to their default values.
659  *
660  * @param pkt The packet to be unreferenced.
661  */
663 
664 /**
665  * Move every field in src to dst and reset src.
666  *
667  * @see av_packet_unref
668  *
669  * @param src Source packet, will be reset
670  * @param dst Destination packet
671  */
673 
674 /**
675  * Copy only "properties" fields from src to dst.
676  *
677  * Properties for the purpose of this function are all the fields
678  * beside those related to the packet data (buf, data, size)
679  *
680  * @param dst Destination packet
681  * @param src Source packet
682  *
683  * @return 0 on success AVERROR on failure.
684  */
685 int av_packet_copy_props(AVPacket *dst, const AVPacket *src);
686 
687 /**
688  * Ensure the data described by a given packet is reference counted.
689  *
690  * @note This function does not ensure that the reference will be writable.
691  * Use av_packet_make_writable instead for that purpose.
692  *
693  * @see av_packet_ref
694  * @see av_packet_make_writable
695  *
696  * @param pkt packet whose data should be made reference counted.
697  *
698  * @return 0 on success, a negative AVERROR on error. On failure, the
699  * packet is unchanged.
700  */
702 
703 /**
704  * Create a writable reference for the data described by a given packet,
705  * avoiding data copy if possible.
706  *
707  * @param pkt Packet whose data should be made writable.
708  *
709  * @return 0 on success, a negative AVERROR on failure. On failure, the
710  * packet is unchanged.
711  */
713 
714 /**
715  * Convert valid timing fields (timestamps / durations) in a packet from one
716  * timebase to another. Timestamps with unknown values (AV_NOPTS_VALUE) will be
717  * ignored.
718  *
719  * @param pkt packet on which the conversion will be performed
720  * @param tb_src source timebase, in which the timing fields in pkt are
721  * expressed
722  * @param tb_dst destination timebase, to which the timing fields will be
723  * converted
724  */
725 void av_packet_rescale_ts(AVPacket *pkt, AVRational tb_src, AVRational tb_dst);
726 
727 /**
728  * @}
729  */
730 
731 #endif // AVCODEC_PACKET_H
av_packet_unref
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
Definition: avpacket.c:422
AV_PKT_DATA_NB
@ AV_PKT_DATA_NB
The number of side data types.
Definition: packet.h:310
AV_PKT_DATA_MPEGTS_STREAM_ID
@ AV_PKT_DATA_MPEGTS_STREAM_ID
MPEGTS stream ID as uint8_t, this is required to pass the stream ID information from the demuxer to t...
Definition: packet.h:216
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
rational.h
av_grow_packet
int av_grow_packet(AVPacket *pkt, int grow_by)
Increase packet size, correctly zeroing padding.
Definition: avpacket.c:120
AV_PKT_DATA_ENCRYPTION_INFO
@ AV_PKT_DATA_ENCRYPTION_INFO
This side data contains encryption info for how to decrypt the packet.
Definition: packet.h:256
AVPacketSideData
Definition: packet.h:315
AVPacket::data
uint8_t * data
Definition: packet.h:374
av_packet_shrink_side_data
int av_packet_shrink_side_data(AVPacket *pkt, enum AVPacketSideDataType type, size_t size)
Shrink the already allocated side data buffer.
Definition: avpacket.c:369
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
version_major.h
AV_PKT_DATA_ENCRYPTION_INIT_INFO
@ AV_PKT_DATA_ENCRYPTION_INIT_INFO
This side data is encryption initialization data.
Definition: packet.h:250
AV_SIDE_DATA_PARAM_CHANGE_SAMPLE_RATE
@ AV_SIDE_DATA_PARAM_CHANGE_SAMPLE_RATE
Definition: packet.h:458
AV_PKT_DATA_AFD
@ AV_PKT_DATA_AFD
Active Format Description data consisting of a single byte as specified in ETSI TS 101 154 using AVAc...
Definition: packet.h:262
AVPacket::duration
int64_t duration
Duration of this packet in AVStream->time_base units, 0 if unknown.
Definition: packet.h:392
AVDictionary
Definition: dict.c:31
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
av_packet_free_side_data
void av_packet_free_side_data(AVPacket *pkt)
Convenience function to free all the side data stored.
Definition: avpacket.c:187
av_packet_free
void av_packet_free(AVPacket **pkt)
Free the packet, if the packet is reference counted, it will be unreferenced first.
Definition: avpacket.c:73
AVPacketSideData::size
size_t size
Definition: packet.h:317
av_packet_add_side_data
int av_packet_add_side_data(AVPacket *pkt, enum AVPacketSideDataType type, uint8_t *data, size_t size)
Wrap an existing array as a packet side data.
Definition: avpacket.c:196
AVPacket::opaque_ref
AVBufferRef * opaque_ref
AVBufferRef for free use by the API user.
Definition: packet.h:410
av_shrink_packet
void av_shrink_packet(AVPacket *pkt, int size)
Reduce packet size, correctly zeroing padding.
Definition: avpacket.c:112
type
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
Definition: writing_filters.txt:86
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
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
av_packet_side_data_name
const char * av_packet_side_data_name(enum AVPacketSideDataType type)
Definition: avpacket.c:268
AV_PKT_DATA_WEBVTT_SETTINGS
@ AV_PKT_DATA_WEBVTT_SETTINGS
The optional settings (rendering instructions) that immediately follow the timestamp specifier of a W...
Definition: packet.h:203
pkt
AVPacket * pkt
Definition: movenc.c:59
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
AV_SIDE_DATA_PARAM_CHANGE_DIMENSIONS
@ AV_SIDE_DATA_PARAM_CHANGE_DIMENSIONS
Definition: packet.h:459
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
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
AV_PKT_DATA_MASTERING_DISPLAY_METADATA
@ AV_PKT_DATA_MASTERING_DISPLAY_METADATA
Mastering display metadata (based on SMPTE-2086:2014).
Definition: packet.h:223
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
AVPacketSideData::data
uint8_t * data
Definition: packet.h:316
AV_PKT_DATA_DYNAMIC_HDR10_PLUS
@ AV_PKT_DATA_DYNAMIC_HDR10_PLUS
HDR10+ dynamic metadata associated with a video frame.
Definition: packet.h:300
AVPacket::opaque
void * opaque
for some private data of the user
Definition: packet.h:399
AV_PKT_DATA_PRFT
@ AV_PKT_DATA_PRFT
Producer Reference Time data corresponding to the AVProducerReferenceTime struct, usually exported by...
Definition: packet.h:269
AVSideDataParamChangeFlags
AVSideDataParamChangeFlags
Definition: packet.h:450
AVPacket::buf
AVBufferRef * buf
A reference to the reference-counted buffer where the packet data is stored.
Definition: packet.h:357
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
AVPacketSideData::type
enum AVPacketSideDataType type
Definition: packet.h:318
AV_PKT_DATA_SUBTITLE_POSITION
@ AV_PKT_DATA_SUBTITLE_POSITION
Subtitle event position.
Definition: packet.h:184
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
av_packet_move_ref
void av_packet_move_ref(AVPacket *dst, AVPacket *src)
Move every field in src to dst and reset src.
Definition: avpacket.c:479
av_packet_from_data
int av_packet_from_data(AVPacket *pkt, uint8_t *data, int size)
Initialize a reference-counted packet from av_malloc()ed data.
Definition: avpacket.c:171
AVPacket::size
int size
Definition: packet.h:375
size
int size
Definition: twinvq_data.h:10344
AV_PKT_DATA_H263_MB_INFO
@ AV_PKT_DATA_H263_MB_INFO
An AV_PKT_DATA_H263_MB_INFO side data packet contains a number of structures with info about macroblo...
Definition: packet.h:94
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
buffer.h
attribute_deprecated
#define attribute_deprecated
Definition: attributes.h:104
AVPacket::dts
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed.
Definition: packet.h:373
AVPacketSideDataType
AVPacketSideDataType
Definition: packet.h:41
attributes.h
av_packet_pack_dictionary
uint8_t * av_packet_pack_dictionary(AVDictionary *dict, size_t *size)
Pack a dictionary for use in side_data.
Definition: avpacket.c:307
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_packet_make_refcounted
int av_packet_make_refcounted(AVPacket *pkt)
Ensure the data described by a given packet is reference counted.
Definition: avpacket.c:485
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
av_packet_rescale_ts
void av_packet_rescale_ts(AVPacket *pkt, AVRational tb_src, AVRational tb_dst)
Convert valid timing fields (timestamps / durations) in a packet from one timebase to another.
Definition: avpacket.c:526
AV_PKT_DATA_METADATA_UPDATE
@ AV_PKT_DATA_METADATA_UPDATE
A list of zero terminated key/value strings.
Definition: packet.h:210
AV_PKT_DATA_JP_DUALMONO
@ AV_PKT_DATA_JP_DUALMONO
An AV_PKT_DATA_JP_DUALMONO side data packet indicates that the packet may contain "dual mono" audio s...
Definition: packet.h:167
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
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
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
AV_PKT_DATA_A53_CC
@ AV_PKT_DATA_A53_CC
ATSC A53 Part 4 Closed Captions.
Definition: packet.h:243
AV_PKT_DATA_CPB_PROPERTIES
@ AV_PKT_DATA_CPB_PROPERTIES
This side data corresponds to the AVCPBProperties struct.
Definition: packet.h:146
AV_PKT_DATA_SKIP_SAMPLES
@ AV_PKT_DATA_SKIP_SAMPLES
Recommmends skipping the specified number of samples.
Definition: packet.h:157
version.h
AV_PKT_DATA_DOVI_CONF
@ AV_PKT_DATA_DOVI_CONF
DOVI configuration ref: dolby-vision-bitstreams-within-the-iso-base-media-file-format-v2....
Definition: packet.h:284
dict.h
AVPacket::side_data
AVPacketSideData * side_data
Additional packet data that can be provided by the container.
Definition: packet.h:385
AV_PKT_DATA_S12M_TIMECODE
@ AV_PKT_DATA_S12M_TIMECODE
Timecode which conforms to SMPTE ST 12-1:2014.
Definition: packet.h:292
av_packet_new_side_data
uint8_t * av_packet_new_side_data(AVPacket *pkt, enum AVPacketSideDataType type, size_t size)
Allocate new information of a packet.
Definition: avpacket.c:230
AV_PKT_DATA_NEW_EXTRADATA
@ AV_PKT_DATA_NEW_EXTRADATA
The AV_PKT_DATA_NEW_EXTRADATA is used to notify the codec or the format that the extradata buffer was...
Definition: packet.h:56
av_packet_make_writable
int av_packet_make_writable(AVPacket *pkt)
Create a writable reference for the data described by a given packet, avoiding data copy if possible.
Definition: avpacket.c:504
AVPacket::stream_index
int stream_index
Definition: packet.h:376
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:82
AV_PKT_DATA_MATROSKA_BLOCKADDITIONAL
@ AV_PKT_DATA_MATROSKA_BLOCKADDITIONAL
Data found in BlockAdditional element of matroska container.
Definition: packet.h:192
AVPacket
This structure stores compressed data.
Definition: packet.h:351
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
AVPacket::pos
int64_t pos
byte position in stream, -1 if unknown
Definition: packet.h:394
AV_PKT_DATA_FALLBACK_TRACK
@ AV_PKT_DATA_FALLBACK_TRACK
This side data contains an integer value representing the stream index of a "fallback" track.
Definition: packet.h:141
AV_PKT_DATA_QUALITY_STATS
@ AV_PKT_DATA_QUALITY_STATS
This side data contains quality related information from the encoder.
Definition: packet.h:133
AV_PKT_DATA_WEBVTT_IDENTIFIER
@ AV_PKT_DATA_WEBVTT_IDENTIFIER
The optional first identifier line of a WebVTT cue.
Definition: packet.h:197
AVPacket::time_base
AVRational time_base
Time base of the packet's timestamps.
Definition: packet.h:418
AVPacket::side_data_elems
int side_data_elems
Definition: packet.h:386
av_packet_clone
AVPacket * av_packet_clone(const AVPacket *src)
Create a new packet that references the same data as src.
Definition: avpacket.c:466