技術参考資料（日本語）。ソースコード・過去の検証チケットはアプリには同梱していません。
HDR関連の現行化：2026-10-20。実装とResult0858〜0871を照合。その他の項目は各節の確認範囲・日付に従います。
確認日：2026-10-04。現行の作業ツリーを対象に、コードの接続と既存のResultを確認した一覧です。2026-10-04の一覧更新ではGUI・実画像・性能の再検証を行っていません。「実装」は動作保証や全条件の検証完了を意味しません。
一般画像対応の追補・照合：2026-10-11（GeneralImage）。一般画像の対応仕様と最終点検結果を参照。従来機能の全件再検証ではありません。 本体はShinG3Genzoの新Workspace、Experimentsは特記がなければNew RAW Workspaceを指します。共有部品があっても、ホスト側の接続と保存先は別です。
RAWに加え、JPEG／PNG／HEIFと単一ページRGB TIFF（8／16bit整数・32bit浮動小数点）を共通画面で編集できます。ゲインマップJPEG／HEIF、PQ／HLG HEIFは新規編集でHDRを保持します。既存SDR編集の解釈は維持します。透過素材・複数フレーム／ページ、PNG・float TIFFのHDR表示は対象外です。アルファ等の詳細条件は一般画像の対応仕様を参照してください。
以下は本体とExperimentsの共有現像パネルで扱う機能です。Baseと調整レイヤーでは利用可能な項目・値の意味が異なり、RAWデコード設定や幾何変換を各レイヤーで独立して変更するものではありません。
| 機能 | 対応内容・注意点 | Kitの主な担当 |
|---|---|---|
| 一般画像のWB・NR | 記録ケルビン基準または相対WB、WBスポイト、独立した輝度／カラーNR。RAW内蔵処理と同一アルゴリズムではない | Imaging：StandardImageDevelopmentFilter／StandardImageColorNoiseReductionFilter |
| RAWデコード・NR | 対応するRAW8／RAW9を選択。NRの利用可否・既定値はOS、デコーダー、RAWに依存 | Imaging：RawFilterFactory、RawSourceSnapshot |
| RAW使用範囲 | 撮影時の範囲／全範囲を画像別に選択。全範囲取得は対応RW2。既定は撮影範囲。サムネイル・プレビュー・書き出しへ反映 | Imagingのソース選択／UIの範囲メニュー |
| フィルムスタイル | モノクロ・カラー・Fカラーの23プロファイル。Baseのみ。粒状ノイズのサイコロ、保存・復元。実在製品の測定再現や現像液シミュレーションではない | Coreの単一JSONカタログ／Imaging／UI |
| 露出・WB | 露出、色温度、ティント。画像上のWBスポイトも本体に接続 | Imagingの現像処理／UIのWBパネル |
| ハイライト・シャドウ | 表示は−100〜+100、EV表記なし。内部値と表示値を区別 | Imaging：ExperimentToneRangeAdjustment／UI |
| 白・黒レベル | 白側・黒側の階調調整 | Coreのパラメータ／Imaging／UI |
| トーンカーブ | 総合・R・G・B、ヒストグラム表示、画像上の調整 | CoreのToneCurve／Imaging／UI |
| 色調整 | コントラスト、彩度、自然な彩度、HSL、カラーグレーディング | Imagingの各フィルタ／UI |
| ディテール | 霞の除去、Clarity、Structure、仕上げシャープネス | Imaging／UI。RAW内シャープネスとは別 |
| 周辺光量・ジオメトリ | 周辺光量、RAWレンズ補正、水平補正、クロップ | Imaging／UI。レンズ補正はRAW対応状況に依存 |
| ごみ取り | Clone／Heal、1クリック配置、サイズ推定、サイズ・角度・ぼかしの画像上操作 | CoreのSpotRepair／Imaging／UI。画像全体からの自動検出とは別 |
| LUT | 複数の3D .cube、並べ替え、有効／無効、適用率。全体用とレイヤー用を独立保持 | Core：RawLUTEntry／Imaging：RawLUTStackFilter／UI：RawLUTPanel |
入口：本体パネル接続、共有現像パネル、本体現像処理、レイヤー現像処理。処理順はパイプライン仕様を参照。
入力・出力をそれぞれ指定します。現像後の色空間・ガンマ変換であり、RAWデコーダーの切り替えやカメラ固有の撮影画質を完全再現する機能ではありません。
| 系統 | 選択肢 |
|---|---|
| 標準 | Linear sRGB / Rec.709、sRGB、Rec.709 / Gamma 2.4 |
| Panasonic | V-Log / V-Gamut |
| Sony | S-Log3 / S-Gamut3.Cine、S-Log3 / S-Gamut3 |
| Canon | Log 2 / Cinema Gamut、Log 3 / Cinema Gamut |
| Fujifilm | F-Log / F-Gamut、F-Log2 / F-Gamut |
| Nikon | N-Log / BT.2020 |
| ARRI | LogC3（EI 800）/ ARRI Wide Gamut 3、LogC4 / ARRI Wide Gamut 4 |
| Blackmagic | Film Gen 5 / Blackmagic Wide Gamut |
| DaVinci | Intermediate / DaVinci Wide Gamut |
3D .cubeは各軸2〜65点、読込ファイル上限32MB。1D LUTと1D／3D複合ファイルは非対応。入力・出力プロファイルの自動判定やLUTファイルの同梱はありません。LUT本体は編集文書に埋め込まれます。
根拠：RawLUT.swift、RawLUTStackFilter.swift、Result0616〜Result0623。
本体は共有レイヤー・マスクパネルへ接続済みです。Experimentsでも共有部品を使用します。
| 機能 | 対応内容 |
|---|---|
| レイヤー | Base、調整、反転。名前、順序、有効／無効、削除 |
| 適用度 | 調整・反転レイヤーに0〜100%、既定100%。ドラッグを離すと現像へ反映。Baseには表示しない |
| Color Region／Global Color | クリック位置からの領域探索／全画面の色選択 |
| 肌選択 | クリック位置から角度・距離範囲で領域探索。円形コントローラーと角度・距離の数値／スライダーが連動。ユーザー既定値。AIは使用しない |
| 輝度Region／グローバル輝度 | クリック位置からの領域探索／全画面の輝度範囲選択。範囲と境界のぼかしを調整 |
| 線形・円／楕円グラデーション | 画像上のハンドルと強度調整 |
| ブラシ | 通常の円形ブラシ／色に沿う領域選択。新規は色に沿う選択が既定ON、閾値調整。色選択中はぼかし不使用、マウスを離してまとめて計算 |
| AI選択 | 選択点を使う生成マスク。生成・編集にはmacOS 27以降が必要 |
| マスク管理 | 複製、順序、有効／無効、削除、境界調整、レイヤー合成マスクの反転 |
| マスク合成・表示 | 加算・減算・交差。選択中マスク／合成結果を切り替え表示 |
加算はmax、減算はmax(0, A−B)、交差はminです。レイヤー適用度は合成マスクの強度と掛け合わせます。マスク生成の基準画像と順番はパイプライン仕様を参照。
| 機能 | 本体の対応内容 | 担当・差分 |
|---|---|---|
| SuperEdit | キー設定、ホイール・方向キー操作、スクロール可能なキー一覧からクリックで開始、通常の0／リセットボタン、Esc／終了ボタン。白・黒レベルは既定キーなし | Kit UI＋本体入力接続 |
| スライダーのリセット | ダブルクリックまたはリセットボタンで各項目の既定値へ戻す | 共有UI。WB等の既定値はRAWに依存 |
| プレビュー速度優先 | 既定ON、表示サイズ・倍率に応じてRAW scaleを変更。OFFは1。書き出しのRAW処理は1 | 本体設定・Controller＋KitのScale policy |
| Undo／Redo | 履歴上限を設定から100〜100,000件で変更 | 編集セッションの履歴。永続保存とは別 |
| 表示 | ズーム、Fit／100%、パン、グリッド、白飛び・黒つぶれ表示 | Kitプレビュー＋ホスト接続 |
| 比較 | 初期状態・スナップショット・バリエーション、分割・重ね合わせ・全画面比較 | 本体の比較制御＋Kit表示部品 |
| 比較のジオメトリ | 作業中のクロップ・水平・レンズ補正を比較対象に適用。既定ON、保存済み比較対象は変更しない | 0615のチェックボックス接続は本体。Experimentsは別経路 |
| 解析パネル | ヒストグラム、メタ情報、カラーピッカー | Kit UI／Imaging |
| 画面カスタマイズ | パネル開閉・順序・表示、ツールバーの順序・グループ・セパレータ、左右パネル入れ替え | 共有UIと本体設定。パネル・ステータス領域の表示制御は本体 |
| 言語・設定 | macOSに合わせる／日本語／英語。SuperEditキー、肌選択既定値等 | 本体設定＋Kitリソース |
| 編集状態保存 | 最新編集状態、バリエーション、ユーザープリセット | Kit Persistence。本体とExperimentsの保存先は別 |
| スナップショット | 一時的な保存・復元・比較 | メモリ保持。永続バリエーションと区別 |
| JPEG／PNG／TIFF／HEIF | 共通プロファイル、サイズ・ICC・署名。JPEGは品質／容量上限、PNGは8／16bit、TIFFは8／16bit整数・32bit floatと3圧縮、HEIFはSDR 8／10bitまたはHDR (PQ) 10bit | Kitエクスポーター＋本体の保存先アクセス処理 |
| 購入・無料体験 | StoreKit 2の14日間無料体験・買い切り・購入復元。体験外でも閲覧・編集・保存は可能、JPEG／PNG／TIFF／HEIF書き出しを制限 | ShinG3Licensing＋本体画面・出力入口。実ストア登録状況はこの一覧で確認していない |
| ファイル選択の記憶 | 画像を開く・書き出し・LUT選択の最終フォルダを別々に保持 | Kit UIの記憶部品。アクセス許可とは別 |
| ライセンス・謝辞 | 「このアプリについて」から同梱の謝辞・ライセンス文を表示 | 本体固有 |
参照：本体Workspace、本体設定、比較処理、保存データ仕様、出力パネル、About。
本体の「ファイル」→「画像ブラウザ…」（⇧⌘B）で独立ウィンドウを開きます。ExperimentsのRAW Browserタブは同じSharedの画面を使用しますが、本体の現像ウィンドウルーティング・コピー／ペースト接続まで自動で共有するわけではありません。
| 機能 | 現行の対応内容 |
|---|---|
| 一覧・フォルダ | RAW／JPEG／PNG／TIFF一覧、形式別の独立トグル、非対応理由の事前案内、サブフォルダ、フォルダツリー、お気に入り、最後のフォルダ復元 |
| 表示・検索・選択 | 指定幅120〜1024ptのサムネイル、ファイル名検索、ファイル名／撮影日時／更新日時／サイズの並べ替え、複数選択 |
| パネル・ツールバー | 左右パネル表示と幅・サムネイル幅を保持。横スクロール可能なツールバーに矢印等の案内 |
| 一括書き出し（本体） | 選択画像の最後に保存した編集でJPEG／PNG／TIFF／HEIF出力。共通プロファイル、進捗・キャンセル・失敗一覧。未保存画像は入力の既定値。同名バリエーション指定にも対応 |
| 選別 | 星0〜5、未判定／採用／除外、キーボード操作、一括設定、絞り込み、評価後に次へ |
| タグ | 作成・追加・解除・名前変更・定義削除、全条件／いずれかの絞り込み |
| 拡大・比較 | 拡大プレビュー、フィルムストリップ、Fit／100%、2枚比較、青枠の操作対象。一覧へ戻ると開く前の位置を復元 |
| 現像先 | 既存画像の現像ウィンドウへ移動、前の現像先を再利用／新規作成 |
| 設定コピー・ペースト | 最新保存状態／バリエーションを選び、1枚または複数枚へ適用。右クリック対応、新規現像ウィンドウなしで保存・サムネイル更新。失敗は残りを継続し最後に報告 |
| スタック | 手動・撮影間隔による自動生成、代表変更、展開・折りたたみ、解除。画像の類似度判定は行わない |
| 現像済みサムネイル | 保存済み現像結果を優先、現像側からの更新通知、サムネイルリセット。設定削除とは別 |
| RAW使用範囲 | 対応画像のバッジ、一覧の一括選択、拡大／比較の範囲メニュー、全範囲で撮影範囲の枠表示 |
| ファイル・キャッシュ | Finderに表示、通常キャッシュの容量設定と削除。元RAWは変更しない |
ブラウザの評価・タグ・スタックDBは現像DBと別です。折りたたみ内部の非選択画像は設定ペーストの対象に含めません。コピー元の画像識別情報とRAW使用範囲は適用先へ転送しません。操作はブラウザガイド、保存先は保存データ仕様、設定キーは設定一覧を参照してください。
入口：共通ブラウザ、本体接続。
ExperimentsにはRAW Mask Lab、AI Mask、Tone Range、New RAW Workspace、Metal Preview、RAW 8 / 9、RAW Browser、RAW対応カメラ、Vectorscope、Skin Tone、Film Style、Histogram、Benchmark、StoreKitのタブがあります。RAW対応カメラの一覧画面はKitで共通化し、本体の「ヘルプ」→「RAW対応カメラ…」からも開けます。その他の検証画面一式を本体へ移したものではありません。
根拠：Experimentsのタブ構成、RAW生成、AIの旧OS対応記録。
| 項目 | 扱い |
|---|---|
| 画像全体の自動ごみ検出・補修 | 持ち越し。現在のクリック後サイズ推定とは別機能 |
| C2PA署名 | 出力パネルでは今後対応予定。署名・証明書運用は未実装 |
| 旧DBからの自動移行、画像移動後の編集再紐付け | 現在の保証対象外。保存仕様を参照 |
| 画質・性能 | 全フィルタ併用時の操作速度、OS・カメラ・LUTの組合せは個別検証が必要 |
| Blackmagic／DaVinci LUT | Result0623に限定テスト・ビルド記録あり。ユーザーの実画像確認は未実施として引き継ぐ |
この一覧は型単位の全件移行監査ではありません。機能追加時は本体・Experimentsの接続、保存・復元、Undo、比較、出力、OS条件を一緒に更新してください。
ブラウザの一括書き出しは「最後に保存した現像設定」または各画像の同名バリエーションを指定できます。該当バリエーションがない画像は件数を表示して除外します。
ブラウザでは保存済みユーザープリセットをツールバー／右クリックから選択画像へ一括適用できます。既存ペースト経路を共用し、最新設定・サムネイルと進捗／成功・失敗表示を更新します。
ブラウザの一括ペースト／プリセット適用は、成功画像を1操作としてUndo／Redoできます。設定・レイヤー・サムネイルを復元し、後から変更された画像は上書きしません。
ブラウザの「現像設定をリセット」はツールバー／右クリックから複数画像へ適用可能です。最新の現像設定・レイヤー・マスクと現像済みサムネイルを初期状態へ戻し、一括Undo／Redoに対応します。保存済みバリエーションは保持します。
現像画面にもツールバーの「現像設定をリセット」を追加。画像全体のパラメータ・レイヤー・マスクを撮影時初期状態へ戻し、現像画面のUndo／Redoに対応します。共通Kitの任意アクション部品を利用し、並べ替え・非表示が可能です。
ブラウザの現像設定ペーストは項目選択に対応。NR／シャープネスとレンズ補正を独立指定し、未選択の設定・レイヤー・マスクを保持します。最後に実行した選択は再起動後も復元。選択パネルはKit UI、永続化と対象画像の固定は本体、選択適用はKit Persistenceに配置しています。
ブラウザの現像状態フィルター：「すべて／現像済み／未現像」。最新設定の保存有無で判定し、他の絞り込み条件と併用。サムネイルリセットとは独立し、現像設定の保存・ペースト・リセット・Undo／Redo通知で更新します。Kit Coreに判定、Kit Persistenceに一括照会、共有ブラウザに状態キャッシュとUIを配置。
| 機能 | 本体の対応範囲 |
|---|---|
| RAW HDRプレビュー | 上部ステータス横のHDRボタン。既定OFF・セッション内のみ。比較表示にも接続 |
| 表示と編集の分離 | 通常画像・ヒストグラム・サムネイルは維持。色取得・crop・マスク／修復編集・クリッピング表示中はOFF |
| HDR (PQ)保存 | 現像画面とブラウザ一括出力のHEIF設定。10bit・BT.2100 PQ／BT.2020、RAWはHDR再現像 |
| PQの制限 | 文字署名・容量上限・写真ライブラリ直接追加は非対応。出力パネルの画像はSDR確認用 |
| ゲインマップ生成 | 実験記録はあるが製品出力は未対応 |