Skip to content

Latest commit

 

History

History
200 lines (148 loc) · 6.22 KB

README.md

File metadata and controls

200 lines (148 loc) · 6.22 KB

Amexio Colors Logo

Amexio Colors API v2.0

(A member of MetaMagic Blue Qube family)


Getting Started

To install the Amexio Colors:

$ sudo npm install -g amexio-colors

Check the Amexio Colors version:

$ ac
Amexio Colors v1.0
Copyright (c) 2018, MetaMagic Global Inc, NJ, USA
.....

To Generate Amexio Material Design Themes

$ pwd
/home/user/

$ mkdir mythemes
$ cd mythemes
$ echo "// Amexio Themes v0.0 " >> Themes-Data.txt
$ echo "// Design-Type : Material Design " >> Themes-Data.txt
$ echo "// Theme-Version : 4.0 " >> Themes-Data.txt
$ echo "army-olive,#4B5320,#708238" >> Themes-Data.txt
$ echo "ash-stone-black,#544C4A,#877F7D" >> Themes-Data.txt

$ ac Themes-Data.txt /home/user/mythemes/

Amexio Colors API Documentation

Checkout the Amexio Colors API Documentation published in GitHub Pages.

For Testing the Themes Autogenerated by the Amexio Colors Checkout the Amexio API Site

Amexio Colors Page

Understanding various Color formats

RGB = Red Green Blue
HSL = Hue Saturation Lightness
HWB = Hue Whiteness Blackness
CMYK = Cyan Magenta Yellow Black

A Color profile establishes the boundaries of the RGB or CMYK gamut, without a color profile, the numbers expressed as RGB or CMYK has no meaning. While RGB is mainly used for electronic displays CMYK is used for print medium.

When all the colors of RGB combines you will get white similar to the convergence of the Rainbow colors resulting in white light.

At the same time when all the colors of CMYK combines you will get Black as it represents the absorption of light resulting in Darkness.

RGB and CMYK are "device dependent", meaning that you can get different colors with the same set of numbers.

How we arrived at building this API

Amexio Color History

Color is the Magical Object in Amexio Color API

Color is an immutable object with RGB with Alpha, HSL, RGB Normalized Values (to be used in Machine Learning), Hex Values and Color Channel identification.

It also has the following Conversion Alogrithms.

  • RGB to HSL

  • RGB to HWB

  • RGB to CMYK

  • RGB to NCol (Natural Colors - To be implemented)

  • HSL to RGB

Functions available in Color API

  • Pure Color of the Current Color (Saturation = 100, Lightness = 51)
  • Gray Tone of the Current Color (Saturation = 25, Lightness = 81)
  • Finding Foreground Color for the Current Color
  • Finding Background Color for the Current Color
  • Darken the Current Color
  • Lighten the Current Color

Code Structure

Package

Start > ColorFactory - checkArgs()
- buildThemes() - AmexioThemeFactory (inputFileName, outputPath)
- createThemes()

Amexio Theme Builder API

Theme Builder uses the the above mentioned functions to understand the color patterns and automatically derive the color patterns and color combinations for the Primary Color given as an input to the Theme Builder.

Amexio Color Factory API

Color Factory API will focus on creating Color combinations based on the following Color Patterns

Color Duo

Colors that are directly opposite one another on the color wheel are known as complementary colors. Complementary colors have a high contrast and can be very effective as accent colors when paired with a more neutral palette.

Triadic Colors

Triadic harmonies consist of three colors equidistant from one another on the color wheel. Like complementary colors, triadic schemes tend to be very bright with a high contrast and work best when one color dominates.

Tetradic Colors

Tetradic color harmonies are formed by two sets of complementary colors 60 degrees apart on the color wheel. Tetradic schemes are an excellent starting point for creating color palettes; fine tune them using color shades, tints and tones.

Analogus Colors

Analogous harmonies are created by selecting the colors directly adjacent to a chosen color. Frequently found in web design, analogous schemes, when paired with a complementary color for contrast, can offer great versatility.

Neutral Colors

Neutral schemes, like analogous harmonies, are formed by taking the colors on either side of a chosen color but at half the distance. While analogous schemes typically use colors 30 degrees apart, neutral harmonies use colors 15 degrees apart.

License

Copyright © MetaMagic Global Inc, 2017-19. Amexio Colors API. All rights reserved.

Licensed under the Apache 2.0 License.

Enjoy!