Class VideoStream (0.2.1)

VideoStream(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Video stream resource.

Attributes

NameDescription
codec str
Codec type. The default is "h264". Supported codecs: - 'h264' - 'h265' - 'vp9'
profile str
Enforce specified codec profile. The default is "high". Supported codec profiles: - 'baseline' - 'main' - 'high'
tune str
Enforce specified codec tune.
preset str
Enforce specified codec preset. The default is "veryfast".
height_pixels int
The height of the video in pixels. Must be an even integer. When not specified, the height is adjusted to match the specified width and input aspect ratio. If both are omitted, the input height is used.
width_pixels int
The width of the video in pixels. Must be an even integer. When not specified, the width is adjusted to match the specified height and input aspect ratio. If both are omitted, the input width is used.
pixel_format str
Pixel format to use. The default is "yuv420p". Supported pixel formats: - 'yuv420p' pixel format. - 'yuv422p' pixel format. - 'yuv444p' pixel format. - 'yuv420p10' 10-bit HDR pixel format. - 'yuv422p10' 10-bit HDR pixel format. - 'yuv444p10' 10-bit HDR pixel format. - 'yuv420p12' 12-bit HDR pixel format. - 'yuv422p12' 12-bit HDR pixel format. - 'yuv444p12' 12-bit HDR pixel format.
bitrate_bps int
Required. The video bitrate in bits per second. Must be between 1 and 1,000,000,000.
rate_control_mode str
Specify the rate_control_mode. The default is "vbr". Supported rate control modes: - 'vbr' - variable bitrate - 'crf' - constant rate factor
enable_two_pass bool
Use two-pass encoding strategy to achieve better video quality. VideoStream.rate_control_mode must be "vbr". The default is false.
crf_level int
Target CRF level. Must be between 10 and 36, where 10 is the highest quality and 36 is the most efficient compression. The default is 21.
vbv_size_bits int
Size of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to VideoStream.bitrate_bps.
vbv_fullness_bits int
Initial fullness of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to 90% of VideoStream.vbv_size_bits.
allow_open_gop bool
Specifies whether an open Group of Pictures (GOP) structure should be allowed or not. The default is false.
gop_frame_count int
Select the GOP size based on the specified frame count. Must be greater than zero.
gop_duration .duration.Duration
Select the GOP size based on the specified duration. The default is "3s".
entropy_coder str
The entropy coder to use. The default is "cabac". Supported entropy coders: - 'cavlc' - 'cabac'
b_pyramid bool
Allow B-pyramid for reference frame selection. This may not be supported on all decoders. The default is false.
b_frame_count int
The number of consecutive B-frames. Must be greater than or equal to zero. Must be less than VideoStream.gop_frame_count if set. The default is 0.
frame_rate float
Required. The target video frame rate in frames per second (FPS). Must be less than or equal to 120. Will default to the input frame rate if larger than the input frame rate. The API will generate an output FPS that is divisible by the input FPS, and smaller or equal to the target FPS. The following table shows the computed video FPS given the target FPS (in parenthesis) and input FPS (in the first column): :: | | (30) | (60) | (25) | (50) | |--------|--------|--------|------|------| | 240 | Fail | Fail | Fail | Fail | | 120 | 30 | 60 | 20 | 30 | | 100 | 25 | 50 | 20 | 30 | | 50 | 25 | 50 | 20 | 30 | | 60 | 30 | 60 | 20 | 30 | | 59.94 | 29.97 | 59.94 | 20 | 30 | | 48 | 24 | 48 | 20 | 30 | | 30 | 30 | 30 | 20 | 30 | | 25 | 25 | 25 | 20 | 30 | | 24 | 24 | 24 | 20 | 30 | | 23.976 | 23.976 | 23.976 | 20 | 30 | | 15 | 15 | 15 | 20 | 30 | | 12 | 12 | 12 | 20 | 30 | | 10 | 10 | 10 | 20 | 30 |
aq_strength float
Specify the intensity of the adaptive quantizer (AQ). Must be between 0 and 1, where 0 disables the quantizer and 1 maximizes the quantizer. A higher value equals a lower bitrate but smoother image. The default is 0.