position_hint.go RawHistoryFolder

1package ports
2
3const (
4	PositionHintMaxColumns = 16
5	PositionHintMaxRows    = 16
6	PositionHintDiameter   = 8
7	// PositionHintActiveDiameter fits in the padding and gap around its cell.
8	PositionHintActiveDiameter = 10
9	PositionHintGap            = 10
10	PositionHintPadding        = 10
11	PositionHintBottom         = 48
12	PositionHintRadius         = 10
13)
14
15// PositionHint is a bounded, comparable snapshot. Scenes copy it by value;
16// neither fading nor a changed grid shares mutable storage with a renderer.
17type PositionHint struct {
18	Opacity              float32
19	Vertical             bool
20	Columns              uint8
21	Counts               [PositionHintMaxColumns]uint8
22	ActiveCol, ActiveRow uint8
23}
24
25func (h PositionHint) Shown() bool { return h.Opacity > 0 && h.Columns > 0 }
26
27// Bounds is the hint's logical output-local background rectangle.
28func (h PositionHint) Bounds(width, height int) Rect {
29	if !h.Shown() {
30		return Rect{}
31	}
32	cols, rows := min(int(h.Columns), PositionHintMaxColumns), 1
33	for _, n := range h.Counts[:cols] {
34		rows = max(rows, min(int(n), PositionHintMaxRows))
35	}
36	w := 2*PositionHintPadding + cols*PositionHintDiameter + (cols-1)*PositionHintGap
37	ht := 2*PositionHintPadding + rows*PositionHintDiameter + (rows-1)*PositionHintGap
38	return Rect{X: (width - w) / 2, Y: height - PositionHintBottom - ht, W: w, H: ht}
39}