Class VideoStream.H265CodecSettings.Builder (1.46.0)

public static final class VideoStream.H265CodecSettings.Builder extends GeneratedMessageV3.Builder<VideoStream.H265CodecSettings.Builder> implements VideoStream.H265CodecSettingsOrBuilder

H265 codec settings.

Protobuf type google.cloud.video.transcoder.v1.VideoStream.H265CodecSettings

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public VideoStream.H265CodecSettings.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

build()

public VideoStream.H265CodecSettings build()
Returns
Type Description
VideoStream.H265CodecSettings

buildPartial()

public VideoStream.H265CodecSettings buildPartial()
Returns
Type Description
VideoStream.H265CodecSettings

clear()

public VideoStream.H265CodecSettings.Builder clear()
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

clearAllowOpenGop()

public VideoStream.H265CodecSettings.Builder clearAllowOpenGop()

Specifies whether an open Group of Pictures (GOP) structure should be allowed or not. The default is false.

bool allow_open_gop = 8;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearAqStrength()

public VideoStream.H265CodecSettings.Builder clearAqStrength()

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.

double aq_strength = 16;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearBFrameCount()

public VideoStream.H265CodecSettings.Builder clearBFrameCount()

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.

int32 b_frame_count = 15;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearBPyramid()

public VideoStream.H265CodecSettings.Builder clearBPyramid()

Allow B-pyramid for reference frame selection. This may not be supported on all decoders. The default is false.

bool b_pyramid = 14;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearBitrateBps()

public VideoStream.H265CodecSettings.Builder clearBitrateBps()

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

int32 bitrate_bps = 4 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearCrfLevel()

public VideoStream.H265CodecSettings.Builder clearCrfLevel()

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.

int32 crf_level = 7;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearEnableTwoPass()

public VideoStream.H265CodecSettings.Builder clearEnableTwoPass()

Use two-pass encoding strategy to achieve better video quality. VideoStream.rate_control_mode must be vbr. The default is false.

bool enable_two_pass = 11;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearField(Descriptors.FieldDescriptor field)

public VideoStream.H265CodecSettings.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Name Description
field FieldDescriptor
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

clearFrameRate()

public VideoStream.H265CodecSettings.Builder clearFrameRate()

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.

double frame_rate = 3 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearGopDuration()

public VideoStream.H265CodecSettings.Builder clearGopDuration()

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.

.google.protobuf.Duration gop_duration = 10;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

clearGopFrameCount()

public VideoStream.H265CodecSettings.Builder clearGopFrameCount()

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

int32 gop_frame_count = 9;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearGopMode()

public VideoStream.H265CodecSettings.Builder clearGopMode()
Returns
Type Description
VideoStream.H265CodecSettings.Builder

clearHeightPixels()

public VideoStream.H265CodecSettings.Builder clearHeightPixels()

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.

int32 height_pixels = 2;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public VideoStream.H265CodecSettings.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Name Description
oneof OneofDescriptor
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

clearPixelFormat()

public VideoStream.H265CodecSettings.Builder clearPixelFormat()

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

string pixel_format = 5;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearPreset()

public VideoStream.H265CodecSettings.Builder clearPreset()

Enforces the specified codec preset. The default is veryfast. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string preset = 19;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearProfile()

public VideoStream.H265CodecSettings.Builder clearProfile()

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

  • 8-bit profiles
    • main (default)
    • main-intra
    • mainstillpicture
  • 10-bit profiles
    • main10 (default)
    • main10-intra
    • main422-10
    • main422-10-intra
    • main444-10
    • main444-10-intra
  • 12-bit profiles

    • main12 (default)
    • main12-intra
    • main422-12
    • main422-12-intra
    • main444-12
    • main444-12-intra

    The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string profile = 17;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearRateControlMode()

public VideoStream.H265CodecSettings.Builder clearRateControlMode()

Specify the rate_control_mode. The default is vbr.

Supported rate control modes:

  • vbr - variable bitrate
  • crf - constant rate factor

string rate_control_mode = 6;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearTune()

public VideoStream.H265CodecSettings.Builder clearTune()

Enforces the specified codec tune. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string tune = 18;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearVbvFullnessBits()

public VideoStream.H265CodecSettings.Builder clearVbvFullnessBits()

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.

int32 vbv_fullness_bits = 13;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearVbvSizeBits()

public VideoStream.H265CodecSettings.Builder clearVbvSizeBits()

Size of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to VideoStream.bitrate_bps.

int32 vbv_size_bits = 12;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clearWidthPixels()

public VideoStream.H265CodecSettings.Builder clearWidthPixels()

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.

int32 width_pixels = 1;

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

clone()

public VideoStream.H265CodecSettings.Builder clone()
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

getAllowOpenGop()

public boolean getAllowOpenGop()

Specifies whether an open Group of Pictures (GOP) structure should be allowed or not. The default is false.

bool allow_open_gop = 8;

Returns
Type Description
boolean

The allowOpenGop.

getAqStrength()

public double getAqStrength()

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.

double aq_strength = 16;

Returns
Type Description
double

The aqStrength.

getBFrameCount()

public int getBFrameCount()

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.

int32 b_frame_count = 15;

Returns
Type Description
int

The bFrameCount.

getBPyramid()

public boolean getBPyramid()

Allow B-pyramid for reference frame selection. This may not be supported on all decoders. The default is false.

bool b_pyramid = 14;

Returns
Type Description
boolean

The bPyramid.

getBitrateBps()

public int getBitrateBps()

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

int32 bitrate_bps = 4 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
int

The bitrateBps.

getCrfLevel()

public int 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.

int32 crf_level = 7;

Returns
Type Description
int

The crfLevel.

getDefaultInstanceForType()

public VideoStream.H265CodecSettings getDefaultInstanceForType()
Returns
Type Description
VideoStream.H265CodecSettings

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getEnableTwoPass()

public boolean getEnableTwoPass()

Use two-pass encoding strategy to achieve better video quality. VideoStream.rate_control_mode must be vbr. The default is false.

bool enable_two_pass = 11;

Returns
Type Description
boolean

The enableTwoPass.

getFrameRate()

public double 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.

double frame_rate = 3 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
double

The frameRate.

getGopDuration()

public Duration 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.

.google.protobuf.Duration gop_duration = 10;

Returns
Type Description
Duration

The gopDuration.

getGopDurationBuilder()

public Duration.Builder getGopDurationBuilder()

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.

.google.protobuf.Duration gop_duration = 10;

Returns
Type Description
Builder

getGopDurationOrBuilder()

public DurationOrBuilder getGopDurationOrBuilder()

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.

.google.protobuf.Duration gop_duration = 10;

Returns
Type Description
DurationOrBuilder

getGopFrameCount()

public int getGopFrameCount()

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

int32 gop_frame_count = 9;

Returns
Type Description
int

The gopFrameCount.

getGopModeCase()

public VideoStream.H265CodecSettings.GopModeCase getGopModeCase()
Returns
Type Description
VideoStream.H265CodecSettings.GopModeCase

getHeightPixels()

public int 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.

int32 height_pixels = 2;

Returns
Type Description
int

The heightPixels.

getPixelFormat()

public String 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

string pixel_format = 5;

Returns
Type Description
String

The pixelFormat.

getPixelFormatBytes()

public ByteString getPixelFormatBytes()

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

string pixel_format = 5;

Returns
Type Description
ByteString

The bytes for pixelFormat.

getPreset()

public String getPreset()

Enforces the specified codec preset. The default is veryfast. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string preset = 19;

Returns
Type Description
String

The preset.

getPresetBytes()

public ByteString getPresetBytes()

Enforces the specified codec preset. The default is veryfast. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string preset = 19;

Returns
Type Description
ByteString

The bytes for preset.

getProfile()

public String getProfile()

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

  • 8-bit profiles
    • main (default)
    • main-intra
    • mainstillpicture
  • 10-bit profiles
    • main10 (default)
    • main10-intra
    • main422-10
    • main422-10-intra
    • main444-10
    • main444-10-intra
  • 12-bit profiles

    • main12 (default)
    • main12-intra
    • main422-12
    • main422-12-intra
    • main444-12
    • main444-12-intra

    The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string profile = 17;

Returns
Type Description
String

The profile.

getProfileBytes()

public ByteString getProfileBytes()

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

  • 8-bit profiles
    • main (default)
    • main-intra
    • mainstillpicture
  • 10-bit profiles
    • main10 (default)
    • main10-intra
    • main422-10
    • main422-10-intra
    • main444-10
    • main444-10-intra
  • 12-bit profiles

    • main12 (default)
    • main12-intra
    • main422-12
    • main422-12-intra
    • main444-12
    • main444-12-intra

    The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string profile = 17;

Returns
Type Description
ByteString

The bytes for profile.

getRateControlMode()

public String getRateControlMode()

Specify the rate_control_mode. The default is vbr.

Supported rate control modes:

  • vbr - variable bitrate
  • crf - constant rate factor

string rate_control_mode = 6;

Returns
Type Description
String

The rateControlMode.

getRateControlModeBytes()

public ByteString getRateControlModeBytes()

Specify the rate_control_mode. The default is vbr.

Supported rate control modes:

  • vbr - variable bitrate
  • crf - constant rate factor

string rate_control_mode = 6;

