Color class

An immutable color value in ARGB format.

Consider the light teal of the Flutter logo. It is fully opaque, with a red r channel value of 0.2588 (or 0x42 or 66 as an 8-bit value), a green g channel value of 0.6471 (or 0xA5 or 165 as an 8-bit value), and a blue b channel value of 0.9608 (or 0xF5 or 245 as an 8-bit value). In a common CSS hex color syntax for RGB color values, it would be described as #42A5F5.

Here are some ways it could be constructed:

const Color c1 = Color.from(alpha: 1.0, red: 0.2588, green: 0.6471, blue: 0.9608);
const Color c2 = Color(0xFF42A5F5);
const Color c3 = Color.fromARGB(0xFF, 0x42, 0xA5, 0xF5);
const Color c4 = Color.fromARGB(255, 66, 165, 245);
const Color c5 = Color.fromRGBO(66, 165, 245, 1.0);

If you are having a problem with Color.new wherein it seems your color is just not painting, check to make sure you are specifying the full 8 hexadecimal digits. If you only specify six, then the leading two digits are assumed to be zero, which means fully-transparent:

const Color c1 = Color(0xFFFFFF); // fully transparent white (invisible)
const Color c2 = Color(0xFFFFFFFF); // fully opaque white (visible)

// Or use double-based channel values:
const Color c3 = Color.from(alpha: 1.0, red: 1.0, green: 1.0, blue: 1.0);

Color's color components are stored as floating-point values. Care should be taken if one does not want the literal equality provided by operator==. To test equality inside of Flutter tests consider using isSameColorAs.

See also:

  • Colors, which defines the colors found in the Material Design specification.
  • isSameColorAs, a Matcher to handle floating-point deltas when checking Color equality.
Implementers

Constructors

Color(int value)
Construct an ColorSpace.sRGB color from the lower 32 bits of an int.
const
Color.from({required double alpha, required double red, required double green, required double blue, ColorSpace colorSpace = ColorSpace.sRGB})
Construct a color with floating-point color components.
const
Color.fromARGB(int a, int r, int g, int b)
Construct an sRGB color from the lower 8 bits of four integers.
const
Color.fromRGBO(int r, int g, int b, double opacity)
Create an sRGB color from red, green, blue, and opacity, similar to rgba() in CSS.
const

Properties

a → double
The alpha channel of this color.
final
alpha → int
The alpha channel of this color in an 8 bit value.
no setter
b → double
The blue channel of this color.
final
blue → int
The blue channel of this color in an 8 bit value.
no setter
colorSpace → ColorSpace
The color space of this color.
final
g → double
The green channel of this color.
final
green → int
The green channel of this color in an 8 bit value.
no setter
hashCode → int
The hash code for this object.
no setteroverride
opacity → double
The alpha channel of this color as a double.
no setter
r → double
The red channel of this color.
final
red → int
The red channel of this color in an 8 bit value.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
value → int
A 32 bit value representing this color.
no setter

Methods

computeLuminance() → double
Returns a brightness value between 0 for darkest and 1 for lightest.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toARGB32() → int
Returns a 32-bit value representing this color.
toString() → String
A string representation of this object.
override
withAlpha(int a) → Color
Returns a new color that matches this color with the alpha channel replaced with a (which ranges from 0 to 255).
withBlue(int b) → Color
Returns a new color that matches this color with the blue channel replaced with b (which ranges from 0 to 255).
withGreen(int g) → Color
Returns a new color that matches this color with the green channel replaced with g (which ranges from 0 to 255).
withOpacity(double opacity) → Color
Returns a new color that matches this color with the alpha channel replaced with the given opacity (which ranges from 0.0 to 1.0).
withRed(int r) → Color
Returns a new color that matches this color with the red channel replaced with r (which ranges from 0 to 255).
withValues({double? alpha, double? red, double? green, double? blue, ColorSpace? colorSpace}) → Color
Returns a new color with the provided components updated.

Operators

operator ==(Object other) → bool
The equality operator.
override

Static Methods

alphaBlend(Color foreground, Color background) → Color
Combine the foreground color as a transparent color over top of a background color, and return the resulting combined color.
getAlphaFromOpacity(double opacity) → int
Returns an alpha value representative of the provided opacity value.
lerp(Color? x, Color? y, double t) → Color?
Linearly interpolate between two colors.