Table Of Contents
Controlling the environment(翻訳済み)¶
環境変数の多くはKivyの初期化と動作を制御するために利用可能です。
たとえば、テキストレンダリングをPILのみに制限するには:
$ KIVY_TEXT=pil python main.py
kivyをインポートする前に環境変数を設定する必要があります:
import os
os.environ['KIVY_TEXT'] = 'pil'
import kivy
Path control¶
バージョン 1.0.7 で追加.
設定ファイル、モジュール、およびKivyのデータが保存されているデフォルトディレクトリを制御できます。
- KIVY_DATA_DIR
Kivyのデータが格納されている場所です。デフォルトは <kivy path>/data です。
- KIVY_MODULES_DIR
Kivyのmoduleが格納されている場所です。デフォルトは <kivy path>/modules です。
- KIVY_HOME
Kivyホームの場所。このディレクトリは、ローカル設定のために使用されるので書き込み可能な場所になければなりません。
- デフォルトは以下の通りです：
デスクトップ: <user home>/.kivy
- Android: <android app path>/.kivy
- iOS: <user home>/Documents/.kivy
バージョン 1.9.0 で追加.
- KIVY_SDL2_PATH
設定した場合、システム全体でインストールの代わりにKivyをコンパイルした場合に、このパスからSDL2のライブラリやヘッダが使用されています。 kivyアプリの実行中に同じライブラリを使用するには、パスを環境変数「PATH」の先頭に追加する必要があります。
バージョン 1.9.0 で追加.
警告
このパスはKivyのコンパイルに必要になります。プログラムの実行では必要ではないです。
Configuration¶
- KIVY_USE_DEFAULTCONFIG
この名前を環境で発見した場合、Kivyは、ユーザーの設定ファイルを読みません。
- KIVY_NO_CONFIG
設定すると、設定ファイルが読み込みと書き込みが行われません。これはユーザー設定ディレクトリに適用されます。
- KIVY_NO_FILELOG
設定すると、ログが書き込まれません
- KIVY_NO_CONSOLELOG
設定すると、コンソールにログが出力されません
- KIVY_NO_ARGS
設定した場合は、コマンドラインで渡された引数が解析され、Kivyによって使用されることはありません。安全にスクリプトまたは必要とせず、独自の引数を使ってアプリを作ることができます - 区切り文字：
import os os.environ["KIVY_NO_ARGS"] = "1" import kivy
バージョン 1.9.0 で追加.
Restrict core to specific implementation¶
使用しているプラットフォームで kivy.core の利用可能で最善の実装を選択してみてください。テストまたはカスタムインストールでは、特定の実装にセレクタを制限する場合があります。
- KIVY_WINDOW
ウィンドウ作成の実装に使用します
値: sdl2, pygame, x11, egl_rpi
- KIVY_TEXT
テキストレンダリングの実装に使用します
値: sdl2, pil, pygame, sdlttf
- KIVY_VIDEO
ビデオのレンダリングの実装に使用します
値: gstplayer, ffpyplayer, ffmpeg, 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
Metrics¶
- KIVY_DPI
設定すると
Metrics.dpiの値に使用されますバージョン 1.4.0 で追加.
- KIVY_METRICS_DENSITY
設定すると :attr:`Metrics.density`の値に使用されます。
バージョン 1.5.0 で追加.
KIVY_METRICS_FONTSCALE
設定すると、
Metrics.fontscaleの値にしようされますバージョン 1.5.0 で追加.
Graphics¶
- KIVY_GL_BACKEND
バックエンドでOpenGLを使用します。
cglを見てください。- KIVY_GL_DEBUG
OpenGL を呼び出すかどうか。
cglを読んでください。- KIVY_GRAPHICS
OpenGL ES2を使用するかどうかです。
cglを見てください。- KIVY_GLES_LIMITS
GLES2制限が適用されるかどうか（デフォルト、または1に設定されている場合）。 falseに設定すると、KivyはGLES2互換性がなくなります。
trueに設定する場合に生じる潜在的な非互換性の問題のリストを以下に示します。
| Mesh indices | 設定するとメッシュのインデックスは65535に制限されます |
Texture blit(テクスチャのビット) |
テクスチャにブリットすると、データフォーマット（色やバッファ）は、テクスチャの作成時に使用されるものと同じ形式でなければなりません。Android上で、デバイスのほとんどは実行に失敗しながら、デスクトップ上に、異なる色の変換が正しく、ドライバによって処理されます。参考：https://github.com/kivy/kivy/issues/1600 |
バージョン 1.8.1 で追加.
- KIVY_BCM_DISPMANX_ID
使用するデフォルトのRaspberry Pi の表示を変更します。使用可能な値のリストは、vc_dispmanx_types.h でアクセス可能です。デフォルト値は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