Godot4_ドキュメント学習 3_Godot について_トラブルシューティング

記事ディレクトリ

トラブルシューティング

トラブルシューティング

このページには、Godot の使用時に発生する一般的な問題と考えられる解決策がリストされています。

コンパイラーの実行が遅く、CPU と GPU のリソースを消費し、コンピューターの騒音が大きくなります。

ほとんどの Mac には Retina ディスプレイが搭載されているため、特に macOS ではこれは既知の問題です。Retina ディスプレイのピクセル密度は非常に高いため、すべてをより高い解像度でレンダリングする必要があります。これにより、GPU の負荷が増加し、体感的なパフォーマンスが低下します。

パフォーマンスとバッテリー寿命を向上させる方法はいくつかあります。

3D では、左上隅にあるPerspectiveボタンをクリックし、 Half Resolutionを有効にします。3D ビューポートは半分の解像度でレンダリングされるようになり、最大 4 倍の速度になります。
エディターの設定を開き、Low Processor Mode Sleep (μsec)の値を 33000 (30FPS、つまり 1000/33 ≈30) に増やします。この値は、レンダリングするフレーム間のマイクロ秒数を決定するために使用されます。この値を増やすと、エディターの反応が鈍くなりますが、GPU と CPU の使用量を大幅に削減できます。
エディターに継続的に再描画させるノード (パーティクルなど) がある場合は、それを非表示にし、_ready()メソッドのスクリプトを使用して表示します。こうすることで、エディターでは非表示になりますが、プロジェクトの実行時には表示されたままになります。

可変リフレッシュレートモニター (G-Sync/FreeSync) でエディターが途切れたりちらついたりする

これは既知の問題です。可変リフレッシュレートモニターでは、時間の経過とともに一貫した量の光を放射するために、ガンマカーブを継続的に調整する必要があります。Godot エディタは必要な場合にのみ再描画するため、リフレッシュレートが大幅に変化すると、画像の暗い領域がちらつく可能性があります。

解決策はいくつかあります。

エディター設定で[インターフェース] > [エディター] > [継続的更新]を有効にします。

画面上に何も変化がない場合でもエディターは継続的にレンダリングされるため、これにより電力消費と熱/ノイズの放出が増加することに注意してください。これを軽減するには、エディタ設定で低プロセッサモードのスリープ (マイクロ秒)を 33000 (30FPS) に増やすことができます。
あるいは、モニターまたはグラフィックスドライバーで可変リフレッシュレートを無効にします。
一部のモニターでの VRR ちらつきは、モニターの OSD のVRR コントロールまたは暗い領域の微調整オプションを使用して軽減できます。これらのオプションを使用すると、入力ラグが増加したり、黒つぶれが発生したりする可能性があります (画像の特に暗い領域では忠実度が失われます)。
OLED ディスプレイを使用している場合は、エディター設定でプリセットされている黒 (OLED)エディターのデフォルトのテーマを使用してください。OLED の完璧な黒レベルのおかげで、VRR のちらつきを隠します。

エディターまたはプロジェクトの起動に時間がかかる

Vulkan ベースのレンダラー (Forward+ または Forward Mobile) を使用する場合、最初の起動には比較的時間がかかることが予想されます。これは、シェーダをキャッシュする前にコンパイルする必要があるためです。Godot の更新、グラフィックスドライバーの更新、またはグラフィックスカードの切り替え後は、シェーダーも再度キャッシュする必要があります。

最初の起動後も問題が解決しない場合は、特定の USB 周辺機器を接続したときに Windows の既知のバグが引き起こされた可能性があります。特に、Corsair の iCUE ソフトウェアがこのエラーを引き起こすようです。USB周辺機器ドライバーを最新のものにアップデートしてみてください。バグが解決しない場合は、エディタを開く前に特定の周辺機器を切断する必要があります。次に、周辺機器を再接続します。

システムコンソールをクリックすると、Godot エディタがフリーズしたように表示される

システムコンソールを有効にして Windows 上で Godot を実行している場合、コマンドラインのシリアルポート内をクリックして誤って選択モードを起動してしまう可能性があります。この Windows 固有の動作によりアプリケーションが一時停止され、システムコンソール内でテキストを選択できるようになります。Godot はこのシステム固有の動作をオーバーライドできません。

この問題を解決するには、システムコンソールウィンドウを選択し、Enter キーを押して選択モードを終了します。

プロジェクトマネージャーおよびエディターウィンドウの左上隅に「NO DC」などのテキストが表示される

これは、NVIDIA グラフィックスドライバーが情報を表示するためにオーバーレイを挿入することが原因で発生します。

Windows でオーバーレイを無効にするには、NVIDIA コントロールパネルでグラフィックスドライバーの設定をデフォルト値に戻します。

Linux でこのオーバーライドを無効にするには、nvidia-settingsを開き、 X Screen 0 > OpenGL Settingsに移動し、Enable Graphics API Visual Indicator のチェックを外します。

エディターまたはプロジェクトが鮮明すぎる、またはぼやけて見える

左は正しい外観、右はグラフィックスドライバーのシャープ化により過度にシャープになった外観です。

エディターまたはプロジェクトが鮮明すぎるように見える場合は、グラフィックスドライバーがすべての Vulkan または OpenGL アプリケーションで画像の鮮明化を強制していることが原因である可能性があります。この動作は、グラフィックスドライバーのコントロールパネルで無効にすることができます。

NVIDIA (Windows): [スタート] メニューを開き、[NVIDIA コントロールパネル]を選択します。左側の「3D 設定の管理」タブを開きます。中央のリストで、「画像の鮮明化」までスクロールし、 「鮮明化オフ」に設定します。