pyglet.canvas

显示和屏幕管理。

呈现是在一个 Canvas ，它在概念上可以是一个屏幕外缓冲区， pyglet.window.Window ，或整个屏幕。目前，画布只能用窗口创建(尽管窗口可以设置为全屏)。

窗口和画布必须属于 Display 。在Windows和Mac OS X上只有一个显示屏，可以通过以下方式获得 get_display() 。Linux支持多个显示器，对应于离散的X11显示器连接和屏幕。 get_display() 在Linux上返回默认显示和屏幕0 (localhost:0.0 )；如果需要特定屏幕或显示器，则 Display 可以直接实例化。

在显示器内连接了一个或多个屏幕。一个 Screen 通常对应于物理连接的显示器，但不会列出为复制另一个屏幕而设置的显示器或投影仪。使用 Display.get_screens() 以获取附加屏幕的列表；然后可以查询这些屏幕的大小和在桌面上的虚拟位置。

屏幕的大小由其当前模式决定，该模式可由应用程序更改；请参阅 Screen 。

在 1.2 版本加入.

get_display()

获取默认显示设备。

如果已经有一个 Display 连接，则将返回该显示。否则，默认设置为 Display 被创建并返回。如果多个显示连接处于活动状态，则返回任意连接。

在 1.2 版本加入.

返回类型:: Display

class Display(name=None, x_screen=None)

一种支持一个或多个屏幕的显示设备。

在 1.2 版本加入.

get_default_screen()

获取由用户的操作系统首选项指定的默认(主)屏幕。

返回类型:: Screen

get_screens()

获取可用的屏幕。

典型的多监视器工作站包括一个 Display 具有多个 Screen S。此方法返回一个屏幕列表，可以枚举这些屏幕以选择一个屏幕进行全屏显示。

为了创建OpenGL配置，默认屏幕就足够了。

返回类型:: 清单 Screen

get_windows()

获取当前连接到此显示器的窗口。

返回类型:: 顺序 Window

name = None

此显示的名称(如果适用)。

类型:: 应力

x_screen = None

此显示屏的X11屏幕编号(如果适用)。

类型:: 集成

class Screen(display, x, y, width, height)

支持全屏窗口的虚拟监视器。

屏幕通常映射到显示器、电视或投影仪等物理显示器上。为窗口选择屏幕没有任何效果，除非该窗口被设置为全屏显示，在这种情况下，该窗口将仅填充该特定的虚拟屏幕。

这个 width 和 height 屏幕的属性提供屏幕的当前分辨率。这个 x 和 y 属性提供屏幕左上角的全局位置。这对于确定屏幕是排列在彼此上方还是相邻很有用。

使用 get_screens() 或 get_default_screen() 若要获取此类的实例，请执行以下操作。

get_best_config(template=None)

获取最佳可用的GL配置。

任何必需的属性都可以在 template 。如果没有与模板匹配的配置， NoSuchConfigException 将会被唤醒。

弃用:

使用 pyglet.gl.Config.match() 。

参数:

templatepyglet.gl.Config: 填写了所需属性的配置。

返回类型:

Config

返回:

平台支持的配置，最能满足模板所描述的需求。

get_closest_mode(width, height)

获取与给定大小最匹配的屏幕模式。

如果没有支持的模式与请求的大小完全相同，则返回一个更大的模式；或者 None 如果没有足够大的模式。

参数:

width集成: 请求的屏幕宽度。
height集成: 请求的屏幕高度。

返回类型:

ScreenMode

在 1.2 版本加入.

get_matching_configs(template)

获取与规范匹配的配置列表。

中指定的任何属性 template 将在每个返回的配置中具有等于或更大的值。如果没有配置满足模板，则返回空列表。

弃用:

使用 pyglet.gl.Config.match() 。

参数:

templatepyglet.gl.Config: 填写了所需属性的配置。

返回类型:

清单 Config

返回:

匹配配置的列表。

get_mode()

获取此屏幕的当前显示模式。

返回类型:: ScreenMode

在 1.2 版本加入.

get_modes()

获取此屏幕支持的屏幕模式列表。

返回类型:: 清单 ScreenMode

在 1.2 版本加入.

restore_mode(): 将屏幕模式恢复为用户的默认模式。

set_mode(mode)

设置此屏幕的显示模式。

模式必须是以前由返回的模式 get_mode() 或 get_modes() 。

参数:

modeScreenMode: 切换到此屏幕的屏幕模式。

display: 显示此屏幕所属的。

height: 屏幕高度，以像素为单位。

width: 屏幕的宽度，以像素为单位。

x: 虚拟桌面上屏幕的左边缘。

y: 虚拟桌面上屏幕的顶部边缘。

class Canvas(display)

抽象绘图区域。

画布由pyglet在内部使用来表示绘图区域--无论是在窗口中还是在全屏中。

在 1.2 版本加入.

display: 显示此画布的创建日期。