# ColorInfo.Builder

Artifact: [androidx.media3:media3-common](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/common/ColorInfo.java+class:androidx.media3.common.ColorInfo.Builder)

*** ** * ** ***


```
class ColorInfo.Builder
```

<br />

*** ** * ** ***

Builds `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo` instances.

Use `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo#buildUpon()` to obtain a builder representing an existing `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo`.

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder#Builder()()` Creates a new instance with default values. |

| ### Public functions |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo!` | `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder#build()()` Builds a new `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo` instance. |
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder#setChromaBitdepth(int)(chromaBitdepth: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Sets chroma bit depth. |
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder#setColorRange(int)(colorRange: @https://developer.android.com/reference/kotlin/androidx/media3/common/C.ColorRange https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Sets the color range. |
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder#setColorSpace(int)(@https://developer.android.com/reference/kotlin/androidx/media3/common/C.ColorSpace colorSpace: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Sets the color space. |
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder#setColorTransfer(int)(@https://developer.android.com/reference/kotlin/androidx/media3/common/C.ColorTransfer colorTransfer: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Sets the color transfer. |
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder#setHdrStaticInfo(byte[])(hdrStaticInfo: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-byte-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-byte/index.html>?)` Sets the HdrStaticInfo as defined in CTA-861.3. |
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder#setLumaBitdepth(int)(lumaBitdepth: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Sets the luma bit depth. |

## Public constructors

### Builder

```
Builder()
```

Creates a new instance with default values.

## Public functions

### build

```
fun build(): ColorInfo!
```

Builds a new `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo` instance.

### setChromaBitdepth

```
@CanIgnoreReturnValue
fun setChromaBitdepth(chromaBitdepth: Int): ColorInfo.Builder!
```

Sets chroma bit depth.

| Parameters |
|---|---|
| `chromaBitdepth: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | The chromaBitdepth. The default value is `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#NO_VALUE()`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | The builder. |

### setColorRange

```
@CanIgnoreReturnValue
fun setColorRange(colorRange: @C.ColorRange Int): ColorInfo.Builder!
```

Sets the color range.

Valid values are `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_RANGE_LIMITED()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_RANGE_FULL()` or `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#NO_VALUE()` if unknown.

| Parameters |
|---|---|
| `colorRange: @https://developer.android.com/reference/kotlin/androidx/media3/common/C.ColorRange https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | The color range. The default value is `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#NO_VALUE()`. Value is one of the following: - `Format.NO_VALUE` <br /> |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | This `Builder`. |

### setColorSpace

```
@CanIgnoreReturnValue
fun setColorSpace(@C.ColorSpace colorSpace: Int): ColorInfo.Builder!
```

Sets the color space.

Valid values are `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_SPACE_BT601()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_SPACE_BT709()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_SPACE_BT2020()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_SPACE_DISPLAY_P3()` or `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#NO_VALUE()` if unknown.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/kotlin/androidx/media3/common/C.ColorSpace colorSpace: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | The color space. The default value is `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#NO_VALUE()`. Value is one of the following: - `Format.NO_VALUE` <br /> |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | This `Builder`. |

### setColorTransfer

```
@CanIgnoreReturnValue
fun setColorTransfer(@C.ColorTransfer colorTransfer: Int): ColorInfo.Builder!
```

Sets the color transfer.

Valid values are `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_TRANSFER_LINEAR()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_TRANSFER_HLG()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_TRANSFER_ST2084()`, `https://developer.android.com/reference/kotlin/androidx/media3/common/C#COLOR_TRANSFER_SDR()` or `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#NO_VALUE()` if unknown.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/kotlin/androidx/media3/common/C.ColorTransfer colorTransfer: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | The color transfer. The default value is `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#NO_VALUE()`. Value is one of the following: - `Format.NO_VALUE` <br /> |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | This `Builder`. |

### setHdrStaticInfo

```
@CanIgnoreReturnValue
fun setHdrStaticInfo(hdrStaticInfo: ByteArray<Byte>?): ColorInfo.Builder!
```

Sets the HdrStaticInfo as defined in CTA-861.3.

| Parameters |
|---|---|
| `hdrStaticInfo: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-byte-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-byte/index.html>?` | The HdrStaticInfo. The default value is `null`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | This `Builder`. |

### setLumaBitdepth

```
@CanIgnoreReturnValue
fun setLumaBitdepth(lumaBitdepth: Int): ColorInfo.Builder!
```

Sets the luma bit depth.

| Parameters |
|---|---|
| `lumaBitdepth: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | The lumaBitdepth. The default value is `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#NO_VALUE()`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/ColorInfo.Builder!` | The builder. |