de.javagl.colors

Class Colors

java.lang.Object

de.javagl.colors.Colors

public class Colors
extends Object

Utility methods related to colors

Method Summary

Modifier and Type	Method and Description
static Color	computeContrastingColor(int argb) Compute a color (either black or white) that as a large contrast to the given ARGB color.
static double	computeContrastRatio(int argb0, int argb1) Compute the contrast ratio between the given colors, as defined by https://www.w3.org/TR/UNDERSTANDING-WCAG20/ visual-audio-contrast-contrast.html
static double	computeLuminance(int argb) Returns the luminance of the given ARGB color
static int[]	createArgbs(List<? extends Color> colors) Creates an array containing the ARGB values of the given colors
static Color	createClamped(double r, double g, double b) Create a new color, clamping the given values to be in [0, 1]
static Color	createClamped(double r, double g, double b, double a) Create a new color, clamping the given values to be in [0, 1].
static Color	createClamped(int r, int g, int b) Create a new color, clamping the given values to be in [0, 255]
static Color	createClamped(int r, int g, int b, int a) Create a new color, clamping the given values to be in [0, 255].
static Color[]	createColors(int... argbs) Creates an array containing the colors for the given ARGB values
static int	getAlpha(int argb) Returns the alpha component of the given ARGB color
static int	getARGB(int a, int r, int g, int b) Returns the ARGB color that is composed from the given values
static int	getBlue(int argb) Returns the blue component of the given ARGB color
static int	getGreen(int argb) Returns the green component of the given ARGB color
static int	getRed(int argb) Returns the red component of the given ARGB color
static int	interpolate(int argb0, int argb1, double v) Linearly interpolate between the given ARGB colors.
static Color	interpolateClamping(Color c0, Color c1, double v) Linearly interpolate between the given colors, clamping each component to be in [0,255)
static int	interpolateClamping(int argb0, int argb1, double v) Linearly interpolate between the given ARGB colors, clamping each component to be in [0,255)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createClamped

public static Color createClamped(int r,
                                  int g,
                                  int b)

Create a new color, clamping the given values to be in [0, 255]

Parameters:

r - The red component

g - The green component

b - The blue component

Returns:

The color

createClamped

public static Color createClamped(int r,
                                  int g,
                                  int b,
                                  int a)

Create a new color, clamping the given values to be in [0, 255].

Parameters:

r - The red component

g - The green component

b - The blue component

a - The alpha component

Returns:

The color

createClamped

public static Color createClamped(double r,
                                  double g,
                                  double b)

Create a new color, clamping the given values to be in [0, 1]

Parameters:

r - The red component

g - The green component

b - The blue component

Returns:

The color

createClamped

public static Color createClamped(double r,
                                  double g,
                                  double b,
                                  double a)

Create a new color, clamping the given values to be in [0, 1].

Parameters:

r - The red component

g - The green component

b - The blue component

a - The alpha component

Returns:

The color

getAlpha

public static int getAlpha(int argb)

Returns the alpha component of the given ARGB color

Parameters:

argb - The ARGB color

Returns:

The alpha component

getRed

public static int getRed(int argb)

Returns the red component of the given ARGB color

Parameters:

argb - The ARGB color

Returns:

The red component

getGreen

public static int getGreen(int argb)

Returns the green component of the given ARGB color

Parameters:

argb - The ARGB color

Returns:

The green component

getBlue

public static int getBlue(int argb)

Returns the blue component of the given ARGB color

Parameters:

argb - The ARGB color

Returns:

The blue component

getARGB

public static int getARGB(int a,
                          int r,
                          int g,
                          int b)

Returns the ARGB color that is composed from the given values

Parameters:

a - The alpha value

r - The red value

g - The green value

b - The blue value

Returns:

The ARGB color

createArgbs

public static int[] createArgbs(List<? extends Color> colors)

Creates an array containing the ARGB values of the given colors

Parameters:

colors - The colors

Returns:

The ARGB values

createColors

public static Color[] createColors(int... argbs)

Creates an array containing the colors for the given ARGB values

Parameters:

argbs - The ARGB values

Returns:

The colors

interpolate

public static int interpolate(int argb0,
                              int argb1,
                              double v)

Linearly interpolate between the given ARGB colors.

Note: The interpolation value should be in [0,1]. Otherwise, the result may contain unexpected colors due to overflow and underflow.

Parameters:

argb0 - The first color

argb1 - The second color

v - The interpolation value

Returns:

The interpolated color

interpolateClamping

public static int interpolateClamping(int argb0,
                                      int argb1,
                                      double v)

Linearly interpolate between the given ARGB colors, clamping each component to be in [0,255)

Parameters:

argb0 - The first color

argb1 - The second color

v - The interpolation value

Returns:

The interpolated color

interpolateClamping

public static Color interpolateClamping(Color c0,
                                        Color c1,
                                        double v)

Linearly interpolate between the given colors, clamping each component to be in [0,255)

Parameters:

c0 - The first color

c1 - The second color

v - The interpolation value

Returns:

The interpolated color

computeContrastingColor

public static Color computeContrastingColor(int argb)

Compute a color (either black or white) that as a large contrast to the given ARGB color. Some details of this method are intentionally not specified.

Parameters:

argb - The ARGB color

Returns:

The contrasting color

computeContrastRatio

public static double computeContrastRatio(int argb0,
                                          int argb1)

Compute the contrast ratio between the given colors, as defined by

https://www.w3.org/TR/UNDERSTANDING-WCAG20/
   visual-audio-contrast-contrast.html

Parameters:

argb0 - The first ARGB color

argb1 - The second ARGB color

Returns:

The contrast ratio

computeLuminance

public static double computeLuminance(int argb)

Returns the luminance of the given ARGB color

Parameters:

argb - The ARGB color

Returns:

The luminance