Google Cloud Video Transcoder V1 Client - Class Vp9CodecSettings (0.6.0)

Reference documentation and code samples for the Google Cloud Video Transcoder V1 Client class Vp9CodecSettings.

VP9 codec settings.

Generated from protobuf message google.cloud.video.transcoder.v1.VideoStream.Vp9CodecSettings

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ 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. For portrait videos that contain horizontal ASR and rotation metadata, provide the width, in pixels, per the horizontal ASR. The API calculates the height per the horizontal ASR. The API detects any rotation metadata and swaps the requested height and width for the output.

↳ 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. For portrait videos that contain horizontal ASR and rotation metadata, provide the height, in pixels, per the horizontal ASR. The API calculates the width per the horizontal ASR. The API detects any rotation metadata and swaps the requested height and width for the output.

↳ 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. See Calculating frame rate for more information.

↳ bitrate_bps int

Required. The video bitrate in bits per second. The minimum value is 1,000. The maximum value is 480,000,000.

↳ pixel_format string

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

↳ rate_control_mode string

Specify the rate_control_mode. The default is vbr. Supported rate control modes: - vbr - variable bitrate

↳ 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. Note: This field is not supported.

↳ gop_frame_count int

Select the GOP size based on the specified frame count. Must be greater than zero.

↳ gop_duration Google\Protobuf\Duration

Select the GOP size based on the specified duration. The default is 3s. Note that gopDuration must be less than or equal to segmentDuration, and segmentDuration must be divisible by gopDuration.

↳ profile string

Enforces the specified codec profile. The following profiles are supported: * profile0 (default) * profile1 * profile2 * profile3 The available options are WebM-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the Vp9CodecSettings message.

getWidthPixels

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. For portrait videos that contain horizontal ASR and rotation metadata, provide the width, in pixels, per the horizontal ASR. The API calculates the height per the horizontal ASR. The API detects any rotation metadata and swaps the requested height and width for the output.

Returns
TypeDescription
int

setWidthPixels

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. For portrait videos that contain horizontal ASR and rotation metadata, provide the width, in pixels, per the horizontal ASR. The API calculates the height per the horizontal ASR. The API detects any rotation metadata and swaps the requested height and width for the output.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getHeightPixels

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. For portrait videos that contain horizontal ASR and rotation metadata, provide the height, in pixels, per the horizontal ASR. The API calculates the width per the horizontal ASR. The API detects any rotation metadata and swaps the requested height and width for the output.

Returns
TypeDescription
int

setHeightPixels

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. For portrait videos that contain horizontal ASR and rotation metadata, provide the height, in pixels, per the horizontal ASR. The API calculates the width per the horizontal ASR. The API detects any rotation metadata and swaps the requested height and width for the output.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getFrameRate

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. See Calculating frame rate for more information.

Returns
TypeDescription
float

setFrameRate

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. See Calculating frame rate for more information.

Parameter
NameDescription
var float
Returns
TypeDescription
$this

getBitrateBps

Required. The video bitrate in bits per second. The minimum value is 1,000. The maximum value is 480,000,000.

Returns
TypeDescription
int

setBitrateBps

Required. The video bitrate in bits per second. The minimum value is 1,000. The maximum value is 480,000,000.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getPixelFormat

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
Returns
TypeDescription
string

setPixelFormat

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
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getRateControlMode

Specify the rate_control_mode. The default is vbr.

Supported rate control modes:

  • vbr - variable bitrate
Returns
TypeDescription
string

setRateControlMode

Specify the rate_control_mode. The default is vbr.

Supported rate control modes:

  • vbr - variable bitrate
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getCrfLevel

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.

Note: This field is not supported.

Returns
TypeDescription
int

setCrfLevel

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.

Note: This field is not supported.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getGopFrameCount

Select the GOP size based on the specified frame count. Must be greater than zero.

Returns
TypeDescription
int

hasGopFrameCount

setGopFrameCount

Select the GOP size based on the specified frame count. Must be greater than zero.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getGopDuration

Select the GOP size based on the specified duration. The default is 3s. Note that gopDuration must be less than or equal to segmentDuration, and segmentDuration must be divisible by gopDuration.

Returns
TypeDescription
Google\Protobuf\Duration|null

hasGopDuration

setGopDuration

Select the GOP size based on the specified duration. The default is 3s. Note that gopDuration must be less than or equal to segmentDuration, and segmentDuration must be divisible by gopDuration.

Parameter
NameDescription
var Google\Protobuf\Duration
Returns
TypeDescription
$this

getProfile

Enforces the specified codec profile. The following profiles are supported:

  • profile0 (default)
  • profile1
  • profile2
  • profile3 The available options are WebM-compatible.

Note that certain values for this field may cause the transcoder to override other fields you set in the Vp9CodecSettings message.

Returns
TypeDescription
string

setProfile

Enforces the specified codec profile. The following profiles are supported:

  • profile0 (default)
  • profile1
  • profile2
  • profile3 The available options are WebM-compatible.

Note that certain values for this field may cause the transcoder to override other fields you set in the Vp9CodecSettings message.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getGopMode

Returns
TypeDescription
string