gitphp 0.2.9.1 :: disclosr.git/blobdiff

<?php

/**

*

* Color values manipulation utilities. Provides methods to convert from and to

* Hex, RGB, HSV and HSL color representattions.

*

* Several color conversion logic are based on pseudo-code from

* http://www.easyrgb.com/math.php

*

* @category Lux

*

* @package Lux_Color

*

* @author Rodrigo Moraes <rodrigo.moraes@gmail.com>

*

* @license http://www.opensource.org/licenses/bsd-license.php BSD License

*

* @version $Id$

*

*/

class Lux_Color

{

/**

*

* Converts hexadecimal colors to RGB.

*

* @param string $hex Hexadecimal value. Accepts values with 3 or 6 numbers,

* with or without #, e.g., CCC, #CCC, CCCCCC or #CCCCCC.

*

* @return array RGB values: 0 => R, 1 => G, 2 => B

*

*/

public function hex2rgb($hex)

{

// Remove #.

if (strpos($hex, '#') === 0) {

$hex = substr($hex, 1);

}

if (strlen($hex) == 3) {

$hex .= $hex;

}

if (strlen($hex) != 6) {

return false;

}

// Convert each tuple to decimal.

$r = hexdec(substr($hex, 0, 2));

$g = hexdec(substr($hex, 2, 2));

$b = hexdec(substr($hex, 4, 2));

return array($r, $g, $b);

}

/**

*

* Converts hexadecimal colors to HSV.

*

* @param string $hex Hexadecimal value. Accepts values with 3 or 6 numbers,

* with or without #, e.g., CCC, #CCC, CCCCCC or #CCCCCC.

*

* @return array HSV values: 0 => H, 1 => S, 2 => V

*

*/

public function hex2hsv($hex)

{

return $this->rgb2hsv($this->hex2rgb($hex));

}

/**

*

* Converts hexadecimal colors to HSL.

*

* @param string $hex Hexadecimal value. Accepts values with 3 or 6 numbers,

* with or without #, e.g., CCC, #CCC, CCCCCC or #CCCCCC.

*

* @return array HSL values: 0 => H, 1 => S, 2 => L

*

*/

public function hex2hsl($hex)

{

return $this->rgb2hsl($this->hex2rgb($hex));

}

/**

*

* Converts RGB colors to hexadecimal.

*

* @param array $rgb RGB values: 0 => R, 1 => G, 2 => B

*

* @return string Hexadecimal value with six digits, e.g., CCCCCC.

*

*/

public function rgb2hex($rgb)

{

if(count($rgb) < 3) {

return false;

}

list($r, $g, $b) = $rgb;

// From php.net.

$r = 0x10000 * max(0, min(255, $r));

$g = 0x100 * max(0, min(255, $g));

$b = max(0, min(255, $b));

return strtoupper(str_pad(dechex($r + $g + $b), 6, 0, STR_PAD_LEFT));

}

/**

*

* Converts RGB to HSV.

*

* @param array $rgb RGB values: 0 => R, 1 => G, 2 => B

*

* @return array HSV values: 0 => H, 1 => S, 2 => V

*

*/

public function rgb2hsv($rgb)

{

// RGB values = 0 ÷ 255

$var_R = ($rgb[0] / 255);

$var_G = ($rgb[1] / 255);

$var_B = ($rgb[2] / 255);

// Min. value of RGB

$var_Min = min($var_R, $var_G, $var_B);

// Max. value of RGB

$var_Max = max($var_R, $var_G, $var_B);

// Delta RGB value

$del_Max = $var_Max - $var_Min;

$V = $var_Max;

// This is a gray, no chroma...

if ( $del_Max == 0 ) {

// HSV results = 0 ÷ 1

$H = 0;

$S = 0;

} else {

// Chromatic data...

$S = $del_Max / $var_Max;

$del_R = ((($var_Max - $var_R) / 6) + ($del_Max / 2)) / $del_Max;

$del_G = ((($var_Max - $var_G) / 6) + ($del_Max / 2)) / $del_Max;

$del_B = ((($var_Max - $var_B) / 6) + ($del_Max / 2)) / $del_Max;

if ($var_R == $var_Max) {

$H = $del_B - $del_G;

} else if ($var_G == $var_Max) {

$H = (1 / 3) + $del_R - $del_B;

} else if ($var_B == $var_Max) {

$H = (2 / 3) + $del_G - $del_R;

}

if ($H < 0) {

$H += 1;

}

if ($H > 1) {

$H -= 1;

}

// Returns agnostic values.

// Range will depend on the application: e.g. $H*360, $S*100, $V*100.

return array($H, $S, $V);

}

/**

*

* Converts RGB to HSL.

*

* @param array $rgb RGB values: 0 => R, 1 => G, 2 => B

*

* @return array HSL values: 0 => H, 1 => S, 2 => L

*

*/

public function rgb2hsl($rgb)

{

// Where RGB values = 0 ÷ 255.

$var_R = $rgb[0] / 255;

$var_G = $rgb[1] / 255;

$var_B = $rgb[2] / 255;

// Min. value of RGB

$var_Min = min($var_R, $var_G, $var_B);

// Max. value of RGB

$var_Max = max($var_R, $var_G, $var_B);

// Delta RGB value

$del_Max = $var_Max - $var_Min;

$L = ($var_Max + $var_Min) / 2;

if ( $del_Max == 0 ) {

// This is a gray, no chroma...

// HSL results = 0 ÷ 1

$H = 0;

$S = 0;

} else {

// Chromatic data...

if ($L < 0.5) {

$S = $del_Max / ($var_Max + $var_Min);

} else {

$S = $del_Max / ( 2 - $var_Max - $var_Min );

}

$del_R = ((($var_Max - $var_R) / 6) + ($del_Max / 2)) / $del_Max;

$del_G = ((($var_Max - $var_G) / 6) + ($del_Max / 2)) / $del_Max;

$del_B = ((($var_Max - $var_B) / 6) + ($del_Max / 2)) / $del_Max;

if ($var_R == $var_Max) {

$H = $del_B - $del_G;

} else if ($var_G == $var_Max) {

$H = ( 1 / 3 ) + $del_R - $del_B;

} else if ($var_B == $var_Max) {

$H = ( 2 / 3 ) + $del_G - $del_R;

}

if ($H < 0) {

$H += 1;

}

if ($H > 1) {

$H -= 1;

}

return array($H, $S, $L);

}

/**

*

* Converts HSV colors to hexadecimal.

*

* @param array $hsv HSV values: 0 => H, 1 => S, 2 => V

*

* @return string Hexadecimal value with six digits, e.g., CCCCCC.

*

*/

public function hsv2hex($hsv)

{

return $this->rgb2hex($this->hsv2rgb($hsv));

}

/**

*

* Converts HSV to RGB.

*

* @param array $hsv HSV values: 0 => H, 1 => S, 2 => V

*

* @return array RGB values: 0 => R, 1 => G, 2 => B

*

*/

public function hsv2rgb($hsv)

{

$H = $hsv[0];

$S = $hsv[1];

$V = $hsv[2];

// HSV values = 0 ÷ 1

if ($S == 0) {

$R = $V * 255;

$G = $V * 255;

$B = $V * 255;

} else {

$var_h = $H * 6;

// H must be < 1

if ( $var_h == 6 ) {

$var_h = 0;

}

// Or ... $var_i = floor( $var_h )

$var_i = floor( $var_h );

$var_1 = $V * ( 1 - $S );

$var_2 = $V * ( 1 - $S * ( $var_h - $var_i ) );

$var_3 = $V * ( 1 - $S * ( 1 - ( $var_h - $var_i ) ) );

switch($var_i) {

case 0:

$var_r = $V;

$var_g = $var_3;

$var_b = $var_1;

break;

case 1:

$var_r = $var_2;

$var_g = $V;

$var_b = $var_1;

break;

case 2:

$var_r = $var_1;

$var_g = $V;

$var_b = $var_3;

break;

case 3:

$var_r = $var_1;

$var_g = $var_2;

$var_b = $V;

break;

case 4:

$var_r = $var_3;

$var_g = $var_1;

$var_b = $V;

break;

default:

$var_r = $V;

$var_g = $var_1;

$var_b = $var_2;

}

//RGB results = 0 ÷ 255

$R = $var_r * 255;

$G = $var_g * 255;

$B = $var_b * 255;

}

return array($R, $G, $B);

}

/**

*

* Converts HSV colors to HSL.

*

* @param array $hsv HSV values: 0 => H, 1 => S, 2 => V

*

* @return array HSL values: 0 => H, 1 => S, 2 => L

*

*/

public function hsv2hsl($hsv)

{

return $this->rgb2hsl($this->hsv2rgb($hsv));

}

/**

*

* Converts hexadecimal colors to HSL.

*

* @param array $hsl HSL values: 0 => H, 1 => S, 2 => L

*

* @return string Hexadecimal value. Accepts values with 3 or 6 numbers,

* with or without #, e.g., CCC, #CCC, CCCCCC or #CCCCCC.

*

*/

public function hsl2hex($hsl)

{

return $this->rgb2hex($this->hsl2rgb($hsl));

}

/**

*

* Converts HSL to RGB.

*

* @param array $hsv HSL values: 0 => H, 1 => S, 2 => L

*