Miam-Player  0.8.0
A nice music player
AVStream Struct Reference

#include <avformat.h>

Public Attributes

int index
 
int id
 
void * priv_data
 
AVRational time_base
 
int64_t start_time
 
int64_t duration
 
int64_t nb_frames
 number of frames in this stream if known or 0 More...
 
int disposition
 
enum AVDiscard discard
 Selects which packets can be discarded at will and do not need to be demuxed. More...
 
AVRational sample_aspect_ratio
 
AVDictionarymetadata
 
AVRational avg_frame_rate
 
AVPacket attached_pic
 
AVPacketSideDataside_data
 
int nb_side_data
 
int event_flags
 
struct {
   int64_t   last_dts
 
   int64_t   duration_gcd
 
   int   duration_count
 
   int64_t   rfps_duration_sum
 
   double(*   duration_error )[2][MAX_STD_TIMEBASES]
 
   int64_t   codec_info_duration
 
   int64_t   codec_info_duration_fields
 
   int   found_decoder
 
   int64_t   last_duration
 
   int64_t   fps_first_dts
 
   int   fps_first_dts_idx
 
   int64_t   fps_last_dts
 
   int   fps_last_dts_idx
 
} * info
 
int pts_wrap_bits
 
int64_t first_dts
 
int64_t cur_dts
 
int64_t last_IP_pts
 
int last_IP_duration
 
int probe_packets
 
int codec_info_nb_frames
 
enum AVStreamParseType need_parsing
 
struct AVCodecParserContextparser
 
struct AVPacketListlast_in_packet_buffer
 
AVProbeData probe_data
 
int64_t pts_buffer [MAX_REORDER_DELAY+1]
 
AVIndexEntryindex_entries
 
int nb_index_entries
 
unsigned int index_entries_allocated_size
 
AVRational r_frame_rate
 
int stream_identifier
 
int64_t interleaver_chunk_size
 
int64_t interleaver_chunk_duration
 
int request_probe
 
int skip_to_keyframe
 
int skip_samples
 
int64_t start_skip_samples
 
int64_t first_discard_sample
 
int64_t last_discard_sample
 
int nb_decoded_frames
 
int64_t mux_ts_offset
 
int64_t pts_wrap_reference
 
int pts_wrap_behavior
 
int update_initial_durations_done
 
int64_t pts_reorder_error [MAX_REORDER_DELAY+1]
 
uint8_t pts_reorder_error_count [MAX_REORDER_DELAY+1]
 
int64_t last_dts_for_order_check
 
uint8_t dts_ordered
 
uint8_t dts_misordered
 
int inject_global_side_data
 
char * recommended_encoder_configuration
 
AVRational display_aspect_ratio
 
struct FFFrac * priv_pts
 
AVStreamInternalinternal
 
AVCodecParameterscodecpar
 

Detailed Description

Stream structure. New fields can be added to the end with minor version bumps. Removal, reordering and changes to existing fields require a major version bump. sizeof(AVStream) must not be used outside libav*.

Member Data Documentation

◆ attached_pic

AVPacket AVStream::attached_pic

For streams with AV_DISPOSITION_ATTACHED_PIC disposition, this packet will contain the attached picture.

decoding: set by libavformat, must not be modified by the caller. encoding: unused

◆ avg_frame_rate

AVRational AVStream::avg_frame_rate

Average framerate

◆ codec_info_duration

int64_t AVStream::codec_info_duration

◆ codec_info_duration_fields

int64_t AVStream::codec_info_duration_fields

◆ codec_info_nb_frames

int AVStream::codec_info_nb_frames

Number of frames that have been demuxed during av_find_stream_info()

◆ codecpar

AVCodecParameters* AVStream::codecpar

◆ cur_dts

int64_t AVStream::cur_dts

◆ discard

enum AVDiscard AVStream::discard

Selects which packets can be discarded at will and do not need to be demuxed.

◆ display_aspect_ratio

AVRational AVStream::display_aspect_ratio

display aspect ratio (0 if unknown)

  • encoding: unused
  • decoding: Set by libavformat to calculate sample_aspect_ratio internally

◆ disposition

int AVStream::disposition

AV_DISPOSITION_* bit field

◆ dts_misordered

uint8_t AVStream::dts_misordered

◆ dts_ordered

uint8_t AVStream::dts_ordered

