Add OrganismPresentation cells derived via biology::derive_phenotype with no controller, owner or level fields (pinned by test), so identical biology renders identically for players and NPCs. OrganismLayer reuses the ADR-0080 ordering/freshness semantics; death is a remnant state and removal is absence. Rendering takes an explicit rectangle budget, falls back to body-only detail and marks truncation instead of dropping data. An opt-in rectangle-only hover inspector shows phenotype gauges; ImGui is not adopted. ADR-0081 records the decision; evidence in VALIDATION.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
82 lines
3.3 KiB
C++
82 lines
3.3 KiB
C++
#pragma once
|
|
#include "evo/biology/development.hpp"
|
|
#include "evo/client/environment_view.hpp"
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
#include <expected>
|
|
#include <optional>
|
|
#include <span>
|
|
#include <vector>
|
|
|
|
namespace evo::client {
|
|
inline constexpr std::size_t max_organism_cells = 1024;
|
|
// Authority revision an organism presentation was copied from (e.g. a community
|
|
// command watermark). Not a capability or session grant.
|
|
struct OrganismRevision {
|
|
world::WorldIdentity identity;
|
|
std::uint64_t tick{}, revision{};
|
|
auto operator<=>(const OrganismRevision&) const = default;
|
|
};
|
|
// Dead organisms remain as remnants until their terminal inventory is gone; removal
|
|
// is absence from a later presentation, never a state.
|
|
enum class OrganismState : std::uint8_t { alive, dead };
|
|
// Copied presentation values. Deliberately has no controller, owner, account,
|
|
// player/NPC, level or name field: every organism is presented by biology alone.
|
|
struct OrganismCell {
|
|
std::uint64_t id{}; // Opaque stable draw-order key; never displayed.
|
|
world::VoxelAddress voxel;
|
|
world::Micrometres x, y; // Centre offset inside the voxel, each in [0, 1e6).
|
|
biology::Phenotype phenotype;
|
|
biology::GrowthState growth;
|
|
OrganismState state{OrganismState::alive};
|
|
};
|
|
// Immutable owned copy of up to 1024 organisms in one Z slice; may be empty.
|
|
class OrganismPresentation {
|
|
public:
|
|
[[nodiscard]] static std::expected<OrganismPresentation, ViewError>
|
|
create(OrganismRevision revision, std::int64_t slice_z, std::span<const OrganismCell> cells);
|
|
[[nodiscard]] OrganismRevision revision() const noexcept {
|
|
return revision_;
|
|
}
|
|
[[nodiscard]] std::int64_t slice_z() const noexcept {
|
|
return slice_z_;
|
|
}
|
|
// Strictly ascending by id, which is also draw order.
|
|
[[nodiscard]] std::span<const OrganismCell> cells() const noexcept {
|
|
return cells_;
|
|
}
|
|
|
|
private:
|
|
OrganismPresentation(OrganismRevision revision, std::int64_t z,
|
|
std::span<const OrganismCell> cells)
|
|
: revision_{revision}, slice_z_{z}, cells_(cells.begin(), cells.end()) {}
|
|
OrganismRevision revision_;
|
|
std::int64_t slice_z_;
|
|
std::vector<OrganismCell> cells_;
|
|
};
|
|
// Derives the phenotype with the M3 contract; visual parameters never come from
|
|
// anything but the genome, growth state and environment supplied here.
|
|
[[nodiscard]] std::expected<OrganismCell, ViewError>
|
|
present_organism(std::uint64_t id, world::VoxelAddress voxel, world::Micrometres x,
|
|
world::Micrometres y, const biology::Genome& genome, biology::GrowthState growth,
|
|
const biology::EnvironmentState& environment, OrganismState state);
|
|
|
|
// Same ordering/freshness semantics as EnvironmentLayer (ADR-0080), without chunks.
|
|
class OrganismLayer {
|
|
public:
|
|
[[nodiscard]] std::expected<void, ViewError> accept(OrganismPresentation next);
|
|
[[nodiscard]] std::expected<void, ViewError> observe(OrganismRevision latest);
|
|
void mark_stale() noexcept;
|
|
void reset() noexcept;
|
|
[[nodiscard]] const OrganismPresentation* current() const noexcept {
|
|
return current_ ? &*current_ : nullptr;
|
|
}
|
|
[[nodiscard]] Freshness freshness() const noexcept;
|
|
|
|
private:
|
|
std::optional<OrganismPresentation> current_;
|
|
std::optional<OrganismRevision> latest_;
|
|
bool stale_{};
|
|
};
|
|
} // namespace evo::client
|