编程向导4.2 控制环境
许多环境变量可以用来控制Kivy的初始化和行为。
例如限制文本渲染使用PIL实现:
$ KIVY_TEXT = pil python main.py
环境变量需要在导入Kiry之前设置:
import os
os.environ['KIVY_TEXT'] = 'pil'
import kivy
一、路径控制
V1.0.7版本加入
你可以控制诸如配置文件、模块、扩展和Kivy数据的默认路径
KIVY_DATA_DIR:Kivy数据默认路径
KIVY_EXTS_DIR:Kivy扩展默认路径
KIVY_MODULES_DIR:Kivy模块默认路径
KIVY_HOME:Kivy主默认路径,该路径被用来作为本地配置,该路径必须是可写入的,默认为:
桌面系统:
/.kivy 安卓系统:
.kivy IOS 系统:
/Documents/.kivy
V1.9.0版本加入
KIVY_SDL2_PATH:如果设置,在编译Kivy时将从该路径寻找SDL2库和头文件,代替系统方面的路径。为使用相同的库,在编译Kivy应用程序时,路径必须在PATH环境变量启动前添加。
在编译Kivy时必须使用,在执行时没有必要。
二、配置
KIVY_USER_DEFAULTCONFIG:如果该配置被设置,则Kivy不会读取用户的配置文件
KIVY_NO_CONFIG:如果设置,则没有配置文件及用户配置路径进行读写
KIVY_NO_FILELOG:如果设置,则不会记录日志到一个文件
KIVY_NO_CONSOLELOG:如果设置,则日志不会输出到控制台
V1.9.0版本加入
KIVY_NO_ARGS:如果设置,则在命令行传递的参数将不被解析,例如,你可以安全的使用你自己的不需要-分隔符的参数写一个脚本或应用程序:
import os
os.environ['KIVY_NO_ARGS'] = "l"
import kivy
三、限制核心到特定实现
kivy.core在你的系统平台中尝试选择最佳实现。为了测试或定制安装,你也许想限制选择一个特定的实现。
KIVY_WINDOW:创建一个窗口的实现,可选值为sdl2,pygame,x11, egl_rpi
KIVY_TEXT:渲染文本的实现,可选值为sdl2, pil, pygame, sdlttf
KIVY_VIDEO:渲染视频的实现,可选值为pygst, gstplayer, pyglet, ffpyplayer, null
KIVY_AUDIO:播放音频的实现,可选值为sdl2, gstplayer, pygst, ffpyplayer, pygame
KIVY_IMAGE:读取图像的实现,可选值为sdl2, pil, pygame, imageio, tex, dds, gif
KIVY_CAMERA:读取摄像头的实现,可选值为videocapture, avfoundation, pygst, opencv
KIVY_SPELLING:拼写的实现,可选值为enchant, osxappkit
KIVY_CLIPBOARD:剪切板管理的实现,可选值为sdl2, pygame, dummy, android
四、度量
V1.4.0版本加入
KIVY_DPI:如果设置,则单位使用Metrics.dpi
V1.5.0版本加入
KIVY_METRICS_DENSITY:如果设置,则单位使用Metrics.density
V1.5.0加入
KIVY_METRICS_FONTSCALE:如果设置,则单位使用Metrics.fontscale
五、图像
KIVY_GLES_LIMITS:是否GLES2限制被执行。如果设置为false,Kivy将不会真正的GLES2兼容。下面是一个当被设置为True时的潜在的不兼容列表
- Mesh indices(网格索引):如果为True,则一个网格里面的索引被限制到65535.
- Texture blit(材质位块传输):当传输材质时,颜色和缓冲的数据格式必须同材质被创建时的格式相同。在桌面系统上,不同颜色间的转换被驱动程序处理。在安卓系统上,大多数的设备会造成失败。
V1.8.1版本加入
KIVY_BCM_DISPMANX_ID:改变默认的用来显示Raspberry Pi,默认值为0,可选值如下:
0: DISPMANX_ID_MAIN_LCD
1: DISPMANX_ID_AUX_LCD
2: DISPMANX_ID_HDMI
3: DISPMANX_ID_SDTV
4: DISPMANX_ID_FORCE_LCD
5: DISPMANX_ID_FORCE_TV
6: DISPMANX_ID_FORCE_OTHER