BlinkGTK 環境変数リファレンス(公開サポート正リスト)

作成者: BlinkGTK Project
最終更新: 2026-08-01(Chromium 151 baseline、#121 API リファレンス第 9 章の正本)

BlinkGTK が解釈する環境変数を 3 区分で定義します。embedder が依存してよいのは第 1 区分(公開サポート)のみです。


1. 公開サポート環境変数

変数 既定 説明
BLINKGTK_GPU_MODE software / egl / swiftshader software 描画モードの選択。software が推奨・既定。egl は GPU 経路(実験的)、swiftshader は software 相当
BLINKGTK_HEADLESS 1 未設定 headless 動作(実ディスプレイなし・CI 向け)。--headless 付与を制御
BLINKGTK_NO_SANDBOX 1 未設定 Chromium sandbox を無効化。コンテナ等 sandbox 非対応環境向け
BLINKGTK_EXTRA_SCHEMES カンマ区切り scheme 名 未設定 追加のカスタム URL scheme を standard scheme として登録(例: ebook)。custom scheme loader と併用
BLINKGTK_SCROLL_SPEED 数値(倍率) 1.0 ホイールスクロール速度の倍率
BLINKGTK_DMABUF_PATH パス 未設定 egl モードの dmabuf デバイスパス指定
BLINKGTK_FRAME_PNG_DIR ディレクトリパス 未設定 フレーム PNG の保存先(検証用途。設定時のみ保存)
BLINKGTK_FRAME_PNG_MAX 整数 実装既定 保存するフレーム PNG の最大枚数

2. エスケープハッチ(既定のまま推奨)

変数 効果(=0 等を設定した場合) 関連
BLINKGTK_PUMP_LEGACY=1 fd-watcher pump を無効化し旧 g_idle pump へ(idle CPU が増加します) #115
BLINKGTK_PUMP_RESCUE=0 pump 起床保証(100ms heartbeat)を無効化 #120
BLINKGTK_CAPTURE_DAMAGE_GATE=0 capture damage gate(idle 時のフレームコピー抑制)を無効化 #115
BLINKGTK_FORCE_SINGLE_THREADED=1 renderer を単一スレッド compositing に戻す(描画停止リスクあり)
BLINKGTK_120_INVAL_FALLBACK=0 invalidation フォールバック(白紙固定の修正)を無効化 #120 fixG
BLINKGTK_120_ACT_REDRAW=0 activation 再 damage(白紙固定の修正)を無効化 #120 fixF
BLINKGTK_120_CKB_REDRAW=0 checkerboard 再 damage(安全網)を無効化 #120 fixE
BLINKGTK_EGL_FRACTIONAL=1 egl モードの分数スケーリングを opt-in(実験的) #117
BLINKGTK_EGL_RESIZE_BRIDGE=0 egl resize ブリッジを無効化

3. 内部診断(サポート対象外)

以下は開発・調査用の内部変数です。一覧のみ掲載し、詳細仕様は公開しません。無保証・予告なく削除されます。

BLINKGTK_120_CC_DIAG / BLINKGTK_120_DISP_DIAG / BLINKGTK_120_CLIP_DIAG / BLINKGTK_120_DIAG / BLINKGTK_120_PAINT_KICK / BLINKGTK_120_FI_ROW1(fault injection・検証専用)/ BLINKGTK_VBREAK_P0 / BLINKGTK_TOC_P0 / BLINKGTK_LAYOUT_DEBUG / BLINKGTK_RUBY_RESERVE_EM / BLINKGTK_EGL_DIAG / BLINKGTK_EGL_MANUAL_VIEWPORT / BLINKGTK_EGL_BRIDGE_SETTLE_MS / BLINKGTK_EGL_GTK4_NATIVE / BLINKGTK_TEST_FORCE_FRACTIONAL / BLINKGTK_TEST_GPU_COPYFROMSURFACE / BLINKGTK_USE_K2C / BLINKGTK_USE_MOJO_IPC / BLINKGTK_USE_EGL_WIDGET / BLINKGTK_USE_NEW_OUTPUT_DEVICE / BLINKGTK_120_TYPEB_FIX / BLINKGTK_REENABLE_ENDPAINT_HOOK / BLINKGTK_HARNESS_AUDIT / BLINKGTK_AURA_SHOW_IMMEDIATE

4. 廃止

変数 状態
BLINKGTK_ENABLE_THREADED_COMPOSITING 廃止(threaded compositing は既定 ON 化済み。旧名は無効)

関連