Python：Pygame相关

原文来自FishC。稍作整理，有点杂乱。

BufferProxy

是Surface对象通过数组协议导出的一个缓冲对象；

pygame.BufferProxy.parent	返回被打包输出的对象
pygame.BufferProxy.length	输出缓冲区的大小，以字节为单位
pygame.BufferProxy.raw	一个导出缓冲区的拷贝，存储在单一得字节块中
pygame.BufferProxy.write()	write raw bytes to object buffer

BufferProxy是pygame支持的一种类型，用于作为Surface.get_buffer()和Surface.get_view()方法的返回值。对于所有版本的python，BufferProxy对象输出一个C结构和python级别的数组接口代表其父对象的缓冲区。

camera

使用摄像头的模块（以前仅支持linux系统和camera_video4linux2驱动，不知现在是否有更新·）。

pygame.camera.colorspace() ---- 转换Surface对象的色彩空间

pygame.camera.list_cameras() ---- 返回一个可用摄像头列表

类 class pygame.camera.camera加载一个摄像头，包括以下方法：

pygame.camera.camera.start()	打开摄像头，初始化然后开始捕捉画面
pygame.camera.camera.stop()	结束摄像头工作，还原并关闭摄像头
pygame.camera.camera.get_controls()	获取当前用户设定的值
pygame.camera.camera.set_controls()	修改当前摄像头设置（如果摄像头支持的话）
pygame.camera.camera.get_size()	返回被记录的图像的尺寸
pygame.camera.camera.query_image()	确认一帧图像是否准备好
pygame.camera.camera.get_image()	捕获一张图像并转换为一个Surface对象
pygame.camera.camera.get_raw()	以字符串的形式返回一张未修改的图像

加载一个V4L2摄像头；此设备通常类似于"/dev/video"；默认宽度和高度为640x480；格式是输出所需的色彩空间，默认格式RGB，也支持YUV，HSV。

cdrom

cdrom=Compact Disc Read-Only Memory即只读光盘，是pygame中使用的音频模块；

常用函数：

pygame.cdrom.init() ---- 初始化cdrom模块

pygame.cdrom.quit() ---- 还原cdrom模块

pygame.cdrom.get_init() ---- 如果cdrom模块初始化完成，则返回True

pygame.cdrom.get_count() ---- 返回系统中cd驱动器的个数

类pygame.cdrom.cd用于管理计算机上的CD和DVD驱动器，也可以控制音频光盘的播放和回放；这个组件在做任何事之前必须进行初始化；创建的每一个CD对象都代表一个cdrom驱动器，而且在使用其绝大部分功能前需要一个个单独初始化；

pygame.cdrom.CD.init()	初始化一个cdrom驱动器用于使用
pygame.cdrom.CD.quit()	还原一个正在使用的cdrom驱动器
pygame.cdrom.CD.get_init()	如果这个CD设备初始化完成，返回true
pygame.cdrom.CD.play()	开始播放音频
pygame.cdrom.CD.stop()	停止播放音频
pygame.cdrom.CD.pause()	暂停播放音频
pygame.cdrom.CD.resume()	回复播放音频
pygame.cdrom.CD.eject()	弹出或打开cdrom驱动器
pygame.cdrom.CD.get_id()	返回cdrom驱动器的ID
pygame.cdrom.CD.get_name()	返回cdrom驱动器的系统名称
pygame.cdrom.CD.get_busy()	如果驱动器正在播放音频，返回true
pygame.cdrom.CD.get_paused()	如果驱动器被暂停，返回true
pygame.cdrom.CD.get_current()	返回当前音频的播放位置
pygame.cdrom.CD.get_empty()	如果驱动器内存在cdrom，返回false
pygame.cdrom.CD.get_numtracks()	返回cdrom上音轨数
pygame.cdrom.CD.get_track_audio()	如果cdrom音轨上有音频数据，返回true
pygame.cdrom.CD.get_all()	获取所有音轨的信息
pygame.cdrom.CD.get_track_start()	返回一条音轨的开始时间
pygame.cdrom.CD.get_track_length()	返回一条音轨的长度

可以为系统内的每一个cdrom创建一个CD对象；使用pygame.cdrom.get_count()去确定目前现存驱动器的个数；id参数是驱动器的一个整数，从0开始编号；

如果这个CD对象没有被初始化，我们只可以调用CD.get_id()方法以及CD.get_name()方法；

对一个驱动器创建多个CD对象是安全的行为，正常情况下这些对象会相互合作运行。

Color

用于描述颜色的对象；常用方法与属性：

pygame.Color.r	获取或设置Color对象的红色值
pygame.Color.g	获取或设置Color对象的绿色值
pygame.Color.b	获取或设置Color对象的蓝色值
pygame.Color.a	获取或设置Color对象的alpha值
pygame.Color.cmy	获取或设置Color对象的CMY值
pygame.Color.hsva	获取或设置Color对象的HSVA值
pygame.Color.hsla	获取或设置Color对象的HSLA值
pygame.Color.i1i2i3	获取或设置Color对象表示的I1I2I3值
pygame.Color.normalize()	返回Color对象表示的RGBA值
pygame.Color.correct_gamma()	应用一定的gamma值调整Color对象
pygame.Color.set_length()	设置Color对象的长度（成员数量）

pygame使用Color类表示RGBA颜色值，每个颜色值的取值范围0~255；可以通过基本的运算创建新的颜色值，支持转换为其它颜色空间，如HSV，HSL，可以调整单个颜色通道；当没有给出alpha的值时，默认是255（不透明）；

RGB值可以是一个颜色名，一个HTML颜色格式的字符串，一个16进制的字符串，或者一个整型像素值；HTML格式是“#rrggbbaa”，其中rr，gg，bb，aa都是2位的16进制；代表alpha的aa是可选的；16进制的字符串形式为“0xrrggbbaa”，当然，其中的aa也是可选的。

cursors

使用光标资源的模块；常用函数：

pygame.cursors.compile() ---- 由纯字符串创建的二进制光标数据

pygame.curcors.load_xbm() ---- 由一个xbm文件载入的光标数据

pygame提供对系统硬件光标的控制，并且只支持白色和黑色光标格式；可以通过pygame.mouse内的方法控制光标；

cursors模块包含载入和解码各种光标格式的方法；这些方法可以实现把光标存储成扩展文件，或者直接作为编码后的python字符串存储；

模块包括若干个标准光标；pygame.mouse.set_cursor()方法能接受若干数据，所有的参数以单个元祖的形式存储，如

pygame.mouse.set_cursor(*pygame.cursors.arrow)

模块也包含了一些格式化字符串的光标，在使用光标之前，需要把相应的字符串传递给pygame.cursors.compile()方法，如：

cursor=pygame.cursors.compile(pygame.cursors.textmarker_strings)
pygame.mouse.set_cursor(*cursor)

以下变量是可以被用作光标的位图：

*) pygame.curcors.arrow

*) pygame.cursors.diamond

*) pygame.cursors.broken_x

*) pygame.cursors.tri_left

*) pygame.cursors.tri_right

以下字符串可以通过pygame.cursors.compile()函数转换成光标位图：

*) pygame.cursors.thickarrow_strings

*) pygame.cursors.sizer_x_strings

*) pygame.cursors.sizer_y_strings

*) pygame.cursors.sizer_xy_strings