Zend Framework: Zend_Color Component Proposal

Proposed Component Name	Zend_Color
Developer Notes	http://framework.zend.com/wiki/display/ZFDEV/Zend_Color
Proposers	Jack Sleight
Revision	0.1 - 10 July 2007 0.2 - 21 July 2007 0.2.1 - 21 July 2007 0.3 - 22 February 2008 (wiki revision: 34)

Zend_Color is a component for generating colours, manipulating colour values, and converting colours between different colour models. Typical uses include using this within views, where you want elements to appear in different tints of a colour based on a dynamic variable, or even customising CSS dynamically to apply custom colour schemes. You could also use the WCAG functions to validate user input colour values offer enough contrast, in for example advertising blocks.

The current version can be downloaded here: http://jacksleight.svn.beanstalkapp.com/zend_color/trunk/

2. References

3. Component Requirements, Constraints, and Acceptance Criteria

This component will provide components for RGB, HSL, HSV (HSB) and CMYK colour models.
This component will not provide a component for "HEX colours", as "HEX" is not a separate colour model, it is simply an RGB colour expressed in Hexadecimal.
This component will provide helper methods within the RGB component for easily working with "HEX colours", and named colours in the HTML spec/X11.
This component will support conversion between RGB to/from HSL, RGB to/from HSV and RGB to/from CMYK.
This component will provide a consistent API for manipulating colour values, including setting and retrieving colour values in decimal, percentages, fractions and degrees.
This component will provide helper functions for generating CSS compatible colour unit strings.
This component will provide methods to make a colour web safe or web smart, and to test for WCAG 1.0 and 2.0 contrast compliance.

4. Dependencies on Other Framework Components

Zend_Exception

5. Theory of Operation

Typically the four colour model classes (Rgb, Hsl, Hsv and Cmyk) are instantiated as objects, and then those objects each represent a colour. The colour objects can be modified by altering the values (e.g. R, G and B), or can be used to generate the same (or similar) colour in another colour model. The Rgb class contains two static factory methods for generating Rgb objects from HEX colour strings, and HTML spec/X11 colour names. The base class (Zend_Color) only contains the constants required by the other classes.

When a colour object is instantiated the user can specify which format (range, percentages, fractions or degrees) the colour values are in (supported formats vary between colour models). In addition, each colour value object has methods for setting/retrieving and adjusting values in any of the supported formats. Although colour values can be specified, retrieved and adjusted in multiple formats, they are always stored as fractions (between 0 and 1) within the value objects. The Rgb object also contains methods for retrieving the HEX value of a colour, and the closest named colour from the HTML spec/X11 list.

6. Milestones / Tasks

Milestone 1: [DONE] Finalise initial proposal ready for community review
Milestone 2: Working prototype checked into the incubator
Milestone 3: Unit tests exist, work, and are checked into SVN
Milestone 4: Initial documentation exists

7. Class Index

Zend_Color_Exception
Zend_Color
Zend_Color_Cmyk
Zend_Color_Hsl
Zend_Color_Hsv
Zend_Color_Rgb
Zend_Color_Value
Zend_Color_Value_Hue
Zend_Color_Value_Rgb

8. Use Cases

UC-01

Get RGB object from hex code

$rgb = Zend_Color_Rgb::fromHex('#0000ff');

UC-02

Create an RGB object

$rgb = new Zend_Color_Rgb(0, 0, 255);

UC-03

Create an RGB object using percentages

$rgb = new Zend_Color_Rgb(0, 0, 100, Zend_Color_Value::PERCENTAGE);

UC-04

Get the RGB values

$rgb = new Zend_Color_Rgb(0, 0, 255);
$rgb->get(); // array(0, 0, 255)
$rgb->get(Zend_Color_Value::PERCENTAGE); // array(0, 0, 100)
$rgb->get(Zend_Color_Value::FRACTION); // array(0, 0, 1)
$rgb->getHex(); // "0000ff"
echo $rgb; // "#0000ff"
$rgb->getCss(); // "rgb(0,0,255)"
$rgb->getCss(Zend_Color_Value::PERCENTAGE); // "rgb(0%,0%,100%)"
$rgb->getCss(Zend_Color_Value_Rgb::RANGE, 0.5); // "rgba(0,0,255,0.5)"
$rgb->getCss(Zend_Color_Value::PERCENTAGE, 0.5); // "rgba(0%,0%,100%,0.5)"

UC-05

Make a colour web safe or web smart

$rgb = Zend_Color_Rgb::fromHex('#3d3dd3');
$rgb->makeWebSmart();
$rgb->getHex(); // "4444cc"
$rgb->makeWebSafe();
$rgb->getHex(); // "3333cc"

UC-06

Find the closest named HTML colour

$rgb = Zend_Color_Rgb::fromHex('#3d3dd3');
$rgb->findBestHtmlName(); // "RoyalBlue"

UC-07

Check W3C visibility

$color1 = Zend_Color_Rgb::fromHex('#ffffff');
$color2 = Zend_Color_Rgb::fromHex('#000000');
Zend_Color::wcag1Contrast($color1, $color2); // true

UC-08

Convert RGB to HSL, HSV or CMYK

$rgb = new Zend_Color_Rgb(51, 51, 204);
$hsl = $rgb->toHsl();
$hsv = $rgb->toHsv();
$cmyk = $rgb->toCmyk();

UC-09

Convert HSL, HSV or CMYK to RGB

$rgb = $hsl->toRgb();
$rgb = $hsv->toRgb();
$rgb = $cmyk->toRgb();

