tile_index.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
 
// Spatial tile index for Morton-ordered clouds (#395, #396).
//
// The index is a blob stored beside a `morton_10bit_bitrev` cloud with
// ProjectDB::save_tile_index(). The web API (ruxd's api/point_lod) reads it to
// stream a cloud tile by tile. It is BUILT here, by the clouds stage, so every
// path that runs that stage — `rux create clouds`, the GUI's POST /jobs, any
// pipeline::run_stage caller — leaves the same index behind.
 
#include <reusex/core/ProjectDB.hpp>
 
#include <cstdint>
#include <string_view>
#include <utility>
#include <vector>
 
namespace reusex::pipeline {

inline constexpr uint32_t kTileIndexMagic = 0x52555854u; // 'RUXT'

inline constexpr std::string_view kMortonStorageOrder = "morton_10bit_bitrev";

struct TileIndexHeader {
  uint32_t magic;
  uint32_t version;   
  uint32_t tile_bits; 
  uint32_t point_count;
  float lo[3]; 
  float hi[3]; 
};

struct TileInfo {
  float min[3];
  float max[3];
  uint32_t count;
};

uint32_t morton_tile_sort_key(float x, float y, float z, const float lo[3],
                              const float range[3]);

std::vector<uint8_t> compute_tile_index(const ProjectDB &db,
                                        std::string_view name,
                                        uint32_t tile_bits = 6);

std::pair<TileIndexHeader, std::vector<TileInfo>>
parse_tile_index(const std::vector<uint8_t> &blob);

std::size_t build_tile_index(ProjectDB &db, std::string_view name);
 
} // namespace reusex::pipeline