第10章 — 初心者モード

場所

ワークフローの上、常に表示。

技術詳細

Stage 割り当て付きのパイプライン全体 (Frame Quality → SfM → Training) に わたる水平進捗バーを表示します: Frame Quality は 0〜5% (Phase 3.11、非常に短い)、 SfM はバーの 0〜30%、Training 30〜100% を占めます。横には Status Text と Phase 名付きパーセント表示 (「SfM 41%」、「Training 12 500/20 000」) があり、 ユーザーが見かけ上の逆行「41% SfM → 25% Training」をエラーとして読まないように — バーはパイプライン全体の進捗を示し、サブステージではありません。ETA 計算は、 十分なトレーニング速度が測定されるとすぐに開始されます (通常、最初の 100 反復後)。 同じ表示が Expert モードでも Inspector の上に使用されます。

場所

Import ステップの左側、シンボル付き大きな破線長方形。初心者モードでは ラベル「Drop photos or a video here」で表示されます。

技術詳細

シンボルが短く跳ね、Drag アイテムがフィールド上に浮かぶとすぐに背景を 着色するドロップ領域。JPG、PNG、TIFF、HEIC、MP4、MOV、PLY、SPZ、.splat、 .radiancescene バンドル、ディレクトリを受け入れます。タイプ別の Drop Routing: 画像は収集され、ソートされて渡される、ビデオは Frame Sampling パスをトリガー、 Splat ファイルは直接プレビューを開く、Scene バンドルは読み込まれる。 ディレクトリは列挙され、含まれるすべての画像がインポートされます。Sandbox 準拠 アクセス用の Security Scoped Bookmarks が正しく取得および解放されます。 サポートされていない拡張子は 5 秒間警告バナーとして表示されます。

場所

Drop ゾーン内、目立つボタン。

技術詳細

複数選択と、ファイルタイプ JPG、PNG、TIFF、MP4、MOV、フォルダ、アプリ 独自の Scene 形式を持つ macOS ファイルダイアログを開くボタン。結果 URL は Security Scoped で、Drag and Drop と同じインポートパス経由で転送されます。ユーザーが フォルダを選択すると、再帰的に画像が列挙されます。

場所

Drop ゾーン内、アプリバンドルに Sample Scene が含まれ、まだ画像/Splat が インポートされていない場合のみ表示。

技術詳細

次の場合にのみ表示されます: (a) sample-scene.splat、.spz、または .ply が アプリバンドルに存在する、かつ (b) まだ画像/ビデオがインポートされておらず、 点群もない場合。クリックすると、完成した点群がロードされ (最小の形式を優先 — .splat ~3 MB、.spz ~1.4 MB、フォールバック .ply)、400 ms 後に Flowers シーンのオリジナルメタデータからのハードコードされたカメラ値を、審美的に意味の ある入力視点として設定します。

場所

Drop ゾーン内、「Try Sample Scene」の隣。同じ可視性条件。

技術詳細

約 427 MB の 960 のフル解像度フレームをロードしてアプリに入力する ダウンロード (リポジトリ github.com/bkindler/radiancekit-sample-photos) を トリガーします。ダウンロード中、ボタンは無効化されます。進捗は上部の Progress Bar に 「Downloading X%」として、独自のステージに表示されます。このステージは独自の 0〜100% スケールを保持し、後の SfM ステージと重ならないためです。

場所

Import オーバーレイのフローティング下部ツールバー、Start ボタンの左側。

技術詳細

ラベル「Quality」付きの操作要素が、利用可能なプリセットをカテゴリ別 (Classic / MCMC / Custom) にグループ化します。組み込みプリセットはカテゴリ別に グループ化されます。セクションヘッダーはハードコードされています。Custom プリセットは存在する場合のみ表示されます。ロック状態: Free リスト (Quick + Preview) にないプリセットは、ユーザーが購入していない場合、名前に「🔒」接尾辞が 付きます。選択時、ピッカーは Preview に戻り、自動的に Purchase Sheet を開きます。 選択時、プリセットが適用され、トレーニング構成全体が置き換えられます。

場所

Import オーバーレイのフローティング下部ツールバー、プリセットピッカーの右側。

技術詳細

画像もビデオもインポートされていない限り、グレーのままのボタン。クリックで パイプラインが開始され、Stage マシンが Frame Quality → SfM → Training の順序に 切り替わります。ボタン自体には他のステータスはありません。実行中の処理は代わりに 別の処理画面として表示されます。

場所

右の画像リスト、画像ではなくビデオがインポートされた場合のみ表示。

技術詳細

