トラブルシューティング

よくある問題と対処法をまとめました。解決しない場合は GitHub Issues まで。

動作が重い / プレビューがカクつく

症状: 編集中のプレビューがコマ落ちする。プレビュー領域の fps 表示が低い。

対処:

症状: Video オブジェクトを追加したのに、画面がフラッシュする / 最初のフレームで固まる / 音ズレが起こる。

対処:

動画は HTML5 <video> 要素として読み込まれます。シーク精度は _frameReady フラグで保証されますが、ネットワーク遅延が大きいファイルは不安定に。
Smart Preview を OFF にしてフル解像度で試す (デコード負荷が安定化)。
WebM / MP4 両方を試す (codec によって挙動が違う)。
大きなファイルは事前に ffmpeg などで再エンコード。

症状: Export MP4 を押すと "no encodable codec" エラー。

対処:

ブラウザが H.264 / VP9 / AV1 のいずれもハードウェアエンコードに対応していない。Chrome の chrome://flags で hardware encoder を有効化、または Firefox / Edge を試す。
Safari の場合は H.264 が標準対応。
最新版のブラウザを使う。

症状: ブラウザ再起動後に自動保存が見つからない。

対処:

IndexedDB は ブラウザプロファイル単位 で保存されます。シークレットウィンドウや別プロファイルでは別ストレージ。
シークレット / プライベートモード では IndexedDB が制限されるか、ウィンドウ終了時に削除される。
「ディスクのクリーンアップ」や「Cookie / サイトデータを削除」で IndexedDB も消える可能性。常時 Save Project で .opengraphs ファイルを手元に残すことを推奨。

症状: マスクを追加したのにレイヤーが消える / 全部表示される。

対処:

デフォルトの Scale 100% の矩形マスクはレイヤー全体を覆うため、「外側」が存在しない。マスクを切り抜きたいときは Scale を 50% 以下に。
楕円マスクは中心 (Position 0, 0) を起点に、円形に切り抜き。コーナーを消したい四角い vignette には楕円 + Scale 60-80% が定番。
Adjustment レイヤー にはマスクを適用できない (仕様)。

症状: 式を入力してもプロパティが動かない / 期待と違う値になる。

対処:

スクリプトコンソール (Ctrl+`) を開いて app.exprErrors を確認。
式は同期的に評価される (Promise は await しない)。
comp / layer は読み取り専用想定。書き込んでも反映されない。
ピックウィップ (◑) で参照すると、式の先頭に comp.layers['xxx'].transform.position_x_kf のような参照が挿入される。

症状: "essential matrix estimation failed" / "not enough matches"。

対処:

OpenGraphs は以下のモダンブラウザで動作します:

推奨メモリ: 4GB 以上 (4K 素材や Displacement Map を多用する場合は 8GB+)。

IndexedDB をクリアすると、自動保存 / バージョン履歴 / スマートリリンクのライブラリがすべて消えます (プロジェクトファイルには影響なし)。

DevTools を開く (F12 または Ctrl+Shift+I)。
Application タブ → Storage → IndexedDB → opengraphs-autosave を右クリック → Delete database。
ページをリロード。

注意

復元したい自動保存データがある状態で実行しないでください。先に Version History から必要なスナップショットを確認・保存。

GitHub Issues に以下を添えて報告してください: