Files
aevolution/include/evo/client/application.hpp
T
dingoandClaude Opus 5.5 897055883a Add M9.8c launcher, legend, labelled inspector and click selection
Toolkit-independent launcher, selection, label and outcome-log models with
bounded inputs and fixed error text; Dear ImGui overlay in the native adapter
with toolkit-first event routing and capture; engineering panels for fixture vs
dev region, legend, inspector, session outcomes, notices and dialog. Additive
SessionClient::unreachable_attempts() bounds unreachable connects. Docs, CI
targets and validation evidence updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 10:09:11 -04:00

70 lines
2.7 KiB
C++

#pragma once
#include "evo/client/input.hpp"
#include "evo/render/frame.hpp"
#include <cstdint>
#include <expected>
#include <functional>
#include <memory>
#include <string>
namespace evo::client {
enum class Error : std::uint8_t {
invalid_config,
already_open,
initialization,
window,
renderer,
surface,
draw,
device_lost
};
enum class Step : std::uint8_t { rendered, paused, closed };
struct Config {
int width{960}, height{640};
bool hidden{false};
std::string renderer; // Empty selects SDL's supported default; explicit names must succeed.
};
struct WindowState {
int logical_width{}, logical_height{}, pixel_width{}, pixel_height{};
float content_scale{1};
bool focused{}, minimized{}, hidden{}, closed{}, failed{};
[[nodiscard]] bool accepts_input() const noexcept {
return focused && !minimized && !hidden && !closed && !failed && logical_width > 0 &&
logical_height > 0 && pixel_width > 0 && pixel_height > 0;
}
};
// Engineering UI callback, run once per rendered frame on the main thread after the
// immutable frame is drawn. It may call the private toolkit (ADR-0084); no toolkit
// type appears in this header.
using Overlay = std::function<void()>;
// One owner, process main thread only (including destruction). No SDL owner may coexist.
class Application {
public:
[[nodiscard]] static std::expected<std::unique_ptr<Application>, Error>
open(const Config& config);
~Application();
Application(const Application&) = delete;
Application& operator=(const Application&) = delete;
[[nodiscard]] WindowState state() const noexcept;
[[nodiscard]] std::expected<void, Error> poll_events();
[[nodiscard]] std::expected<Step, Error> present(const render::Frame& frame);
// External modal/widget capture cannot be disabled by the legacy Tab toggle.
void set_ui_capture(bool captured) noexcept;
[[nodiscard]] bool ui_captured() const noexcept;
void set_overlay(Overlay overlay);
// The toolkit held the pointer during the last poll (no world click, pan or zoom).
[[nodiscard]] bool ui_wants_pointer() const noexcept;
// Engineering visual review: the next rendered frame is saved as a BMP file.
[[nodiscard]] bool request_screenshot(std::string path);
[[nodiscard]] Navigation take_navigation() noexcept;
[[nodiscard]] std::expected<Intention, InputError> sample_intention(std::uint64_t tick);
// Borrows the immutable frame for this call only. Errors latch until destruction.
[[nodiscard]] std::expected<Step, Error> step(const render::Frame& frame);
private:
struct Impl;
explicit Application(std::unique_ptr<Impl> impl);
std::unique_ptr<Impl> impl_;
};
} // namespace evo::client