Streams¶
Stream collections¶
- class av.container.streams.StreamContainer¶
Bases:
objectA tuple-like container of
Stream.# There are a few ways to pulling out streams. first = container.streams[0] video = container.streams.video[0] audio = container.streams.get(audio=(0, 1))
Dynamic Slicing¶
- StreamContainer.get(streams=None, video=None, audio=None, subtitles=None, data=None)¶
Get a selection of
Streamas alist.Positional arguments may be
int(which is an index into the streams), orlistortupleof those:# Get the first channel. streams.get(0) # Get the first two audio channels. streams.get(audio=(0, 1))
Keyword arguments (or dicts as positional arguments) as interpreted as
(stream_type, index_value_or_set)pairs:# Get the first video channel. streams.get(video=0) # or streams.get({'video': 0})
Streamobjects are passed through untouched.If nothing is selected, then all streams are returned.
Typed Collections¶
These attributes are preferred for readability if you don’t need the
dynamic capabilities of get():
- StreamContainer.video¶
A tuple of
VideoStream.
- StreamContainer.audio¶
A tuple of
AudioStream.
- StreamContainer.subtitles¶
A tuple of
SubtitleStream.
- StreamContainer.data¶
A tuple of
DataStream.
- StreamContainer.other¶
A tuple of
Stream
Streams¶
- class av.stream.Stream¶
Bases:
objectA single stream of audio, video or subtitles within a
Container.>>> fh = av.open(video_path) >>> stream = fh.streams.video[0] >>> stream <av.VideoStream #0 h264, yuv420p 1280x720 at 0x...>
This encapsulates a
CodecContext, located atStream.codec_context. Attribute access is passed through to that context when attributes are missing on the stream itself. E.g.stream.optionswill be the options on the context.
Basics¶
- Stream.codec_context¶
Timing¶
See also
Time for a discussion of time in general.
- Stream.time_base¶
The unit of time (in fractional seconds) in which timestamps are expressed.
- Type:
FractionorNone
