gaussian_splat.hpp

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Povl Filip Sonne-Frederiksen
//
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
// PLY header inspection for INRIA-format 3D Gaussian Splatting files (#322).
//
// A trained splat is opaque bytes to everything downstream — `ProjectDB`
// stores it, the GUI streams it, the browser renders it — but *something* has
// to establish that the bytes really are a splat before any of that happens.
// A point cloud written by `rux export ply` is a perfectly valid PLY, and
// handing one to a splat renderer produces an empty viewport and no clue why.
//
// This header is that check, and it lives in `core` (not in the app or in
// `gsplat`) because `ProjectDB::save_gaussian_splat()` is the choke point: the
// file is validated on the way *into* the project, so a stored splat is a
// splat by construction and no reader has to re-litigate it.
//
// Deliberately dependency-free: no PCL, no OpenCV, no sqlite. Just the ASCII
// header at the front of the file.
 
#include <cstddef>
#include <cstdint>
#include <string_view>
 
namespace reusex::core {

struct GaussianSplatHeader {
  std::uint64_t gaussian_count = 0;
  int sh_degree = 0;
};

inline constexpr std::size_t kGaussianSplatHeaderProbeBytes = 64 * 1024;

GaussianSplatHeader parse_gaussian_splat_ply_header(std::string_view head);
 
} // namespace reusex::core