# Karuiya 0.9.3.1 既知の制約

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

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

スマートフォン動画の表示方向は、動画ストリームの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%付近で映像・音声を検査します。
高解像度または長尺の動画では、この検査にも相応の時間がかかります。

## セキュリティソフト

一部のセキュリティソフトが、初回起動や動画処理を警告・停止する場合があります。
保護機能を無効化したりフォルダー全体を除外したりせず、公式配布元と公開SHA-256を
確認してください。問題が続く場合は、製品名、表示内容、`logs/sessions`の該当ログを添えて
`support@karuiya.org`へお問い合わせください。

## 更新確認

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

## プロジェクト互換性

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

## 診断ログ

`logs/sessions`は問題調査のため自動削除しません。容量が増えた場合は、Karuiyaを終了して
不要な古いセッションフォルダーを手動で整理してください。素材そのものはログへ埋め込みません。
