Files
Dreierpack-Manager/src/ui/live_matchday.hpp
T
ClaudeandClaude Sonnet 5.5 287b5a9251 Add header comments to the source files
Every source file in ui, app, game, formats, cli, audio and launch that had none
now starts with a short English comment: what it implements, what state it owns
and how it relates to its neighbours (request/acknowledge flow, pairs of files,
random generator use). Comment lines only; the full build and the runnable
tests are unchanged.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-06 09:15:23 +01:00

149 lines
6.1 KiB
C++

// SPDX-License-Identifier: GPL-3.0-only
// Live matchday overview: all matches of the day with minute, scores, statistics, attendance and weather,
// plus chance, booking and shoot-out projections. LiveMatchdayFrame is an owned copy made synchronously from
// the engine's observation hook. LiveScoreReveal keeps preview scores until the result hook so simulation is
// not delayed. LiveMatchdayScreen renders frames. Implementation: live_matchday.cpp.
#pragma once
#include <filesystem>
#include <optional>
#include <array>
#include <string>
#include <string_view>
#include <vector>
#include "formats/font.hpp"
#include "formats/le.hpp"
#include "formats/palette.hpp"
#include "game/match_engine.hpp"
namespace bmh::ui {
struct LiveMatchRow {
std::string home;
std::string away;
int home_goals = 0;
int away_goals = 0;
bool score_known = false;
int home_team = -1;
int away_team = -1;
std::array<int, 4> home_stats{}; // SquadRange3 and three source event-log tag counts
std::array<int, 4> away_stats{};
uint32_t spectators = 0;
bool spectators_known = false;
bool attendance_at_capacity = false;
std::string spectators_text;
uint8_t rain = 0;
int8_t temperature = 0;
std::string temperature_text;
bool operator==(const LiveMatchRow&) const = default;
};
// Owned copy made synchronously from the engine's observation hook.
struct LiveMatchdayFrame {
int minute = 0;
std::string minute_text; // owned FormatNumber(0x81) text
bool gradient_text = true; // Source TextGradientDisabled; minute deliberately toggles the font mode
std::vector<LiveMatchRow> matches;
bool operator==(const LiveMatchdayFrame&) const = default;
};
LiveMatchdayFrame live_matchday_frame(int minute, const std::vector<MatchGroup>& groups,
const GameState& state);
// The engine commits a chance before its ball/set-piece/shot presentation. Keep
// the observed preview scores until the result hook, without delaying simulation.
class LiveScoreReveal {
public:
void observe(LiveChanceStage stage, const LiveMatchdayFrame& frame) {
if (stage == LiveChanceStage::preview) preview_ = frame;
else preview_.reset();
}
LiveMatchdayFrame project(LiveMatchdayFrame frame) const {
if (!preview_ || preview_->minute != frame.minute) return frame;
for (auto& row : frame.matches) for (const auto& before : preview_->matches)
if (row.home_team == before.home_team && row.away_team == before.away_team) {
row.home_goals = before.home_goals;
row.away_goals = before.away_goals;
row.score_known = before.score_known;
break;
}
return frame;
}
private:
std::optional<LiveMatchdayFrame> preview_;
};
struct LiveChanceProjection {
LiveChanceStage stage = LiveChanceStage::preview;
int minute = 0, group = 0, match = 0, side = 0;
std::string stadium, home, away, description, shooter_detail;
std::string outcome, participants, ticker_score;
bool ticker = false;
bool operator==(const LiveChanceProjection&) const = default;
};
LiveChanceProjection live_chance_projection(const LiveChanceEvent&,
const std::vector<MatchGroup>&, const GameState&, const LeImage&);
struct LiveBookingProjection {
LiveChanceProjection header;
int kind = 0, home_goals = 0, away_goals = 0;
bool score_known = false;
std::string message;
bool operator==(const LiveBookingProjection&) const = default;
};
LiveBookingProjection live_booking_projection(const LiveBookingEvent&,
const std::vector<MatchGroup>&, const GameState&, const LeImage&);
struct LiveShootoutProjection {
LiveChanceProjection header;
int home_goals = 0, away_goals = 0;
std::string message;
bool operator==(const LiveShootoutProjection&) const = default;
};
LiveShootoutProjection live_shootout_projection(const LiveShootoutEvent&,
const std::vector<MatchGroup>&, const GameState&, const LeImage&);
class LiveMatchdayScreen {
public:
explicit LiveMatchdayScreen(const std::filesystem::path& data);
Image render(const LiveMatchdayFrame& frame) const;
// BallFrameCount draws positions 0, +/-2, ... up to two pixels before
// the even target. Its last target step exits without another present.
static int ball_frame_count(int displacement);
Image render_ball(const LiveMatchdayFrame&, int displacement, int frame_index,
const LiveChanceProjection* chance = nullptr) const;
Image render_reality(const LiveMatchdayFrame&, const LiveChanceProjection&) const;
Image render_chance(const LiveMatchdayFrame&, const LiveChanceProjection&) const;
// The 18 Source frames, reconstructed once from an owned, already drawn shot.
std::array<Image, 18> render_shot(const LiveMatchdayFrame&, const LiveShotEvent&,
const Image* source_backdrop = nullptr) const;
Palette shot_palette(const Palette&, const LiveShotEvent&,
const std::vector<MatchGroup>&, const GameState&) const;
std::vector<Image> render_set_piece(const LiveMatchdayFrame&, const LiveSetPieceEvent&,
const Image* source_backdrop = nullptr) const;
Image render_sportschau_header(const LiveChanceProjection&, int home_before,
int away_before, bool gradient_text) const;
Image render_booking(const LiveMatchdayFrame&, const LiveBookingProjection&) const;
Image render_shootout(const LiveMatchdayFrame&, const LiveShootoutProjection&) const;
private:
Image render_header(const LiveMatchdayFrame&, const LiveChanceProjection&,
int home_goals, int away_goals, bool score_known, uint8_t actor_color) const;
LeImage exe_;
Image background_;
Image board_;
Image score_digits_;
Image weather_;
Image goal_background_;
Image goal_sprites_;
Image set_piece_background_;
Image set_piece_sprites_;
Font font_;
Font heading_;
void text(Image&, int x, int baseline, std::string_view, uint8_t color, int max_width,
bool centered = false, bool gradient = false) const;
};
} // namespace bmh::ui