WallpaperColors
class WallpaperColors : Parcelable
| kotlin.Any | |
| ↳ | android.app.WallpaperColors |
Provides information about the colors of a wallpaper.
Exposes the 3 most visually representative colors of a wallpaper. Can be either WallpaperColors.getPrimaryColor(), WallpaperColors.getSecondaryColor() or WallpaperColors.getTertiaryColor().
Summary
| Constants | |
|---|---|
| static Int |
Specifies that dark text is preferred over the current wallpaper for best presentation. |
| static Int |
Specifies that dark theme is preferred over the current wallpaper for best presentation. |
| Inherited constants | |
|---|---|
| Public constructors | |
|---|---|
WallpaperColors(primaryColor: Color, secondaryColor: Color?, tertiaryColor: Color?)Constructs a new object from three colors. |
|
WallpaperColors(primaryColor: Color, secondaryColor: Color?, tertiaryColor: Color?, colorHints: Int)Constructs a new object from three colors, where hints can be specified. |
|
WallpaperColors(parcel: Parcel!) |
|
| Public methods | |
|---|---|
| Int |
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
| Boolean |
Indicates whether some other object is "equal to" this one. |
| static WallpaperColors! |
fromBitmap(bitmap: Bitmap)Constructs |
| static WallpaperColors! |
fromDrawable(drawable: Drawable!)Constructs |
| Int |
Returns the color hints for this instance. |
| Color |
Gets the most visually representative color of the wallpaper. |
| Color? |
Gets the second most preeminent color of the wallpaper. |
| Color? |
Gets the third most preeminent color of the wallpaper. |
| Int |
hashCode()Returns a hash code value for the object. |
| String |
toString()Returns a string representation of the object. |
| Unit |
writeToParcel(dest: Parcel, flags: Int)Flatten this object in to a Parcel. |
| Properties | |
|---|---|
| static Parcelable.Creator<WallpaperColors!> | |
Constants
HINT_SUPPORTS_DARK_TEXT
static val HINT_SUPPORTS_DARK_TEXT: Int
Specifies that dark text is preferred over the current wallpaper for best presentation.
eg. A launcher may set its text color to black if this flag is specified.
Value: 1HINT_SUPPORTS_DARK_THEME
static val HINT_SUPPORTS_DARK_THEME: Int
Specifies that dark theme is preferred over the current wallpaper for best presentation.
eg. A launcher may set its drawer color to black if this flag is specified.
Value: 2Public constructors
WallpaperColors
WallpaperColors(
primaryColor: Color,
secondaryColor: Color?,
tertiaryColor: Color?)
Constructs a new object from three colors.
| Parameters | |
|---|---|
primaryColor |
Color: Primary color. This value cannot be null. |
secondaryColor |
Color?: Secondary color. This value may be null. |
tertiaryColor |
Color?: Tertiary color. This value may be null. |
WallpaperColors
WallpaperColors(
primaryColor: Color,
secondaryColor: Color?,
tertiaryColor: Color?,
colorHints: Int)
Constructs a new object from three colors, where hints can be specified.
| Parameters | |
|---|---|
primaryColor |
Color: Primary color. This value cannot be null. |
secondaryColor |
Color?: Secondary color. This value may be null. |
tertiaryColor |
Color?: Tertiary color. This value may be null. |
colorHints |
Int: A combination of color hints. Value is either 0 or a combination of the following:
|
Public methods
describeContents
fun describeContents(): Int
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel,int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.
| Return | |
|---|---|
Int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or
|
equals
fun equals(other: Any?): Boolean
Indicates whether some other object is "equal to" this one.
The equals method implements an equivalence relation on non-null object references:
- It is reflexive: for any non-null reference value
x,x.equals(x)should returntrue. - It is symmetric: for any non-null reference values
xandy,x.equals(y)should returntrueif and only ify.equals(x)returnstrue. - It is transitive: for any non-null reference values
x,y, andz, ifx.equals(y)returnstrueandy.equals(z)returnstrue, thenx.equals(z)should returntrue. - It is consistent: for any non-null reference values
xandy, multiple invocations ofx.equals(y)consistently returntrueor consistently returnfalse, provided no information used inequalscomparisons on the objects is modified. - For any non-null reference value
x,x.equals(null)should returnfalse.
An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.
| Parameters | |
|---|---|
obj |
the reference object with which to compare. |
o |
This value may be null. |
| Return | |
|---|---|
Boolean |
true if this object is the same as the obj argument; false otherwise. |
fromBitmap
static fun fromBitmap(bitmap: Bitmap): WallpaperColors!
Constructs WallpaperColors from a bitmap.
Main colors will be extracted from the bitmap.
| Parameters | |
|---|---|
bitmap |
Bitmap: Source where to extract from. This value cannot be null. |
fromDrawable
static fun fromDrawable(drawable: Drawable!): WallpaperColors!
Constructs WallpaperColors from a drawable.
Main colors will be extracted from the drawable.
| Parameters | |
|---|---|
drawable |
Drawable!: Source where to extract from. |
getColorHints
fun getColorHints(): Int
Returns the color hints for this instance.
| Return | |
|---|---|
Int |
The color hints. Value is either 0 or a combination of the following:
|
getPrimaryColor
fun getPrimaryColor(): Color
Gets the most visually representative color of the wallpaper. "Visually representative" means easily noticeable in the image, probably happening at high frequency. fromBitmap
| Return | |
|---|---|
Color |
A color. This value cannot be null. |
getSecondaryColor
fun getSecondaryColor(): Color?
Gets the second most preeminent color of the wallpaper. Can be null.
| Return | |
|---|---|
Color? |
A color, may be null. |
getTertiaryColor
fun getTertiaryColor(): Color?
Gets the third most preeminent color of the wallpaper. Can be null.
| Return | |
|---|---|
Color? |
A color, may be null. |
hashCode
fun hashCode(): Int
Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.
The general contract of hashCode is:
- Whenever it is invoked on the same object more than once during an execution of a Java application, the
hashCodemethod must consistently return the same integer, provided no information used inequalscomparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. - If two objects are equal according to the
equalsmethod, then calling thehashCodemethod on each of the two objects must produce the same integer result. - It is not required that if two objects are unequal according to the
equalsmethod, then calling thehashCodemethod on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
| Return | |
|---|---|
Int |
a hash code value for this object. |
toString
fun toString(): String
Returns a string representation of the object.
| Return | |
|---|---|
String |
a string representation of the object. |
writeToParcel
fun writeToParcel(
dest: Parcel,
flags: Int
): Unit
Flatten this object in to a Parcel.
| Parameters | |
|---|---|
dest |
Parcel: The Parcel in which the object should be written. This value cannot be null. |
flags |
Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of the following:
|