# Interface VideoStream.H264CodecSettingsOrBuilder (1.92.0)

1.92.0 (latest) 1.90.0 1.87.0 1.86.0 1.84.0 1.82.0 1.81.0 1.79.0 1.77.0 1.75.0 1.74.0 1.73.0 1.72.0 1.71.0 1.69.0 1.67.0 1.66.0 1.63.0 1.62.0 1.61.0 1.59.0 1.58.0 1.57.0 1.56.0 1.55.0 1.54.0 1.53.0 1.52.0 1.51.0 1.50.0 1.48.0 1.47.0 1.46.0 1.45.0 1.44.0 1.43.0 1.42.0 1.41.0 1.40.0 1.39.0 1.38.0 1.36.0 1.35.0 1.34.0 1.33.0 1.32.0 1.31.0 1.30.0 1.29.0 1.28.0 1.27.0 1.26.0 1.23.0 1.22.0 1.21.0 1.20.0 1.19.0 1.18.0 1.17.0 1.16.0 1.15.0 1.14.0 1.13.0 1.12.0 1.11.0 1.10.0 1.8.0 1.7.0 1.6.0 1.5.0 1.4.0 1.3.0 1.2.5 1.0.4 0.4.3

    public static interface VideoStream.H264CodecSettingsOrBuilder extends MessageOrBuilder

## Implements

[MessageOrBuilder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.MessageOrBuilder.html)

## Methods

### getAllowOpenGop()

    public abstract 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** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The allowOpenGop. |

### getAqStrength()

    public abstract 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 = 17;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The aqStrength. |

### getBFrameCount()

    public abstract int getBFrameCount()

The number of consecutive B-frames. Must be greater than or equal to
zero. Must be less than
H264CodecSettings.gop_frame_count
if set. The default is 0.

`int32 b_frame_count = 16;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The bFrameCount. |

### getBPyramid()

    public abstract boolean getBPyramid()

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

`bool b_pyramid = 15;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The bPyramid. |

### getBitrateBps()

    public abstract 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** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The bitrateBps. |

### getColorFormatCase()

    public abstract VideoStream.H264CodecSettings.ColorFormatCase getColorFormatCase()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264CodecSettings.ColorFormatCase` |   |

### getCrfLevel()

    public abstract 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** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The crfLevel. |

### getEnableTwoPass()

    public abstract boolean getEnableTwoPass()

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

`bool enable_two_pass = 11;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The enableTwoPass. |

### getEntropyCoder()

    public abstract String getEntropyCoder()

The entropy coder to use. The default is `cabac`.

Supported entropy coders:

- `cavlc`
- `cabac`

`string entropy_coder = 14;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The entropyCoder. |

### getEntropyCoderBytes()

    public abstract ByteString getEntropyCoderBytes()

The entropy coder to use. The default is `cabac`.

Supported entropy coders:

- `cavlc`
- `cabac`

`string entropy_coder = 14;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for entropyCoder. |

### getFrameRate()

    public abstract double getFrameRate()

Required. The target video frame rate in frames per second (FPS). Must be
less than or equal to 120.

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

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The frameRate. |

### getFrameRateConversionStrategy()

    public abstract VideoStream.FrameRateConversionStrategy getFrameRateConversionStrategy()

Optional. Frame rate conversion strategy for desired frame rate. The
default is `DOWNSAMPLE`.

`
.google.cloud.video.transcoder.v1.VideoStream.FrameRateConversionStrategy frame_rate_conversion_strategy = 23 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.FrameRateConversionStrategy` | The frameRateConversionStrategy. |

### getFrameRateConversionStrategyValue()

    public abstract int getFrameRateConversionStrategyValue()

Optional. Frame rate conversion strategy for desired frame rate. The
default is `DOWNSAMPLE`.

