#pragma once #include "evo/world/fields.hpp" #include #include #include #include #include #include #include #include namespace evo::world { inline constexpr std::size_t max_environment_footprint = 256; inline constexpr std::uint32_t all_environment_fields = (1U << field_count) - 1; struct EnvironmentMass { accounting::Femtograms amount; MassConcentration concentration; auto operator<=>(const EnvironmentMass&) const = default; }; using EnvironmentQuantity = std::variant; enum class MoistureStatus : std::uint8_t { not_requested, missing_water, zero_capacity, available }; struct EnvironmentSample { VoxelAddress voxel; ChunkAddress chunk; std::uint64_t chunk_revision; FieldSite habitat; CellSample terrain; HabitatMeasure measure; accounting::Femtograms water_capacity; std::array, field_count> fields{}; MoistureStatus moisture_status{MoistureStatus::not_requested}; std::optional moisture; }; enum class EnvironmentError : std::uint8_t { invalid_request, invalid_voxel, missing_site, missing_chunk, source_error, wrong_owner, stale_tick, stale_fields, stale_terrain, invalid_view }; class EnvironmentView; [[nodiscard]] std::expected query_environment(const FieldStore& fields, const ChunkStore& terrain, std::uint64_t tick, std::span footprint, std::uint32_t requested_mask); [[nodiscard]] std::expected validate_environment(const EnvironmentView& view, const FieldStore& fields, const ChunkStore& terrain, std::uint64_t current_tick) noexcept; // Owned immutable samples, non-owning store identities. Stores must outlive validation. // Moved-from views may only be reassigned or destroyed. No concurrent store mutation. class EnvironmentView { public: EnvironmentView(const EnvironmentView&) = default; EnvironmentView& operator=(const EnvironmentView&) = default; EnvironmentView(EnvironmentView&&) noexcept = default; EnvironmentView& operator=(EnvironmentView&&) noexcept = default; [[nodiscard]] std::span samples() const noexcept { return samples_; } [[nodiscard]] WorldIdentity identity() const noexcept { return identity_; } [[nodiscard]] std::uint64_t tick() const noexcept { return tick_; } [[nodiscard]] std::uint64_t field_revision() const noexcept { return field_revision_; } [[nodiscard]] std::uint32_t requested_mask() const noexcept { return mask_; } [[nodiscard]] SignedMillimetres terrain_pitch() const noexcept { return {cell_pitch_mm}; } private: friend class EnvironmentalTransfers; friend std::expected query_environment(const FieldStore&, const ChunkStore&, std::uint64_t, std::span, std::uint32_t); friend std::expected validate_environment(const EnvironmentView&, const FieldStore&, const ChunkStore&, std::uint64_t) noexcept; EnvironmentView(const FieldStore& fields, const ChunkStore& terrain, std::uint64_t tick, std::uint32_t mask) : fields_{&fields}, terrain_{&terrain}, identity_{fields.identity()}, tick_{tick}, field_revision_{fields.last_command()}, mask_{mask} {} const FieldStore* fields_; const ChunkStore* terrain_; WorldIdentity identity_; std::uint64_t tick_, field_revision_; std::uint32_t mask_; std::vector samples_; std::vector terrain_tokens_; }; } // namespace evo::world