# Karuiya 0.9.1 既知の制約

## 表示言語

対応言語は英語、日本語、簡体字中国語、韓国語、スペイン語、ブラジルポルトガル語、
フランス語、ドイツ語です。繁体字中国語は未実装で、Windowsが繁体字環境の場合は英語へ
フォールバックします。簡体字を繁体字として自動表示することはありません。

言語変更は安全性を優先して次回起動時に反映します。ファイル名、素材パス、字幕本文、
レイヤー名、ユーザープリセット名は利用者のデータなので翻訳しません。各言語の長文説明や
狭い画面幅には、翻訳品質またはレイアウトの改善余地が残る場合があります。

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

公開版の外部FFmpegはLGPL構成を前提とし、libx264とlibx265を同梱しません。
標準版では実機試験に成功したH.264 hardware／Media Foundation／OpenH264だけを表示し、
GPL拡張がない新規プロジェクトではCPU H.264／HEVCプロファイルを表示しません。既存の
GPL専用設定は保持しますが、検証済み拡張が利用可能になるまで書き出せません。

## 色調補正と背景ぼかし

書き出しはLGPLの`lutyuv`／`colorchannelmixer`／`gblur`へ移行しています。Qt Quickの
RGBプレビューと素材固有のYUV matrix/rangeは数学的に完全同一ではないため、
BT.601／BT.709／BT.2020、limited／full、8／10-bitの組み合わせによって見え方に差が
生じる可能性があります。

## 配布物の整合性

公開onedirは、LGPL版FFmpeg、第三者台帳、正規ライセンス本文、Qtの配置と全配布ファイルを
`release_verify.py`で検査し、`release_manifest.json`へサイズとSHA-256を記録します。
配布後にファイルを追加・削除・変更した場合、この検査結果は無効になります。

## 旧プロジェクトの初回再リンク

Codex-28 RC3以前のプロジェクトには相対パス、パス履歴、ファイルサイズが保存されていません。ファイルサイズが不明な素材は、同名候補が一意でも自動確定しません。別素材への誤照合を避けるため、初回だけクリップ右クリックの手動再リンクを使用してください。再保存後はハイブリッド参照情報が記録されます。

## 実機D3D11受入

自動回帰試験のQt offscreen／software描画は、実GPUのD3D11描画スレッドを検証しません。
本配布系列では高性能PCと対象下限PCで実機確認していますが、すべてのGPU／ドライバー構成を
網羅するものではありません。`run_software_canvas.bat`の成功は切り分け情報であり、
D3D11受入の代替にはなりません。

## 高負荷プレビュー

多数の動画レイヤーが同じ境界で同時にジャンプする構成では、補助レイヤーが一瞬遅れて復帰する場合があります。Codex-16で激しい明滅・フリーズは大幅に抑えていますが、現行QMediaPlayer方式の既知制約として残します。最終書き出し品質とは別問題です。

## 大規模書き出し

極端に多数のクリップを含む長尺書き出しでは、Windowsのコマンドライン長と一時容量に
注意が必要です。MP4／MOV／MKVごとのチャンク、結合、容量推定と、通常最大500構成区間・
色／ぼかし推定メモリに応じてさらに小さくする自動分割を実装していますが、数千クリップの
長尺出力は素材形式、ストレージ速度、空き容量によって処理時間と必要容量が大きく変わります。

本版では、`lutyuv`／`gblur`を同時に展開するfilter node数と解像度からネイティブ作業メモリを
保守的に事前推定します。推定512 MiB以上はセッションログへ警告し、1 GiBを超える場合は
OS全体を不安定にする前に書き出しを停止します。その場合は範囲を分けて書き出してください。
ProRes／FFV1の容量推定は安全側の概算であり、素材内容によって実ファイル容量と差が出ます。

書き出し完了後は、途中破損を成功扱いしないため、完成ファイルの全映像・全音声を
decode-to-nullで検査します。そのため進捗99%の検証工程に追加時間がかかりますが、
プレビュー再生やタイムライン編集時の処理量には影響しません。

## 更新確認

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

## プロジェクト互換性

`.karprj` / version 25のみ対応します。旧`.karuiya`および`.ffproj`は仕様どおり非対応です。

## 動画デコード

標準起動は動画デコードをソフトウェア方式へ固定しています。`run_hardware_decode_compare.bat`は診断比較用であり、通常利用の保証対象ではありません。

## Python実行版

ソース版は64-bit Python 3.10～3.14から専用`.venv`を作成し、PySide6 6.11.1を使用します。初回導入にはインターネット接続またはpipキャッシュが必要です。`.venv`作成後の通常起動では外部通信しません。`.venv`は数百MBのディスク容量を使用しますが、グローバルPythonを変更せず、再生処理量も増やしません。

## セッションログの保存

`logs/sessions`は調査証拠を失わないよう自動削除しません。長期運用で容量が増えた場合は、Karuiyaを終了した状態で不要な古いセッションフォルダーを手動整理してください。同時起動時の`last_session_logs.txt`は最後に開始したセッションを指しますが、各セッションログ自体は別フォルダーへ保存されます。

親supervisorはGUI子の終了を待つため、待機中のPythonプロセス分だけ数十MB程度の追加メモリを使用する場合があります。Qt、動画、プロジェクトは読み込まず、再生・編集処理には参加しません。
