colorutils 0.3.0

3.1 实例化一个Color

实例化Color的基本方法

>>> from colorutils import Color
>>> c = Color((255, 255, 255))
>>> c
<Color (255, 255, 255)>

默认情况下，Color对象期望一个RGB 3元组，但有多种方式可以实例化一个Color。以青色为例，可能性

Color((0, 255, 255))
Color(green=255, blue=255)
Color(rgb=(0, 255, 255))
Color(hex='#00FFFF')
Color(hex='00ffff')
Color(hex='#0ff')
Color(hex='0ff')
Color(web='cyan')
Color(web='Cyan')
Color(web='CYAN')
Color(web='#00ffff')
Color(web='#0ff')
Color(yiq=(0.701, -0.596, -0.217))
Color(hsv=(180, 1, 1))

Color对象也可以从其他Color对象中获取颜色

>>> Color(Color((255, 255, 255)))
<Color (255, 255, 255)>

>>> Color(Color(Color(Color((255, 255, 255)))))
<Color (255, 255, 255)>

3.2 颜色转换

colorutils支持的当前颜色模型是：RGB、HEX、WEB、YIQ和HSV。每个实例化的Color对象都有属性，可以自动执行所需的转换

>>> c = Color((46, 139, 87))

>>> c.red
46

>>> c.green
139

>>> c.blue
87

>>> c.rgb
(46, 139, 87)

>>> c.hex
'#2e8b57'

>>> c.shorthex
'#2e8b57'

>>> c.web
'SeaGreen'

>>> c.yiq
(0.413, -0.152, -0.143)

>>> c.hsv
(146.452, 0.669, 0.545)

如果颜色是这样的，HEX表示可以捕获为3字符的十六进制

>>> c = Color((0, 0, 0))

>>> c.hex
'#000000'

>>> c.shorthex
'#000'

如果颜色不是已知的网络颜色名称，则WEB表示将返回十六进制值

>>> c = Color((1, 243, 77))

>>> c.hex
'#01f34d'

>>> c.web
'#01f34d'

这些相同的转换可以通过使用静态方法在不实例化Color对象的情况下完成

• rgb_to_hex()

• rgb_to_web()

• rgb_to_yiq()

• rgb_to_hsv()

• hex_to_rgb()

• hex_to_web()

• hex_to_yiq()

• hex_to_hsv()

• web_to_rgb()

• web_to_hex()

• web_to_yiq()

• web_to_hsv()

• yiq_to_rgb()

• yiq_to_hex()

• yiq_to_web()

• yiq_to_hsv()

• hsv_to_rgb()

• hsv_to_hex()

• hsv_to_web()

• hsv_to_yiq()

使用这些静态转换方法，可以链式转换（由于所有多值颜色表示的输入参数和输出参数都是元组），这是您无法使用Python默认的colorsys完成的。

>>> rgb_to_hex(hex_to_rgb('#808080'))
'#808080'

当然，要小心链式操作。由于转换算法中存在近似，因此会发生退化

>>> yiq_to_web(rgb_to_yiq(hex_to_rgb('808080')))
'#7f807e'

尽管如此，值仍然很接近

>>> hex(int('80', 16) - int('7f', 16))  # Red difference
'0x1'

>>> hex(int('80', 16) - int('80', 16))  # Green difference
'0x0'

>>> hex(int('80', 16) - int('7e', 16))  # Blue difference
'0x2'

3.3 Color 算术

尽管颜色加法和减法不一定有意义，但这种能力得到了支持。目前支持两种加法模型：LIGHT和BLEND。

>>> Color((0, 100, 200)) + Color((100, 100, 100))
<Color (100, 200, 255)>

>>> Color((0, 100, 200), arithmetic=ArithmeticModel.BLEND) + Color((100, 100, 100))
<Color (50, 150, 250)>

>>> Color((50, 50, 50)) + (20, 20, 20)
<Color (70, 70, 70)>

>>> Color((100, 100, 100)) - Color((0, 75, 200))
<Color (100, 25, 0)>

>>> Color((50, 50, 50)) - (20, 20, 20)
<Color (30, 30, 30)>

3.4 颜色相等性

默认情况下，测试颜色之间的相等性是测试 RGB 值之间的相等性

>>> c1 = Color((10, 20, 30))
>>> c2 = Color((10, 20, 30))
>>> c3 = Color((10, 20, 20))

>>> c1 == c2
True

>>> c1 == c3
False

可以设置不同的相等性函数，使用 colorutils.equality 中的预定义相等性，或自定义相等性函数

>>> from colorutils.equality import *
>>> c = Color((10, 20, 30), equality_fn=RED_eq)
>>> c2 = Color((10, 40, 60))

>>> c == c2
True

>>> c2 == c
False

注意，在上面的示例中，当检查红色相等性时，当具有 RED_eq 相等性的颜色在比较中排在前面时，它评估为 True。如果它排在后面，它评估为 False。这是因为比较中第一个 Color 实例的相等性函数定义了使用哪个相等性函数。

预定义的相等性包括

• RGB_eq

• RED_eq

• GREEN_eq

• BLUE_eq

• HEX_eq

• WEB_eq

• YIQ_eq

• HSV_eq

定义自定义相等性将遵循以下 RGB_eq 定义的模式

RGB_eq = lambda c1, c2: c1.rgb == c2.rgb

3.5 颜色调色板

存在一些预定义的颜色调色板以方便使用。当前已实现的调色板包括

• 灰度

• 主色

• RGB

• ROYGBV

• 副色

可以从调色板中使用单个命名的颜色，或检索所有颜色

>>> import colorutils.palettes.primary as primary

>>> primary.red
<Color (255, 0, 0)>

>>> primary.yellow
<Color (255, 255, 0)>

>>> primary.blue
<Color (0, 0, 255)>

>>> primary.all
[<Color (255, 0, 0)>, <Color (255, 255, 0)>, <Color (0, 0, 255)>]