3 * StatusNet, the distributed open-source microblogging tool
5 * Base class for deleting things
9 * LICENCE: This program is free software: you can redistribute it and/or modify
10 * it under the terms of the GNU Affero General Public License as published by
11 * the Free Software Foundation, either version 3 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU Affero General Public License for more details.
19 * You should have received a copy of the GNU Affero General Public License
20 * along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * @author Zach Copley <zach@status.net>
25 * @copyright 2009 StatusNet, Inc.
26 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
27 * @link http://status.net/
30 if (!defined('STATUSNET') && !defined('LACONICA')) {
35 // XXX: Maybe make getters and setters for r,g,b values and tuples,
36 // e.g.: to support this kinda CSS representation: rgb(255,0,0)
37 // http://www.w3.org/TR/CSS21/syndata.html#color-units
49 function __construct($color = null)
52 $this->parseColor($color);
57 * Parses input to and tries to determine whether the color
58 * is being specified via an integer or hex tuple and sets
59 * the RGB instance variables accordingly.
61 * XXX: Maybe support (r,g,b) style, and array?
67 function parseColor($color) {
69 if (is_numeric($color)) {
70 $this->setIntColor($color);
75 // XXX: probably should do even more validation
77 if (preg_match('/(#([0-9A-Fa-f]{3,6})\b)/u', $color) > 0) {
78 $this->setHexColor($color);
80 $errmsg = _('%s is not a valid color!');
81 throw new WebColorException(sprintf($errmsg, $color));
91 function setNamedColor($name)
97 * Sets the RGB color values from a a hex tuple
99 * @param string $hexcolor
103 function setHexColor($hexcolor) {
105 if ($hexcolor[0] == '#') {
106 $hexcolor = substr($hexcolor, 1);
109 if (strlen($hexcolor) == 6) {
110 list($r, $g, $b) = array($hexcolor[0].$hexcolor[1],
111 $hexcolor[2].$hexcolor[3],
112 $hexcolor[4].$hexcolor[5]);
113 } elseif (strlen($hexcolor) == 3) {
114 list($r, $g, $b) = array($hexcolor[0].$hexcolor[0],
115 $hexcolor[1].$hexcolor[1],
116 $hexcolor[2].$hexcolor[2]);
118 // TRANS: Validation error for a web colour.
119 // TRANS: %s is the provided (invalid) text for colour.
120 $errmsg = _('%s is not a valid color! Use 3 or 6 hex characters.');
121 throw new WebColorException(sprintf($errmsg, $hexcolor));
124 $this->red = hexdec($r);
125 $this->green = hexdec($g);
126 $this->blue = hexdec($b);
131 * Sets the RGB color values from a 24-bit integer
133 * @param int $intcolor
137 function setIntColor($intcolor)
139 // We could do 32 bit and have an alpha channel because
140 // Sarven wants one real bad, but nah.
142 $this->red = $intcolor >> 16;
143 $this->green = $intcolor >> 8 & 0xFF;
144 $this->blue = $intcolor & 0xFF;
149 * Returns a hex tuple of the RGB color useful for output in HTML
153 function hexValue() {
155 $hexcolor = (strlen(dechex($this->red)) < 2 ? '0' : '' ) .
157 $hexcolor .= (strlen(dechex($this->green)) < 2 ? '0' : '') .
158 dechex($this->green);
159 $hexcolor .= (strlen(dechex($this->blue)) < 2 ? '0' : '') .
162 return strtoupper($hexcolor);
166 * Returns a 24-bit packed integer representation of the RGB color
167 * for convenient storage in the DB
169 * XXX: probably could just use hexdec() instead
175 $intcolor = 256 * 256 * $this->red + 256 * $this->green + $this->blue;
181 class WebColorException extends Exception