10장 — 초보자 모드

위치

창 상단 바에서, 모드 전환기 왼쪽. 초보자 모드에서만 표시된다.

기술적 설명

파이프라인의 여섯 단계를 아이콘과 이름이 있는 버튼이 연결된 체인 형태로 보여주며, 화살표 기호로 구분된다: Import → Frame Quality → Cameras → Training → Preview → Export. 현재 단계는 완전히 색이 채워지고, 이미 지나간 단계는 반투명하게, 아직 도달하지 않은 단계는 회색으로 표시된다. 이미 완료된 단계는 클릭 가능하며 클릭하면 뒤로 돌아간다. 현재 단계와 아직 도달하지 않은 모든 단계는 비활성화되며, 처리가 진행되는 동안에는 체인 전체가 비활성화된다. 파이프라인 전체에 걸친 연속적인 퍼센트 진행률 바는 더 이상 존재하지 않는다 — 현재 진행 중인 단계의 진행률은 처리 화면(C-19)의 큰 원으로 표시된다.

위치

Import 단계의 왼쪽, 아이콘이 있는 큰 점선 사각형. 초보자 모드에서는 "Drop photos or a video here" 라벨과 함께 표시된다.

기술적 설명

드래그 항목이 영역 위에 있으면 아이콘을 잠깐 튀어오르게 하고 배경색을 바꾸는 드롭 영역. JPG, PNG, TIFF, HEIC, MP4, MOV, PLY, SPZ, .splat, .radiancescene 번들 및 디렉터리를 허용한다. 유형별 드롭 라우팅: 이미지는 모아서 정렬된 상태로 전달되고, 비디오는 프레임 샘플링 경로를 트리거하며, Splat 파일은 바로 미리보기를 열고, Scene 번들은 로드된다. 디렉터리는 열거되어 포함된 모든 이미지가 임포트된다. 샌드박스 호환 접근을 위한 Security-scoped Bookmarks는 올바르게 획득되고 해제된다. 지원되지 않는 확장자는 5초 동안 경고 배너로 표시된다.

위치

드롭 영역 안, 눈에 띄는 버튼.

기술적 설명

다중 선택과 JPG, PNG, TIFF, MP4, MOV, 폴더, 그리고 앱 자체의 Scene 포맷을 지원하는 macOS 파일 대화상자를 여는 버튼. 결과 URL은 security-scoped이며, 드래그 앤 드롭과 동일한 임포트 경로를 통해 전달된다. 사용자가 폴더를 선택하면 재귀적으로 이미지를 열거한다.

위치

드롭 영역 안, 앱 번들에 샘플 씬이 포함되어 있고 아직 이미지/Splat이 임포트되지 않은 경우에만 표시됨.

기술적 설명

(a) 앱 번들에 sample-scene.splat, .spz 또는 .ply가 존재하고 (b) 아직 이미지/비디오가 임포트되지 않았고 포인트 클라우드도 없을 때만 나타난다. 클릭하면 완성된 포인트 클라우드(가장 작은 포맷을 우선함 — .splat ~3 MB, .spz ~1.4 MB, 폴백 .ply)를 로드하고 400ms 후 미학적으로 적절한 시작 관점을 위해 꽃 씬의 원본 메타데이터에서 가져온 하드코딩된 카메라 값을 설정한다.

위치

"Try Sample Scene" 옆, 드롭 영역 안; 동일한 표시 조건.

기술적 설명

RadianceKit이 제공하는 예시 세트를 인터넷에서 다운로드한다: 약 427 MB에 달하는 960개의 전체 해상도 프레임으로, 이후 압축이 해제되어 바로 앱으로 가져와진다. 다른 처리가 진행 중인 동안에는 버튼이 비활성화되고 다운로드가 시작되지 않는다. 다운로드 진행률은 화면에 퍼센트로 표시되지 않는다; 다운로드가 완료되었는지는 오른쪽 이미지 목록이 960개의 프레임으로 채워지는 것을 보고 알 수 있다.

위치

Import 오버레이의 하단 플로팅 툴바, 시작 버튼 왼쪽.

기술적 설명

"Quality" 라벨이 있는 메뉴 선택기로, 제공된 프리셋을 카테고리별로 네 개의 섹션으로 그룹화한다: "Classic", "MCMC (fewer Gaussians, slower)", "Hybrid (sharp detail, compact)", "Capture — curated real-world (Drone / 360° / Photo)". 다섯 번째 섹션 "Custom"은 정식 버전이 잠금 해제되고 최소 하나의 사용자 프리셋이 저장되면 추가된다. 잠금 상태: 사용자가 정식 버전을 소유하지 않은 경우 Quick과 Preview를 제외한 모든 프리셋에는 이름 뒤에 "🔒" 접미사가 붙는다; 선택 시 선택기는 Preview로 되돌아가고 자동으로 구매 창이 열린다. 선택하면 프리셋이 적용되어 전체 학습 설정이 대체된다.

위치

Import 오버레이의 하단 플로팅 툴바, 프리셋 선택기 오른쪽.

기술적 설명

이미지도 비디오도 임포트되지 않은 동안에는 회색으로 남아있는 버튼. 클릭하면 파이프라인이 시작되고 단계 머신이 Frame-Quality → SfM → Training 순서로 전환된다. 버튼 자체에는 추가 상태가 없다; 진행 중인 처리는 별도의 처리 화면으로 나타난다.

위치

오른쪽 이미지 목록, 이미지 대신 비디오가 임포트된 경우에만 표시됨.

기술적 설명

0.5fps – 30fps, 0.5 단위 슬라이더. 값이 바뀌면 프레임 밀도가 업데이트되고, 밀도와 비디오 길이로부터 목표 프레임 수(최소 10)가 추가로 계산된다. 슬라이더는 이미지 목록 밖에 있는데, 목록 항목이 슬라이더의 마우스 이벤트를 가로챌 수 있기 때문이다. 슬라이더 아래에는 계산된 목표 프레임 수("247 frames")와 비디오 길이 ("1m23s video")가 표시된다. 툴팁 경고: "Doubling the density doubles the number of frames and increases SfM time by ~100%."

위치

오른쪽 이미지 목록, 오른쪽 아래; 이미지가 임포트된 경우에만 표시됨.

기술적 설명

빨간색 버튼. 클릭하면 제목이 "Clear all imported files?"이고 메시지가 "N images will be removed."인 확인 대화상자가 열린다. 확인하면 임포트된 모든 이미지/비디오, 스테이징 디렉터리, 포인트 클라우드, 학습 상태, SfM 결과 및 모든 캐시가 지워지고, 단계는 Import로 되돌아간다. Cancel을 누르면 모든 것이 유지된다. 대화상자는 파괴적이지 않은 경로가 기본값으로 설정되어 있다 (파괴적인 버튼은 빨간색으로 표시).

위치

오른쪽 이미지 목록, 각 항목.

기술적 설명

스와이프-삭제가 가능한 임포트된 이미지 목록. 이미지마다 아이콘, 파일명, 해상도("1920 × 1080"), 파일 크기 (KB/MB로 포맷됨)가 있는 한 줄. 해상도는 화면이 멈추지 않도록 이미지 헤더로부터 비동기적으로 채워지는 메타데이터 캐시에서 가져온다. 삭제는 macOS의 전형적인 스와이프-삭제(트랙패드에서 한 줄을 왼쪽으로 스와이프)로 이루어진다; 목록에는 행 선택이 없으므로 여기서는 키보드 삭제도 없다. 참고: 명시적인 마이너스 버튼, 백스페이스, 되돌리기용 Cmd-Z가 있는 확장된 이미지 삭제 경로는 Expert 모드에서만 Project Navigator에 추가되었다 — 초보자 모드에서는 스와이프-삭제만 있다.

위치

이미지 목록 아래, Clear-All 버튼 위.

기술적 설명

임포트된 이미지 수를 기준으로 한 세 개의 연속적인 임계값(이미지가 존재하고 비디오가 없을 때만 활성화): - 3장 미만: 빨간색 배너(빨간 팔각형), 텍스트 "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장: 주황색 배너(경고 삼각형), 텍스트 "Workable, but quality usually improves with 20+ images and good coverage around the scene."

20장부터는 배너가 사라진다. 임계값은 하드코딩되어 있으며 560건 이상의 경험적 학습 실험에 기반한다.

위치

폴더를 드롭할 때 — 눈에 보이는 버튼이 아니라 감지 로직임.

기술적 설명

디렉터리를 드롭하면, 그 안에 세 가지 정식 Workspace 레이아웃 중 하나가 있는지 확인한다: sparse/0/cameras.bin, sparse/cameras.bin, 또는 루트에 바로 있는 cameras.bin. 해당하면 기본 이미지 열거가 중단되고 대신 모달 경고창이 열려, 사용자에게 기존 재구성을 사용할지 아니면 이미지를 다시 Apple Photogrammetry로 처리할지 묻는다. 동일한 경로가 텍스트 포맷 Workspace(cameras.txt)와 ETH3D 익스포트에도 적용된다. 자세한 내용은 9장 Backend Q6 참고. 초보자 모드에서든 Expert 모드에서든 동일하게 작동한다.

위치

진행 원 뒤에 전체 화면을 채우는 배경으로, 취소 또는 오류 시 숨겨짐.

기술적 설명

파이프라인 진행 상태(0…1)에 따라 점점 늘어나는 개수의 작은 애니메이션 splat 파티클을 렌더링하는 장식용 애니메이션. 소스는 SfM 단계를 0–0.2에, 트레이닝을 0.2–1.0(프레임 품질은 0–0.05)에 매핑한 계산된 진행 값입니다. 이를 통해 트레이닝이 진행되는 동안 splat이 눈에 보이게 「쌓여」갑니다. 순전히 장식용일 뿐 — 이 표시는 현재 트레이닝의 실제 중간 결과를 보여주지 않습니다(그것은 Expert 모드의 Live-Preview에 해당). 취소나 실패 시 숨겨지고 상태 원만 표시된 채로 남습니다.

위치

처리 화면 가운데, 220 × 220 픽셀.

기술적 설명

겹쳐서 렌더링되는 두 개의 링: 바깥쪽은 흐릿한 트랙 링, 안쪽은 강조색 또는 빨간색 스트로크(오류 시 빨간색)의 채워진 진행 링. 이 링은 진행 중인 단계의 실제 진행 상황을 직접 따라갑니다 (짧은 페이드인/아웃 애니메이션을 통해 부드럽게), 이렇게 하면 Expert 모드의 진행 바와 표시가 일치하게 됩니다. 원 안에는 단계 아이콘(트레이닝의 경우 뇌, SfM의 경우 카메라, 비디오 프레임 추출의 경우 필름, 프레임 품질 검사의 경우 스파클, 360° 소재 언래핑의 경우 지구본), 단계 제목, 진행 숫자가 표시됩니다. 이 숫자는 트레이닝 중에는 반복 횟수 카운터(「12,500/20,000」)이고, 다른 모든 단계에서는 퍼센트 숫자입니다. 처리가 활성 상태인 동안 아이콘은 부드럽게 맥동합니다. 오류 발생 시 제목이 실패한 단계로 바뀌고(「Structure from Motion Failed」, 「Training Failed」), 링과 숫자는 빨간색이 됩니다. 취소 후에는 원이 대신 「Cancelled!」와 함께 주황색 십자를 표시합니다.

위치

처리 화면 왼쪽 위, 32 × 32 픽셀.

기술적 설명

Material 배경을 가진 단순한 버튼. 정보 패널을 켜거나 끕니다. 활성화 시 아이콘이 정보 원 아웃라인과 정보 원 채움 사이를 전환합니다. 부드러운 페이드인 애니메이션. 툴팁에는 「Show detailed processing metrics」.

위치

처리 화면 왼쪽 아래, 처리 상세정보가 표시되어 있을 때만 보임.

기술적 설명

Ultra-Thin-Material 배경을 가진 2단 패널. 왼쪽 열: 단계별 정보 행 — SfM의 경우 상태 텍스트와 퍼센트; 트레이닝의 경우 반복 횟수, 결합 Loss, L1-Loss, D-SSIM-Loss, Gaussian 개수(주황색으로 표시), 속도(it/s), 경과 시간, 계산된 ETA, SH-Degree, Learning-Rate. 오른쪽 열: 상태 텍스트, 시간 정보 문자열, 인라인 Loss 차트(C-28 참조), Discoverability 넛지(C-32 참조). 모든 값은 트레이닝 틱마다 갱신되는 트레이닝 상태로부터 읽어옵니다.

위치

하단 내비게이션 바, 트레이닝 단계 중(SfM 중에는 표시 안 됨)에만, 그리고 처리가 진행되는 동안에만 표시.

기술적 설명

테두리 버튼(Bordered Button). 상태에 따라 일시정지 또는 재개를 호출합니다. 라벨은 「Pause」(일시정지 아이콘)와 「Resume」(재생 아이콘) 사이를 전환합니다. SfM 단계 중에는 이 버튼이 표시되지 않는데, Apple Photogrammetry에 일시정지 의미론이 없기 때문입니다. 일시정지 상태는 반복 횟수, Gaussian 상태, Optimizer Momentum을 완전히 보존합니다 — 재개하면 이전에 멈춘 지점부터 계속됩니다.

위치

하단 내비게이션 바, 처리가 진행되는 동안(SfM 또는 트레이닝) 표시.

기술적 설명

빨간색 테두리 버튼. 「Stop and discard progress?」 제목의 확인 대화 상자를 열며, 「Discard Progress」(파괴적) 버튼과 「Keep Running」(취소) 버튼이 있습니다. 확인하면 취소 플래그가 설정되고, 트레이닝 작업이 종료되며, 필요시 SfM 하위 프로세스가 종료되고, 취소 상태를 담은 요약 행이 JSONL 로그에 기록됩니다. 일시정지와 달리 트레이닝 버퍼와 상태는 폐기됩니다.

위치

하단 내비게이션 바, 파이프라인이 실패했을 때(SfM 상태가 「SfM failed」로 시작하거나 트레이닝이 오류 상태일 때) 표시.

기술적 설명

강조색 버튼. 전체 파이프라인을 재시작합니다. 시작 전에 임포트된 이미지/비디오가 여전히 존재하는지 확인합니다. 이전 오류 로그는 JSONL 디렉터리에 그대로 남고, 새 실행은 현재 타임스탬프로 새 로그 파일을 작성합니다.

위치

정보 패널 오른쪽 열, 트레이닝 중 히스토리가 비어있지 않을 때만 표시.

기술적 설명

작은 그리기 영역(높이 40 픽셀)으로, Loss 히스토리를 강조색 1픽셀 선으로 그립니다. 데이터는 유한한 값으로 필터링됩니다 (불안정한 트레이닝에 대한 NaN 보호). 최소/최대값은 전체 히스토리에 대해 계산됩니다 — 따라서 차트는 값 범위에 맞춰 자동으로 확대/축소됩니다. 마지막 Loss 값은 차트 위 오른쪽에 표시됩니다. 히스토리 자체는 트레이닝 틱마다(일반적으로 100번 반복마다) 앱 상태에 쌓입니다.

위치

정보 패널 오른쪽 열 아래, 트레이닝 중이면서 초보자 모드일 때만 표시.

기술적 설명

눈 아이콘과 「Switch to Expert Mode (⌘2) for live splat preview」캡션 텍스트가 있는 작은 행으로, 절제된 톤과 10포인트 글자 크기. 대화형 요소가 아니라 안내일 뿐입니다. 클릭에 반응하지 않습니다 — 사용자가 실제로 Cmd+2를 누르거나 Mode → Expert Mode 메뉴를 클릭해야 합니다.

위치

미리보기 단계의 전체 화면 배경.

기술적 설명

완성된 포인트 클라우드를 렌더링하는 Metal 기반 3D 뷰포트. 렌더러는 RadianceKit 자체의 ForwardPass 래스터라이저다 — 트레이닝 중에도 이미 스플랫을 렌더링하는 것과 동일한 렌더러이므로 — 진정한 WYSIWYG(학습되는 그대로 표시되고 내보내진다)이다. 타일 기반 렌더링 파이프라인이며 Order-Independent Transparency를 사용한다. 렌더러를 초기화할 수 없는 경우(예: 시스템에서 Metal을 사용할 수 없는 경우) 대신 „Metal not available" 텍스트가 있는 검은색 배경이 나타난다. 이 뷰는 Safe Area를 무시하므로 모델이 창 가장자리까지 채워진다.

위치

뷰포트 위에 떠 있음: 왼쪽 위에 두 개의 아이콘 버튼, 그 아래 왼쪽 아래에 정보 패널.

기술적 설명

오버레이는 정확히 두 개의 버튼으로 구성된다: „Scene Info"는 왼쪽 아래의 정보 패널을 켜고 끄며, 두 번째 버튼은 카메라 모드를 „Orbit"(목표 지점 주위를 도는 방식)과 „Fly-Through"(자유 비행)로 전환한다. 정보 패널에는 프레임 속도, Gaussian 개수, 카메라 모드, 시야각, 렌더 해상도, 샘플링이 표시된다. 트레이닝이 진행 중일 때는 트레이닝 상태 줄이 추가되고, 종료 후에는 완료 줄이 표시된다. 씬 로딩이 실패하거나 진행 중인 경우, 정보 스위치와는 별개로 독자적인 상태 줄이 표시된다. 자동 회전, 카메라 초기화, 배경색, 스크린샷은 오버레이 버튼이 아니라 „Viewport" 메뉴에 있는 항목들이다.

위치

Z3의 하단 내비게이션 바.

기술적 설명

„Export" 레이블과 공유 아이콘이 있는 강조(Accent) 버튼. 클릭하면 Z4로 전환된다. 그 전에 상위 뷰는 정식 버전이 잠금 해제되어 있는지 확인한다 — 그렇지 않은 경우 내보내기 화면 대신 잠금 화면이 표시된다(U-06 참조).

위치

Export 단계의 왼쪽 메인 영역.

기술적 설명

12포인트 간격을 둔 두 개의 유연한 열로 구성된 카드 그리드. 초심자 모드에서 제공되는 형식들을 순회한다 — 전체 형식 목록 중 가장 중요한 6가지 형식만 포함하는 필터링된 부분집합: PLY, SPZ, glTF, .splat, Orbit 비디오, 웹 뷰어. 나머지 형식은 Expert 모드에서만 제공된다.

위치

그리드 안의 각 카드.

기술적 설명

카드 레이아웃의 단순한 버튼: 상단에 아이콘(예: PLY는 문서-지퍼, SPZ는 아카이브 박스, Orbit 비디오는 비디오 아이콘), 헤드라인으로 형식 이름, 설명 캡션(2줄로 축약), 그 아래에 예상 파일 크기(형식, Gaussian 개수, SH 차수로부터 실시간 계산되어 KB/MB로 표기됨)가 있다. 클릭하면 해당 형식이 선택된다. 선택된 카드는 강조 배경, 강조 테두리, 오른쪽 위에 체크 아이콘을 받는다. 툴팁은 형식 설명이다.

위치

형식 그리드 아래, 비디오 형식(Orbit 비디오나 소셜 비디오)이 선택된 경우에만 표시된다.

기술적 설명

3–30초 범위를 1초 단위로 조절하는 슬라이더로, 앱 상태의 비디오 길이 값에 바인딩된다. 최대 너비 300픽셀. 비디오 형식이 선택된 경우에만 표시된다. 비디오가 아닌 형식에서는 슬라이더가 화면에서 완전히 제거된다 — 남는 공간 없이.

위치

형식 그리드 아래(비디오가 선택된 경우 Duration 슬라이더 아래).

기술적 설명

큰 강조 버튼. 라벨: "Export {형식 이름}", 공유 아이콘. 클릭하면 형식에 맞는 파일 확장자를 가진 macOS 저장 대화상자가 열린다. 제안되는 파일명은 현재 장면의 이름에서 가져온다. 이름이 설정되어 있지 않으면(예: 장면을 아직 한 번도 저장한 적이 없는 경우) "scene"으로 표시된다. 확인하면 선택한 위치에 내보내기가 기록된다. 학습 결과가 없거나 내보내기가 이미 진행 중이면 비활성화된다. 버튼 아래에는 결과 지표("2,991 Gaussians · SH degree 3")가 표시된다.

위치

Export 버튼 아래, 내보내기가 진행 중일 때만 표시된다.

기술적 설명

최대 너비 300픽셀의 진행 표시줄이며, 아래에 "Exporting… N %" 캡션이 붙는다. 값은 0에서 1까지 진행되며 쓰기 작업 중에 갱신된다 — PLY는 10,000 Gaussian 단위 청크로, SPZ는 양자화 이후 한 번에, Orbit 비디오는 프레임 간격 단위로 갱신된다.

위치

진행 표시줄 아래, 마지막 내보내기에서 오류가 발생했을 때만 표시된다.

기술적 설명

경고 삼각형과 "Export failed: …" 텍스트에 오류 설명이 붙은 빨간색 줄. 8 % 불투명도의 빨간 배경, 둥근 모서리. 최대 너비 400픽셀. 흔한 오류 원인: 디스크 공간 부족으로 인한 쓰기 오류; 허용 범위 밖의 저장 위치로 인한 샌드박스 오류.

위치

Export 단계의 오른쪽 영역.

기술적 설명

내보내기 히스토리를 보여주는 목록(앱 설정에 영구적으로 저장되며, 내보내기가 성공할 때마다 갱신된다). 각 줄에는 형식 배지(작고 강조색), 타임스탬프(HH:mm), 파일명(1줄 축약), 그리고 형식화된 파일 크기가 표시된다. 줄을 클릭하면 해당 파일이 선택된 상태로 Finder가 열린다. 빈 상태: "No exports yet".

위치

History 줄을 우클릭.

기술적 설명

목록의 각 항목에 대한 컨텍스트 메뉴로 두 가지 동작이 있다: "Reveal in Finder"(단순 클릭과 동일하게 선택된 파일이 표시된 상태로 Finder를 연다)와 "Copy Path"(전체 파일 경로를 텍스트로 클립보드에 복사한다). 후자는 다른 앱으로의 드래그 앤 드롭이나 커맨드라인에 전달할 때 유용하다.