UC-10

Modify colour values

$hsl = new Zend_Color_Hsl(240, 75, 80);
$hsl->getLightness()->adjust(10);
$hsl->getLightness()->adjust(-10);

$rgb = new Zend_Color_Rgb(51, 51, 204);
$rgb->getRed()->adjust(10);
$rgb->getRed()->adjust(15, Zend_Color_Value::PERCENTAGE);

9. Class Skeletons

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Color_Rgb
 */
require_once 'Zend/Color/Rgb.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color
{    
    /**
     * Compares two RGB colors for WCAG 1.0 contrast compliance
     *
     * @param  Zend_Color_Rgb $a RGB color
     * @param  Zend_Color_Rgb $b RGB color
     * @return bool
     */
    public static function wcag1Contrast(Zend_Color_Rgb $a, Zend_Color_Rgb $b)
    {
        return ((self::wcag1BrightnessDifference($a, $b) > 125) && (self::wcag1ColorDifference($a, $b) > 500));
    }

    /**
     * Compares two RGB colors for WCAG 2.0 contrast compliance
     *
     * @param  Zend_Color_Rgb $a RGB color
     * @param  Zend_Color_Rgb $b RGB color
     * @return bool
     */
    public static function wcag2Contrast(Zend_Color_Rgb $a, Zend_Color_Rgb $b)
    {
		// todo
    }

    /**
     * Compares two RGB colors for W3C brightness difference
     *
     * @param  Zend_Color_Rgb $a RGB color
     * @param  Zend_Color_Rgb $b RGB color
     * @return integer
     */
    public static function wcag1BrightnessDifference(Zend_Color_Rgb $a, Zend_Color_Rgb $b)
    {
        return abs($a->getWcag1Brightness() - $b->getWcag1Brightness());
    }

    /**
     * Compares two RGB colors for WCAG 1.0 color difference
     *
     * @param  Zend_Color_Rgb $a RGB color
     * @param  Zend_Color_Rgb $b RGB color
     * @return integer
     */
    public static function wcag1ColorDifference(Zend_Color_Rgb $a, Zend_Color_Rgb $b)
    {
        list($aR, $aG, $aB) = $a->get(Zend_Color_Value_Rgb::RANGE, 0);
        list($bR, $bG, $bB) = $b->get(Zend_Color_Value_Rgb::RANGE, 0);
        return (max($aR, $bR) - min($aR, $bR))
             + (max($aG, $bG) - min($aG, $bG))
             + (max($aB, $bB) - min($aB, $bB));
    }
}

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Color_Value
 */
require_once 'Zend/Color/Value.php';

/**
 * Zend_Color_Rgb
 */
require_once 'Zend/Color/Rgb.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color_Cmyk
{    
    /**
     * Zend_Color_Value instance
     *
     * @var Zend_Color_Value
     */
    protected $_c;

    /**
     * Zend_Color_Value instance
     *
     * @var Zend_Color_Value
     */
    protected $_m;

    /**
     * Zend_Color_Value instance
     *
     * @var Zend_Color_Value
     */
    protected $_y;

    /**
     * Zend_Color_Value instance
     *
     * @var Zend_Color_Value
     */
    protected $_k;
    
    /**
     * Constructs a new CMYK color
     *
     * @param  float $c Cyan value
     * @param  float $m Magenta value
     * @param  float $y Yellow value
     * @param  float $k Key value
     * @param  string $cType Optional cyan value type
     * @param  string $mType Optional magenta value type
     * @param  string $yType Optional yellow value type
     * @param  string $kType Optional key value type
     * @return void
     */
    public function __construct($c, $m, $y, $k, $cType = Zend_Color_Value::PERCENTAGE, $mType = null, $yType = null, $kType = null)
    {
        if ($mType === null || $yType === null || $kType === null) {
            $mType = $yType = $kType = $cType;
        }
        $this->_c = new Zend_Color_Value($c, $cType);
        $this->_m = new Zend_Color_Value($m, $mType);
        $this->_y = new Zend_Color_Value($y, $yType);
        $this->_k = new Zend_Color_Value($k, $kType);
    }
        
    /**
     * Gets all four (CMYK) values as an array
     *
     * @param  string $type Optional value type
     * @param  integer $precision Optional precision
     * @return array
     */
    public function get($type = Zend_Color_Value::PERCENTAGE, $precision = 1)
    {
        return array($this->_c->get($type, $precision),
                     $this->_m->get($type, $precision),
                     $this->_y->get($type, $precision),
                     $this->_k->get($type, $precision));
    }

    /**
     * Gets the cyan value
     *
     * @return Zend_Color_Value
     */
    public function getCyan()
    {
        return $this->_c;
    }

    /**
     * Gets the magenta value
     *
     * @return Zend_Color_Value
     */
    public function getMagenta()
    {
        return $this->_m;
    }

    /**
     * Gets the yellow value
     *
     * @return Zend_Color_Value
     */
    public function getYellow()
    {
        return $this->_y;
    }

    /**
     * Gets the key value
     *
     * @return Zend_Color_Value
     */
    public function getKey()
    {
        return $this->_k;
    }

    /**
     * Alias of getKey()
     *
     * @return Zend_Color_Value
     */
    public function getBlack()
    {
        return $this->getKey();
    }

    /**
     * Converts the color to RGB
     *
     * @return Zend_Color_Rgb
     */
    public function toRgb()
    {
        list($cA, $mA, $yA, $kA) = $this->get(Zend_Color_Value::FRACTION, null);
        $cC = ($cA * (1 - $kA) + $kA);
        $mC = ($mA * (1 - $kA) + $kA);
        $yC = ($yA * (1 - $kA) + $kA);
        $rB = 1 - $cC;
        $gB = 1 - $mC;
        $bB = 1 - $yC;
        return new Zend_Color_Rgb($rB, $gB, $bB, Zend_Color_Value::FRACTION);
    }
}

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Exception
 */
