public class

Color

extends Object
java.lang.Object
   ↳android.graphics.Color

Class Overview

The Color class defines methods for creating and converting color ints. Colors are represented as packed ints, made up of 4 bytes: alpha, red, green, blue. The values are unpremultiplied, meaning any transparency is stored solely in the alpha component, and not in the color components. The components are stored as follows (alpha << 24) | (red << 16) | (green << 8) | blue. Each component ranges between 0..255 with 0 meaning no contribution for that component, and 255 meaning 100% contribution. Thus opaque-black would be 0xFF000000 (100% opaque but no contributions from red, green, or blue), and opaque-white would be 0xFFFFFFFF

Summary

Constants
intBLACK
intBLUE
intCYAN
intDKGRAY
intGRAY
intGREEN
intLTGRAY
intMAGENTA
intRED
intTRANSPARENT
intWHITE
intYELLOW
Public Constructors
Color()
Public Methods
static int HSVToColor(float[] hsv)
Convert HSV components to an ARGB color.
static int HSVToColor(int alpha, float[] hsv)
Convert HSV components to an ARGB color.
static void RGBToHSV(int red, int green, int blue, float[] hsv)
Convert RGB components to HSV.
static int alpha(int color)
Return the alpha component of a color int.
static int argb(int alpha, int red, int green, int blue)
Return a color-int from alpha, red, green, blue components.
static int blue(int color)
Return the blue component of a color int.
static void colorToHSV(int color, float[] hsv)
Convert the argb color to its HSV components.
static int green(int color)
Return the green component of a color int.
static int parseColor(String colorString)
Parse the color string, and return the corresponding color-int.
static int red(int color)
Return the red component of a color int.
static int rgb(int red, int green, int blue)
Return a color-int from red, green, blue components.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int BLACK

Since: API Level 1

Constant Value: -16777216 (0xff000000)

public static final int BLUE

Since: API Level 1

Constant Value: -16776961 (0xff0000ff)

public static final int CYAN

Since: API Level 1

Constant Value: -16711681 (0xff00ffff)

public static final int DKGRAY

Since: API Level 1

Constant Value: -12303292 (0xff444444)

public static final int GRAY

Since: API Level 1

Constant Value: -7829368 (0xff888888)

public static final int GREEN

Since: API Level 1

Constant Value: -16711936 (0xff00ff00)

public static final int LTGRAY

Since: API Level 1

Constant Value: -3355444 (0xffcccccc)

public static final int MAGENTA

Since: API Level 1

Constant Value: -65281 (0xffff00ff)

public static final int RED

Since: API Level 1

Constant Value: -65536 (0xffff0000)

public static final int TRANSPARENT

Since: API Level 1

Constant Value: 0 (0x00000000)

public static final int WHITE

Since: API Level 1

Constant Value: -1 (0xffffffff)

public static final int YELLOW

Since: API Level 1

Constant Value: -256 (0xffffff00)

Public Constructors

public Color ()

Since: API Level 1

Public Methods

public static int HSVToColor (float[] hsv)

Since: API Level 1

Convert HSV components to an ARGB color. Alpha set to 0xFF. hsv[0] is Hue [0 .. 360) hsv[1] is Saturation [0...1] hsv[2] is Value [0...1] If hsv values are out of range, they are pinned.

Parameters
hsv 3 element array which holds the input HSV components.
Returns
  • the resulting argb color

public static int HSVToColor (int alpha, float[] hsv)

Since: API Level 1

Convert HSV components to an ARGB color. The alpha component is passed through unchanged. hsv[0] is Hue [0 .. 360) hsv[1] is Saturation [0...1] hsv[2] is Value [0...1] If hsv values are out of range, they are pinned.

Parameters
alpha the alpha component of the returned argb color.
hsv 3 element array which holds the input HSV components.
Returns
  • the resulting argb color

public static void RGBToHSV (int red, int green, int blue, float[] hsv)

Since: API Level 1

Convert RGB components to HSV. hsv[0] is Hue [0 .. 360) hsv[1] is Saturation [0...1] hsv[2] is Value [0...1]

Parameters
red red component value [0..255]
green green component value [0..255]
blue blue component value [0..255]
hsv 3 element array which holds the resulting HSV components.

public static int alpha (int color)

Since: API Level 1

Return the alpha component of a color int. This is the same as saying color >>> 24

public static int argb (int alpha, int red, int green, int blue)

Since: API Level 1

Return a color-int from alpha, red, green, blue components. These component values should be [0..255], but there is no range check performed, so if they are out of range, the returned color is undefined.

Parameters
alpha Alpha component [0..255] of the color
red Red component [0..255] of the color
green Green component [0..255] of the color
blue Blue component [0..255] of the color

public static int blue (int color)

Since: API Level 1

Return the blue component of a color int. This is the same as saying color & 0xFF

public static void colorToHSV (int color, float[] hsv)

Since: API Level 1

Convert the argb color to its HSV components. hsv[0] is Hue [0 .. 360) hsv[1] is Saturation [0...1] hsv[2] is Value [0...1]

Parameters
color the argb color to convert. The alpha component is ignored.
hsv 3 element array which holds the resulting HSV components.

public static int green (int color)

Since: API Level 1

Return the green component of a color int. This is the same as saying (color >> 8) & 0xFF

public static int parseColor (String colorString)

Since: API Level 1

Parse the color string, and return the corresponding color-int. If the string cannot be parsed, throws an IllegalArgumentException exception. Supported formats are: #RRGGBB #AARRGGBB 'red', 'blue', 'green', 'black', 'white', 'gray', 'cyan', 'magenta', 'yellow', 'lightgray', 'darkgray'

public static int red (int color)

Since: API Level 1

Return the red component of a color int. This is the same as saying (color >> 16) & 0xFF

public static int rgb (int red, int green, int blue)

Since: API Level 1

Return a color-int from red, green, blue components. The alpha component is implicity 255 (fully opaque). These component values should be [0..255], but there is no range check performed, so if they are out of range, the returned color is undefined.

Parameters
red Red component [0..255] of the color
green Green component [0..255] of the color
blue Blue component [0..255] of the color