# Target.Builder

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  
belongs to Maven artifact com.android.support:palette-v7:28.0.0-alpha1  
Summary:[Ctors](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#pubctors)\|[Methods](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#)  

# Target.Builder

| This package is part of the Android[support library](https://developer.android.com/topic/libraries/support-library)which is no longer maintained. The support library has been superseded by[AndroidX](https://developer.android.com/jetpack/androidx)which is part of[Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider[migrating](https://developer.android.com/jetpack/androidx/migrate)existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library[class mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings).

`
public
static
final

class
Target.Builder
`  
`

extends Object


``


`

|---|--------------------------------------------|
| java.lang.Object                              ||
| ↳ | android.support.v7.graphics.Target.Builder |

<br />

*** ** * ** ***

Builder class for generating custom[Target](https://developer.android.com/reference/android/support/v7/graphics/Target)instances.

## Summary

|                                                                                                                                                                                    ### Public constructors                                                                                                                                                                                     ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#Target.Builder())`() ` Create a new[Target](https://developer.android.com/reference/android/support/v7/graphics/Target)builder from scratch.                                                                                                                                         |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#Target.Builder(android.support.v7.graphics.Target))`(`[Target](https://developer.android.com/reference/android/support/v7/graphics/Target)` target) ` Create a new builder based on an existing[Target](https://developer.android.com/reference/android/support/v7/graphics/Target). |

|                                                                                                                                                                          ### Public methods                                                                                                                                                                          ||
|---------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[Target](https://developer.android.com/reference/android/support/v7/graphics/Target)                 | ` `[build](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#build())`() ` Builds and returns the resulting[Target](https://developer.android.com/reference/android/support/v7/graphics/Target).                           |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setExclusive](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setExclusive(boolean))`(boolean exclusive) ` Set whether any color selected for this target is exclusive to this target only.                          |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setLightnessWeight](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setLightnessWeight(float))`(float weight) ` Set the weight of importance that this target will place on lightness values.                        |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setMaximumLightness](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setMaximumLightness(float))`(float value) ` Set the maximum lightness value for this target.                                                    |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setMaximumSaturation](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setMaximumSaturation(float))`(float value) ` Set the maximum saturation value for this target.                                                 |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setMinimumLightness](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setMinimumLightness(float))`(float value) ` Set the minimum lightness value for this target.                                                    |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setMinimumSaturation](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setMinimumSaturation(float))`(float value) ` Set the minimum saturation value for this target.                                                 |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setPopulationWeight](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setPopulationWeight(float))`(float weight) ` Set the weight of importance that this target will place on a color's population within the image. |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setSaturationWeight](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setSaturationWeight(float))`(float weight) ` Set the weight of importance that this target will place on saturation values.                     |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setTargetLightness](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setTargetLightness(float))`(float value) ` Set the target/ideal lightness value for this target.                                                 |
| ` `[Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | ` `[setTargetSaturation](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setTargetSaturation(float))`(float value) ` Set the target/ideal saturation value for this target.                                              |

| ### Inherited methods |
|-----------------------|---|
| [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#)From class` java.lang.Object ` |-------------------|-------------------------------| | ` Object`         | ` clone() `                   | | ` boolean`        | ` equals(Object arg0) `       | | ` void`           | ` finalize() `                | | ` final Class<?>` | ` getClass() `                | | ` int`            | ` hashCode() `                | | ` final void`     | ` notify() `                  | | ` final void`     | ` notifyAll() `               | | ` String`         | ` toString() `                | | ` final void`     | ` wait(long arg0, int arg1) ` | | ` final void`     | ` wait(long arg0) `           | | ` final void`     | ` wait() `                    | ||

## Public constructors

### Target.Builder

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder ()
```

Create a new[Target](https://developer.android.com/reference/android/support/v7/graphics/Target)builder from scratch.

<br />

### Target.Builder

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder (Target target)
```

Create a new builder based on an existing[Target](https://developer.android.com/reference/android/support/v7/graphics/Target).

<br />

|        Parameters         ||
|----------|-----------------|
| `target` | `Target` <br /> |

## Public methods

### build

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target build ()
```

Builds and returns the resulting[Target](https://developer.android.com/reference/android/support/v7/graphics/Target).

<br />

|                                           Returns                                            ||
|--------------------------------------------------------------------------------------|--------|
| [Target](https://developer.android.com/reference/android/support/v7/graphics/Target) | <br /> |

### setExclusive

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setExclusive (boolean exclusive)
```

Set whether any color selected for this target is exclusive to this target only. Defaults to true.

<br />

|                                                                 Parameters                                                                 ||
|-------------|-------------------------------------------------------------------------------------------------------------------------------|
| `exclusive` | `boolean`: true if any the color is exclusive to this target, or false is the color can be selected for other targets. <br /> |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

### setLightnessWeight

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setLightnessWeight (float weight)
```

Set the weight of importance that this target will place on lightness values.

The larger the weight, relative to the other weights, the more important that a color being close to the target value has on selection.

A weight of 0 means that it has no weight, and thus has no bearing on the selection.

<br />

<br />

|                 Parameters                 ||
|----------|----------------------------------|
| `weight` | `float` Value is 0.0 or greater. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

**See also:**

- [setTargetLightness(float)](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setTargetLightness(float))  

### setMaximumLightness

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setMaximumLightness (float value)
```

Set the maximum lightness value for this target.

<br />

|                        Parameters                        ||
|---------|-------------------------------------------------|
| `value` | `float` Value is between 0.0 and 1.0 inclusive. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

### setMaximumSaturation

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setMaximumSaturation (float value)
```

Set the maximum saturation value for this target.

<br />

|                        Parameters                        ||
|---------|-------------------------------------------------|
| `value` | `float` Value is between 0.0 and 1.0 inclusive. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

### setMinimumLightness

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setMinimumLightness (float value)
```

Set the minimum lightness value for this target.

<br />

|                        Parameters                        ||
|---------|-------------------------------------------------|
| `value` | `float` Value is between 0.0 and 1.0 inclusive. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

### setMinimumSaturation

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setMinimumSaturation (float value)
```

Set the minimum saturation value for this target.

<br />

|                        Parameters                        ||
|---------|-------------------------------------------------|
| `value` | `float` Value is between 0.0 and 1.0 inclusive. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

### setPopulationWeight

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setPopulationWeight (float weight)
```

Set the weight of importance that this target will place on a color's population within the image.

The larger the weight, relative to the other weights, the more important that a color's population being close to the most populous has on selection.

A weight of 0 means that it has no weight, and thus has no bearing on the selection.

<br />

<br />

|                 Parameters                 ||
|----------|----------------------------------|
| `weight` | `float` Value is 0.0 or greater. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

### setSaturationWeight

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setSaturationWeight (float weight)
```

Set the weight of importance that this target will place on saturation values.

The larger the weight, relative to the other weights, the more important that a color being close to the target value has on selection.

A weight of 0 means that it has no weight, and thus has no bearing on the selection.

<br />

<br />

|                 Parameters                 ||
|----------|----------------------------------|
| `weight` | `float` Value is 0.0 or greater. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

**See also:**

- [setTargetSaturation(float)](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder#setTargetSaturation(float))  

### setTargetLightness

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setTargetLightness (float value)
```

Set the target/ideal lightness value for this target.

<br />

|                        Parameters                        ||
|---------|-------------------------------------------------|
| `value` | `float` Value is between 0.0 and 1.0 inclusive. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

### setTargetSaturation

added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
Target.Builder setTargetSaturation (float value)
```

Set the target/ideal saturation value for this target.

<br />

|                        Parameters                        ||
|---------|-------------------------------------------------|
| `value` | `float` Value is between 0.0 and 1.0 inclusive. |

|                                                   Returns                                                    ||
|------------------------------------------------------------------------------------------------------|--------|
| [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder) | <br /> |

-

  ## Interfaces

  - [Palette.Filter](https://developer.android.com/reference/android/support/v7/graphics/Palette.Filter)
  - [Palette.PaletteAsyncListener](https://developer.android.com/reference/android/support/v7/graphics/Palette.PaletteAsyncListener)
-

  ## Classes

  - [Palette](https://developer.android.com/reference/android/support/v7/graphics/Palette)
  - [Palette.Builder](https://developer.android.com/reference/android/support/v7/graphics/Palette.Builder)
  - [Palette.Swatch](https://developer.android.com/reference/android/support/v7/graphics/Palette.Swatch)
  - [Target](https://developer.android.com/reference/android/support/v7/graphics/Target)
  - [Target.Builder](https://developer.android.com/reference/android/support/v7/graphics/Target.Builder)