Returns
Type Description
ByteString

The bytes for rateControlMode.

getTune()

public String getTune()

Enforces the specified codec tune. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string tune = 18;

Returns
Type Description
String

The tune.

getTuneBytes()

public ByteString getTuneBytes()

Enforces the specified codec tune. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string tune = 18;

Returns
Type Description
ByteString

The bytes for tune.

getVbvFullnessBits()

public int getVbvFullnessBits()

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.

int32 vbv_fullness_bits = 13;

Returns
Type Description
int

The vbvFullnessBits.

getVbvSizeBits()

public int getVbvSizeBits()

Size of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to VideoStream.bitrate_bps.

int32 vbv_size_bits = 12;

Returns
Type Description
int

The vbvSizeBits.

getWidthPixels()

public int 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.

int32 width_pixels = 1;

Returns
Type Description
int

The widthPixels.

hasGopDuration()

public boolean hasGopDuration()

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.

.google.protobuf.Duration gop_duration = 10;

Returns
Type Description
boolean

Whether the gopDuration field is set.

hasGopFrameCount()

public boolean hasGopFrameCount()

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

int32 gop_frame_count = 9;

Returns
Type Description
boolean

Whether the gopFrameCount field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeFrom(VideoStream.H265CodecSettings other)

public VideoStream.H265CodecSettings.Builder mergeFrom(VideoStream.H265CodecSettings other)
Parameter
Name Description
other VideoStream.H265CodecSettings
Returns
Type Description
VideoStream.H265CodecSettings.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public VideoStream.H265CodecSettings.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public VideoStream.H265CodecSettings.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

mergeGopDuration(Duration value)

public VideoStream.H265CodecSettings.Builder mergeGopDuration(Duration value)

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.

.google.protobuf.Duration gop_duration = 10;

Parameter
Name Description
value Duration
Returns
Type Description
VideoStream.H265CodecSettings.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final VideoStream.H265CodecSettings.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

setAllowOpenGop(boolean value)

public VideoStream.H265CodecSettings.Builder setAllowOpenGop(boolean value)

Specifies whether an open Group of Pictures (GOP) structure should be allowed or not. The default is false.

bool allow_open_gop = 8;

Parameter
Name Description
value boolean

The allowOpenGop to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setAqStrength(double value)

public VideoStream.H265CodecSettings.Builder setAqStrength(double value)

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.

double aq_strength = 16;

Parameter
Name Description
value double

The aqStrength to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setBFrameCount(int value)

public VideoStream.H265CodecSettings.Builder setBFrameCount(int value)

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.

int32 b_frame_count = 15;

Parameter
Name Description
value int

The bFrameCount to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setBPyramid(boolean value)

public VideoStream.H265CodecSettings.Builder setBPyramid(boolean value)

Allow B-pyramid for reference frame selection. This may not be supported on all decoders. The default is false.

bool b_pyramid = 14;

Parameter
Name Description
value boolean

The bPyramid to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setBitrateBps(int value)

public VideoStream.H265CodecSettings.Builder setBitrateBps(int value)

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

int32 bitrate_bps = 4 [(.google.api.field_behavior) = REQUIRED];

Parameter
Name Description
value int

The bitrateBps to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setCrfLevel(int value)

public VideoStream.H265CodecSettings.Builder setCrfLevel(int value)

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.

int32 crf_level = 7;

Parameter
Name Description
value int

The crfLevel to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setEnableTwoPass(boolean value)

public VideoStream.H265CodecSettings.Builder setEnableTwoPass(boolean value)

Use two-pass encoding strategy to achieve better video quality. VideoStream.rate_control_mode must be vbr. The default is false.

bool enable_two_pass = 11;

Parameter
Name Description
value boolean

The enableTwoPass to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setField(Descriptors.FieldDescriptor field, Object value)

public VideoStream.H265CodecSettings.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

setFrameRate(double value)

public VideoStream.H265CodecSettings.Builder setFrameRate(double value)

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.

double frame_rate = 3 [(.google.api.field_behavior) = REQUIRED];

Parameter
Name Description
value double

The frameRate to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setGopDuration(Duration value)

public VideoStream.H265CodecSettings.Builder setGopDuration(Duration value)

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.

.google.protobuf.Duration gop_duration = 10;

Parameter
Name Description
value Duration
Returns
Type Description
VideoStream.H265CodecSettings.Builder

setGopDuration(Duration.Builder builderForValue)

public VideoStream.H265CodecSettings.Builder setGopDuration(Duration.Builder builderForValue)

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.

.google.protobuf.Duration gop_duration = 10;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
VideoStream.H265CodecSettings.Builder

setGopFrameCount(int value)

