pygame功能--pygame.cursors鼠标模块

pygame.cursors

用于游标资源的Pygame模块
pygame.cursors.compile
从简单字符串创建二进制游标数据
pygame.cursors.load_xbm
从XBM文件加载游标数据

Pygame提供了对系统硬件光标的控制。
Pygame只支持系统的黑白游标。
你可以使用pygame中的函数来控制光标。
Mousepygame模块用鼠标工作。
这个游标模块包含用于加载和解码各种游标格式的函数。
这允许您轻松地将游标存储在外部文件中或直接作为编码的python字符串。
该模块包括几个标准游标。
为鼠标光标函数设置图像的pygame.mouse.set_cursor()有几个参数。
所有这些参数都存储在一个元组中，可以像这样调用：

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

以下变量可以传递给pygame.mouse。set_cursor功能:

• pygame.cursors.arrow
  pygame.cursors.diamond
  pygame.cursors.broken_x
  pygame.cursors.tri_left
  pygame.cursors.tri_right

这个模块还包含一些格式化字符串的游标。在使用它们之前，需要将它们传递给pygame.cursor .compile()函数。示例调用看起来像这样:

>>> cursor = pygame.cursors.compile(pygame.cursors.textmarker_strings)
>>> pygame.mouse.set_cursor((8, 16), (0, 0), *cursor)

以下字符串可以被转换为游标位图：
pygame.cursors.compile() :

• pygame.cursors.thickarrow_strings
  pygame.cursors.sizer_x_strings
  pygame.cursors.sizer_y_strings
  pygame.cursors.sizer_xy_strings
  pygame.cursor.textmarker_strings

pygame.cursors.compile()¶
从简单字符串创建二进制游标数据
compile(strings, black=‘X’, white=’.’, xor=‘o’) -> data, mask
字符串序列可用于为系统游标创建二进制游标数据。
这将以两个元组的形式返回二进制数据。
它们可以分别作为pygame.mouse.set_cursor()的第三个和第四个参数传递，用于设置鼠标光标函数的图像。
如果您正在创建自己的游标字符串，则可以使用任何值来表示黑白像素。
有些系统允许你为系统颜色设置一个特殊的切换颜色，这也称为异或颜色。
如果系统不支持异或游标，则该颜色将简单地为黑色。
高度必须能被8整除。
字符串的宽度必须相等并能被8整除。
如果不满足这两个条件，将引发ValueError。
一个游标字符串示例如下所示

thickarrow_strings = (               #sized 24x24
  "XX                      ",
  "XXX                     ",
  "XXXX                    ",
  "XX.XX                   ",
  "XX..XX                  ",
  "XX...XX                 ",
  "XX....XX                ",
  "XX.....XX               ",
  "XX......XX              ",
  "XX.......XX             ",
  "XX........XX            ",
  "XX........XXX           ",
  "XX......XXXXX           ",
  "XX.XXX..XX              ",
  "XXXX XX..XX             ",
  "XX   XX..XX             ",
  "     XX..XX             ",
  "      XX..XX            ",
  "      XX..XX            ",
  "       XXXX             ",
  "       XX               ",
  "                        ",
  "                        ",
  "                        ")

pygame.cursors.load_xbm()
从XBM文件加载游标数据
load_xbm(cursorfile) -> cursor_args
load_xbm(cursorfile, maskfile) -> cursor_args
这将为XBM文件的一个简单子集加载游标。
XBM文件传统上用于在UNIX系统上存储游标，它们是用于表示简单图像的ASCII格式。
有时黑白颜色值会被分割成两个单独的XBM文件。
您可以传递第二个maskfile参数将这两个图像加载到单个游标中。
cursorfile和maskfile参数可以是文件名，也可以是带有readlines方法的类文件对象。
返回值cursor_args可以直接传递给pygame.mouse.set_cursor()函数。