# MonochromaticImage.Builder

# MonochromaticImage.Builder

Artifact:[androidx.wear.watchface:watchface-complications-data](https://developer.android.com/jetpack/androidx/releases/wear-watchface)  
[View Source](https://cs.android.com/search?q=file:androidx/wear/watchface/complications/data/Image.kt+class:androidx.wear.watchface.complications.data.MonochromaticImage.Builder)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/wear/watchface/complications/data/MonochromaticImage.Builder "View this page in Java")

<br />

```
class MonochromaticImage.Builder
```

<br />

*** ** * ** ***

Builder for[MonochromaticImage](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage).

## Summary

|                                                                                                                         ### Public constructors                                                                                                                         |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Builder](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage.Builder#Builder(android.graphics.drawable.Icon))`(image: `[Icon](https://developer.android.com/reference/android/graphics/drawable/Icon.html)`)` |

|                                                                ### Public functions                                                                |
|----------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [MonochromaticImage](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage)                 | [build](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage.Builder#build())`()` Constructs the[MonochromaticImage](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage).                                                                                                   |
| [MonochromaticImage.Builder](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage.Builder) | [setAmbientImage](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage.Builder#setAmbientImage(android.graphics.drawable.Icon))`(ambientImage: `[Icon](https://developer.android.com/reference/android/graphics/drawable/Icon.html)`?)` Sets a different image for when the device is ambient mode to save power and prevent burn in. |

## Public constructors

### Builder

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)  

```
Builder(image: Icon)
```  

|                                          Parameters                                          |
|----------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
| `image: `[Icon](https://developer.android.com/reference/android/graphics/drawable/Icon.html) | the[Icon](https://developer.android.com/reference/android/graphics/drawable/Icon.html)representing the image |

## Public functions

### build

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)  

```
fun build(): MonochromaticImage
```

Constructs the[MonochromaticImage](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage).  

### setAmbientImage

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)  

```
fun setAmbientImage(ambientImage: Icon?): MonochromaticImage.Builder
```

Sets a different image for when the device is ambient mode to save power and prevent burn in. If no ambient variant is provided, the watch face may not show anything while in ambient mode.