public VideoStream.H265CodecSettings.Builder setGopFrameCount(int value)

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

int32 gop_frame_count = 9;

Parameter
Name Description
value int

The gopFrameCount to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setHeightPixels(int value)

public VideoStream.H265CodecSettings.Builder setHeightPixels(int value)

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.

int32 height_pixels = 2;

Parameter
Name Description
value int

The heightPixels to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setPixelFormat(String value)

public VideoStream.H265CodecSettings.Builder setPixelFormat(String value)

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

string pixel_format = 5;

Parameter
Name Description
value String

The pixelFormat to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setPixelFormatBytes(ByteString value)

public VideoStream.H265CodecSettings.Builder setPixelFormatBytes(ByteString value)

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

string pixel_format = 5;

Parameter
Name Description
value ByteString

The bytes for pixelFormat to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setPreset(String value)

public VideoStream.H265CodecSettings.Builder setPreset(String value)

Enforces the specified codec preset. The default is veryfast. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string preset = 19;

Parameter
Name Description
value String

The preset to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setPresetBytes(ByteString value)

public VideoStream.H265CodecSettings.Builder setPresetBytes(ByteString value)

Enforces the specified codec preset. The default is veryfast. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string preset = 19;

Parameter
Name Description
value ByteString

The bytes for preset to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setProfile(String value)

public VideoStream.H265CodecSettings.Builder setProfile(String value)

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

  • 8-bit profiles
    • main (default)
    • main-intra
    • mainstillpicture
  • 10-bit profiles
    • main10 (default)
    • main10-intra
    • main422-10
    • main422-10-intra
    • main444-10
    • main444-10-intra
  • 12-bit profiles

    • main12 (default)
    • main12-intra
    • main422-12
    • main422-12-intra
    • main444-12
    • main444-12-intra

    The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string profile = 17;

Parameter
Name Description
value String

The profile to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setProfileBytes(ByteString value)

public VideoStream.H265CodecSettings.Builder setProfileBytes(ByteString value)

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

  • 8-bit profiles
    • main (default)
    • main-intra
    • mainstillpicture
  • 10-bit profiles
    • main10 (default)
    • main10-intra
    • main422-10
    • main422-10-intra
    • main444-10
    • main444-10-intra
  • 12-bit profiles

    • main12 (default)
    • main12-intra
    • main422-12
    • main422-12-intra
    • main444-12
    • main444-12-intra

    The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string profile = 17;

Parameter
Name Description
value ByteString

The bytes for profile to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setRateControlMode(String value)

public VideoStream.H265CodecSettings.Builder setRateControlMode(String value)

Specify the rate_control_mode. The default is vbr.

Supported rate control modes:

  • vbr - variable bitrate
  • crf - constant rate factor

string rate_control_mode = 6;

Parameter
Name Description
value String

The rateControlMode to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setRateControlModeBytes(ByteString value)

public VideoStream.H265CodecSettings.Builder setRateControlModeBytes(ByteString value)

Specify the rate_control_mode. The default is vbr.

Supported rate control modes:

  • vbr - variable bitrate
  • crf - constant rate factor

string rate_control_mode = 6;

Parameter
Name Description
value ByteString

The bytes for rateControlMode to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public VideoStream.H265CodecSettings.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Name Description
field FieldDescriptor
index int
value Object
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

setTune(String value)

public VideoStream.H265CodecSettings.Builder setTune(String value)

Enforces the specified codec tune. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string tune = 18;

Parameter
Name Description
value String

The tune to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setTuneBytes(ByteString value)

public VideoStream.H265CodecSettings.Builder setTuneBytes(ByteString value)

Enforces the specified codec tune. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the H265CodecSettings message.

string tune = 18;

Parameter
Name Description
value ByteString

The bytes for tune to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setUnknownFields(UnknownFieldSet unknownFields)

public final VideoStream.H265CodecSettings.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
VideoStream.H265CodecSettings.Builder
Overrides

setVbvFullnessBits(int value)

public VideoStream.H265CodecSettings.Builder setVbvFullnessBits(int value)

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.

int32 vbv_fullness_bits = 13;

Parameter
Name Description
value int

The vbvFullnessBits to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setVbvSizeBits(int value)

public VideoStream.H265CodecSettings.Builder setVbvSizeBits(int value)

Size of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to VideoStream.bitrate_bps.

int32 vbv_size_bits = 12;

Parameter
Name Description
value int

The vbvSizeBits to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.

setWidthPixels(int value)

public VideoStream.H265CodecSettings.Builder setWidthPixels(int value)

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.

int32 width_pixels = 1;

Parameter
Name Description
value int

The widthPixels to set.

Returns
Type Description
VideoStream.H265CodecSettings.Builder

This builder for chaining.