`
.google.cloud.video.transcoder.v1.VideoStream.FrameRateConversionStrategy frame_rate_conversion_strategy = 23 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The enum numeric value on the wire for frameRateConversionStrategy. |

### getGopDuration()

    public abstract 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`](https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264CodecSettingsOrBuilder#SegmentSettings), and
[`segmentDuration`](https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264CodecSettingsOrBuilder#SegmentSettings) must be divisible by
`gopDuration`.

`.google.protobuf.Duration gop_duration = 10;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.Duration.html` | The gopDuration. |

### getGopDurationOrBuilder()

    public abstract 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`](https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264CodecSettingsOrBuilder#SegmentSettings), and
[`segmentDuration`](https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264CodecSettingsOrBuilder#SegmentSettings) must be divisible by
`gopDuration`.

`.google.protobuf.Duration gop_duration = 10;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.DurationOrBuilder.html` |   |

### getGopFrameCount()

    public abstract 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** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The gopFrameCount. |

### getGopModeCase()

    public abstract VideoStream.H264CodecSettings.GopModeCase getGopModeCase()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264CodecSettings.GopModeCase` |   |

### getHeightPixels()

    public abstract 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** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The heightPixels. |

### getHlg()

    public abstract VideoStream.H264ColorFormatHLG getHlg()

Optional. HLG color format setting for H264.

`
.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatHLG hlg = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatHLG` | The hlg. |

### getHlgOrBuilder()

    public abstract VideoStream.H264ColorFormatHLGOrBuilder getHlgOrBuilder()

Optional. HLG color format setting for H264.

`
.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatHLG hlg = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatHLGOrBuilder` |   |

### getPixelFormat()

    public abstract 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** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The pixelFormat. |

### getPixelFormatBytes()

    public abstract 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** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for pixelFormat. |

### getPreset()

    public abstract String getPreset()

Enforces the specified codec preset. The default is `veryfast`. The
available options are
[FFmpeg-compatible](https://trac.ffmpeg.org/wiki/Encode/H.264#Preset).
Note that certain values for this field may cause the
transcoder to override other fields you set in the `H264CodecSettings`
message.

`string preset = 20;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The preset. |

### getPresetBytes()

    public abstract ByteString getPresetBytes()

Enforces the specified codec preset. The default is `veryfast`. The
available options are
[FFmpeg-compatible](https://trac.ffmpeg.org/wiki/Encode/H.264#Preset).
Note that certain values for this field may cause the
transcoder to override other fields you set in the `H264CodecSettings`
message.

`string preset = 20;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for preset. |

### getProfile()

    public abstract String getProfile()

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

- `baseline`
- `main`
- `high` (default)

  The available options are
  [FFmpeg-compatible](https://trac.ffmpeg.org/wiki/Encode/H.264#Tune).
  Note that certain values for this field may cause the
  transcoder to override other fields you set in the `H264CodecSettings`
  message.

`string profile = 18;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The profile. |

### getProfileBytes()

    public abstract ByteString getProfileBytes()

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

- `baseline`
- `main`
- `high` (default)

  The available options are
  [FFmpeg-compatible](https://trac.ffmpeg.org/wiki/Encode/H.264#Tune).
  Note that certain values for this field may cause the
  transcoder to override other fields you set in the `H264CodecSettings`
  message.

`string profile = 18;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for profile. |

### getRateControlMode()

    public abstract String getRateControlMode()

Specify the mode. The default is `vbr`.

Supported rate control modes:

- `vbr` - variable bitrate
- `crf` - constant rate factor

`string rate_control_mode = 6;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The rateControlMode. |

### getRateControlModeBytes()

    public abstract ByteString getRateControlModeBytes()

Specify the mode. The default is `vbr`.

Supported rate control modes:

- `vbr` - variable bitrate
- `crf` - constant rate factor

`string rate_control_mode = 6;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for rateControlMode. |

### getSdr()

    public abstract VideoStream.H264ColorFormatSDR getSdr()

Optional. SDR color format setting for H264.

`
.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatSDR sdr = 21 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatSDR` | The sdr. |

### getSdrOrBuilder()

    public abstract VideoStream.H264ColorFormatSDROrBuilder getSdrOrBuilder()

Optional. SDR color format setting for H264.

`
.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatSDR sdr = 21 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatSDROrBuilder` |   |

### getTune()

    public abstract String getTune()

Enforces the specified codec tune. The available options are
[FFmpeg-compatible](https://trac.ffmpeg.org/wiki/Encode/H.264#Tune).
Note that certain values for this field may cause the
transcoder to override other fields you set in the `H264CodecSettings`
message.

`string tune = 19;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The tune. |

### getTuneBytes()

    public abstract ByteString getTuneBytes()

Enforces the specified codec tune. The available options are
[FFmpeg-compatible](https://trac.ffmpeg.org/wiki/Encode/H.264#Tune).
Note that certain values for this field may cause the
transcoder to override other fields you set in the `H264CodecSettings`
message.

`string tune = 19;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for tune. |

### getVbvFullnessBits()

    public abstract 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
H264CodecSettings.vbv_size_bits.

`int32 vbv_fullness_bits = 13;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The vbvFullnessBits. |

### getVbvSizeBits()

    public abstract int getVbvSizeBits()

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

`int32 vbv_size_bits = 12;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The vbvSizeBits. |

### getWidthPixels()

    public abstract 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** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The widthPixels. |

### hasGopDuration()

    public abstract 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`](https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264CodecSettingsOrBuilder#SegmentSettings), and
[`segmentDuration`](https://docs.cloud.google.com/java/docs/reference/google-cloud-video-transcoder/latest/com.google.cloud.video.transcoder.v1.VideoStream.H264CodecSettingsOrBuilder#SegmentSettings) must be divisible by
`gopDuration`.

`.google.protobuf.Duration gop_duration = 10;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the gopDuration field is set. |

### hasGopFrameCount()

    public abstract 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** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the gopFrameCount field is set. |

### hasHlg()

    public abstract boolean hasHlg()

Optional. HLG color format setting for H264.

`
.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatHLG hlg = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the hlg field is set. |

### hasSdr()

    public abstract boolean hasSdr()

Optional. SDR color format setting for H264.

`
.google.cloud.video.transcoder.v1.VideoStream.H264ColorFormatSDR sdr = 21 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the sdr field is set. |