◆ duration

int64_t AVStream::duration

Decoding: duration of the stream, in stream time base. If a source file does not specify a duration, but does specify a bitrate, this value will be estimated from bitrate and file size.

◆ duration_count

int AVStream::duration_count

◆ duration_error

double(* AVStream::duration_error)[2][MAX_STD_TIMEBASES]

◆ duration_gcd

int64_t AVStream::duration_gcd

◆ event_flags

int AVStream::event_flags

Flags for the user to detect events happening on the stream. Flags must be cleared by the user once the event has been handled. A combination of AVSTREAM_EVENT_FLAG_*.

◆ first_discard_sample

int64_t AVStream::first_discard_sample

If not 0, the first audio sample that should be discarded from the stream. This is broken by design (needs global sample count), but can't be avoided for broken by design formats such as mp3 with ad-hoc gapless audio support.

◆ first_dts

int64_t AVStream::first_dts

Timestamp corresponding to the last dts sync point.

Initialized when AVCodecParserContext.dts_sync_point >= 0 and a DTS is received from the underlying container. Otherwise set to AV_NOPTS_VALUE by default.

◆ found_decoder

int AVStream::found_decoder

0 -> decoder has not been searched for yet. >0 -> decoder found <0 -> decoder with codec_id == -found_decoder has not been found

◆ fps_first_dts

int64_t AVStream::fps_first_dts

Those are used for average framerate estimation.

◆ fps_first_dts_idx

int AVStream::fps_first_dts_idx

◆ fps_last_dts

int64_t AVStream::fps_last_dts

◆ fps_last_dts_idx

int AVStream::fps_last_dts_idx

◆ id

int AVStream::id

Format-specific stream ID. decoding: set by libavformat encoding: set by the user, replaced by libavformat if left unset

◆ index

int AVStream::index

stream index in AVFormatContext

◆ index_entries

AVIndexEntry* AVStream::index_entries

Only used if the format does not support seeking natively.

◆ index_entries_allocated_size

unsigned int AVStream::index_entries_allocated_size

◆ info

struct { ... } * AVStream::info

◆ inject_global_side_data

int AVStream::inject_global_side_data

Internal data to inject global side data

◆ interleaver_chunk_duration

int64_t AVStream::interleaver_chunk_duration

◆ interleaver_chunk_size

int64_t AVStream::interleaver_chunk_size

◆ internal

AVStreamInternal* AVStream::internal

An opaque field for libavformat internal usage. Must not be accessed in any way by callers.

◆ last_discard_sample

int64_t AVStream::last_discard_sample

The sample after last sample that is intended to be discarded after first_discard_sample. Works on frame boundaries only. Used to prevent early EOF if the gapless info is broken (considered concatenated mp3s).

◆ last_dts

int64_t AVStream::last_dts

◆ last_dts_for_order_check

int64_t AVStream::last_dts_for_order_check

Internal data to analyze DTS and detect faulty mpeg streams

◆ last_duration

int64_t AVStream::last_duration

◆ last_in_packet_buffer

struct AVPacketList* AVStream::last_in_packet_buffer

last packet in packet_buffer for this stream when muxing.

◆ last_IP_duration

int AVStream::last_IP_duration

◆ last_IP_pts

int64_t AVStream::last_IP_pts

◆ metadata

AVDictionary* AVStream::metadata

◆ mux_ts_offset

int64_t AVStream::mux_ts_offset

Timestamp offset added to timestamps before muxing NOT PART OF PUBLIC API

◆ nb_decoded_frames

int AVStream::nb_decoded_frames

Number of internally decoded frames, used internally in libavformat, do not access its lifetime differs from info which is why it is not in that structure.

◆ nb_frames

int64_t AVStream::nb_frames

number of frames in this stream if known or 0

◆ nb_index_entries

int AVStream::nb_index_entries

◆ nb_side_data

int AVStream::nb_side_data

The number of elements in the AVStream.side_data array.

◆ need_parsing

enum AVStreamParseType AVStream::need_parsing

◆ parser

struct AVCodecParserContext* AVStream::parser

◆ priv_data

void* AVStream::priv_data

◆ priv_pts

struct FFFrac* AVStream::priv_pts

◆ probe_data

AVProbeData AVStream::probe_data

◆ probe_packets

int AVStream::probe_packets

