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>
70 lines
2.7 KiB
C++
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
|