「静的イメージ接続」は、単一の画像ファイルを画面として扱い、画像比較やOCRの検証・デバッグを行うためのモードです（ライブ操作はしません）。

基本

• クライアントにキーイベントを消費させる（推奨ON）

  ビューアがフォーカス中に押されたキーをOSへ送らず捨てる設定。誤ってPC上のアプリが反応するのを防ぎます。

  逆に、ビューアにフォーカスしていても手元のアプリへキー入力を通したい場合のみOFF。

• リフレッシュ間隔（ミリ秒）（既定 200ms）

  画像ファイルをどれくらいの頻度で読み直すか。

  大きな画像／ネットワーク越し → 500–1000ms に上げてI/O負荷を軽減。

  高頻度で差し替える（外部ツールが連続で保存） → 100–200ms へ。

• 最大読み込み時間（ミリ秒）（既定 1000ms）

  1回の読み込みにかけるタイムアウト。NAS/クラウドや巨大画像なら 3000–5000ms 程度に。

最適化オプション

• ファイルサイズの変更時のみリフレッシュ

  「サイズが変わったときだけ再読込」。

  省I/Oで速い反面、同サイズ上書きだと変化を検知できません。外部ツールが毎回同じサイズで保存する場合はOFFのままに。

• イメージ接続プーリングを有効化

  画像読み込みの接続を再利用して初期化コストを削減。多数の静止画を連続で読むワークロードで有効。

  ただしWindowsではファイルハンドルが保持され**「使用中で上書きできない」**状況が出ることがあります。保存側で排他エラーが出るならOFF。

おすすめプリセット

• 一般的な検証（ローカルSSD、数MB画像）
  • キーイベントを消費：ON
  • リフレッシュ間隔：200–300ms
  • 最大読み込み時間：1000–2000ms
  • サイズ変更のみでリフレッシュ：OFF
  • 接続プーリング：OFF
• 大量の画像を連続検査／高スループットが必要
  • リフレッシュ間隔：100–200ms
  • プーリング：ON（保存側がロックで困る場合はOFFへ）

<aside> 💡

ミニTIPS — よくあるハマりどころ

</aside>

• 画像が更新されているのに反映されない → 「サイズ変更のみ」チェックを外す／間隔を短く。
• 外部アプリが「ファイルが使用中で保存できない」 → プーリングOFF。
• キー入力がPC側に飛んでしまう → 「キーイベントを消費」ONにして、ビューアにフォーカス。