Skip to content

Windows Empty Paint 2026 11 17

odashi edited this page Nov 16, 2026 · 1 revision

Windowsの空矩形更新による画面停止(2026-11-17)

GUI・操作のログ · 開発資料

対象と環境

  • 基点: 315879a5839e4339aef9110f9a58d14b5056090d。
  • 修正: 9aa7f324ea43280f5d10f76d77fbd34958e2c102。
  • 統合先: PR #111、main向け。記録時点では未マージ。
  • 障害報告時の版: Integral v0.1.0。
  • 実機: Windows 11、Cubase 16、表示倍率150%、NVIDIA RTX 2000 Ada。
  • 関連する描画基盤: baseview 0.4.2。

症状

編集画面をサブウィンドウで開くとIntegralの表示が更新されず、操作結果は別のアプリケーションへ切り替えて戻した瞬間に反映された。編集画面を開いたままホストへフォーカスを戻すと、ホスト全体の画面更新も停止した。別アプリケーションへの切替で一時的に操作できる状態へ戻り、編集画面を閉じればホストは正常に動作した。

診断ログの観測

診断用ビルドで、編集画面の子ウィンドウに届くメッセージと、処理後に残る更新領域を計数した。次の値は同一セッション内の累積値である。

経過時間 WM_PAINT 描画完了 再描画タイマー Editorタイマー 更新あり 更新矩形
1.024秒 199,824 1 0 0 あり (0, 0, 0, 0)
113.085秒 19,928,912 4 3 3 あり (0, 0, 0, 0)
114.087秒 20,004,346 4 17 13 なし (0, 0, 0, 0)

GetUpdateRectが非ゼロを返しているのに取得矩形は空で、WM_PAINT処理後も更新要求が残っていた。更新要求が消えた後はWM_PAINTの増加が止まり、タイマーの配送が再開した。停止中もメッセージ処理そのものは継続していた。

原因の判定

baseviewのWindows実装では、更新矩形の照会で「更新なし」と「空矩形」をともに描画対象なしとして返す。WM_PAINTハンドラーは描画対象がある場合だけ描画とValidateRectを実行するため、「更新あり・空矩形」では要求を完了させずに処理を終える。

Windowsは更新領域が残っている間、WM_PAINTを繰り返し生成する。この完了処理の欠落と、実機で観測した大量の描画通知・タイマー停止が一致する。修正後の実機確認もこの説明を支持する。一方、非ゼロの戻り値と空矩形の組合せを最初に発生させる条件までは特定していない。表示倍率やGPUを原因と断定する根拠はない。

初期の切り分けではWGLの垂直同期を明示的に無効化したが、実機の症状は改善しなかった。この変更は最終実装には採用していない。

最終実装

Integral自身の子ウィンドウにsubclassを登録し、既存の処理をDefSubclassProcで実行した後、WM_PAINTで「更新あり・空矩形」が残っている場合だけBeginPaintとEndPaintで要求を完了させる。描画中に追加された非空の更新領域は消さず、次回の描画へ残す。

subclassの識別子にはEditorが所有するStateの安定したアドレスを使う。コールバックはこのアドレスを参照せず、同じUIスレッドで登録・解除する。Editorの解放時とWM_NCDESTROY時に解除する。追加したWin32構造体PAINTSTRUCTは64bitで72バイト、rcPaintのオフセットは12バイトで、Rust側とSDKヘッダ側の双方で検査する。

本体は2ファイル・132行追加。回帰テストを含めると4ファイル・172行追加・2行削除。既存のbaseviewを使い、追加のRustクレートは導入しない。

検証条件と結果

Windows x86_64 MSVC向けの最適化ビルドをLinuxで作成し、Wine上でSDKヘッダを使うABIスモークテストとWindowsの描画回帰テストを実行した。

  • ABIスモークテスト: 100インスタンス、float32/float64、ノート処理、波形オートメーション、位相継続、状態保存・復元、無音、ライフサイクルを通過。
  • 描画回帰テスト: プラグインのIAT内のGetUpdateRectだけに「非ゼロの戻り値・空矩形」を注入。実際のOS更新領域が消え、WM_PAINTがキューに残らないことを確認。
  • ValidateRect直後に別の非空領域を無効化し、その領域が次の描画まで保持されることを確認。
  • 400回の再描画、4回の開閉、4回のタイマー作成失敗で、ホストのOpenGLコンテキストとDCを保持。
  • 修正前の診断用ビルドでは、同じ空矩形注入に対して更新領域が残るアサーションで失敗。最終実装では成功。
  • cargo fmt --check、git diff --checkに成功。

Wine上の実行は、tests/abi-smoke.cppの一時コピーでGUI呼び出しをcheckGlContext(controller)へ限定し、リポジトリのgui-smoke.hとgui-reentry.hをそのまま使用した。Windows GUIの全画面キャプチャ試験とは区別する。通常のGUI検証入口はpython3 scripts/check-abi.py --gui。

最終実装を含むIntegral-windows-x86_64-paint-fix-3.zipは上記のWindows 11 / Cubase 16環境で正常動作を確認した。配布物はコミット前に作成したため、埋め込み情報は基点コミットとdirty=trueを示すが、修正ソースは上記の修正コミットと一致する。

  • ZIPサイズ: 27,687,516バイト。
  • SHA-256: 94f8a4b109e81e4aa0f5a7b5899b1770567c967d1feb0e2ee9efe37aafbfceef。

公式資料

Clone this wiki locally