pygame中文手册

【实例简介】

pygame中文手册完整翻译，简单通俗易懂，便于2D游戏快速开发。
Color| Pygame中文文档
class pygame. Color
Pygame中用于描述颜色的对象
Color(name)->Color
Color(r, g, b, a)-> Color
Color(rgbvalue)-> Color
方法&属性
pygame. Color.:一获取或设置 Color对象的红色值
pygame. Color. g一获取或设置 Color对象的绿色值
· pygame. Color.b一获取或设置 Color对象的蓝色值
· pygame. Color.a一获取或设置 Color对象的 alpha值
pygame. Color cmy一获取或设置 Color对象表示的CMY值
pygame. Colorhsva一获取或设置 Color对象表示的HSVA值
pygame. Color.hsla一获取或设置 Color对象表示的HSLA值
pygame. Color.1i2i3一获取或设置 Color对象表示的II2I3值
pygame. Color normalize0一返回 Color对象的标准化RGBA值
pygame. Color correct _ gamma(一应用一定的伽马值调整 Color对象
pygame. Color set_length0一设置 Color对象的长度(成员数量)
Pygame使用 Color类表示RGBA颜色值,每个颜色值的取值范围是0~255。允许通过基本的算术运算
创造新的颜色值,支持转换为其他颜色空间,例如HSV或HSL,并让你调整单个颜色通道。当没有给岀
alpha的值是,默认是255(不透明)。
RGB值”可以是一个颜色名,一个HTML颜色格式的字符串,一个16进制数的字符串,或者一个整型
像素值。HTML格式是"# rrggbbaa",其中"r","gg","bb","a"都是2位的16进制数。代表 alpha
的"a"是可选的。16进制数的字符串组成形式为"0 xrrggbbaa",当然,其中的"aa"也是可选的。
Pygame19.0之后,颜色对象支持与其他颜色对象进行等值比较(3或4整型元祖)
在 Pygame1.81中有—个bug,就是 alpha的默认值被设置为0,而不是255。
Color对象采用C级别的接口输出。输出为只读的维无符号字节数组,分配与 color对象相同的长度
对于 CPython26以后的版本,新的缓冲区接口(与数组接口具有相同的特性)也会被输出。 Pygame
1.9.2新增加的。
Color的新实现在 Pygame181中完成
方法&属性详解
获取或设置 Color对象的红色值。
r-> int
Coor对象的红色值。
g
获取或设置 Color对象的绿色值。
nt
Color对象的绿色值。
获取或设置 Color对象的蓝色值。
Color对象的蓝色值
获取或设置Coor对象的 alpha值。
a-> int
Color对象的 alpha值
cmy
获取或设置 Color对象表示的CMY值。
cmy-> tuple
Color对象表示的CMY值。CMY每个分量的范围是C=[0,1],M=[0,1],Y=[0,1]。
注意:由于RGB值应设为0~255,而CMY值为0~1,因此无法绝对准确地返回所有RGB值对应的
CMY值,会有少许偏差
小甲鱼温馨提示:CMY是青(Cyan)、洋红或品红( Magenta)和黄(YeoW)三种颜色的简写,是相
减混色模式,用这种方法产生的颜色之所以称为相减色,乃是因为它减少了为视觉系统识别颜色所需要的
反射光。由于彩色墨水和颜料的化学特性,用三种基本色得到的黑色不是纯黑色,因此在印刷术中,常常
加一种真正的黑色( black ink),这种模型称为MYK模型,广泛应用于印刷术。每种颜色分量的取值范
围为0~100;CMY常用于纸张彩色打印方面。
hsva
获取或设置 Color对象表示的HSVA值。
hsva-> tuple
Color对象表示的HSVA值。HSVA每个分量的范围是H=[0,360],S=[0,100],V=[0,100],A=[0
100
注意:由于RGB值应设为0~255,而HSV值为0~100和0~360,因此无法绝对准确地返回所有
RGB值对应的HSV值,会有少许偏差。
小甲鱼温馨提示:Hs∨色彩模型中颜色的参数分别是:色调(H),饱和度(S),亮度(V)。RGB和
CMY颜色模型都是面向硬件的,而Hs∨( Hue saturation value)颜色模型是面向用户的。HSⅤ模型的
三维表示从RGB立方体演化而来。设想从RGB沿立方体对角线的白色顶点向黑色顶点观察,就可以看到
立方体的六边形外形。六边形边界表示色彩,水平轴表示纯度,明度沿垂直轴测量。
色调H
绿120
黄
白
红
蓝240
0.0黑
hsla
获取或设置 Color对象表示的HSLA值
hsla-> tuple
Color对象表示的HSLA值。HSLA每个分量的范围是H=[0360],S=[0,1],L=[0,1],A=[0,1]。
注意:由于RGB值应设为0~255,而HSL值为0~1和0~360,因此无法绝对准确地返回所有RGB
值对应的HSL值,会有少许偏差
小甲鱼温馨提示:HSL色彩模型是工业界的一种颜色标准,是通过对色相(H)、饱和度(S)、明度
(L)三个颜色通道的变化以及它们相互之间的叠加来得到各式各样的颜色的,HSL即是代表色相,饱和
度,明度三个通道的颜色,这个标准几乎包括了人类视力所能感知的所有颜色,是目前运用最广的颜色系
统之一
1i2i3
获取或设置 Color对象表示的I23值
Color对象表示的I23值。2I3每个分量的范围是11=[0,1],I2=[-0.5,0.5],B3=[-0.5,05]。
注意:由于RGB值应设为0~255,而I12I3值为0~1和-0.5~05,因此无法绝对准确地返回所有
RGB值对应的I2I3值,会有少许偏差
小甲鱼温馨提示:I123是与RGB类似的颜色空间,转化公式为:n=(R G B/3,I2=(G-B)/
2,I3=(2G-R-B)/4
normalize
返回 Color对象的标准化RGBA值
normalize(-> tuple
返回 Color对象的标准化RGBA值。每个分量的值是浮点数表示
小甲鱼温馨提示:但这里每个分量的值不是整数范围0~255,而是转化为浮点数范围0~1。
correct_gamma
应用一定的伽马值调整 Color对象。
correct gamma(gamma)-> Color
应用一定的伽马值调整 Color对象,并返回调整后的RGBA值。
set_length
设置 Color对象的长度(成员数量)。
set_length(len)->None
默认值是4,它可以被设置为1,2,3或4。这对于解压为r,g,b而不是r,g,b,a很有用。如果你
希望得到一个Co|or对象的长度,你可以使用len(colo)获得。
小甲鱼温馨提示: color: set_length(2)它只是修改了en0,而不是真的把其中两个成员扔掉
display| Pygame中文文档
pygame. display
Pygame中用于控制窗口和屏幕显示的模块。
小甲鱼注:为了适应语境, display在该文档中有时翻译为“显示”,有时翻译为“显示界面”。
函数
pygame.display inite0一初始化 display模块
pygame. display. quit一结束 display模块
pygame. display. get_ inito一如果 display模块已经初始化,返回True
pygame. display set_mode(一初始化一个准备显示的窗口或屏幕
pygame. display. get_surface0一获取当前显示的 Surface对象
pygame. display. flip一更新整个待显示的 Surface对象到屏幕上
pygame. display update0一更新部分软件界面显示
pygame. display. get_driver0一获取 Pygame显示后端的名字
pygame. display Info0一创建有关显示界面的信息对象
pygame. display.getwm_info0一获取关于当前窗口系统的信息
pygame. display list_modes0—获取全屏模式下可使用的分辨率
· pygame. display mode_ok0一为显示模式选择最合适的颜色深度
pygame. display.gl_get_attribute0)一获取当前显示界面 OpenGL的属性值
pygame.display. glset_attribute0一设置当前显示模式的 OpenGL属性值
pygame. display. get_active一当前显示界面显示在屏幕上时返回Tre
pygame. display iconify)一最小化显示的 Surface对象
· pygame. display toggle_fullscreen0一切换全屏模式和窗口模式
pygame. display set_gamma0一修改硬件显示的gama坡道
pygame. display set_gamma_ramp0一自定义修改硬件显示的gama坡道
pygame. display set_iconO一修改显示窗口的图标
pygame.displayset_caption()- Set the current window caption
pygame.display.get_caption(--Get the current window caption
pygame. display set_palette(- Set the display color palette for indexed displays
这个模块提供控制 Pygame显示界面( display)的各种函数。 Pygame的 Surface对象即可显示为一个窗口,也可以
全屏模式显示。当你创建并显示一个常规的 Surface对刘象后,在该对象上的改变并不会立刻反映到可见屏幕上,你必须
选择一个翻转函数来显示改动后的画面。
显示的原点是(x=0,y=0)的位置,及屏幕的左上角,坐标轴向右下角增长
Pygame的 display事实上可以有几种初始化的方式。默认情况下, display作为一个软件驱动的帧缓冲区。除此之
外,你可以使用硬件加速和 OpenGL支持的特殊模块。这些是通过给 pygame. display set_mode0传入fags参数来
控制的
Pygame在任何时间内都只允许有一个显示界面。使用 pygame. display set_mode0创建的新显示界面会自动替换掉
旧的。如果需要精确控制像素格式或显示分辨率,使用 pygame. display mode_kO
pygame. display list_modes((),和 pygame. display Info(来查询显示界面相关的信息
旦 Surface对彖的显示界面被创建岀来,这个模块的函数就只影响当前的显示界面。如果该模块未初始化, Surface
对象也会变为“非法”。如果新的显示模式被设置,当前的 Surface对象将会自动切换到新的显示界面。
一个新的显示模式被设置,会在 Pygame的事件队列中放入几个相关事件。当用于希望关闭程序时, pygame. QUIT
事件会被发送;当显示界面获得和失去焦点时,窗口会得到 pygame. ACTIVEEVENT事件;如果显示界面设置了
pygame. RESIZABLE标志,那么当用户调整窗口尺寸时, pygameⅦ DEORESIZE事件会被发送;硬件显示指当接收到
pygameⅥ DEOEXPOSE事件时,将部分需要被重绘的窗口直接绘制到屏幕上。
一些显示环境拥有自动拉伸所有窗口的选项。当该选项被启动时,自动拉伸会扭曲 Pygame窗口的外观。在 Pygame
的例子目录中,有一个演示代码( prevent_display_stretching py)展示如何在微软系统( Vista以上系统)中关闭
Pygame显示的自动拉伸属性。
函数详解
pygame. display initO
初始化 display模块。
init(-> None
初始化ρ game的 display模块。在初始化之前, display模块无法做任何事情。但当你调用更高级别的
pygame. Init0,变会自动调用 pygame. displayinit(0进行初始化
初始化后, Pygame将自动从几个内部的显示后端中选择一个。显示模式由平台和当前用户权限决定。在 display模块
被初始化之前,可以通过环境变量SDLⅥ DEODRⅣVER设置哪一个显示后端将被使用。具有多种显示后端的系统如
下
Windows, win dib, directx
Unix: xll, dga, fbcon, directfb, ggi, vgl, svgalib, aalib
在一些平台上,可以将 Pygame的 display嵌入到已经存在的窗口中。如果这么做,环境变量 SDL WINDOWID必须
被设置为一个包含窗口D或句柄的字符串。当 Pygame的 display被初始化的时候,将裣测环境变量。注意,在一个
运行的窗口嵌入 display会产生许多奇怪的副作用。
多次调用该函数并没有任何问题,但也不会有什么效果。
pygame. display. quito
结束 display模块。
quito->None
这个函数会关闭整个 display模块。这将意味着任何一个活跃的显示界面都将被关闭。当主程序退出时,该函数也会被
自动调用
多次调用该函数并没有任何问题,但也不会有什么效果。
pygame. display. get_initO
如果 display模块已经初始化,返回True
get_init(-> bool
如果 display模块已经初始化,返回True
pygame. display set modeo
初始化一个准备显示的窗口或屏幕。
set mode(resolution=(0,0), flags=0, depth=0)-> Surface
这个函数将创建一个 Surface对象的显示界面。传入的参数用于指定显示类型。最终创建出来的显示界面将是最大可能
地匹配当前操作系统。
resolution参数是一个二元组,表示宽和高。和ags参数是咐件选项的集合。 depth参数表示使用的颜色深度。
返回的 Surface对象可以像常规的 Surface对象那样去绘制,但发生的改变最终会显示到屏幕上
如果没有传入 resolution参数,或者使用默认设置(00),且 Pygame使用SDL1,210以上版本,那么创建出来的
Surface对象将与当前屏幕用户一样的分辨率。如果只有宽或高其中一项被设置为0,那么 Surface对象将使用屏幕分
辨率的宽或高代替它。如果SDL版本低于1.2.10,那么将抛出异常。
通常来说,最好的做法是不要传递 depth参数。因为默认 Pygame会根据当前操作系统选择最好和最快的颜色深度。
如果你的游戏确实需要一个特殊的颜色格式,那么你可以通过控制 depth参数来实现。 Pygame将为模拟一个非现成
的颜色深度而耗费更多的时间。
当使用全屏显示模式的时候,有时候无法完全匹配到需要的分辨率。在这种情况下, Pygame将自动选择最匹配的分辨
率使用,而返回的 Surface对象将保持与需求的分辨率一致
flags参数指定你想要的显示类型。提供几个选择给你,你可以通过位操作同时使用多个类型(管道操作符"")。如果
你传入0或没有传入 flags参数,默认会使用软件驱动窗口。这儿是 flags参数提供的几个可选项
选项
含义
pygame. FULLSCREEN创建一个全屏显示
pygame. DOUBLEBUF1双缓冲模式
2.推荐和 HWSURFACE或 OPENGL一起使用
pygame. HWSURFACE硬件加速,只有在 FULLSCREEN下可以使用
pygame. OPENGL
创建一个 OPENGL渲染的显示
pygame. RESIZABLE
创建一个可调整尺寸的窗囗
pygame. NOFRAME
创建一个没有边框和控制按钮的窗口
举个栗子