colour 0.1.5

合理的默认值

颜色比较是一个广泛的主题。然而，它可能对您来说非常直接。《色彩》使用可配置的默认比较方式，可能适合您的需求

>>> Color("red") == Color("#f00") == Color("blue", hue=0)
True

默认比较算法仅关注“web”表示形式，这相当于比较长十六进制表示形式（例如#FF0000），或者更具体地说，它相当于比较RGB表示中的红色、绿色和蓝色的组成数量，这些值均量化为256值刻度。

这种默认比较是一种实际且方便的方式来衡量您屏幕或视频卡内存中实际颜色的等效性。

但这种比较不会区分黑红色和黑蓝色，这两种颜色都是黑色

>>> black_red = Color("red", luminance=0)
>>> black_blue = Color("blue", luminance=0)

>>> black_red == black_blue
True

自定义

但是，这不是比较两种颜色的唯一方式。由于我相当懒惰，我提供了一种自定义它以满足您需求的方法。因此

>>> from colour import RGB_equivalence, HSL_equivalence
>>> black_red = Color("red", luminance=0, equality=HSL_equivalence)
>>> black_blue = Color("blue", luminance=0, equality=HSL_equivalence)

>>> black_red == black_blue
False

如您所猜测的，合理的默认值是.RGB_equivalence，所以

>>> black_red = Color("red", luminance=0, equality=RGB_equivalence)
>>> black_blue = Color("blue", luminance=0, equality=RGB_equivalence)

>>> black_red == black_blue
True

这是您如何实现您独特的比较函数的方法

>>> saturation_equivalence = lambda c1, c2: c1.saturation == c2.saturation
>>> red = Color("red", equality=saturation_equivalence)
>>> blue = Color("blue", equality=saturation_equivalence)
>>> white = Color("white", equality=saturation_equivalence)

>>> red == blue
True
>>> white == red
False

注意：在比较两种颜色时，仅使用第一个颜色的相等性函数。

>>> black_red = Color("red", luminance=0, equality=RGB_equivalence)
>>> black_blue = Color("blue", luminance=0, equality=HSL_equivalence)

>>> black_red == black_blue
True

但反向操作并不等效！

>>> black_blue == black_red
False

与非.Color对象的相等性

作为旁注，无论您的自定义相等性函数是什么，如果您与任何非.Color实例进行比较，它将不会被使用

>>> red = Color("red", equality=lambda c1, c2: True)
>>> blue = Color("blue", equality=lambda c1, c2: True)

请注意，这些实例将与其他任何颜色视为相等

>>> red == blue
True

但与另一个非.Color对象

>>> red == None
False
>>> red != None
True

实际上，.Color实例将礼貌地给另一边的相等性一个机会来决定输出（通过执行自己的.__eq__），因此

>>> class OtherColorImplem(object):
...     def __init__(self, color):
...         self.color = color
...     def __eq__(self, other):
...         return self.color == other.web

>>> alien_red = OtherColorImplem("red")
>>> red == alien_red
True
>>> blue == alien_red
False

并且不等式（使用.__ne__）也是礼貌的

>>> class AnotherColorImplem(OtherColorImplem):
...     def __ne__(self, other):
...         return self.color != other.web

>>> new_alien_red = AnotherColorImplem("red")
>>> red != new_alien_red
False
>>> blue != new_alien_red
True

基本用法

有时，您只是想为应用程序中的对象选择一种颜色，通常是为了视觉上识别该对象。因此，所选颜色应与相同对象相同，与不同对象不同

>>> foo = object()
>>> bar = object()

>>> Color(pick_for=foo)  # doctest: +ELLIPSIS
<Color ...>
>>> Color(pick_for=foo) == Color(pick_for=foo)
True
>>> Color(pick_for=foo) == Color(pick_for=bar)
False

当然，虽然不同字符串产生相同颜色的概率很小，但大多数情况下，不同的输入会产生不同的颜色。

高级用法

您可以通过提供picker来自定义颜色选择算法。一个picker是一个可调用的函数，它接受一个对象，并返回可以被Color实例化的某个对象。

>>> my_picker = lambda obj: "red" if isinstance(obj, int) else "blue"
>>> Color(pick_for=3, picker=my_picker, pick_key=None)
<Color red>
>>> Color(pick_for="foo", picker=my_picker, pick_key=None)
<Color blue>

您可能想使用特定的picker，但强制执行picker如何识别两个对象为相同（或不相同）。因此，提供了一个默认为hash方法的pick_key属性，如果您的对象不支持hash方法，则默认为对象字符串与类名混合。

因此

>>> class MyObj(str): pass
>>> my_obj_color = Color(pick_for=MyObj("foo"))
>>> my_str_color = Color(pick_for="foo")
>>> my_obj_color == my_str_color
False

在使用RGB_color_picker选择机制之前，请确保您的对象是可哈希的或“可转换为字符串”的，或者提供另一个颜色picker。几乎所有Python对象默认都是可哈希的，所以这不应该成问题（例如，object实例及其子类都是可哈希的）。

neitherhash nor str都不是完美的解决方案。因此，在Color实例化时，请随时使用pick_key来设置您识别对象的方式，例如

>>> a = object()
>>> b = object()
>>> Color(pick_for=a, pick_key=id) == Color(pick_for=b, pick_key=id)
False

在选择pick key时，您应该仔细考虑是否希望在运行之间保持颜色的一致性（这与最后一个示例不同），或者如果它是可变对象，则与对象的内容保持一致。

pick_key和picker的默认值确保对于大多数Python对象，在不同的计算机上的不同运行中，相同的颜色会被分配给相同的对象。

新功能

• 颜色名称不区分大小写。[Chris Priest]

  颜色名称结构中的名称首字母大写。由一个单词组成的颜色名称将显示为小写。

修复

• 现在使用 W3C 颜色推荐。[Chris Priest]

  之前使用 X11 颜色方案，它与 W3C 网页颜色规范略有不同。

• 许可证信息不一致（删除了 GPL 提及）。（修复了 #8）[Valentin Lab]

• 从 setup.py 的依赖项列表中删除了 gitchangelog。（修复了 #9）[Valentin Lab]