0.5 fps – 30 fps、0.5 ステップのスライダー。変更時、フレーム密度が 更新され、密度とビデオ長から計算されたターゲットフレーム数 (最小 10) も追加で 更新されます。リスト要素がスライダーからマウスイベントをブロックするため、 スライダーは画像リストの外に配置されています。スライダーの下に、計算された ターゲットフレーム (「247 frames」) とビデオ長 (「1m23s video」) があります。 ツールチップが警告します: 「密度を 2 倍にするとフレーム数が 2 倍になり、SfM 時間が ~100% 増加します。」

場所

右の画像リスト、右下、画像がインポートされた場合のみ表示。

技術詳細

赤いボタン。クリックは、タイトル「Clear all imported files?」と メッセージ「N images will be removed.」で確認ダイアログを開きます。確認は、 すべてのインポートされた画像/ビデオ、ステージングディレクトリ、点群、トレーニング ステータス、SfM 結果、すべてのキャッシュを消去します。ステージは Import に戻ります。 Cancel ですべてが保持されます。ダイアログは非破壊的なデフォルトパスとして構成 されています (破壊的ボタンは赤でマーク)。

場所

右の画像リスト、各エントリ。

技術詳細

スワイプで削除付きのインポートされた画像のリスト。画像ごとに、アイコン、 ファイル名、解像度 (「1920 × 1080」)、ファイルサイズ (フォーマット KB/MB) を 持つ行。解像度はメタデータキャッシュから取得され、UI がブロックされないように、 画像ヘッダーから非同期で埋められます。削除アクションは macOS 風のスワイプ削除 (行でのトラックパッド左スワイプ) と、選択された行での Delete キーボードを提供します。 注意: 明示的なマイナスボタン、Backspace、Cmd-Z による Undo を持つ拡張画像削除パスは、 Expert モードのみ の Project Navigator で追加されました — 初心者モードでは スワイプ削除のままです。

場所

画像リストの下、Clear All ボタンの上。

技術詳細

インポートされた画像の数に基づく 3 つの連続した閾値 (画像が存在し、 ビデオがない場合のみアクティブ): - < 3 画像: 赤バナー (red octagon)、テキスト 「At least 3 images are required. Camera alignment cannot be computed from fewer images.」- 3〜9 画像: 赤バナー、テキスト「With fewer than 10 images, SfM often fails and the trained scene tends to overfit […]. 15–20 images minimum recommended; 30+ for object captures.」- 10〜19 画像: オレンジバナー (warning triangle)、テキスト「Workable, but quality usually improves with 20+ images and good coverage around the scene.」

20 画像から、バナーは消えます。閾値はハードコードされており、経験的な 560+ トレーニング実験に基づいています。

場所

フォルダのドロップ時 — 可視のボタンではなく、検出ロジック。

技術詳細

ディレクトリのドロップ時、3 つの正規 Workspace レイアウトのいずれかが 含まれているかチェックされます: sparse/0/cameras.bin、sparse/cameras.bin、または 直接 Root に cameras.bin。それが該当する場合、標準画像列挙が中止され、代わりに モーダルアラートが開かれ、ユーザーに既存の再構築を使用するか、画像を Apple Photogrammetry で新しく実行するかを尋ねます。テキスト形式 Workspace (cameras.txt) と ETH3D エクスポートでも同じパス。詳細は第 9 章 Backend Q6 参照。初心者モードでも Expert モードと同じように動作します。

場所

Progress 円の後ろのフルスクリーン背景、中止またはエラーで非表示。

技術詳細

パイプライン進捗 (0…1) に応じて増加する数の小さなアニメーション化された Splat 粒子をレンダリングする装飾アニメーション。ソースは、SfM フェーズを 0〜0.2 に、Training を 0.2〜1.0 に (Frame Quality を 0〜0.05 に) マッピングする 計算された進捗値です。これにより、トレーニング中に Splat が見えて「構築」されます。 純粋に装飾的 — 表示は現在のトレーニングの実際の中間結果を示しません (それは Expert モードのライブプレビューでしょう)。Cancel や Failure では非表示になり、 Status 円のみが見えます。

場所

処理画面の中央、220 × 220 ピクセル。

技術詳細

