pygame.Color
用于颜色表示的Pygame对象
Color(r, g, b) -> Color
Color(r, g, b, a=255) -> Color
Color(color_value) -> Color
pygame.Color.r
获取或设置“颜色”的红色值。
pygame.Color.g
获取或设置Color的绿色值。
pygame.Color.b
获取或设置颜色的蓝色值。
pygame.Color.a
获取或设置颜色的alpha值。
pygame.Color.cmy
获取或设置颜色的CMY表示形式。
pygame.Color.hsva
获取或设置颜色的HSVA表示形式。
pygame.Color.hsla
获取或设置颜色的HSLA表示形式。
pygame.Color.i1i2i3
获取或设置颜色的I1I2I3表示形式。
pygame.Color.normalize
返回Color的标准化RGBA值。
pygame.Color.correct_gamma
对颜色应用特定的伽玛值。
pygame.Color.set_length
将Color中的元素数量设置为1、2、3或4。
pygame.Color.lerp
返回给定颜色的线性插值。
pygame.Color.premul_alpha
返回一个颜色,其中r,g,b组件已经乘以了alpha。
pygame.Color.update
设置颜色的元素
Color类表示RGBA颜色值,取值范围为0到255(含255)。
它允许基本的算术操作二进制操作+,-,*,//,%和一元操作~来创建新的颜色,支持转换到其他颜色空间,如HSV或HSL,并允许您调整单一颜色通道。
Alpha默认为255(完全不透明)当没有给出。
算术运算和correct_gamma()方法保留了子类。
对于二元操作符,返回的颜色的类是该操作符的左边的color对象的类。
颜色对象支持与其他颜色对象以及3或4个整数元组的相等比较。
在pygame 1.8.1中有一个bug,默认alpha是0,而不是之前的255。
颜色对象导出C级数组接口。
该接口导出一个与颜色指定长度相同的只读单维无符号字节数组。
对于CPython 2.6及更高版本,还导出了新的缓冲区接口,具有与数组接口相同的特征。
底数除法//和模数%运算符不会引发被零除法的异常。
相反,如果右边的颜色或alpha通道是0,那么结果是0。
例如:
# These expressions are True
Color(255, 255, 255, 255) // Color(0, 64, 64, 64) == Color(0, 3, 3, 3)
Color(255, 255, 255, 255) % Color(64, 64, 64, 0) == Color(63, 63, 63, 0)
Parameters(参数):
r (int)–红色值,取值范围为0 ~ 255(含255)
g (int)–绿色取值范围为0 ~ 255(含255)
b (int)–蓝色值,取值范围为0 ~ 255
a (int)–(可选)alpha值的取值范围为0 ~ 255(含255),默认为255
color_value(颜色或str或int或元组(int, int, [int])或list(int, int, int, [int]))–颜色值(请参阅下面支持的格式)
请注意
支持color_value格式:
-颜色对象:克隆给定的颜色对象
str:要使用的颜色名称,例如
‘red’(所有支持的名称字符串都可以在colordict模块中找到)
- HTML颜色格式str: ‘#rrggbbaa’或’#rrggbb’,其中rr, gg, bb, aa是2位十六进制数字,范围从0到0xFF(含0xFF), aa (alpha)值默认为0xFF(如果没有提供)
-十六进制数str: ‘0xrrggbbaa’或’0xrrggbb’,其中rr, gg, bb, aa是2位十六进制数,范围从0x00到0xFF(含0xFF), aa (alpha)值如果没有提供,默认为0xFF - int: int值的颜色使用,使用十六进制数字可以让这个参数更具可读性,例如0 xrrggbbaa, rr, gg, bb,和美航便是十六进制数字0 x00 0 xff包容性的范围,注意,aa(α)的int值不是可选格式和必须提供
-元组/列表的int颜色值:(R, G, B, A)或(R, G, B),其中R, G, B,和A是int值的范围为0到255(含255),如果没有提供,A (alpha)值默认为255
Returns(返回):一个新创建的Color对象
Return type(返回类型):颜色Color