Positional factory function for class com.evocomputing.colors.color.

Add an amount to the alpha (transparency) of the color, keeping it
within the allowable range of 0-255.

Shift the hue of the color around the color wheel by the specified
number of degrees. Will wrap around if it goes below 0.0 or above
360.0.

The keyword arguments which may be used to create an HSL color.

The keyword arguments which may be used to create an RGB color.

Return the alpha (int) component of this color.

Return a java.awt.Color object using this color's rgba components.

Return the blue (int) component of this color.

Check that every element is of the format:
- 1st, H (Hue): Float value in the range of: 0.0 - 360.0.
- 2nd, S (Saturation): Float value in the range: 0.0 - 100.0.
- 3rd, L (Lightness or Luminance): Float value in the range 0.0 - 100.0.

Check that every element in the passed in rgba sequence is an
integer in the range 0 - 255.

Check that every element in the passed in rgba sequence is an
integer in the range 0 - 255.

Return true if passed in float is in the range 0.0 - 360.0, false otherwise.

Clamp the hue value so that it lies in the range 0.0 - 360.0.

Clamp the floating point value to be within the range 0 - 100.0.

Clamp the integer value to be within the range 0 - 255, the legal
values for an RGB color component.

Clamp the floating point value to be within the range 0 - 1.0.

Add the RGB values of two colors together, clamping each to a maximum of 255.

Divide the RGB values of two colors.

The maximum resolution for color math; if any value is less than or
equal to this value, it is treated as zero.

Multiply the RGB values of two colors, clamping each to a maximum of 255

If there is an entry for this color value in the symbolic color
names map, return that. Otherwise, return the hexcode string of this
color's rgba integer value.

Subtract the RGB values of color2 from color 1, clamping each to a
minimum of 0.

The tolerance for comparing the components of two colors. In general,
colors are considered equal if all of their components are within this
tolerance value of each other.

Return true if rgba components are equal, and hsl float components
are within tolerance.

Create a color struct using the passed in args.

This will create a color struct that has RGBA integer values in the range:
- R (Red): Integer in range 0 - 255
- G (Green): Integer in range 0 - 255
- B (Blue): Integer in range 0 - 255
- A (Alpha): Integer in range 0 - 255, with default as 255 (100% opacity)

And HSL values with the range:
- H (Hue): Float value in the range of: 0.0 - 360.0
- S (Saturation): Float value in the range: 0.0 - 100.0
- L (Lightness or Luminance): Float value in the range 0.0 - 100.0

This multimethod is very liberal in what it will accept to create a
color. Following is a list of acceptable formats:

Single Arg
- Symbolic: Either a string or keyword or symbol that matches an entry
in the symbolic color pallete. Currently, this is defaults to the
html4 colors map and x11 colors map, but the end user of this library
can set any named palette they want.

  examples:
  (create-color "blue")
  (create-color :blue)

- Hexstring: A hex string representation of an RGB(A) color
  examples:
  (create-color "0xFFCCAA")
  (create-color "#FFCCAA")
  (create-color "Ox80FFFF00") ;; alpha = 128

- Integer: An integer representation of an RGB(A) color
  examples:
  (create-color 0xFFCCAA) ;; integer in hexidecimal format
  (create-color 16764074) ;; same integer in decimal format

- Sequence or array of RGB(A) integers
  :examples
  (create-color [255 0 0])
  (create-color [255 0 0 128]) ;;alpha = 128

- Map of either RGB (A) kw/values or HSL(A) kw/values
  Allowable RGB keys: :r :red :g :green :b :blue
  Allowable HSL keys: :h :hue :s :saturation :l :lightness

  examples:
  (create-color {:r 255 :g 0 :blue 0})
  (create-color {:r 255 :g 0 :blue 0 :a 128})
  (create-color {:h 120.0 :s 100.0 :l 50.0})
  (create-color {:h 120.0 :s 100.0 :l 50.0 :a 128})

Multiple Arg
- Sequence or array of RGB(A) integers
  :examples
  (create-color 255 0 0)
  (create-color 255 0 0 128) ;;alpha = 128