2 つの重ねられたリング: 外側にミュートされた Track リング、内側に Accent または Red Stroke (エラーで赤) を持つ塗りつぶされた Progress リング。 円の中には、Stage アイコン (Training 用脳、SfM 用カメラ、Video Frame Extraction 用 フィルム、Frame Quality 用 Sparkles)、Stage タイトル、32 ポイント Rounded フォントで ライブアニメーション化されたパーセント数値。アイコンは処理がアクティブな限り 柔らかく脈打ちます。表示は 30 Hz タイマーで現在の実際の進捗の方向に滑らかに補間 されます — Constant-Creep (0.0003/フレーム) + Proportional Anteil (ギャップの 4%)、 次の予想されるマイルストーンの 80% に設定する Soft Ceiling (SfM ではハードコードされた マイルストーンテーブルから)。これにより、実際の SfM 更新が数秒ごとにしか入っても、 進捗が流動的に感じられます。

場所

処理画面の左上、32 × 32 ピクセル。

技術詳細

Material 背景を持つシンプルなボタン。Info パネルをオンまたはオフに切り替え ます。アクティブ時、アイコンは Info Circle Outline と Info Circle Filled の間で 切り替わります。柔らかいフェードインアニメーション。ツールチップは 「Show detailed processing metrics」。

場所

処理画面の左下、showProcessingInfo == true の場合のみ表示。

技術詳細

Ultra-Thin Material 背景を持つ 2 カラムパネル。左カラム: ステージ固有の 情報行 — SfM 用は Status Text とパーセント、Training 用は Iteration、結合 Loss、 L1 Loss、D-SSIM Loss、Gaussian カウント (オレンジ色)、Speed (it/s)、経過時間、 計算された ETA、SH Degree、学習率。右カラム: Status Text、Time Info 文字列、 インライン Loss チャート (C-28 参照)、Discoverability Nudge (C-32 参照)。すべての 値はトレーニングステータスから読み取られ、各トレーニング Tick で更新されます。

場所

下部ナビゲーションバー、トレーニングステージ中のみ表示 (SfM 中は NOT)、 処理が実行されている限り。

技術詳細

Bordered Button。ステータスに応じて Pause または Resume を呼び出します。 ラベルは「Pause」(Pause アイコン付き) と「Resume」(Play アイコン) の間で切り替わります。 SfM ステップ中、Apple Photogrammetry に Pause セマンティクスがないため、ボタンは 表示されません。Pause 状態は、反復、Gaussian ステータス、Optimizer Momentum を 完全に保持 — Resume は中断したところから続行します。

場所

下部ナビゲーションバー、処理が実行されている間 (SfM またはトレーニング) に表示。

技術詳細

赤い Bordered Button。タイトル「Stop and discard progress?」、ボタン 「Discard Progress」(破壊的) と「Keep Running」(Cancel) で確認ダイアログを開きます。 確認で、Cancel フラグが設定され、トレーニングタスクが終了され、必要に応じて SfM サブプロセスが終了され、中止ステータスを持つ Summary 行が JSONL ログに 書き込まれます。Pause とは異なり、トレーニングバッファとステータスは破棄されます。

場所

下部ナビゲーションバー、パイプラインが失敗した場合に表示 (SfM ステータスが 「SfM failed」で始まるか、トレーニングがエラー状態の場合)。

技術詳細

Accent Button。パイプライン全体を再起動します。開始前に、まだインポート された画像/ビデオが存在するかチェックされます。以前のエラーログは JSONL ディレクトリに残ります。新しい実行は、現在のタイムスタンプを持つ新しい Log ファイルを書き込みます。

場所

Info Panel 内、右カラム、非空履歴を持つトレーニング中のみ表示。

技術詳細

コンパクトな描画領域 (40 ピクセル高)、Loss History をアクセント色の 1 ピクセル線として描画します。データは有限値にフィルタリングされます (不安定な トレーニング用 NaN 保護)。Min/Max は全履歴にわたって計算されます — チャートは 値範囲に自動ズームします。最後の Loss 値はチャートの右上にあります。履歴自体は 各トレーニング Tick (通常 100 反復ごと) でアプリ状態に構築されます。

場所

Info Panel 内、右カラムの下部、トレーニング中かつ初心者モードでのみ表示。

技術詳細

目アイコンと Caption テキスト「Switch to Expert Mode (⌘2) for live splat preview」を持つ小さな行、控えめなトーンと 10 ポイントフォントで。インタラクティブ 要素ではなく、単なるヒント。クリックに反応しません — ユーザーは実際に Cmd+2 を 押すか、メニュー Mode → Expert Mode をクリックする必要があります。

場所

プレビューステップのフルスクリーン背景。

技術詳細

完成した点群をレンダリングする Metal ベースの 3D Viewport。レンダラーは Popping/Flickering 用の RadianceKit Fix を持つ vendored MetalSplatter Fork です。 Order-Independent Transparency を持つタイルベースのレンダリングパイプライン。 レンダラーが初期化できない場合 (例えば Metal がシステムで利用できない)、代わりに 「Metal not available」テキスト付きの黒い背景が表示されます。ビューは Safe Area を 無視するため、モデルはウィンドウ端に達します。

場所

Viewport の上、フローティング。

技術詳細

Auto Rotation (Turntable)、Reset Camera、Background 選択 (Gray/Black/White)、 Save Screenshot、Toggle Info Panel 用のボタンを持つコンパクト UI オーバーレイ。 カメラパラメータ (距離、Azimuth、Elevation、Target、FOV) にバインドし、Auto Turntable を 制御します。トレーニング中 (ユーザーが Expert モードで Viewport が実行されるのを 見たい場合)、オーバーレイはさらにコンパクトなトレーニングステータス行を表示します。

場所

Z3 の下部ナビゲーションバー。

技術詳細

ラベル「Export」と Share アイコン付き Accent Button。クリックは Z4 への 切り替えをトリガーします。事前に、親ビューはフルバージョンがアンロックされているかを チェックします — そうでない場合、Export ステージの代わりにロックビューが 表示されます (U-06 参照)。

場所

Export ステップの左メインページ。

技術詳細

2 つの柔軟なカラムと 12 ポイント間隔のカードラスター。初心者モードで 提供される形式を反復処理 — 最も重要な 6 形式のみを含むフル形式リストの フィルタリングされたサブセット: PLY、SPZ、glTF、.splat、Orbit Video、Web Viewer。 Compressed PLY と SOG は Expert モードでのみ提供されます。

場所

グリッド内の各カード。

技術詳細

カードレイアウト付きのシンプルなボタン: アイコン (例えば PLY 用 Document Zipper、SPZ 用 Archive Box、Orbit Video 用 Video アイコン) が上、Format Name が Headline、Description Caption (2 行切り詰め)、下に推定ファイルサイズ (形式、 Gaussian カウント、SH Degree からライブ計算され、KB/MB としてフォーマット)。 クリックで形式が選択されます。選択されたカードは Accent 背景、Accent Border、 右上にチェックマークアイコンを取得します。ツールチップは Format Description です。

場所

形式グリッドの下、ビデオ形式が選択されている場合のみ表示 (Orbit Video または Social Video)。

技術詳細

3〜30 秒のスライダー、1 秒ステップ、アプリ状態のビデオ長にバインド。最大 幅 300 ピクセル。ビデオ形式が選択されている場合のみ表示。非ビデオ形式では、 スライダーはビューから完全に削除されます — デッドスペースなし。

場所

形式グリッドの下 (およびビデオが選択されている場合は Duration スライダーの下)。

技術詳細

大きな Accent Button。ラベル: 「Export {Format-Name}」、Share アイコン。 クリックで、形式に適した拡張子と Default ファイル名「scene.{ext}」を持つ macOS 保存ダイアログが開きます。確認で、エクスポートが選択された URL に書き込まれます。 トレーニング結果がない、またはエクスポートがすでに実行中の場合は無効。

場所

Export ボタンの下、エクスポートが実行されている間のみ表示。

技術詳細

最大幅 300 ピクセルの進捗表示、下に Caption「Exporting… N%」。値は 0 から 1 まで実行され、書き込み中に更新されます — PLY では 10 000 Gaussian のチャンクで、 SPZ では量子化後に 1 回、Orbit Video ではフレーム間隔で。

場所

Progress Bar の下、最後のエクスポートでエラーが発生した場合のみ表示。

技術詳細

Warning アイコンとエラーテキスト付き赤い行。赤の 8% 背景 Opacity、角丸。 最大幅 400 ピクセル。一般的なエラー原因: SOG はシステム PATH に cwebp を期待 (App Store 準拠ではない)。フルディスクスペースでの書き込みエラー。許可された 領域外の保存ターゲットでの Sandbox エラー。

場所

Export ステップの右側。

技術詳細

Export 履歴のリスト (UserDefaults に JSON として永続的に保存、各成功した エクスポート後に保守)。各行は Format Badge (小さい、Accent 色)、Timestamp (HH:mm)、ファイル名 (1 行切り詰め)、フォーマットされたファイルサイズを表示します。 行をクリックすると、選択されたファイルで Finder を開きます。Empty State: 「No exports yet」。

場所

History 行への右クリック。

技術詳細

各リストエントリのコンテキストメニュー、2 つのアクション付き: 「Reveal in Finder」(シンプルクリックのように、選択されたファイルで Finder を開く) と 「Copy Path」(完全なファイルパスをテキストとしてクリップボードに配置)。後者は、 他のアプリへの Drag and Drop やコマンドラインへの転送に便利です。