ホームMachine Learningnikopueringer/CorridorKey
// archived 2026-04-14
23

// 概要

CorridorKey は、グリーンバックやブルーバックから被写体を分離する複雑な課題を解決するために設計されたニューラルネットワークベースのツールです。各ピクセルの真のストレートカラーとリニアアルファチャンネルを再構築し、髪の毛やモーションブラーなどの微細なディテールを効果的に保持します。本プロジェクトは、業界標準のコンポジットソフトウェアと互換性のある 16-bit および 32-bit のリニア float EXR ファイルを出力することで、高精度な VFX ワークフローをサポートします。

// 技術解説

CorridorKey は、従来のツールでは困難であった前景の被写体と背景のスピルを正確に分離する「アンミキシング」問題を解決するために設計された、ニューラルネットワークベースのグリーンバックキーイングソリューションです。前景の真のストレートカラーと各ピクセルのクリーンなリニア Alpha チャンネルを予測することで、バイナリマスクでは失われがちなモーションブラーや透明度といった繊細なディテールを保持します。本プロジェクトは、16-bit および 32-bit リニア EXR 出力をサポートすることで高忠実度な VFX ワークフローを優先しており、手動のロトスコープや複雑なエッジマット作成に代わる洗練された選択肢を提供します。

// 主要ハイライト

01
物理的に正確なアンミキシングにより、前景オブジェクトの真の色を再構築し、髪の毛、モーションブラー、半透明性を保持します。
02
解像度に依存しないエンジンが推論を動的にスケーリングし、2048x2048 の高忠実度バックボーンを維持しながら 4K プレートを処理します。
03
16-bit および 32-bit Linear float EXR ファイルのネイティブサポートにより、Nuke、Fusion、Resolve といったプロフェッショナルな VFX パイプラインへのシームレスな統合を実現します。
04
自動化された形態学的クリーンアップシステムが、トラッキングマーカーや不要な背景アーティファクトを最終出力からインテリジェントに除去します。
05
グリーンバックおよびブルーバック専用のチェックポイントにより、撮影時に使用された特定の背景色に合わせて正確なスピル除去が可能です。
06
NVIDIA CUDA、Apple Silicon (MLX 経由)、AMD GPU (ROCm 経由) といった柔軟なハードウェアサポートに加え、自動 Alpha Hint 生成用のオプションモジュールも備えています。

// ユースケース

01
グリーンバックやブルーバックからの被写体の物理的に正確な分離
02
高精度なアルファチャンネルとストレートカラーパスの自動生成
03
Nuke、Fusion、Resolve へのシームレスな統合を実現する VFX 標準の出力

// クイックスタート

開始するには、リポジトリを clone し、OS 用に提供されているインストールスクリプトを使用してください。これらは 'uv' を活用して Python と依存関係を自動的に管理します。インストールが完了したら、コマンドラインウィザードを使用し、ビデオクリップをランチャーのスクリプトにドラッグ&ドロップしてファイルを整理し、必要な Alpha Hint を生成します。最後に、ウィザード内で設定を行い、クリップを処理して前景およびマットファイルを出力します。