四、编程向导(4.2控制环境)

编程向导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 path>/data

KIVY_EXTS_DIR:Kivy扩展默认路径<kivy path>/extensions

KIVY_MODULES_DIR:Kivy模块默认路径<kivy path>/modules

KIVY_HOME:Kivy主默认路径,该路径被用来作为本地配置,该路径必须是可写入的,默认为:

  • 桌面系统:<user home\>/.kivy
    
  • 安卓系统:<android app path\>.kivy
    
  • IOS 系统:<user home\>/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

下节预告:编程向导4.3配置Kivy

    原文作者:python
    原文地址: https://www.jianshu.com/p/3cd6d25aa25d
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