require_once 'Zend/Exception.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color_Exception extends Zend_Exception
{}

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Color_Value
 */
require_once 'Zend/Color/Value.php';

/**
 * Zend_Color_Value_Hue
 */
require_once 'Zend/Color/Value/Hue.php';

/**
 * Zend_Color_Rgb
 */
require_once 'Zend/Color/Rgb.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color_Hsl
{
    /**
     * Zend_Color_Value_Hue instance
     *
     * @var Zend_Color_Value_Hue
     */
    protected $_h;

    /**
     * Zend_Color_Value instance
     *
     * @var Zend_Color_Value
     */
    protected $_s;

    /**
     * Zend_Color_Value instance
     *
     * @var Zend_Color_Value
     */
    protected $_l;

    /**
     * Constructs a new HSL color
     *
     * @param  float $h Hue value
     * @param  float $s Saturation value
     * @param  float $l Lightness value
     * @param  string $hType Optional hue value type
     * @param  string $sType Optional saturation value type
     * @param  string $lType Optional lightness value type
     * @return void
     */
    public function __construct($h, $s, $l, $hType = Zend_Color_Value::PERCENTAGE, $sType = null, $lType = null)
    {
        if ($sType === null || $lType === null) {
            $sType = $lType = $hType;
        }
        $this->_h = new Zend_Color_Value_Hue($h, $hType);
        $this->_s = new Zend_Color_Value($s, $sType);
        $this->_l = new Zend_Color_Value($l, $lType);
    }
    
    /**
     * Gets all three (HSL) values as an array
     *
     * @param  string $type Optional value type
     * @param  integer $precision Optional precision
     * @return array
     */
    public function get($type = Zend_Color_Value::PERCENTAGE, $precision = 1)
    {
        return array($this->_h->get($type, $precision),
                     $this->_s->get($type, $precision),
                     $this->_l->get($type, $precision));
    }

    /**
     * Gets the hue value
     *
     * @return Zend_Color_Value_Hue
     */
    public function getHue()
    {
        return $this->_h;
    }

    /**
     * Gets the saturation value
     *
     * @return Zend_Color_Value
     */
    public function getSaturation()
    {
        return $this->_s;
    }

    /**
     * Gets the lightness value
     *
     * @return Zend_Color_Value
     */
    public function getLightness()
    {
        return $this->_l;
    }

    /**
     * Gets the CSS color unit compliant string for this color
     *
     * @param  float $alpha Optional alpha value
     * @return string
     */
    public function getCss($alpha = null)
    {
        $h = $this->_h->get(Zend_Color_Value_Hue::DEGREE, 0);
        list(, $s, $l) = $this->get(Zend_Color_Value::PERCENTAGE, 1);
        $values = $h . ',' . $s . '%,' . $l . '%';
        if ($alpha === null) {
            return 'hsl(' . $values . ')';
        } else {
            return 'hsla(' . $values . ',' . $alpha . ')';
        }
    }
   
    /**
     * Converts the color to RGB
     *
     * @return Zend_Color_Rgb
     */
    public function toRgb()
    {
        list($hA, $sA, $lA) = $this->get(Zend_Color_Value::FRACTION, null);
        if ($sA === 0) {
            $rB = $gB = $bB = $lA;
        } else {
            if ($lA < 0.5) {
                $temp2 = $lA * (1 + $sA);
            } else {
                $temp2 = $lA + $sA - $lA * $sA;
            }
            $temp1 = 2 * $lA - $temp2;
            $rB = $this->_toRgbHue($temp1, $temp2, $hA + 1 / 3);
            $gB = $this->_toRgbHue($temp1, $temp2, $hA);
            $bB = $this->_toRgbHue($temp1, $temp2, $hA - 1 / 3);
        }
        return new Zend_Color_Rgb($rB, $gB, $bB, Zend_Color_Value::FRACTION);
    }
    
    /**
     * Calculates rgb values for conversion
     *
     * @param  float $temp1 Tempoary value 1
     * @param  float $temp2 Tempoary value 2
     * @param  float $temp3 Tempoary value 3
     * @return float
     */
    private function _toRgbHue($temp1, $temp2, $temp3) {
        if ($temp3 < 0) {
            $temp3 += 1;
        } elseif ($temp3 > 1) {
            $temp3 -= 1;
        }
        if (6 * $temp3 < 1) {
            return $temp1 + ($temp2 - $temp1) * 6 * $temp3;
        } elseif (2 * $temp3 < 1) {
            return $temp2;            
        } elseif (3 * $temp3 < 2) {
            return $temp1 + ($temp2 - $temp1) * ((2 / 3) - $temp3) * 6;
        } else {
            return $temp1;
        }
    }
}

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Color_Value
 */
require_once 'Zend/Color/Value.php';

/**
 * Zend_Color_Value_Hue
 */
require_once 'Zend/Color/Value/Hue.php';

/**
 * Zend_Color_Rgb
 */
