|
0
|
1
|
|
|
2
|
|
|
3 # Copyright (c) 2005 Gavin E. Crooks
|
|
|
4 #
|
|
|
5 # This software is distributed under the MIT Open Source License.
|
|
|
6 # <http://www.opensource.org/licenses/mit-license.html>
|
|
|
7 #
|
|
|
8 # Permission is hereby granted, free of charge, to any person obtaining a
|
|
|
9 # copy of this software and associated documentation files (the "Software"),
|
|
|
10 # to deal in the Software without restriction, including without limitation
|
|
|
11 # the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
|
12 # and/or sell copies of the Software, and to permit persons to whom the
|
|
|
13 # Software is furnished to do so, subject to the following conditions:
|
|
|
14 #
|
|
|
15 # The above copyright notice and this permission notice shall be included
|
|
|
16 # in all copies or substantial portions of the Software.
|
|
|
17 #
|
|
|
18 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
19 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
20 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
21 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
22 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
23 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
24 # THE SOFTWARE.
|
|
|
25
|
|
|
26 """ Color specifications using CSS2 (Cascading Style Sheet) syntax."""
|
|
|
27
|
|
|
28 class Color:
|
|
|
29 """ Color specifications using CSS2 (Cascading Style Sheet) syntax.
|
|
|
30
|
|
|
31 http://www.w3.org/TR/REC-CSS2/syndata.html#color-units
|
|
|
32
|
|
|
33 Usage:
|
|
|
34
|
|
|
35 red = Color(255,0,0)
|
|
|
36 red = Color(1., 0., 0.)
|
|
|
37 red = Color.by_name("red")
|
|
|
38 red = Color.from_rgb(1.,0.,0.)
|
|
|
39 red = Color.from_rgb(255,0,0)
|
|
|
40 red = Color.from_hsl(0.,1., 0.5)
|
|
|
41
|
|
|
42 red = Color.from_string("red")
|
|
|
43 red = Color.from_string("RED")
|
|
|
44 red = Color.from_string("#F00")
|
|
|
45 red = Color.from_string("#FF0000")
|
|
|
46 red = Color.from_string("rgb(255, 0, 0)")
|
|
|
47 red = Color.from_string("rgb(100%, 0%, 0%)")
|
|
|
48 red = Color.from_string("hsl(0, 100%, 50%)")
|
|
|
49
|
|
|
50 """
|
|
|
51 def __init__(self, red, green, blue) :
|
|
|
52
|
|
|
53 if ( type(red) is not type(green) ) or (type(red) is not type(blue)):
|
|
|
54 raise TypeError("Mixed floats and integers?")
|
|
|
55
|
|
|
56 if type(red) is type(1) : red = float(red)/255.
|
|
|
57 if type(green) is type(1) : green = float(green)/255.
|
|
|
58 if type(blue) is type(1) : blue = float(blue)/255.
|
|
|
59
|
|
|
60 self.red = max(0., min(float(red), 1.0))
|
|
|
61 self.green = max(0., min(float(green), 1.0))
|
|
|
62 self.blue = max(0., min(float(blue), 1.0))
|
|
|
63
|
|
|
64 #@staticmethod
|
|
|
65 def names():
|
|
|
66 "Return a list of standard color names."
|
|
|
67 return _std_colors.keys()
|
|
|
68 names = staticmethod(names)
|
|
|
69
|
|
|
70 #@classmethod
|
|
|
71 def from_rgb(cls, r, g, b):
|
|
|
72 return cls(r,g,b)
|
|
|
73 from_rgb = classmethod(from_rgb)
|
|
|
74
|
|
|
75 #@classmethod
|
|
|
76 def from_hsl(cls, hue_angle, saturation, lightness ):
|
|
|
77 def hue_to_rgb( v1, v2, vH) :
|
|
|
78 if vH < 0.0 : vH += 1.0
|
|
|
79 if vH > 1.0 : vH -= 1.0
|
|
|
80 if vH*6.0 < 1.0 : return (v1 + (v2 - v1) * 6.0 * vH)
|
|
|
81 if vH*2.0 < 1.0 : return v2
|
|
|
82 if vH*3.0 < 2.0 : return (v1 + (v2 - v1) * ((2.0/3.0) - vH) * 6.0)
|
|
|
83 return v1
|
|
|
84
|
|
|
85 hue = (((hue_angle % 360.) + 360.) % 360.)/360.
|
|
|
86
|
|
|
87 if not (saturation >= 0.0 and saturation <=1.0) :
|
|
|
88 raise ValueError("Out-of-range saturation %f"% saturation)
|
|
|
89 if not (lightness >= 0.0 and lightness <=1.0) :
|
|
|
90 raise ValueError("Out-of-range lightness %f"% lightness)
|
|
|
91
|
|
|
92 if saturation == 0 :
|
|
|
93 # greyscale
|
|
|
94 return cls.from_rgb( lightness, lightness, lightness)
|
|
|
95
|
|
|
96 if lightness < 0.5 :
|
|
|
97 v2 = lightness * (1.0+ saturation)
|
|
|
98 else :
|
|
|
99 v2 = (lightness + saturation) - (saturation* lightness)
|
|
|
100
|
|
|
101 v1 = 2.0 * lightness - v2
|
|
|
102 r = hue_to_rgb( v1, v2, hue + (1./3.) )
|
|
|
103 g = hue_to_rgb( v1, v2, hue )
|
|
|
104 b = hue_to_rgb( v1, v2, hue - (1./3.) )
|
|
|
105
|
|
|
106 return cls(r,g,b)
|
|
|
107 from_hsl = classmethod(from_hsl)
|
|
|
108
|
|
|
109
|
|
|
110 #@staticmethod
|
|
|
111 def by_name(string):
|
|
|
112 s = string.strip().lower().replace(' ', '')
|
|
|
113
|
|
|
114 try:
|
|
|
115 return _std_colors[s]
|
|
|
116 except KeyError:
|
|
|
117 raise ValueError("Unknown color name: %s"% s)
|
|
|
118 by_name = staticmethod(by_name)
|
|
|
119
|
|
|
120 #@classmethod
|
|
|
121 def from_string(cls, string):
|
|
|
122 def to_frac(string) :
|
|
|
123 # string can be "255" or "100%"
|
|
|
124 if string[-1]=='%':
|
|
|
125 return float(string[0:-1])/100.
|
|
|
126 else:
|
|
|
127 return float(string)/255.
|
|
|
128
|
|
|
129 s = string.strip().lower().replace(' ', '').replace('_', '')
|
|
|
130
|
|
|
131 if s in _std_colors : # "red"
|
|
|
132 return _std_colors[s]
|
|
|
133
|
|
|
134 if s[0] == "#" : # "#fef"
|
|
|
135 if len(s) == 4 :
|
|
|
136 r = int(s[1]+s[1],16)
|
|
|
137 g = int(s[2]+s[2],16)
|
|
|
138 b = int(s[3]+s[3],16)
|
|
|
139 return cls(r,g,b)
|
|
|
140 elif len(s) ==7 : # "#ff00aa"
|
|
|
141 r = int(s[1:3],16)
|
|
|
142 g = int(s[3:5],16)
|
|
|
143 b = int(s[5:7],16)
|
|
|
144 return cls(r,g,b)
|
|
|
145 else :
|
|
|
146 raise ValueError("Cannot parse string: %s" % s)
|
|
|
147
|
|
|
148 if s[0:4] == 'rgb(' and s[-1] == ')' :
|
|
|
149 rgb = s[4:-1].split(",")
|
|
|
150 if len(rgb) != 3 :
|
|
|
151 raise ValueError("Cannot parse string a: %s" % s)
|
|
|
152 return cls( to_frac(rgb[0]), to_frac(rgb[1]), to_frac(rgb[2]))
|
|
|
153
|
|
|
154 if s[0:4] == 'hsl(' and s[-1] == ')' :
|
|
|
155 hsl = s[4:-1].split(",")
|
|
|
156 if len(hsl) != 3 :
|
|
|
157 raise ValueError("Cannot parse string a: %s" % s)
|
|
|
158 return cls.from_hsl( int(hsl[0]), to_frac(hsl[1]), to_frac(hsl[2]))
|
|
|
159
|
|
|
160 raise ValueError("Cannot parse string: %s" % s)
|
|
|
161 from_string = classmethod(from_string)
|
|
|
162
|
|
|
163 def __eq__(self, other) :
|
|
|
164 req = int(0.5+255.*self.red) == int(0.5+255.*other.red)
|
|
|
165 beq = int(0.5+255.*self.blue) == int(0.5+255.*other.blue)
|
|
|
166 geq = int(0.5+255.*self.green) == int(0.5+255.*other.green)
|
|
|
167
|
|
|
168 return req and beq and geq
|
|
|
169
|
|
|
170 def __repr__(self):
|
|
|
171 return "Color(%f,%f,%f)" % (self.red, self.green, self.blue)
|
|
|
172
|
|
|
173
|
|
|
174 _std_colors = dict(
|
|
|
175 aliceblue = Color(240,248,255), #f0f8ff
|
|
|
176 antiquewhite = Color(250,235,215), #faebd7
|
|
|
177 aqua = Color(0,255,255), #00ffff
|
|
|
178 aquamarine = Color(127,255,212), #7fffd4
|
|
|
179 azure = Color(240,255,255), #f0ffff
|
|
|
180 beige = Color(245,245,220), #f5f5dc
|
|
|
181 bisque = Color(255,228,196), #ffe4c4
|
|
|
182 black = Color(0,0,0), #000000
|
|
|
183 blanchedalmond = Color(255,235,205), #ffebcd
|
|
|
184 blue = Color(0,0,255), #0000ff
|
|
|
185 blueviolet = Color(138,43,226), #8a2be2
|
|
|
186 brown = Color(165,42,42), #a52a2a
|
|
|
187 burlywood = Color(222,184,135), #deb887
|
|
|
188 cadetblue = Color(95,158,160), #5f9ea0
|
|
|
189 chartreuse = Color(127,255,0), #7fff00
|
|
|
190 chocolate = Color(210,105,30), #d2691e
|
|
|
191 coral = Color(255,127,80), #ff7f50
|
|
|
192 cornflowerblue = Color(100,149,237), #6495ed
|
|
|
193 cornsilk = Color(255,248,220), #fff8dc
|
|
|
194 crimson = Color(220,20,60), #dc143c
|
|
|
195 cyan = Color(0,255,255), #00ffff
|
|
|
196 darkblue = Color(0,0,139), #00008b
|
|
|
197 darkcyan = Color(0,139,139), #008b8b
|
|
|
198 darkgoldenrod = Color(184,134,11), #b8860b
|
|
|
199 darkgray = Color(169,169,169), #a9a9a9
|
|
|
200 darkgreen = Color(0,100,0), #006400
|
|
|
201 darkgrey = Color(169,169,169), #a9a9a9
|
|
|
202 darkkhaki = Color(189,183,107), #bdb76b
|
|
|
203 darkmagenta = Color(139,0,139), #8b008b
|
|
|
204 darkolivegreen = Color(85,107,47), #556b2f
|
|
|
205 darkorange = Color(255,140,0), #ff8c00
|
|
|
206 darkorchid = Color(153,50,204), #9932cc
|
|
|
207 darkred = Color(139,0,0), #8b0000
|
|
|
208 darksalmon = Color(233,150,122), #e9967a
|
|
|
209 darkseagreen = Color(143,188,143), #8fbc8f
|
|
|
210 darkslateblue = Color(72,61,139), #483d8b
|
|
|
211 darkslategray = Color(47,79,79), #2f4f4f
|
|
|
212 darkslategrey = Color(47,79,79), #2f4f4f
|
|
|
213 darkturquoise = Color(0,206,209), #00ced1
|
|
|
214 darkviolet = Color(148,0,211), #9400d3
|
|
|
215 deeppink = Color(255,20,147), #ff1493
|
|
|
216 deepskyblue = Color(0,191,255), #00bfff
|
|
|
217 dimgray = Color(105,105,105), #696969
|
|
|
218 dimgrey = Color(105,105,105), #696969
|
|
|
219 dodgerblue = Color(30,144,255), #1e90ff
|
|
|
220 firebrick = Color(178,34,34), #b22222
|
|
|
221 floralwhite = Color(255,250,240), #fffaf0
|
|
|
222 forestgreen = Color(34,139,34), #228b22
|
|
|
223 fuchsia = Color(255,0,255), #ff00ff
|
|
|
224 gainsboro = Color(220,220,220), #dcdcdc
|
|
|
225 ghostwhite = Color(248,248,255), #f8f8ff
|
|
|
226 gold = Color(255,215,0), #ffd700
|
|
|
227 goldenrod = Color(218,165,32), #daa520
|
|
|
228 gray = Color(128,128,128), #808080
|
|
|
229 green = Color(0,128,0), #008000
|
|
|
230 greenyellow = Color(173,255,47), #adff2f
|
|
|
231 grey = Color(128,128,128), #808080
|
|
|
232 honeydew = Color(240,255,240), #f0fff0
|
|
|
233 hotpink = Color(255,105,180), #ff69b4
|
|
|
234 indianred = Color(205,92,92), #cd5c5c
|
|
|
235 indigo = Color(75,0,130), #4b0082
|
|
|
236 ivory = Color(255,255,240), #fffff0
|
|
|
237 khaki = Color(240,230,140), #f0e68c
|
|
|
238 lavender = Color(230,230,250), #e6e6fa
|
|
|
239 lavenderblush = Color(255,240,245), #fff0f5
|
|
|
240 lawngreen = Color(124,252,0), #7cfc00
|
|
|
241 lemonchiffon = Color(255,250,205), #fffacd
|
|
|
242 lightblue = Color(173,216,230), #add8e6
|
|
|
243 lightcoral = Color(240,128,128), #f08080
|
|
|
244 lightcyan = Color(224,255,255), #e0ffff
|
|
|
245 lightgoldenrodyellow = Color(250,250,210), #fafad2
|
|
|
246 lightgray = Color(211,211,211), #d3d3d3
|
|
|
247 lightgreen = Color(144,238,144), #90ee90
|
|
|
248 lightgrey = Color(211,211,211), #d3d3d3
|
|
|
249 lightpink = Color(255,182,193), #ffb6c1
|
|
|
250 lightsalmon = Color(255,160,122), #ffa07a
|
|
|
251 lightseagreen = Color(32,178,170), #20b2aa
|
|
|
252 lightskyblue = Color(135,206,250), #87cefa
|
|
|
253 lightslategray = Color(119,136,153), #778899
|
|
|
254 lightslategrey = Color(119,136,153), #778899
|
|
|
255 lightsteelblue = Color(176,196,222), #b0c4de
|
|
|
256 lightyellow = Color(255,255,224), #ffffe0
|
|
|
257 lime = Color(0,255,0), #00ff00
|
|
|
258 limegreen = Color(50,205,50), #32cd32
|
|
|
259 linen = Color(250,240,230), #faf0e6
|
|
|
260 magenta = Color(255,0,255), #ff00ff
|
|
|
261 maroon = Color(128,0,0), #800000
|
|
|
262 mediumaquamarine = Color(102,205,170), #66cdaa
|
|
|
263 mediumblue = Color(0,0,205), #0000cd
|
|
|
264 mediumorchid = Color(186,85,211), #ba55d3
|
|
|
265 mediumpurple = Color(147,112,219), #9370db
|
|
|
266 mediumseagreen = Color(60,179,113), #3cb371
|
|
|
267 mediumslateblue = Color(123,104,238), #7b68ee
|
|
|
268 mediumspringgreen = Color(0,250,154), #00fa9a
|
|
|
269 mediumturquoise = Color(72,209,204), #48d1cc
|
|
|
270 mediumvioletred = Color(199,21,133), #c71585
|
|
|
271 midnightblue = Color(25,25,112), #191970
|
|
|
272 mintcream = Color(245,255,250), #f5fffa
|
|
|
273 mistyrose = Color(255,228,225), #ffe4e1
|
|
|
274 moccasin = Color(255,228,181), #ffe4b5
|
|
|
275 navajowhite = Color(255,222,173), #ffdead
|
|
|
276 navy = Color(0,0,128), #000080
|
|
|
277 oldlace = Color(253,245,230), #fdf5e6
|
|
|
278 olive = Color(128,128,0), #808000
|
|
|
279 olivedrab = Color(107,142,35), #6b8e23
|
|
|
280 orange = Color(255,165,0), #ffa500
|
|
|
281 orangered = Color(255,69,0), #ff4500
|
|
|
282 orchid = Color(218,112,214), #da70d6
|
|
|
283 palegoldenrod = Color(238,232,170), #eee8aa
|
|
|
284 palegreen = Color(152,251,152), #98fb98
|
|
|
285 paleturquoise = Color(175,238,238), #afeeee
|
|
|
286 palevioletred = Color(219,112,147), #db7093
|
|
|
287 papayawhip = Color(255,239,213), #ffefd5
|
|
|
288 peachpuff = Color(255,218,185), #ffdab9
|
|
|
289 peru = Color(205,133,63), #cd853f
|
|
|
290 pink = Color(255,192,203), #ffc0cb
|
|
|
291 plum = Color(221,160,221), #dda0dd
|
|
|
292 powderblue = Color(176,224,230), #b0e0e6
|
|
|
293 purple = Color(128,0,128), #800080
|
|
|
294 red = Color(255,0,0), #ff0000
|
|
|
295 rosybrown = Color(188,143,143), #bc8f8f
|
|
|
296 royalblue = Color(65,105,225), #4169e1
|
|
|
297 saddlebrown = Color(139,69,19), #8b4513
|
|
|
298 salmon = Color(250,128,114), #fa8072
|
|
|
299 sandybrown = Color(244,164,96), #f4a460
|
|
|
300 seagreen = Color(46,139,87), #2e8b57
|
|
|
301 seashell = Color(255,245,238), #fff5ee
|
|
|
302 sienna = Color(160,82,45), #a0522d
|
|
|
303 silver = Color(192,192,192), #c0c0c0
|
|
|
304 skyblue = Color(135,206,235), #87ceeb
|
|
|
305 slateblue = Color(106,90,205), #6a5acd
|
|
|
306 slategray = Color(112,128,144), #708090
|
|
|
307 slategrey = Color(112,128,144), #708090
|
|
|
308 snow = Color(255,250,250), #fffafa
|
|
|
309 springgreen = Color(0,255,127), #00ff7f
|
|
|
310 steelblue = Color(70,130,180), #4682b4
|
|
|
311 tan = Color(210,180,140), #d2b48c
|
|
|
312 teal = Color(0,128,128), #008080
|
|
|
313 thistle = Color(216,191,216), #d8bfd8
|
|
|
314 tomato = Color(255,99,71), #ff6347
|
|
|
315 turquoise = Color(64,224,208), #40e0d0
|
|
|
316 violet = Color(238,130,238), #ee82ee
|
|
|
317 wheat = Color(245,222,179), #f5deb3
|
|
|
318 white = Color(255,255,255), #ffffff
|
|
|
319 whitesmoke = Color(245,245,245), #f5f5f5
|
|
|
320 yellow = Color(255,255,0), #ffff00
|
|
|
321 yellowgreen = Color(154,205,50) #9acd32
|
|
|
322 )
|
|
|
323
|
|
|
324
|
