Mercurial > libavcodec.hg
comparison avcodec.h @ 9359:f978e4a699c5 libavcodec
Clarify which time_base the relevant members of AVPacket use
author | superdump |
---|---|
date | Wed, 08 Apr 2009 01:45:44 +0000 |
parents | 2108342734cc |
children | 66e270967340 |
comparison
equal
deleted
inserted
replaced
9358:93da33bb271e | 9359:f978e4a699c5 |
---|---|
843 #define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content. | 843 #define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content. |
844 #define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update). | 844 #define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update). |
845 | 845 |
846 typedef struct AVPacket { | 846 typedef struct AVPacket { |
847 /** | 847 /** |
848 * Presentation timestamp in time_base units; the time at which the | 848 * Presentation timestamp in AVStream->time_base units; the time at which |
849 * decompressed packet will be presented to the user. | 849 * the decompressed packet will be presented to the user. |
850 * Can be AV_NOPTS_VALUE if it is not stored in the file. | 850 * Can be AV_NOPTS_VALUE if it is not stored in the file. |
851 * pts MUST be larger or equal to dts as presentation cannot happen before | 851 * pts MUST be larger or equal to dts as presentation cannot happen before |
852 * decompression, unless one wants to view hex dumps. Some formats misuse | 852 * decompression, unless one wants to view hex dumps. Some formats misuse |
853 * the terms dts and pts/cts to mean something different. Such timestamps | 853 * the terms dts and pts/cts to mean something different. Such timestamps |
854 * must be converted to true pts/dts before they are stored in AVPacket. | 854 * must be converted to true pts/dts before they are stored in AVPacket. |
855 */ | 855 */ |
856 int64_t pts; | 856 int64_t pts; |
857 /** | 857 /** |
858 * Decompression timestamp in time_base units; the time at which the | 858 * Decompression timestamp in AVStream->time_base units; the time at which |
859 * packet is decompressed. | 859 * the packet is decompressed. |
860 * Can be AV_NOPTS_VALUE if it is not stored in the file. | 860 * Can be AV_NOPTS_VALUE if it is not stored in the file. |
861 */ | 861 */ |
862 int64_t dts; | 862 int64_t dts; |
863 uint8_t *data; | 863 uint8_t *data; |
864 int size; | 864 int size; |
865 int stream_index; | 865 int stream_index; |
866 int flags; | 866 int flags; |
867 /** | 867 /** |
868 * Duration of this packet in time_base units, 0 if unknown. | 868 * Duration of this packet in AVStream->time_base units, 0 if unknown. |
869 * Equals next_pts - this_pts in presentation order. | 869 * Equals next_pts - this_pts in presentation order. |
870 */ | 870 */ |
871 int duration; | 871 int duration; |
872 void (*destruct)(struct AVPacket *); | 872 void (*destruct)(struct AVPacket *); |
873 void *priv; | 873 void *priv; |
874 int64_t pos; ///< byte position in stream, -1 if unknown | 874 int64_t pos; ///< byte position in stream, -1 if unknown |
875 | 875 |
876 /** | 876 /** |
877 * Time difference in stream time base units from the pts of this | 877 * Time difference in AVStream->time_base units from the pts of this |
878 * packet to the point at which the output from the decoder has converged | 878 * packet to the point at which the output from the decoder has converged |
879 * independent from the availability of previous frames. That is, the | 879 * independent from the availability of previous frames. That is, the |
880 * frames are virtually identical no matter if decoding started from | 880 * frames are virtually identical no matter if decoding started from |
881 * the very first frame or from this keyframe. | 881 * the very first frame or from this keyframe. |
882 * Is AV_NOPTS_VALUE if unknown. | 882 * Is AV_NOPTS_VALUE if unknown. |