# ExtensionMode

Artifact: [androidx.camera:camera-extensions](https://developer.android.com/jetpack/androidx/releases/camera) [View Source](https://cs.android.com/search?q=file:androidx/camera/extensions/ExtensionMode.java+class:androidx.camera.extensions.ExtensionMode) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/camera#1.1.0)

*** ** * ** ***


```
class ExtensionMode
```

<br />

*** ** * ** ***

The available modes for the extensions.

## Summary

| ### Constants |
|---|---|
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/camera/extensions/ExtensionMode#AUTO() = 5` Automatically adjusts the final image with the surrounding scenery. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/camera/extensions/ExtensionMode#BOKEH() = 1` Bokeh mode blurs the background of a photo. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/camera/extensions/ExtensionMode#FACE_RETOUCH() = 4` Retouches face skin tone, geometry and so on when taking still images. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/camera/extensions/ExtensionMode#HDR() = 2` HDR mode takes photos that keep a larger range of scene illumination levels visible in the final image. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/camera/extensions/ExtensionMode#NIGHT() = 3` Gets the best still images under low-light situations, typically at night time. |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/camera/extensions/ExtensionMode#NONE() = 0` Normal mode without any specific effect applied. |

## Constants

### AUTO

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/camera#1.1.0)

```
const val AUTO = 5: Int
```

Automatically adjusts the final image with the surrounding scenery. For example, the vendor library implementation might do the low light detection and can switch to low light mode or HDR to take the picture. Or the face retouch mode can be automatically applied when taking a portrait image. This delegates modes to the vendor library implementation to decide.

### BOKEH

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/camera#1.1.0)

```
const val BOKEH = 1: Int
```

Bokeh mode blurs the background of a photo. It is generally intended for taking portrait photos of people like what would be produced by a camera with a large lens.

### FACE_RETOUCH

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/camera#1.1.0)

```
const val FACE_RETOUCH = 4: Int
```

Retouches face skin tone, geometry and so on when taking still images.

### HDR

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/camera#1.1.0)

```
const val HDR = 2: Int
```

HDR mode takes photos that keep a larger range of scene illumination levels visible in the final image. For example, when taking a picture of an object in front of a bright window, both the object and the scene through the window may be visible when using HDR mode, while in normal mode, one or the other may be poorly exposed. As a tradeoff, HDR mode generally takes much longer to capture a single image, has no user control, and may have other artifacts depending on the HDR method used.

### NIGHT

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/camera#1.1.0)

```
const val NIGHT = 3: Int
```

Gets the best still images under low-light situations, typically at night time.

### NONE

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/camera#1.1.0)

```
const val NONE = 0: Int
```

Normal mode without any specific effect applied.