require_once 'Zend/Color/Rgb.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color_Hsv
{    
    /**
     * Zend_Color_Value_Hue instance
     *
     * @var Zend_Color_Value_Hue
     */
    protected $_h;

    /**
     * Zend_Color_Value instance
     *
     * @var Zend_Color_Value
     */
    protected $_s;

    /**


     * Zend_Color_Value instance
     *
     * @var Zend_Color_Value
     */
    protected $_v;

    /**
     * Constructs a new HSV color
     *
     * @param  float $h Hue value
     * @param  float $s Saturation value
     * @param  float $v Value value
     * @param  string $hType Optional hue value type
     * @param  string $sType Optional saturation value type
     * @param  string $vType Optional value value type
     * @return void
     */
    public function __construct($h, $s, $v, $hType = Zend_Color_Value::PERCENTAGE, $sType = null, $vType = null)
    {
        if ($sType === null || $vType === null) {
            $sType = $vType = $hType;
        }
        $this->_h = new Zend_Color_Value_Hue($h, $hType);
        $this->_s = new Zend_Color_Value($s, $sType);
        $this->_v = new Zend_Color_Value($v, $vType);
    }
    
    /**
     * Gets all three (HSV) values as an array
     *
     * @param  string $type Optional value type
     * @param  integer $precision Optional precision
     * @return array
     */
    public function get($type = Zend_Color_Value::PERCENTAGE, $precision = 1)
    {
        return array($this->_h->get($type, $precision),
                     $this->_s->get($type, $precision),
                     $this->_v->get($type, $precision));
    }

    /**
     * Gets the hue value
     *
     * @return Zend_Color_Value_Hue
     */
    public function getHue()
    {
        return $this->_h;
    }

    /**
     * Gets the saturation value
     *
     * @return Zend_Color_Value
     */
    public function getSaturation()
    {
        return $this->_s;
    }

    /**
     * Gets the value value
     *
     * @return Zend_Color_Value
     */
    public function getValue()
    {
        return $this->_v;
    }
    
    /**
     * Converts the color to RGB
     *
     * @return Zend_Color_Rgb
     */
    public function toRgb()
    {
        list($hA, $sA, $vA) = $this->get(Zend_Color_Value::FRACTION, null);
        if ($sA === 0) {
            $rB = $gB = $bB = $vA;
        } else {
            if ($hA === 360) {
                $hA = 0;
            }
            $hA /= 60;
            $i = floor($hA);
            $temp1 = $hA - $i;
            $temp2 = $vA * (1 - $sA);
            $temp3 = $vA * (1 - ($sA * $temp1));
            $temp4 = $vA * (1 - ($sA * (1 - $temp1)));
            switch ($i) {
                case 0: $rB = $vA; $gB = $temp4; $bB = $temp2; break;
                case 1: $rB = $temp3; $gB = $vA; $bB = $temp2; break;
                case 2: $rB = $temp2; $gB = $vA; $bB = $temp4; break;
                case 3: $rB = $temp2; $gB = $temp3; $bB = $vA; break;
                case 4: $rB = $temp4; $gB = $temp2; $bB = $vA; break;
                case 5: $rB = $vA; $gB = $temp2; $bB = $temp3; break;
            } 
        }
        return new Zend_Color_Rgb($rB, $gB, $bB, Zend_Color_Value::FRACTION);
    }    
}

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Color_Exception
 */
require_once 'Zend/Color/Exception.php';

/**
 * Zend_Color_Value
 */
require_once 'Zend/Color/Value.php';

/**
 * Zend_Color_Value_Rgb
 */
require_once 'Zend/Color/Value/Rgb.php';

/**
 * Zend_Color_Cmyk
 */
require_once 'Zend/Color/Cmyk.php';

/**
 * Zend_Color_Hsl
 */
require_once 'Zend/Color/Hsl.php';

/**
 * Zend_Color_Hsv
 */
