Color Harmony provides methods useful for color combination discovery.
_adjustOffsetAndFinish
color
offsets
to
Takes an HSL array, and an array of offsets and returns and array of colors that have been adjusted. The returned colors will match the array of offsets provided. If you wish you have the same color value returned, you can provide null or an empty object to the offsets. The returned array will contain color value strings that have been adjusted from subtractive to additive.
_constrainHue
hue
[precision]
Contrain the hue to a value between 0 and 360 for calculations and real color wheel value space. Provide a precision value to round return value to a decimal place
Constrained hue value
_finish
hsla
[to]
Converts the provided HSLA values from subtractive to additive returning a converted color string
_searchLuminanceForBrightness
color
brightness
min
max
Calculates the luminance as a mid range between the min and max to match the brightness level provided
Found luminance to achieve requested brightness
_start
str
Converts the provided color from additive to subtractive returning an Array of HSLA values
str
String
_toAdditive
hue
Adjusts the hue degree from subtractive to additive
hue
Number
Converted additive hue
_toSubtractive
hue
Adjusts the hue degree from additive to subtractive
hue
Number
Converted subtractive hue
getAnalogous
str
[offset]
[to]
Returns an Array of five colors. The first color in the Array will be the color passed in. The remaining four will be analogous colors two in either direction from the initially provided color.
getBrightness
str
Returns 0 - 100 percentage of brightness from 0
(black) being the
darkest to 100
(white) being the brightest.
str
String
getComplementary
str
[to]
Returns an Array of two colors. The first color in the Array will be the color passed in. The second will be the complementary color of the color provided
getMonochrome
str
[count]
[to]
Calculates lightness offsets resulting in a monochromatic Array of values.
getOffset
str
adjust
[to]
Adjusts the provided color by the offset(s) given. You may adjust hue, saturation, and/or luminance in one step.
getSimilar
str
[offset]
[count]
[to]
Creates an Array of similar colors. Returned Array is prepended with the color provided followed a number of colors decided by count
getSimilarBrightness
str
match
[to]
Returns a new color value with adjusted luminance so that the
brightness of the return color matches the perceived brightness
of the match
color provided.
getSplit
str
[offset]
[to]
Returns an Array of three colors. The first color in the Array will be the color passed in. The second two will be split complementary colors.
getSquare
str
[to]
Returns an Array of four colors. The first color in the Array will be the color passed in. The remaining three colors are equidistant offsets from the starting color and each other.
getTetrad
str
[offset]
[to]
Returns an Array of four colors. The first color in the Array will be the color passed in. The remaining three colors are equidistant offsets from the starting color and each other.
_brightnessWeights
Brightness weight factors for perceived brightness calculations
"standard" values are listed as R: 0.241, G: 0.691, B: 0.068 These values were changed based on grey scale comparison of hsl to new hsl where brightness is said to be within plus or minus 0.01.