# Karuiya 1.0.0の既知の制約

## 波形キャッシュとストレージ整理

初めて読み込む素材や、内容・更新日時が変わった素材では音声波形を作り直します。
永続波形キャッシュは最大512MiBまたは2048件で、古い項目から自動で整理されます。
キャッシュが壊れている場合はその項目を使用せず、元素材から再生成します。

波形解析は、開始前に他の処理が完了するまで待つ場合があります。いったん開始すると、
完了または失敗が確定するまで継続し、サムネイル、静止画、プレビュープロキシ、再生、
書き出しを理由に中断しません。アプリ終了、素材の削除・変更、プロジェクトの切替・復元など、
解析結果の利用先がなくなる場合は終了します。

「ヘルプ > ストレージ使用量と整理」で不要データを整理すると、波形キャッシュは
消去され、必要になったときに再生成されます。終了済みセッションの一時キャッシュと
古いログも対象ですが、現在のログと直近10回分は残します。素材、プロジェクト、
書き出したファイル、利用者プリセットは削除しません。

## シーケンスの自動設定

最初に動画を読み込んだ場合のシーケンス自動設定は、素材やレイヤーがない新規プロジェクト
だけで動作します。画像から始めたプロジェクト、保存済みプロジェクト、利用者が先に
シーケンス設定を変更した場合、後から追加した動画で既存設定を上書きしません。

スマートフォン動画の表示方向は、動画ストリームのDisplay Matrixが明示する90度単位の
回転を対象にします。旧式の`rotate`タグだけを持ち、Display Matrixがない素材は自動判定の
対象外です。必要な場合はシーケンス解像度とレイヤー配置を手動で調整してください。

DF／NDFの自動設定は、素材に明示されたタイムコード情報があり、その値が矛盾せず、
29.97／59.94系の場合だけ行います。情報がない素材やMPEG-2のGOPタイムコードだけを持つ
素材では、フレームレートから推測せずNDFを使用します。必要な場合はシーケンス設定で
DFを明示してください。

## ユーザープリセット

ユーザープリセットはWindowsの利用者ごとのアプリ設定に保存され、`.karprj`には
埋め込まれません。別PCへ移す場合は「ファイル > ユーザープリセット」からバックアップを
書き出し、移動先で読み込んでください。読み込んだプリセットは編集中のプロジェクトへ
自動適用されません。静止画の既定時間は、設定後に追加する画像だけへ適用されます。

## 表示言語

英語、日本語、簡体字中国語、韓国語、スペイン語、ブラジルポルトガル語、フランス語、
ドイツ語に対応します。繁体字中国語を含む未対応言語では英語を使用します。
言語変更は次回起動時に反映されます。ファイル名、素材パス、字幕本文、レイヤー名、
ユーザープリセット名など、利用者が入力したデータは翻訳しません。

## 書き出しエンコーダー

標準版はLGPL構成で、libx264とlibx265を同梱しません。MP4は、このPCで利用可能な
検証済みH.264 hardware／Media Foundation／OpenH264エンコーダーを使用します。
CPU H.264／HEVCを必要とする既存設定は保持しますが、対応する検証済み拡張がない場合は
書き出せません。利用できないエンコーダーを別のものへ黙って置き換えることはありません。

## プレビューと書き出しの色

Qt QuickによるRGBプレビューと、素材固有のYUV matrix／rangeを使用する書き出しは、
すべての条件で数学的に完全同一ではありません。BT.601／BT.709／BT.2020、limited／full、
8／10-bitの組み合わせにより、見え方にわずかな差が生じる場合があります。

## 古いプロジェクトの素材再リンク

一部の古いプロジェクトには、相対パス、過去のパス、ファイルサイズが記録されていません。
別素材への誤照合を避けるため、素材が見つからない場合はクリップを右クリックして手動で
再リンクしてください。再保存すると、以後の検索に使う素材情報が記録されます。

## GPUと高負荷プレビュー

すべてのGPU、ドライバー、複数画面構成を網羅することはできません。表示に問題がある場合、
`run_software_canvas.bat`は原因の切り分けに利用できますが、通常起動より機能や性能が
制限される場合があります。

多数の動画レイヤーが同じ境界で同時に切り替わる構成では、補助レイヤーの表示復帰が
一瞬遅れる場合があります。これはプレビュー上の制約で、最終書き出しとは別です。

## 大規模・高解像度の書き出し

長尺、4K、多数のクリップやレイヤーを含む書き出しでは、処理時間と必要なメモリ・空き容量が
大きくなります。素材形式、保存先の速度、エフェクト、出力形式によって必要量は変わります。
容量不足の警告が表示された場合は、保存先を変更するか範囲を分けて書き出してください。

完成ファイルの途中破損を成功扱いしないため、進捗99%付近で映像・音声を検査します。
高解像度または長尺の動画では、この検査にも相応の時間がかかります。

## セキュリティソフト

一部のセキュリティソフトが、初回起動や動画処理の確認画面を表示する場合があります。
保護機能全体を無効にしたりフォルダー全体を除外したりせず、画面の案内に沿って
Karuiyaの実行だけを許可してください。問題が続く場合は、製品名、表示内容、
`logs/sessions`の該当ログを添えて
`support@karuiya.org`へお問い合わせください。

## 更新確認

更新確認先は`https://karuiya.org/updates/stable-v1.json`です。自動確認は24時間に1回で、
更新がある場合も自動ダウンロードや自動実行は行いません。確認後に公式ページを開きます。

## プロジェクト互換性

`.karprj` / format 25に対応します。旧`.karuiya`および`.ffproj`は非対応です。
1.0.0は受入基準の0.9.5からプロジェクト形式を変更していません。

## 診断ログ

現在のセッションログは通常動作中に削除しません。「ヘルプ > ストレージ使用量と整理」で
利用者が整理を実行した場合だけ、現在のログと直近10回分を残して、それより古いログを
整理します。素材そのものはログへ埋め込みません。