require_once 'Zend/Color/Hsv.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color_Rgb
{
    public static $HTML_NAMED = array(
        'AliceBlue'         => array(240, 248, 255),
        'AntiqueWhite'      => array(250, 235, 215),
        'Aqua'              => array(0, 255, 255),
        'Aquamarine'        => array(127, 255, 212),
        'Azure'             => array(240, 255, 255),
        'Beige'             => array(245, 245, 220),
        'Bisque'            => array(255, 228, 196),
        'Black'             => array(0, 0, 0),
        'BlanchedAlmond'    => array(255, 235, 205),
        'Blue'              => array(0, 0, 255),
        'BlueViolet'        => array(138, 43, 226),
        'Brown'             => array(165, 42, 42),
        'BurlyWood'         => array(222, 184, 135),
        'CadetBlue'         => array(95, 158, 160),
        'Chartreuse'        => array(127, 255, 0),
        'Chocolate'         => array(210, 105, 30),
        'Coral'             => array(255, 127, 80),
        'CornflowerBlue'    => array(100, 149, 237),
        'Cornsilk'          => array(255, 248, 220),
        'Crimson'           => array(220, 20, 60),
        'Cyan'              => array(0, 255, 255),
        'DarkBlue'          => array(0, 0, 139),
        'DarkCyan'          => array(0, 139, 139),
        'DarkGoldenrod'     => array(184, 134, 11),
        'DarkGray'          => array(169, 169, 169),
        'DarkGreen'         => array(0, 100, 0),
        'DarkKhaki'         => array(189, 183, 107),
        'DarkMagenta'       => array(139, 0, 139),
        'DarkOliveGreen'    => array(85, 107, 47),
        'DarkOrange'        => array(255, 140, 0),
        'DarkOrchid'        => array(153, 50, 204),
        'DarkRed'           => array(139, 0, 0),
        'DarkSalmon'        => array(233, 150, 122),
        'DarkSeaGreen'      => array(143, 188, 143),
        'DarkSlateBlue'     => array(72, 61, 139),
        'DarkSlateGray'     => array(47, 79, 79),
        'DarkTurquoise'     => array(0, 206, 209),
        'DarkViolet'        => array(148, 0, 211),
        'DeepPink'          => array(255, 20, 147),
        'DeepSkyBlue'       => array(0, 191, 255),
        'DimGray'           => array(105, 105, 105),
        'DodgerBlue'        => array(30, 144, 255),
        'FireBrick'         => array(178, 34, 34),
        'FloralWhite'       => array(255, 250, 240),
        'ForestGreen'       => array(34, 139, 34),
        'Fuchsia'           => array(255, 0, 255),
        'Gainsboro'         => array(220, 220, 220),
        'GhostWhite'        => array(248, 248, 255),
        'Gold'              => array(255, 215, 0),
        'Goldenrod'         => array(218, 165, 32),
        'Gray'              => array(128, 128, 128),
        'Green'             => array(0, 128, 0),
        'GreenYellow'       => array(173, 255, 47),
        'Honeydew'          => array(240, 255, 240),
        'HotPink'           => array(255, 105, 180),
        'IndianRed'         => array(205, 92, 92),
        'Indigo'            => array(75, 0, 130),
        'Ivory'             => array(255, 255, 240),
        'Khaki'             => array(240, 230, 140),
        'Lavender'          => array(230, 230, 250),
        'LavenderBlush'     => array(255, 240, 245),
        'LawnGreen'         => array(124, 252, 0),
        'LemonChiffon'      => array(255, 250, 205),
        'LightBlue'         => array(173, 216, 230),
        'LightCoral'        => array(240, 128, 128),
        'LightCyan'         => array(224, 255, 255),
        'LightGoldenrodYellow' => array(250, 250, 210),
        'LightGreen'        => array(144, 238, 144),
        'LightGrey'         => array(211, 211, 211),
        'LightPink'         => array(255, 182, 193),
        'LightSalmon'       => array(255, 160, 122),
        'LightSalmon'       => array(255, 160, 122),
        'LightSeaGreen'     => array(32, 178, 170),
        'LightSkyBlue'      => array(135, 206, 250),
        'LightSlateGray'    => array(119, 136, 153),
        'LightSteelBlue'    => array(176, 196, 222),
        'LightYellow'       => array(255, 255, 224),
        'Lime'              => array(0, 255, 0),
        'LimeGreen'         => array(50, 205, 50),
        'Linen'             => array(250, 240, 230),
        'Magenta'           => array(255, 0, 255),
        'Maroon'            => array(128, 0, 0),
        'MediumAquamarine'  => array(102, 205, 170),
        'MediumBlue'        => array(0, 0, 205),
        'MediumOrchid'      => array(186, 85, 211),
        'MediumPurple'      => array(147, 112, 219),
        'MediumSeaGreen'    => array(60, 179, 113),
        'MediumSlateBlue'   => array(123, 104, 238),
        'MediumSpringGreen' => array(0, 250, 154),
        'MediumTurquoise'   => array(72, 209, 204),
        'MediumVioletRed'   => array(199, 21, 133),
        'MidnightBlue'      => array(25, 25, 112),
        'MintCream'         => array(245, 255, 250),
        'MistyRose'         => array(255, 228, 225),
        'Moccasin'          => array(255, 228, 181),
        'NavajoWhite'       => array(255, 222, 173),
        'Navy'              => array(0, 0, 128),
        'OldLace'           => array(253, 245, 230),
        'Olive'             => array(128, 128, 0),
        'OliveDrab'         => array(107, 142, 35),
        'Orange'            => array(255, 165, 0),
        'OrangeRed'         => array(255, 69, 0),
        'Orchid'            => array(218, 112, 214),
        'PaleGoldenrod'     => array(238, 232, 170),
        'PaleGreen'         => array(152, 251, 152),
        'PaleTurquoise'     => array(175, 238, 238),
        'PaleVioletRed'     => array(219, 112, 147),
        'PapayaWhip'        => array(255, 239, 213),
        'PeachPuff'         => array(255, 218, 185),
        'Peru'              => array(205, 133, 63),
        'Pink'              => array(255, 192, 203),
        'Plum'              => array(221, 160, 221),
        'PowderBlue'        => array(176, 224, 230),
        'Purple'            => array(128, 0, 128),
        'Red'               => array(255, 0, 0),
        'RosyBrown'         => array(188, 143, 143),
        'RoyalBlue'         => array(65, 105, 225),
        'SaddleBrown'       => array(139, 69, 19),
        'Salmon'            => array(250, 128, 114),
        'SandyBrown'        => array(244, 164, 96),
        'SeaGreen'          => array(46, 139, 87),
        'Seashell'          => array(255, 245, 238),
        'Sienna'            => array(160, 82, 45),
        'Silver'            => array(192, 192, 192),
        'SkyBlue'           => array(135, 206, 235),
        'SlateBlue'         => array(106, 90, 205),
        'SlateGray'         => array(112, 128, 144),
        'Snow'              => array(255, 250, 250),
        'SpringGreen'       => array(0, 255, 127),
        'SteelBlue'         => array(70, 130, 180),
        'Tan'               => array(210, 180, 140),
        'Teal'              => array(0, 128, 128),
        'Thistle'           => array(216, 191, 216),
        'Tomato'            => array(255, 99, 71),
        'Turquoise'         => array(64, 224, 208),
        'Violet'            => array(238, 130, 238),
        'Wheat'             => array(245, 222, 179),
        'White'             => array(255, 255, 255),
        'WhiteSmoke'        => array(245, 245, 245),
        'Yellow'            => array(255, 255, 0),
        'YellowGreen'       => array(154, 205, 50));

    /**
     * Zend_Color_Value_Rgb instance
     *
     * @var Zend_Color_Value_Rgb
     */
    protected $_r;

    /**
     * Zend_Color_Value_Rgb instance
     *
     * @var Zend_Color_Value_Rgb
     */
    protected $_g;

    /**
     * Zend_Color_Value_Rgb instance
     *
     * @var Zend_Color_Value_Rgb
     */
    protected $_b;

    /**
     * Constructs a new RGB color
     *
     * @param  float $r Red value
     * @param  float $g Green value
     * @param  float $b Blue value
     * @param  string $rType Optional red value type
     * @param  string $gType Optional green value type
     * @param  string $bType Optional blue value type
     * @return void
     */
    public function __construct($r, $g, $b, $rType = Zend_Color_Value_Rgb::RANGE, $gType = null, $bType = null)
    {
        if ($gType === null || $bType === null) {
            $gType = $bType = $rType;
        }
        $this->_r = new Zend_Color_Value_Rgb($r, $rType);
        $this->_g = new Zend_Color_Value_Rgb($g, $gType);
        $this->_b = new Zend_Color_Value_Rgb($b, $bType);
    }
        
    /**
     * Gets all three (RGB) values as an array
     *
     * @param  string $type Optional value type
     * @param  integer $precision Optional precision
     * @return array
     */
    public function get($type = Zend_Color_Value_Rgb::RANGE, $precision = 0)
    {
        return array($this->_r->get($type, $precision),
                     $this->_g->get($type, $precision),
                     $this->_b->get($type, $precision));
    }
    
    /**
     * Gets the red value
     *
     * @return Zend_Color_Value_Rgb
     */
    public function getRed()
    {
        return $this->_r;
    }

    /**
     * Gets the green value
     *
     * @return Zend_Color_Value_Rgb
     */
    public function getGreen()
    {
        return $this->_g;
    }

    /**
     * Gets the blue value
     *
     * @return Zend_Color_Value_Rgb
     */
    public function getBlue()
    {
        return $this->_b;
    }
            
    /**
     * Gets the hexadecimal string for the color
     *
     * @return string
     */
    public function getHex()
    {
        list($r, $g, $b) = $this->get(Zend_Color_Value_Rgb::RANGE, 0);
        return sprintf('%02x', $r) . sprintf('%02x', $g) . sprintf('%02x', $b);
    }
    
    /**
     * Gets the hexadecimal string for the color, with a # prepended
     *
     * @return string
     */
    public function __toString()
    {
        return '#' . $this->getHex();
    }
    
    /**
     * Finds the closest named HTML colour to this
     *
     * @return string
     */
    public function findBestHtmlName()
    {
        list($r, $g, $b) = $this->get(Zend_Color_Value_Rgb::RANGE, 0);
        $bestDiff = 765;
        $bestName = null;
        foreach (self::$HTML_NAMED as $name => $rgb) {
            $diff = abs($r - $rgb[0]) + abs($g - $rgb[1]) + abs($b - $rgb[2]);
            if($diff < $bestDiff) {
                $bestDiff = $diff;
                $bestName = $name;
            }
        }
        return $bestName;        
    }
    
    /**
     * Gets the CSS color unit compliant string for this color
     *
     * @param  string $type Optional value type
     * @param  float $alpha Optional alpha value
     * @return string
     */
    public function getCss($type = Zend_Color_Value_Rgb::RANGE, $alpha = null)
    {
        switch ($type) {
            case Zend_Color_Value_Rgb::RANGE:
                list($r, $g, $b) = $this->get(Zend_Color_Value_Rgb::RANGE, 0);
                $values = $r . ',' . $g . ',' . $b;
            break;
            case Zend_Color_Value::PERCENTAGE:
                list($r, $g, $b) = $this->get(Zend_Color_Value::PERCENTAGE, 1);
                $values = $r . '%,' . $g . '%,' . $b . '%';
            break;
            default:
                throw new Zend_Color_Exception("Type '$type' unsupported in CSS string output");
            break;
        }
        if ($alpha === null) {
            return 'rgb(' . $values . ')';
        } else {
            return 'rgba(' . $values . ',' . $alpha . ')';
        }
    }
        
    /**
     * Makes the color web safe
     *
     * @return Zend_Color_Rgb
     */
    public function makeWebSafe()
    {
        $this->_r->makeWebSafe();
        $this->_g->makeWebSafe();
        $this->_b->makeWebSafe();
        return $this;
    }
    
    /**
     * Makes the color web smart
     *
     * @return Zend_Color_Rgb
     */
    public function makeWebSmart()
    {
        $this->_r->makeWebSmart();
        $this->_g->makeWebSmart();
        $this->_b->makeWebSmart();
        return $this;
    }
    
    /**
     * Inverts the color
     *
     * @return Zend_Color_Rgb
     */
    public function invert()
    {
        $this->_r->invert();
        $this->_g->invert();
        $this->_b->invert();
        return $this;
    }

    /**
     * Converts the color to CMYK
     *
     * @return Zend_Color_Cmyk
     */
    public function toCmyk()
    {
        list($rA, $gA, $bA) = $this->get(Zend_Color_Value::FRACTION, null);
        $cC = 1 - $rA;
        $mC = 1 - $gA;
        $yC = 1 - $bA;
        $kC = 1;
        if ($cC < $kC) {
            $key = $cC;
        }
        if ($mC < $kC) {
            $kC = $mC;
        }
        if ($yC < $kC) {
            $kC = $yC;
        }
        if ($kC === 1) {
            $cB = 0;
            $mB = 0;
            $yB = 0;
        } else {
            $cB = ($cC - $kC) / (1 - $kC);
            $mB = ($mC - $kC) / (1 - $kC);
            $yB = ($yC - $kC) / (1 - $kC);
        }
        $kB = $kC;
        return new Zend_Color_Cmyk($cB, $mB, $yB, $kB, Zend_Color_Value::FRACTION);
    }

    /**
     * Converts the color to HSL
     *
     * @return Zend_Color_Hsl
     */
    public function toHsl()
    {
        list($rA, $gA, $bA) = $this->get(Zend_Color_Value::FRACTION, null);
        $min = min($rA, $gA, $bA);
        $mAx = max($rA, $gA, $bA);
        $delta = $mAx - $min;
        $lB = ($mAx + $min) / 2;
        if ($delta === 0) {
            $hB = 0;
            $sB = 0;
        } else {
            if ($lB < 0.5) {
                $sB = $delta / ($mAx + $min);
            } else {
                $sB = $delta / (2 - $mAx - $min);
            }
            $rDelta = ((($mAx - $rA) / 6 ) + ($mAx / 2)) / $mAx;
            $gDelta = ((($mAx - $gA) / 6 ) + ($mAx / 2)) / $mAx;
            $bDelta = ((($mAx - $bA) / 6 ) + ($mAx / 2)) / $mAx;
            if ($rA === $mAx) {
                $hB = $bDelta - $gDelta;
            } elseif ($gA === $mAx) {
                $hB = (1 / 3) + $rDelta - $bDelta;
            } elseif ($bA === $mAx) {
                $hB = (2 / 3) + $gDelta - $rDelta;
            }
            if ($hB < 0)  {
                $hB += 1;
            } elseif ($hB > 1) {
                $hB -= 1;
            }
        }
        return new Zend_Color_Hsl($hB, $sB, $lB, Zend_Color_Value::FRACTION);
    }
    
    /**
     * Converts the color to HSV
     *
     * @return Zend_Color_Hsv
     */
    public function toHsv()
    {
        list($rA, $gA, $bA) = $this->get(Zend_Color_Value::FRACTION, null);
        $min = min($rA, $gA, $bA);
        $mAx = max($rA, $gA, $bA);
        $delta = $mAx - $min;
        $vB = $mAx;
        if ($delta === 0) {
            $hB = 0;
            $sB = 0;
        } else {
            $sB = $delta / $mAx;
            $rDelta = ((($mAx - $rA) / 6 ) + ($mAx / 2)) / $mAx;
            $gDelta = ((($mAx - $gA) / 6 ) + ($mAx / 2)) / $mAx;
            $bDelta = ((($mAx - $bA) / 6 ) + ($mAx / 2)) / $mAx;
            if ($rA === $mAx) {
                $hB = $bDelta - $gDelta;
            } elseif ($gA === $mAx) {
                $hB = (1 / 3) + $rDelta - $bDelta;
            } elseif ($bA === $mAx) {
                $hB = (2 / 3) + $gDelta - $rDelta;
            }
            if ($hB < 0)  {
                $hB += 1;
            } elseif ($hB > 1) {
                $hB -= 1;
            }
        }
        return new Zend_Color_Hsv($hB, $sB, $vB, Zend_Color_Value::FRACTION);
    }
        
    /**
     * Gets the W3C brightness value for the color
     *
     * @return integer
     */
    public function getW3cBright()
    {
        list($r, $g, $b) = $this->get(Zend_Color_Value_Rgb::RANGE, 0);
        return (($r * 299) + ($g * 587) + ($b * 114)) / 1000;
    }
        
    /**
     * Builds an RGB color from a hexadecimal string
     *
     * @param  string $hex Hexadecimal color string
     * @return Zend_Color_Rgb
     */
    public static function fromHex($hex)
    {
        if (!preg_match('/^#?([0-9a-f]{3}|[0-9a-f]{6})$/i', $hex, $match)) {
            throw new Zend_Color_Exception("Hex code '$hex' is invalid");
        }
        $hex = $match[1];
		if (strlen($hex) === 3) {
			$r = hexdec(str_repeat(substr($hex, 0, 1), 2);
			$g = hexdec(str_repeat(substr($hex, 1, 1), 2);
			$b = hexdec(str_repeat(substr($hex, 2, 1), 2);
		} else {
			$r = hexdec(substr($hex, 0, 2));
			$g = hexdec(substr($hex, 2, 2));
			$b = hexdec(substr($hex, 4, 2));
		}
        return new Zend_Color_Rgb($r, $g, $b, Zend_Color_Value_Rgb::RANGE);
    }
    
    /**
     * Builds an RGB color from an HTML/X11 named color
     *
     * @param  string $name HTML/X11 color name
     * @return Zend_Color_Rgb
     */
    public static function fromHtmlNamed($name)
    {
        foreach (self::$HTML_NAMED as $key => $value) {
			if (strtolower($key) === strtolower($name)) {
				$rgb = $value;
				break;
			}
		}
		if (!isset($rgb)) {
            throw new Zend_Color_Exception("Name '$name' not found");
		}
        $rgb = self::$HTML_NAMED[$name];
        return new Zend_Color_Rgb($rgb[0], $rgb[1], $rgb[2], Zend_Color_Value_Rgb::RANGE);
    }
}

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Color_Exception
 */
require_once 'Zend/Color/Exception.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color_Value
{
    const FRACTION   = 'FRACTION';
    const PERCENTAGE = 'PERCENTAGE';

    /**
     * Numerical value
     *
     * @var float
     */
    protected $_value;
    
    /**
     * Constructs a new value
     *
     * @param  float $value Value
     * @param  string $type Optional value type
     * @return void
     */
    public function __construct($value, $type = Zend_Color_Value::PERCENTAGE)
    {
        $this->set($value, $type);
    }
    
    /**
     * Sets the value
     *
     * @param  float $value Value
     * @param  string $type Optional value type
     * @return void
     */
    public function set($value, $type = Zend_Color_Value::PERCENTAGE)
    {
        $value = $this->_input($value, $type);
        $this->_value = ($value > 1) ? 1 : ($value < 0) ? 0 : $value;
    }
    
    /**
     * Converts the input value
     *
     * @param  float $value Value
     * @param  string $type Optional value type
     * @return float
     */
    protected function _input($value, $type)
    {
        switch ($type) {
            case Zend_Color_Value::FRACTION:
                return $value;
            break;
            case Zend_Color_Value::PERCENTAGE:
                return $value / 100;
            break; 
            default:
                throw new Zend_Color_Exception("Type '$type' not recognised");
            break;
        }
    }

    /**
     * Gets the value
     *
     * @param  string $type Optional value type
     * @param  integer $precision Optional precision
     * @return float
     */
    public function get($type = Zend_Color_Value::PERCENTAGE, $precision = 1)
    {
        $value = $this->_output($type);
        return ($precision !== null) ? round($value, $precision) : $value;
    }

    /**
     * Converts the output value
     *
     * @param  string $type Optional value type
     * @return float
     */
    protected function _output($type)
    {
        switch ($type) {
            case Zend_Color_Value::FRACTION:
                return $this->_value;
            break; 
            case Zend_Color_Value::PERCENTAGE:
                return $this->_value * 100;
            break;
            default:
                throw new Zend_Color_Exception("Type '$type' not recognised");
            break;
        }
    }
    
    /**
     * Adjusts the value
     *
     * @param  float $value Adjustment value
     * @param  string $type Optional value type
     * @return void
     */
    public function adjust($value, $type = Zend_Color_Value::PERCENTAGE)
    {
        $value = $this->_input($value, $type);
        $this->set($this->_value += $value, Zend_Color_Value::FRACTION);
    }

    /**
     * Inverts the value
     *
     * @return void
     */
    public function invert()
    {
        $this->_value = abs($this->_value - 1);
    }
}

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Color_Value
 */
require_once 'Zend/Color/Value.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color_Value_Hue extends Zend_Color_Value
{
    const DEGREE = 'DEGREE';
    
    /**
     * Converts the input value
     *
     * @param  float $value Value
     * @param  string $type Optional value type
     * @return float
     */
    protected function _input($value, $type)
    {
        switch ($type) {
            case Zend_Color_Value_Hue::DEGREE:
                return $value / 360;
            break; 
            default:
                return parent::_input($value, $type);
            break;
        }
    }

    /**
     * Converts the output value
     *
     * @param  string $type Optional value type
     * @return float
     */
    protected function _output($type)
    {
        switch ($type) {
            case Zend_Color_Value_Hue::DEGREE:
                return $this->_value * 360;
            break; 
            default:
                return parent::_output($type);
            break;
        }
    }
}

/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id$
 */


/**
 * Zend_Color_Value
 */
require_once 'Zend/Color/Value.php';


/**
 * @category   Zend
 * @package    Zend_Color
 * @copyright  Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Color_Value_Rgb extends Zend_Color_Value
{
    const RANGE = 'RANGE';

    /**
     * Converts the input value
     *
     * @param  float $value Value
     * @param  string $type Optional value type
     * @return float
     */
    protected function _input($value, $type)
    {
        switch ($type) {
            case Zend_Color_Value_Rgb::RANGE:
                return $value / 255;
            break; 
            default:
                return parent::_input($value, $type);
            break;
        }
    }

    /**
     * Converts the output value
     *
     * @param  string $type Optional value type
     * @return float
     */
    protected function _output($type)
    {
        switch ($type) {
            case Zend_Color_Value_Rgb::RANGE:
                return $this->_value * 255;
            break; 
            default:
                return parent::_output($type);
            break;
        }
    }

    /**
     * Rounds value to nearest 5th of value range
     *
     * @return void
     */
    public function makeWebSafe()
    {
        $value = $this->get(Zend_Color_Value_Rgb::RANGE, 0);
        $value = round($value / 51) * 51;
        $this->set($value, Zend_Color_Value_Rgb::RANGE);
    }
    
    /**
     * Rounds value to nearest 15th of value range
     *
     * @return void
     */
    public function makeWebSmart()
    {
        $value = $this->get(Zend_Color_Value_Rgb::RANGE, 0);
        $value = round($value / 17) * 17;
        $this->set($value, Zend_Color_Value_Rgb::RANGE);
    }
}

Page Operations

Browse Space

Zend_Color - Jack Sleight

Labels