- Assoc list of either RGB (A) kw/values or HSL(A) kw/values
  Allowable RGB keys: :r :red :g :green :b :blue
  Allowable HSL keys: :h :hue :s :saturation :l :lightness

  examples:
  (create-color :r 255 :g 0 :blue 0)
  (create-color :r 255 :g 0 :blue 0 :a 128)
  (create-color :h 120.0 :s 100.0 :l 50.0)
  (create-color :h 120.0 :s 100.0 :l 50.0 :a 128)

Inspect the arguments and determine which version of the
create-color multimethod to invoke.

Decrease the lightness of the color by the specified amount, down
to a minimum of 0.0.

Decrease the saturation of the color by the specified amount, down
to a minimum of 0.0.

Remove all hue from the color, converting it to a gray with the
same lightness level.

Return the green (int) component of this color.

Convert a hexadecimal string to the corresponding array of RGBA
integer values.

Given color with HSL values return vector of r, g, b.

Based on algorithms described in:
http://en.wikipedia.org/wiki/Luminance-Hue-Saturation#Conversion_from_HSL_to_RGB
and:
http://en.wikipedia.org/wiki/Hue#Computing_hue_from_RGB
and:
http://www.w3.org/TR/css3-color/#hsl-color

Return the hue (float) component of this color.

Convert hue color to rgb components
Based on algorithm described in:
http://en.wikipedia.org/wiki/Hue#Computing_hue_from_RGB
and:
http://www.w3.org/TR/css3-color/#hsl-color

Increase the lightness of the color by the specified amount, up to
a maximum of 100.0.

Return the lightness (float) component of this color.

Factory function for class com.evocomputing.colors.color, taking a map of keywords to field values.

If alpha is a float value, try to convert to integer in range 0 -
255, otherwise return as-is.

Produce a blend between two colors, optionally weighted by the
given percentage. Takes the average of each of the RGB components,
taking into account the opacity of each color. The weight specifies
the amount of the first color that should be included in the
returned color. The default value of 50.0 means that half the first
color and half the second color should be used. A value of 25.0
would count the second color three times as much as the first.

Produce a blend between two colors in the HSL color space,
optionally weighted by the given percentage. Takes the average of
each of the HSL components (always going the shortest distance
around the hue circle), taking into account the opacity of each
color. The weight specifies the amount of the first color that
should be included in the returned color. The default value of 50.0
means that half the first color and half the second color should be
used. A value of 25.0 would count the second color three times as
much as the first.

Maps the known color names to their RGB values.

Maps the known color RGB values to their names.

Returns true if fvalue is within color-epsilon of one.

Returns true if the fvalue is within color-epsilon of zero or less
than zero.

Returns true if the fvalue is less than color-epsilon.

Shift the hue of the color halfway around the color weel, to the
opposite color.

Return true if passed in float is in the range 0.0 - 100.0, false otherwise.

Return the red (int) component of this color.

Return the hexcode string representation of this color.

Return a integer (RGB) representation of this color.

Convert a vector of the 3 rgb integer values into a color given in
numeric rgb format.

Convert a color given in numeric rgb format into a vector of the 3
rgb integer values.

Convert the integer in range 0 - 255 to float in range 0.0 - 1.0.

If the passed in value is an integer in the range 0 - 255
inclusive, return true, otherwise return false.

Given the three RGB values, convert to HSL and return vector of
Hue, Saturation, Lightness.

Based on algorithm described in:
http://en.wikipedia.org/wiki/Luminance-Hue-Saturation#Conversion_from_RGB_to_HSL_overview

Return the hexcode string representation of this color.

Return a integer (RGBA) representation of this color.

Convert a vector of the 4 rgba integer values into a color given in
numeric rgb format.

Convert a color given in numeric rgb format into a vector of the 4
rgba integer values.

Increase the saturation of the color by the specified amount, up to
a maximum of 100.0.

Return the saturation (float) component of this color.

Check that the passed in float is in the range 0.0 - 1.0, then
convert it to the appropriate integer in the range 0 - 255.

Return true if passed in float is in the range 0.0 - 1.0, false otherwise.

Check whether the two values are close enough to be considered the same.