[TOC] # **pygame.cursors** Pygame 中使用光標資源的模塊。 ## **函數** * pygame.cursors.compile() —— 由純字符串創建二進制光標數據 * pygame.cursors.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.cursors.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 ## **函數詳解** ### **pygame.cursors.compile()** 由純字符串創建二進制光標數據。 compile(strings, black=’X’, white=’.’, xor=’o’) -> data, mask 一串連續的字符串可以被用于創建對應系統光標的二進制光標數據。返回值要和 pygame.mouse.set\_cursor() 所需要的參數格式相同。 如果你正在創建自己的光標字符串，你可使用任何值來代表白色和黑色像素。一些系統允許你根據系統顏色自己設置一種特殊的切換色，也被稱為 xor 色。如果系統不支持 xor 光標，則光標顏色將會變為純黑色。 字符串的長度必須全部相等，而且可以被 8 整除。一個光標字符串設定示例，如下所示： ~~~ 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 方法的 filenames 或者 filelike 對象。 返回值 cursor\_args 可以被直接傳遞給 pygame.mouse.set\_cursor() 方法。