public
final
class
Palette
extends Object
java.lang.Object | |
↳ | android.support.v7.graphics.Palette |
A helper class to extract prominent colors from an image.
A number of colors with different profiles are extracted from the image:
Instances are created with a Palette.Builder
which supports several options to tweak the
generated Palette. See that class' documentation for more information.
Generation should always be completed on a background thread, ideally the one in
which you load your image on. Palette.Builder
supports both synchronous and asynchronous
generation:
// Synchronous Palette p = Palette.from(bitmap).generate(); // Asynchronous Palette.from(bitmap).generate(new PaletteAsyncListener() { public void onGenerated(Palette p) { // Use generated instance } });
Nested classes | |
---|---|
class |
Palette.Builder
Builder class for generating |
interface |
Palette.Filter
A Filter provides a mechanism for exercising fine-grained control over which colors
are valid within a resulting |
interface |
Palette.PaletteAsyncListener
Listener to be used with |
class |
Palette.Swatch
Represents a color swatch generated from an image's palette. |
Public methods | |
---|---|
static
Palette
|
from(List<Palette.Swatch> swatches)
Generate a |
static
Palette.Builder
|
from(Bitmap bitmap)
Start generating a |
static
Palette
|
generate(Bitmap bitmap, int numColors)
This method is deprecated.
Use |
static
Palette
|
generate(Bitmap bitmap)
This method is deprecated.
Use |
static
AsyncTask<Bitmap, Void, Palette>
|
generateAsync(Bitmap bitmap, int numColors, Palette.PaletteAsyncListener listener)
This method is deprecated.
Use |
static
AsyncTask<Bitmap, Void, Palette>
|
generateAsync(Bitmap bitmap, Palette.PaletteAsyncListener listener)
This method is deprecated.
Use |
int
|
getColorForTarget(Target target, int defaultColor)
Returns the selected color for the given target from the palette as an RGB packed int. |
int
|
getDarkMutedColor(int defaultColor)
Returns a muted and dark color from the palette as an RGB packed int. |
Palette.Swatch
|
getDarkMutedSwatch()
Returns a muted and dark swatch from the palette. |
int
|
getDarkVibrantColor(int defaultColor)
Returns a dark and vibrant color from the palette as an RGB packed int. |
Palette.Swatch
|
getDarkVibrantSwatch()
Returns a dark and vibrant swatch from the palette. |
int
|
getLightMutedColor(int defaultColor)
Returns a muted and light color from the palette as an RGB packed int. |
Palette.Swatch
|
getLightMutedSwatch()
Returns a muted and light swatch from the palette. |
int
|
getLightVibrantColor(int defaultColor)
Returns a light and vibrant color from the palette as an RGB packed int. |
Palette.Swatch
|
getLightVibrantSwatch()
Returns a light and vibrant swatch from the palette. |
int
|
getMutedColor(int defaultColor)
Returns a muted color from the palette as an RGB packed int. |
Palette.Swatch
|
getMutedSwatch()
Returns a muted swatch from the palette. |
Palette.Swatch
|
getSwatchForTarget(Target target)
Returns the selected swatch for the given target from the palette, or |
List<Palette.Swatch>
|
getSwatches()
Returns all of the swatches which make up the palette. |
List<Target>
|
getTargets()
Returns the targets used to generate this palette. |
int
|
getVibrantColor(int defaultColor)
Returns the most vibrant color in the palette as an RGB packed int. |
Palette.Swatch
|
getVibrantSwatch()
Returns the most vibrant swatch in the palette. |
Inherited methods | |
---|---|
From
class
java.lang.Object
|
Palette from (List<Palette.Swatch> swatches)
Generate a Palette
from the pre-generated list of Palette.Swatch
swatches.
This is useful for testing, or if you want to resurrect a Palette
instance from a
list of swatches. Will return null if the swatches
is null.
Parameters | |
---|---|
swatches |
List
|
Returns | |
---|---|
Palette |
Palette.Builder from (Bitmap bitmap)
Start generating a Palette
with the returned Palette.Builder
instance.
Parameters | |
---|---|
bitmap |
Bitmap
|
Returns | |
---|---|
Palette.Builder |
Palette generate (Bitmap bitmap, int numColors)
This method is deprecated.
Use Palette.Builder
to generate the Palette.
Parameters | |
---|---|
bitmap |
Bitmap
|
numColors |
int
|
Returns | |
---|---|
Palette |
Palette generate (Bitmap bitmap)
This method is deprecated.
Use Palette.Builder
to generate the Palette.
Parameters | |
---|---|
bitmap |
Bitmap
|
Returns | |
---|---|
Palette |
AsyncTask<Bitmap, Void, Palette> generateAsync (Bitmap bitmap, int numColors, Palette.PaletteAsyncListener listener)
This method is deprecated.
Use Palette.Builder
to generate the Palette.
Parameters | |
---|---|
bitmap |
Bitmap
|
numColors |
int
|
listener |
Palette.PaletteAsyncListener
|
Returns | |
---|---|
AsyncTask<Bitmap, Void, Palette> |
AsyncTask<Bitmap, Void, Palette> generateAsync (Bitmap bitmap, Palette.PaletteAsyncListener listener)
This method is deprecated.
Use Palette.Builder
to generate the Palette.
Parameters | |
---|---|
bitmap |
Bitmap
|
listener |
Palette.PaletteAsyncListener
|
Returns | |
---|---|
AsyncTask<Bitmap, Void, Palette> |
int getColorForTarget (Target target, int defaultColor)
Returns the selected color for the given target from the palette as an RGB packed int.
Parameters | |
---|---|
target |
Target
|
defaultColor |
int :
value to return if the swatch isn't available
|
Returns | |
---|---|
int |
int getDarkMutedColor (int defaultColor)
Returns a muted and dark color from the palette as an RGB packed int.
Parameters | |
---|---|
defaultColor |
int :
value to return if the swatch isn't available |
Returns | |
---|---|
int |
See also:
Palette.Swatch getDarkMutedSwatch ()
Returns a muted and dark swatch from the palette. Might be null.
Returns | |
---|---|
Palette.Swatch |
See also:
int getDarkVibrantColor (int defaultColor)
Returns a dark and vibrant color from the palette as an RGB packed int.
Parameters | |
---|---|
defaultColor |
int :
value to return if the swatch isn't available |
Returns | |
---|---|
int |
See also:
Palette.Swatch getDarkVibrantSwatch ()
Returns a dark and vibrant swatch from the palette. Might be null.
Returns | |
---|---|
Palette.Swatch |
See also:
int getLightMutedColor (int defaultColor)
Returns a muted and light color from the palette as an RGB packed int.
Parameters | |
---|---|
defaultColor |
int :
value to return if the swatch isn't available |
Returns | |
---|---|
int |
See also:
Palette.Swatch getLightMutedSwatch ()
Returns a muted and light swatch from the palette. Might be null.
Returns | |
---|---|
Palette.Swatch |
See also:
int getLightVibrantColor (int defaultColor)
Returns a light and vibrant color from the palette as an RGB packed int.
Parameters | |
---|---|
defaultColor |
int :
value to return if the swatch isn't available |
Returns | |
---|---|
int |
See also:
Palette.Swatch getLightVibrantSwatch ()
Returns a light and vibrant swatch from the palette. Might be null.
Returns | |
---|---|
Palette.Swatch |
See also:
int getMutedColor (int defaultColor)
Returns a muted color from the palette as an RGB packed int.
Parameters | |
---|---|
defaultColor |
int :
value to return if the swatch isn't available |
Returns | |
---|---|
int |
See also:
Palette.Swatch getMutedSwatch ()
Returns a muted swatch from the palette. Might be null.
Returns | |
---|---|
Palette.Swatch |
See also:
Palette.Swatch getSwatchForTarget (Target target)
Returns the selected swatch for the given target from the palette, or null
if one
could not be found.
Parameters | |
---|---|
target |
Target
|
Returns | |
---|---|
Palette.Swatch |
List<Palette.Swatch> getSwatches ()
Returns all of the swatches which make up the palette.
Returns | |
---|---|
List<Palette.Swatch> |
List<Target> getTargets ()
Returns the targets used to generate this palette.
Returns | |
---|---|
List<Target> |
int getVibrantColor (int defaultColor)
Returns the most vibrant color in the palette as an RGB packed int.
Parameters | |
---|---|
defaultColor |
int :
value to return if the swatch isn't available |
Returns | |
---|---|
int |
See also:
Palette.Swatch getVibrantSwatch ()
Returns the most vibrant swatch in the palette. Might be null.
Returns | |
---|---|
Palette.Swatch |
See also: