运行时选项

options = {'audio': ('xaudio2', 'directsound', 'openal', 'pulse', 'silent'), 'com_mta': False, 'debug_font': False, 'debug_gl': True, 'debug_gl_shaders': False, 'debug_gl_trace': False, 'debug_gl_trace_args': False, 'debug_graphics_batch': False, 'debug_input': False, 'debug_lib': False, 'debug_media': False, 'debug_texture': False, 'debug_trace': False, 'debug_trace_args': False, 'debug_trace_depth': 1, 'debug_trace_flush': True, 'debug_win32': False, 'debug_x11': False, 'dw_legacy_naming': False, 'headless': False, 'headless_device': 0, 'osx_alt_loop': False, 'search_local_libs': True, 'shadow_window': True, 'vsync': None, 'win32_disable_shaping': False, 'win32_disable_xinput': False, 'win32_gdi_font': False, 'xlib_fullscreen_override_redirect': False, 'xsync': True}

侏儒期权的全球词典。

要更改选项的缺省设置,必须导入 pyglet 在任何子套餐之前。例如::

import pyglet
pyglet.options['debug_gl'] = False

可以从操作系统环境中覆盖默认选项。每个选项键的相应环境变量前面都有 PYGLET_ 。例如,在Bash中,您可以设置 debug_gl 选项包括::

PYGLET_DEBUG_GL=True; export PYGLET_DEBUG_GL

对于需要值的元组的选项,请用逗号分隔每个值。

非开发选项包括:

音频

A Sequence 有效音频模块名称的。它们将从头到尾进行尝试,直到加载驱动程序或没有剩余条目。看见 选择音频驱动程序 以获取更多信息。

有效的驱动程序名称为:

  • 'xaudio2' ,Windows Xaudio2音频模块(仅限Windows)

  • 'directsound' ,Windows DirectSound音频模块(仅限Windows)

  • 'pulse' vt.的. PulseAudio 模块

    (仅限Linux,否则几乎无处不在。功能有限;使用 'openal' 了解更多信息。)

  • 'openal' vt.的. OpenAL 音频模块(可能需要在Windows和Linux上安装库)

  • 'silent' ,无音频

debug_lib

如果为True,则打印加载的每个动态库的路径。

debug_gl

如果为True,则使用以下命令检查对OpenGL函数的所有调用是否有错误 glGetError 。这将严重影响性能,但会在故障点提供有用的异常。默认情况下,在以下情况下启用此选项 __debug__ 是(即,如果运行时没有使用-O选项)。默认情况下,当pyglet在py2exe或py2app库归档中被“冻结”时,它是禁用的。

shadow_window

默认情况下,在导入pyglet.gl时,pyglet会创建一个带有GL上下文的隐藏窗口。这允许在创建应用程序窗口之前加载资源,并允许在窗口之间共享GL对象,即使它们已经关闭。通过将此选项设置为FALSE,可以禁用阴影窗口的创建。

某些OpenGL驱动程序实现可能不支持共享OpenGL上下文,并且可能需要禁用阴影窗口(并且必须在创建使用它们的窗口之后加载所有资源)。仅建议高级开发人员使用。

在 1.1 版本加入.

垂直同步

如果设置,则 pyglet.window.Window.vsync 属性被忽略,并且此选项将覆盖它(以强制打开或关闭vsync)。如果未设置或设置为None,则 pyglet.window.Window.vsync 属性的行为与文档中的行为相同。

交叉同步

如果设置(默认设置),pyglet将尝试将双缓冲窗口的绘制与X11窗口管理器的边界更新同步。这改善了窗口在调整大小操作期间的外观。此选项仅影响支持Xsync扩展的X11服务器上的双缓冲窗口,该服务器具有实现_NET_WM_SYNC_REQUEST协议的窗口管理器。

在 1.1 版本加入.

search_local_libs

如果为False,则pyglet不会尝试在脚本目录中搜索库及其 lib 子目录。这对于加载本地库而不是系统安装的版本很有用。默认情况下,此选项设置为True。

在 1.2 版本加入.

环境设置

中的选项 pyglet.options 字典可以通过操作系统的环境变量设置缺省值。下表显示了每个选项使用的环境变量:

环境变量

pyglet.options 钥匙

类型

缺省值

PYGLET_AUDIO

audio

字符串列表

directsound,openal,alsa,silent

PYGLET_DEBUG_GL

debug_gl

布尔型

1 [1]