Number of packets to buffer for codec probing

◆ pts_buffer

int64_t AVStream::pts_buffer[MAX_REORDER_DELAY+1]

◆ pts_reorder_error

int64_t AVStream::pts_reorder_error[MAX_REORDER_DELAY+1]

Internal data to generate dts from pts

◆ pts_reorder_error_count

uint8_t AVStream::pts_reorder_error_count[MAX_REORDER_DELAY+1]

◆ pts_wrap_behavior

int AVStream::pts_wrap_behavior

Options for behavior, when a wrap is detected.

Defined by AV_PTS_WRAP_ values.

If correction is enabled, there are two possibilities: If the first time stamp is near the wrap point, the wrap offset will be subtracted, which will create negative time stamps. Otherwise the offset will be added.

◆ pts_wrap_bits

int AVStream::pts_wrap_bits

number of bits in pts (used for wrapping control)

◆ pts_wrap_reference

int64_t AVStream::pts_wrap_reference

Internal data to check for wrapping of the time stamp

◆ r_frame_rate

AVRational AVStream::r_frame_rate

Real base framerate of the stream. This is the lowest framerate with which all timestamps can be represented accurately (it is the least common multiple of all framerates in the stream). Note, this value is just a guess! For example, if the time base is 1/90000 and all frames have either approximately 3600 or 1800 timer ticks, then r_frame_rate will be 50/1.

Code outside avformat should access this field using: av_stream_get/set_r_frame_rate(stream)

◆ recommended_encoder_configuration

char* AVStream::recommended_encoder_configuration

String containing paris of key and values describing recommended encoder configuration. Paris are separated by ','. Keys are separated from values by '='.

◆ request_probe

int AVStream::request_probe

stream probing state -1 -> probing finished 0 -> no probing requested rest -> perform probing with request_probe being the minimum score to accept. NOT PART OF PUBLIC API

◆ rfps_duration_sum

int64_t AVStream::rfps_duration_sum

◆ sample_aspect_ratio

AVRational AVStream::sample_aspect_ratio

sample aspect ratio (0 if unknown)

  • encoding: Set by user.
  • decoding: Set by libavformat.

◆ side_data

AVPacketSideData* AVStream::side_data

An array of side data that applies to the whole stream (i.e. the container does not allow it to change between packets).

There may be no overlap between the side data in this array and side data in the packets. I.e. a given side data is either exported by the muxer (demuxing) / set by the caller (muxing) in this array, then it never appears in the packets, or the side data is exported / sent through the packets (always in the first packet where the value becomes known or changes), then it does not appear in this array.

  • demuxing: Set by libavformat when the stream is created.
  • muxing: May be set by the caller before avformat_write_header().

Freed by libavformat in avformat_free_context().

See also
av_format_inject_global_side_data()

◆ skip_samples

int AVStream::skip_samples

Number of samples to skip at the start of the frame decoded from the next packet.

◆ skip_to_keyframe

int AVStream::skip_to_keyframe

Indicates that everything up to the next keyframe should be discarded.

◆ start_skip_samples

int64_t AVStream::start_skip_samples

If not 0, the number of samples that should be skipped from the start of the stream (the samples are removed from packets with pts==0, which also assumes negative timestamps do not happen). Intended for use with formats such as mp3 with ad-hoc gapless audio support.

◆ start_time

int64_t AVStream::start_time

Decoding: pts of the first frame of the stream in presentation order, in stream time base. Only set this if you are absolutely 100% sure that the value you set it to really is the pts of the first frame. This may be undefined (AV_NOPTS_VALUE).

Note
The ASF header does NOT contain a correct start_time the ASF demuxer must NOT set this.

◆ stream_identifier

int AVStream::stream_identifier

Stream Identifier This is the MPEG-TS stream identifier +1 0 means unknown

◆ time_base

AVRational AVStream::time_base

This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented.

decoding: set by libavformat encoding: May be set by the caller before avformat_write_header() to provide a hint to the muxer about the desired timebase. In avformat_write_header(), the muxer will overwrite this field with the timebase that will actually be used for the timestamps written into the file (which may or may not be related to the user-provided one, depending on the format).

◆ update_initial_durations_done

int AVStream::update_initial_durations_done

Internal data to prevent doing update_initial_durations() twice


The documentation for this struct was generated from the following file: