Kapitel 8 — Eksportformater

HVOR

Menulinje → Export → 3D Formats → Export PLY… (⌘E). Simple-tilstand: wizard-trinnet Export → formatkortet „PLY". Størrelse: typisk 100 % (referenceværdi). Kompatibel med: SuperSplat, PolyCam, alle 3DGS-viewere.

TEKNISK

PLY er det kanoniske lagringsformat for 3D Gaussian Splatting. RadianceKit skriver en binær little-endian-fil med det standardiserede 3DGS-property-layout: pr. gausser en tre-komponent position, tre normaler der altid er sat til nul, tre DC-SH-koefficienter (f_dc_0..2) til basis-RGB-farven, efterfulgt af op til 45 yderligere SH-koefficienter (f_rest_0..44) i den transponerede channel-major-ordning defineret i Kerbl-2023-papiret (først alle R-kanal-koefficienter, så alle G, så alle B), efterfulgt af logit-opacitet (rå pre-sigmoid-værdier), tre log-space-skalaer og en wxyz-kvaternion-rotation. Den maksimalt eksporterede SH-grad clampes til minimum af brugerens ønske og den faktisk lærte grad; standard er 3 (45 rest-koefficienter). Før skrivning beregnes payload-størrelsen som 64-bit-heltal for at fange overløb ved ekstremt store skyer. Filen skrives atomart, hvilket kortvarigt optager dobbelt diskplads ved store skyer.

HVOR

Menulinje → Export → 3D Formats → Export Compressed PLY…. Simple-tilstand: formatkortet „Compressed PLY". Størrelse: ca. 10–20 % i forhold til PLY (5- til 10-fold kompression). Kompatibel med: SuperSplat, PlayCanvas-engine, web-baserede viewere.

TEKNISK

PlayCanvas-varianten af PLY-formatet med chunked kvantisering. Gausserne grupperes i chunks à 256. Pr. chunk gemmes min/max-grænser for position, skala og farve separat i headeren; de enkelte gaussere refererer deres værdier relativt til disse grænser og komprimeres til 32 bit hver: position og skala med 11-10-11-bit-pakning, rotation som 2-10-10-10-bit „smallest-three"-kvaternion, farve som 8-8-8-8-RGBA. Højere SH-koefficienter kvantiseres med kun 8 bit pr. komponent (tre byte pr. koefficient og gausser). Selve formatet er stadig ASCII-header-PLY og dermed grundlæggende validérbart med PLY-værktøjer, men vertex-egenskaberne er deklareret som uint-felter. SH-grad er som standard 0 (ingen rest-koefficienter) for at maksimere kompressionen — højere SH-grader kan vælges eksplicit.

HVOR

Menulinje → Export → 3D Formats → Export SPZ…. Simple-tilstand: formatkortet „SPZ". Størrelse: ca. 10 % i forhold til PLY (90 % mindre). Kompatibel med: Niantic Scaniverse, Niantic Spatial Fields, MetalSplatter.

TEKNISK

Niantics SPZ-v2-format. Positioner pakkes som 24-bit fixed-point (det giver ca. 0,25 mm opløsning), skalaer som 8-bit kvantisering i log-rummet, rotationer som 8-bit smallest-three (i v2 gemmes kun xyz, w udledes af decoderen fra kvaternion-normen), opaciteter som sigmoidiserede 8-bit-værdier. DC-SH gemmes med en SPZ-specifik pakningsformel (dc_raw * 0.15 * 255 + 0.5 * 255), højere SH-bånd med 5 bit (bånd 1) hhv. 4 bit (bånd 2-3) pr. koefficient. Hele den pakkede binærblob komprimeres derefter med standard-gzip (RFC 1952), hvilket giver et gzippet container-format med magic bytes 1f 8b. RadianceKit kalder her systemets gzip, fordi Apples indbyggede zlib-API genererer proprietær Apple-framing, som ikke ville være kompatibel med SPZ-readerne i Spatial Fields eller MetalSplatter. Systemets gzip kan stadig spawnes inden for macOS-sandboxen.

HVOR

Menulinje → Export → 3D Formats → Export SOG…. Simple-tilstand: formatkortet „SOG". Størrelse: ca. 5–6 % i forhold til PLY (15- til 20-fold kompression — den mindste mulighed). Kompatibel med: PlayCanvas-engine, SuperSplat-editor.

TEKNISK

„Spatially Ordered Gaussians" — et PlayCanvas-format, der gemmer skyen GPU-klar i flere lossless-WebP-billeder. Først sorteres alle gaussere rumligt via 3D-Morton-kode (30-bit Z-order, 10 bit pr. akse), hvilket giver billederne senere cache-locality i renderen. Så kvantiseres positioner med symmetrisk log-transformation (for bedre dynamikområde) til 16-bit-værdier og splittes i to RGBA-billeder (means_l.webp for de nedre 8 bit, means_u.webp for de øvre). Rotationer kodes som smallest-three med 3×8 bit plus 2-bit mode i et RGBA-billede (mode havner i alpha som 252 + largest). Skalaer og DC-SH kvantiseres med hver et 256-indgangs-codebook (percentilbaseret fordelt over alle værdier), indekserne havner i scales.webp og sh0.webp. De fem billeder plus en meta.json med codebooks og grænser pakkes i en ZIP-fil (custom encoder, fordi sandboxen blokerer systemets zip) og gemmes med endelsen .sog.

Bemærk sandbox: SOG er den eneste formatmulighed, der kræver en ekstern binary. WebP-encoder-trinnet kalder cwebp fra /usr/local/bin/cwebp eller /opt/homebrew/bin/cwebp. Hvis ingen cwebp-binary findes, falder koden tilbage til rå PNG-encoding — men: PNG-fallback fungerer ikke i SuperSplat. I App Store-versionen evalueres tilgængeligheden ud fra build-varianten; i developer-varianten skal cwebp installeres via Homebrew (brew install webp).

HVOR

Menulinje → Export → 3D Formats → Export glTF…. Simple-tilstand: formatkortet „glTF". Størrelse: sammenlignelig med PLY. Kompatibel med: glTF-viewere med KHR_gaussian_splatting-udvidelsen (Khronos-udkast-standard).

TEKNISK

Skriver en selvbærende .glb-binærfil (ingen separat bin-file-vedhæftning) i henhold til KHR_gaussian_splatting-udvidelsesspecifikationen. Positioner gemmes som almindelige glTF-POSITION-vertex-data (float3), alle andre attributter (rotation som float4, skala som float3, opacity som float, SH-koefficienter som float3 × shCoeffCount) ligger i yderligere vertex-attributter og refereres via udvidelsen. Vigtigt: glTF bruger et højrehåndet Y-up-koordinatsystem, COLMAP/3DGS arbejder med Y-down/Z-forward. Eksportøren anvender derfor en 180-graders rotation om X-aksen — positioner omskrives med (x, -y, -z), kvaternioner tilpasses til (w, x, -y, -z). Det giver en geometrisk korrekt, handet (ikke spejlvendt) fremstilling i glTF-viewere. JSON- og binærblokke paddes til 4-byte-alignment, som krævet af GLB-standarden.

HVOR

Menulinje → Export → 3D Formats → Export .splat…. Simple-tilstand: formatkortet „.splat". Størrelse: præcis 32 byte pr. gausser. Kompatibel med: gsplat.js, web-baserede viewere (antimatter15-referencen), de fleste browser-3DGS-demoer.

TEKNISK

Antimatter15-.splat-formatet — 32 byte pr. gausser, ingen header, ingen indirection. Layout pr. post: 3 × float32 position (verdenskoordinater), 3 × float32 skala (eksp-transformeret fra det interne buffers log-space), 4 × uint8 RGBA-farve (DC-SH-koefficient skaleret med SH_C0 = 0.282... og clampet til [0,255]), 4 × uint8 kvaternion (w,x,y,z, normaliseret og kodet som 128 + 128*q i byte-intervallet). Kun DC-SH gemmes — højere SH-bånd kasseres. Det gør formatet ekstremt kompakt, men koster de synsvinkelafhængige farveændringer, der optræder ved spejlinger eller spekulære highlights. Skriverækkefølgen er præcis indeks-rækkefølgen i skyen (ingen rumlig sortering), web-viewere som gsplat.js renderer ud fra det.

HVOR

Menulinje → Export → Media → Export Web Viewer…. Simple-tilstand: formatkortet „Web Viewer". Størrelse: splat-data base64-kodet (≈ 4/3 overhead) + ca. 5 KB HTML/JS-shell. Kompatibel med: enhver moderne browser med WebGL2 (alle desktops, iOS 15+, Android 5+).

TEKNISK

Samler den gaussiske sky sammen med en fuldt inline skrevet WebGL2-renderer i en enkelt .html-fil. Der er ingen CDN-afhængigheder, ingen WASM, ingen anden fil. Skyen kodes internt først som en .splat-binary (samme 32-byte-logik som E6), derefter base64-indlejres den, derefter afkodes den med atob i browseren. Den indbyggede renderer laver egen WebGL2-sortering, muse-orbit-styring og CPU-sortering pr. frame; al JS-koden (shaders, matematik, loop) er synlig i output-HTML'en. Aksekonventionen ved grænsen mellem lager og renderer er præcis den samme som i E5: position (x, -y, -z), kvaternion (w, x, -y, -z). Valgfrit kan et branding-overlay vises (free-tier-kontakt). Da alt er inline, fungerer filen også direkte via file://-protokollen — ingen lokal webserver nødvendig til test.

HVOR

Menulinje → Viewport → Record Turntable Video ELLER Menulinje → Export → Media → Export Orbit Video…. Simple-tilstand: formatkortet „Orbit Video" med varighedsslider 3–30 s. Størrelse: afhænger af varighed, opløsning, bitrate. Kompatibel med: alle platforme (H.264 og HEVC er Apple-standard).

TEKNISK

Renderer den gaussiske sky langs en parametrisk orbit-kamerakørsel og enkoder hvert frame via AVAssetWriter til en MP4- eller MOV-fil. Orbit-konfigurationen styrer omdrejningshastighed (omdrejninger), afstand, elevation, FOV, varighed og ease-in/out-faktor. Orbit-video-eksporten kører gennem RadianceKits EGEN render-stadie med fuld SH-evaluering — pixelidentisk med in-app-viewporten (WYSIWYG). Pr. frame ganges verdens-tilpasningsmatricen (beregnet af renderen for at rotere de interne koordinater ind i den Y-up-orienterede orbit-verden) med kameraet, hvorefter en kamera-konverteringsspejling (orbit-Y-up → COLMAP-Y-down) anvendes. Offscreen-render-målet trækkes via IOSurface til en CVPixelBuffer til encoderen. Encoderen understøtter H.264 og HEVC, konfigurerbar bitrate og opløsning fra 480p til 8K. Før det første frame venter renderen 200 ms, så den indledende splat-sortering er afsluttet. Denne eksport er GPU-bound — ved 8K og millioner gaussere ligger render-tiden pr. frame på flere sekunder, altså mulige samlede rendertider på 10–30 minutter for 6 s video.

HVOR

Menulinje → Export → Photogrammetry → Export SfM (transforms.json)…. Størrelse: typisk 1–10 KB (kun positurer + intrinsics, ingen billeder, ingen gaussere). Kompatibel med: nerfstudio, Brush, gsplat, OpenSplat, Meshroom, alle moderne feed-forward 3DGS-trænere.

TEKNISK

Skriver nerfstudio-transforms.json-formatet med en liste af kamerapositurer plus fælles intrinsics. Pr. kamera inverteres view-matricen (RadianceKit-internt: world-to-camera i COLMAP-konvention), derefter spejles de kameralokale Y- og Z-basisvektorer for at konvertere til nerfstudio-konventionen (OpenGL-stil, kameraet kigger langs -Z, +Y er op). Den endelige 4×4-matrix havner som row-major nested array af doubles i transform_matrix-feltet for hvert frame. Intrinsics gemmes på top-niveau (brændvidde x/y, hovedpunkt x/y, billedbredde/-højde, camera_model = "OPENCV", plus distortion-koefficienterne k1, k2, p1, p2) — undtagen når eksportøren opdager flere forskellige intrinsics-sæt, i så fald skrives de pr. frame. Billedstier skrives som images/<filename> relativt til JSON-filen; brugeren skal oprette en sibling-images/-mappe med træningsfotoene.

HVOR

Menulinje → Export → Photogrammetry → Export SfM (COLMAP Workspace)…. Størrelse: tre binærfiler tilsammen typisk 4–8 MB — points3D.bin dominerer (en linje pr. 3D-punkt i den sparse sky), images.bin og cameras.bin er hver især markant under 100 KB. Kompatibel med: COLMAP selv, Nerfstudio, Postshot, Meshroom, alle værktøjer, der forventer en COLMAP-sparse/-mappe.

TEKNISK

Skriver det standard COLMAP-sparse/0/-layout med tre binære filer: cameras.bin, images.bin, points3D.bin. Formatreferencen er den officielle COLMAP-dokumentation. cameras.bin indeholder den dedupliserede intrinsics-liste (kameraer med identiske intrinsics + billedstørrelse samles til én enkelt post); det anvendte kameramodel er OPENCV (model 4), med fx/fy/cx/cy plus de fire distortion-koefficienter k1/k2/p1/p2. images.bin viser pr. billede positurer som wxyz-kvaternion plus translation, efterfulgt af kamera-ID og filnavn; der gemmes ingen 2D-3D-korrespondancer. points3D.bin indeholder SfM-punktskyen med position, farve (0-255 RGB) og standardværdier for reprojektion og track-length. Alt skrives i little-endian. Genimport i RadianceKit fungerer via fil-menuen → „Import COLMAP/Metashape Workspace…" (se Q3 i SfM-backend-kapitlet).