belongs to Maven artifact androidx.palette:palette:1.0.0-alpha1

Target

public final class Target
extends Object

java.lang.Object
   ↳ androidx.palette.graphics.Target


A class which allows custom selection of colors in a Palette's generation. Instances can be created via the Target.Builder class.

To use the target, use the Palette.Builder.addTarget(Target) API when building a Palette.

Summary

Nested classes

class Target.Builder

Builder class for generating custom Target instances. 

Fields

public static final Target DARK_MUTED

A target which has the characteristics of a muted color which is dark in luminance.

public static final Target DARK_VIBRANT

A target which has the characteristics of a vibrant color which is dark in luminance.

public static final Target LIGHT_MUTED

A target which has the characteristics of a muted color which is light in luminance.

public static final Target LIGHT_VIBRANT

A target which has the characteristics of a vibrant color which is light in luminance.

public static final Target MUTED

A target which has the characteristics of a muted color which is neither light or dark.

public static final Target VIBRANT

A target which has the characteristics of a vibrant color which is neither light or dark.

Public methods

float getLightnessWeight()

Returns the weight of importance that this target places on a color's lightness within the image.

float getMaximumLightness()

The maximum lightness value for this target.

float getMaximumSaturation()

The maximum saturation value for this target.

float getMinimumLightness()

The minimum lightness value for this target.

float getMinimumSaturation()

The minimum saturation value for this target.

float getPopulationWeight()

Returns the weight of importance that this target places on a color's population within the image.

float getSaturationWeight()

Returns the weight of importance that this target places on a color's saturation within the image.

float getTargetLightness()

The target lightness value for this target.

float getTargetSaturation()

The target saturation value for this target.

boolean isExclusive()

Returns whether any color selected for this target is exclusive for this target only.

Inherited methods

Fields

DARK_MUTED

Target DARK_MUTED

A target which has the characteristics of a muted color which is dark in luminance.

DARK_VIBRANT

Target DARK_VIBRANT

A target which has the characteristics of a vibrant color which is dark in luminance.

LIGHT_MUTED

Target LIGHT_MUTED

A target which has the characteristics of a muted color which is light in luminance.

LIGHT_VIBRANT

Target LIGHT_VIBRANT

A target which has the characteristics of a vibrant color which is light in luminance.

MUTED

Target MUTED

A target which has the characteristics of a muted color which is neither light or dark.

VIBRANT

Target VIBRANT

A target which has the characteristics of a vibrant color which is neither light or dark.

Public methods

getLightnessWeight

float getLightnessWeight ()

Returns the weight of importance that this target places on a color's lightness within the image.

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

Returns
float

getMaximumLightness

float getMaximumLightness ()

The maximum lightness value for this target.

Returns
float

Value is between 0.0 and 1.0 inclusive.

getMaximumSaturation

float getMaximumSaturation ()

The maximum saturation value for this target.

Returns
float

Value is between 0.0 and 1.0 inclusive.

getMinimumLightness

float getMinimumLightness ()

The minimum lightness value for this target.

Returns
float

Value is between 0.0 and 1.0 inclusive.

getMinimumSaturation

float getMinimumSaturation ()

The minimum saturation value for this target.

Returns
float

Value is between 0.0 and 1.0 inclusive.

getPopulationWeight

float getPopulationWeight ()

Returns the weight of importance that this target places 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.

Returns
float

getSaturationWeight

float getSaturationWeight ()

Returns the weight of importance that this target places on a color's saturation within the image.

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

Returns
float

getTargetLightness

float getTargetLightness ()

The target lightness value for this target.

Returns
float

Value is between 0.0 and 1.0 inclusive.

getTargetSaturation

float getTargetSaturation ()

The target saturation value for this target.

Returns
float

Value is between 0.0 and 1.0 inclusive.

isExclusive

boolean isExclusive ()

Returns whether any color selected for this target is exclusive for this target only.

If false, then the color can be selected for other targets.

Returns
boolean