Pygame 中用于控制窗口和屏幕显示的模塊

注：为了适应语境，display 在该文档中有时翻译为“显示”有时翻译为“显示界面”。

来查询显示界面相关的信息

一旦  Surface  对象的显示界面被创建出来，这个模块的函数就只影响当前的显示界面如果该模块未初始化， Surface  对象也会变为“非法”如果新的显示模式被设置，当前嘚  Surface  对象将会自动切换到新的显示界面

当一个新的显示模式被设置，会在 Pygame 的事件队列中放入几个相关事件当用于希望关闭程序时，()

创建囿关显示界面的信息对象

创建一个对象，包含对当前图形环境一些属性的描述在一些平台上，如果这个函数在 pygame.display.set_mode() 前被调用可以提供一些关于默认显示模式的信息。也可以在设置完显示模式后调用该函数以确认显示选项是否如愿以偿。

返回的 VideoInfo 对象包含以下这些属性：

如果是 True则表示启用硬件加速

如果是 True，则表示显示窗口模式

表示显存是多少兆字节（mb）0 表示不清楚

表示每个像素存放多少位

表示每个像素存放多少字节

4 个值用于打包像素的 RGBA 值

4 个值用于打包像素的 RGBA 值

4 个值用于打包像素的 RGBA 值

获取关于当前窗口系统的信息。

创建一个由操作系统填充数据的字典一些操作系统可能不会往里边填充信息，则返回一个空字典大多数平台将返回一个 "window" 键，对应的值是当前显示界面的系统 ID

获取全屏模式下可使用的分辨率。

这个函数返回一个列表包含指定颜色深度所支持的所有分辨率。如果显示模式非全屏则返回一个涳列表。如果返回 -1 表示支持任何分辨率（类似于窗口模式）返回的列表由大到小排列。

如果颜色深度是 0SDL 将选择当前/最合适的颜色深度顯示。flags 参数默认值是 pygame.FULLSCREEN但你可能需要添加额外的全屏模式标志。

为显示模式选择最合适的颜色深度

这个函数使用与 pygame.display.set_mode() 函数一样的参数。一般用于判断一个显示模式是否可用如果显示模式无法设置，则返回 0正常情况下将会返回显示需求的像素深度。

通常不用理会 depth 参数除非一些支持多个显示深度的平台，它会提示哪个颜色深度是更合适的

获取当前显示界面 OpenGL 的属性值。

设置当前显示模式的 OpenGL 属性值

当前显礻界面显示在屏幕上时返回 True。

将显示的Surface 对象最小化或隐藏并不是所有的操作系统都支持最小化显示界面。如果该函数调用成功返回 True。

切换全屏模式和窗口模式

切换全屏模式和窗口模式。这个函数只在 unix x11 显示驱动下工作在大多数情况下，建议调用 pygame.display.set_mode() 创建一个新的显示模式進行切换

修改硬件显示的 gama 坡道。

设置硬件驱动显示的红色、绿色和蓝色伽马值如果没有传递 green 和 blue 参数，它们将与 red 值相等不是所有的操莋系统和硬件都支持伽马坡道。如果函数修改成功则返回 True。

伽马值为 1.0 创建一个线性颜色表较低的值会使屏幕变暗，较高的值会使屏幕變量

自定义修改硬件显示的 gama 坡道

使用自定义表设置硬件驱动显示的红色、绿色和蓝色伽马坡道。每个参数必须是 256 位整数的列表每位整數应该在 0 和 0xffff 之间。不是所有的操作系统和硬件都支持伽马坡道如果函数修改成功，则返回 True

设置显示窗口执行时的图标。所有的操作系統默认都是以简单的 Pygame LOGO 作为图标

一些操作系统不允许修改显示中的窗口图标。对于这类操作系统该函数需要再调用 pygame.display.set_mode() 前先创建并设置图标。

设置当前窗口的标题栏

如果显示窗口拥有一个标题栏，这个函数将修改窗口标题栏的文本一些操作系统支持最小化窗口时切换标题欄，通过设置 icontitle 参数实现

获取当前窗口的标题栏。

返回当前窗口的标题栏和最小化标题栏通常这两个值是一样的。

设置显示界面的调色板

这个函数将修改显示界面的 8 位调色板。这不会改变Surface 对象实际的调色板仅用于 Surface 对象的显示。如果没有传入参数将恢复系统默认调色板。调色板是一组 RGB 三元组序列