projectcleverweb/color

This is a stand-alone PHP 7 (and PHP 5!) library for working with RGB, HSL, HSB/HSV, Hexadecimal, and CMYK colors. Create schemes, modify specific color properties, easily convert between color spaces, create gradients, and make color suggestions quickly and easily.

dev-master 2017-09-06 16:51 UTC

Requires

• php: >=5.3

Requires (Dev)

• codacy/coverage: dev-master
• codeclimate/php-test-reporter: dev-master
• phpunit/phpunit: ~5.5.5

MIT

• Nicholas Jordon

• theme
• object
• color
• class
• split
• manipulation
• hue
• custom
• hexadecimal
• rgb
• cmyk
• hsl
• light
• compound
• green
• hex
• hsb
• scheme
• Brightness
• blue
• saturation
• red
• pantone
• ral
• complementary
• triad
• tetrad
• analogous
• accented
• monochromatic
• shades
• shade
• chroma

README

This is a PHP 7 library for working with RGB, HSL, and Hexadecimal colors. Create schemes, modify specific color properties, export CMYK, and make color suggestions quickly and easily with this stand-alone library.

Demo: jsfiddle.net/t3LL4q14

Download:

Copyright © 2016 Nicholas Jordon — All Rights Reserved

Features

• Convert any color between the RGB, HSL, HSB, Hexadecimal, and CMYK color spectrums.
• Dynamically generate 10 different color scheme algorithims for any color. (That's over 165,000,000 possible schemes)
• Check whether a color appears visually dark or light. (uses YIQ weights for better accuraccy)
• Easily modify a color's hue, saturation, light, red, green, blue, and alpha (transparcency) values.
• Generate CSS values on the fly
• Find the contrast between 2 colors.
• Dynamically generate random colors, including for specific color ranges.
• All errors are recoverable, and errors can be triggered as exceptions (default), using trigger_error(), or can be turned off for all instances.

Installation & Usage

See the Official Wiki on Github for all documentation.

Contributing

Contributing via Suggestions:
The best way to submit a suggestion is to open an issue on Github and prefix the title with [Suggestion]. Alternatively, you can email your suggestions to projectcleverweb(at)gmail(dot)com.

Contributing via Reporting Problems:
All problems must be reported via Github's issue tracker.

Contributing via Code:

1. Fork the repo on Github: github.com/ProjectCleverWeb/PHP-Color
2. Make your changes.
3. Send a pull request to have your changes reviewed.

License

The PHP-Color documentation & source code (hereafter referred to as "Library") by Nicholas Summers (hereafter referred to as "Author") is licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License with the below "Additional Terms" superseding it. To view a copy of the Creative Commons license, visit creativecommons.org/licenses/by-nc-nd/4.0. From now on "License" refers to this combination of licensing.

Additional Terms:

1. Any person or non-profit entity or may use this Library for personal or professional use as long as the Library as well as any of its parts are not sold in any fashion, and users are not forced to pay to use it in any way.
2. Anyone may use this Library for purely internal use as long as the Library as well as any of its parts are available without payment and are not publicly accessible.
3. Anyone seeking to sell this Library or use this Library in a commercial environment MUST first obtain a OEM license from the Author.
4. Anyone in direct violation of this License is liable for a minimum of $50,000 in damages, plus an additional $10 per user, and agrees to refund any charge or fees collected as a result of violating this License.
5. By downloading or using this Library you agree to all the License terms.