point_lod.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
 
// Voxel LOD for `GET /api/v1/clouds/{name}/points?max_points=N` (#320).
//
// Paging answers "the first N points of this cloud". A viewport wants "all of
// this cloud, coarsely" — those are different questions, and this file answers
// the second one. The rationale, the alternatives that were rejected, and the
// forward path to a precomputed progressive ordering are in
// docs/gui/binary-points.md § "Level of detail".
//
// Deliberately framework-free, like gui/binary_points.hpp: a ProjectDB and a
// budget in, a page of storage records out. The HTTP layer (gui/api.cpp) turns
// that page into RUXP or JSON with the same encoders a paged read uses.
 
// ProjectDB is included rather than forward-declared: this header returns the
// nested ProjectDB::CloudPage by value, which needs the complete class.
#include <reusex/core/ProjectDB.hpp>
 
#include <cstdint>
#include <string_view>
#include <vector>
 
namespace rux::gui {

inline constexpr uint64_t kLodStreamChunk = 262144;

struct LodSelection {
  reusex::ProjectDB::CloudPage page;

  std::vector<uint64_t> indices;

  bool subsampled = false;

  double voxel_size = 0.0;

  uint64_t skipped_non_finite = 0;
};

bool lod_supports(std::string_view point_type);

LodSelection voxel_lod(const reusex::ProjectDB &db, std::string_view name,
                       uint64_t max_points);

reusex::ProjectDB::CloudPage
gather_points(const reusex::ProjectDB &db, std::string_view name,
              const std::vector<uint64_t> &indices);
 
} // namespace rux::gui