simvx.core.ui.grid_slots

GridSlots: non-widget layout helper for fixed-size cell grids.

Used by ports that draw N×M slots of identical cells (You’re the OS dashboards: CPUs, idle queues, ragequit, RAM, disk; Solitaire foundation/tableau rows; Balatro hand+jokers+consumables; tactics movement-range overlays). The shape is always “compute a slot index → position” and never a hierarchical container.

GridSlots is a pure function-of-its-fields layout calculator: it owns no nodes, queues no redraws, and never participates in input. Drop one into any on_draw and call :meth:idx_to_xy per cell.

Example::

from simvx.core.ui import GridSlots
slots = GridSlots(rows=4, cols=8, size=(48, 48), gap=4, origin=(20, 100))
for i, item in enumerate(items):
    x, y = slots.idx_to_xy(i)
    renderer.draw_rect((x, y), slots.size, colour=...)

Module Contents

Classes

GridSlots

Fixed-size cell grid laid out row-major from origin.

Data

__all__

API

simvx.core.ui.grid_slots.__all__

[‘GridSlots’]

class simvx.core.ui.grid_slots.GridSlots

Fixed-size cell grid laid out row-major from origin.

All coordinates are returned as :class:Vec2. Layout is row-major (idx = row * cols + col); pass row_major=False to flip to column-major.

Args: rows: Number of rows. Must be >= 1. cols: Number of columns. Must be >= 1. size: (cell_w, cell_h) cell dimensions in pixels. gap: Pixel gutter between adjacent cells (same on both axes). origin: (x, y) top-left corner of the cell at index 0. row_major: When True (default), idx increases left-to-right then top-to-bottom; when False, top-to-bottom then left-to-right.

rows: int

None

cols: int

None

size: tuple[float, float]

(48.0, 48.0)

gap: float

4.0

origin: tuple[float, float]

(0.0, 0.0)

row_major: bool

True

__post_init__()

property count: int

Total number of slots.

property cell_w: float

property cell_h: float

property total_size: simvx.core.math.types.Vec2

Outer width and height of the grid (no trailing gap).

idx_to_rc(idx: int) → tuple[int, int]

Translate a linear index into (row, col) honouring row_major.

idx_to_xy(idx: int) → simvx.core.math.types.Vec2

Top-left corner of slot idx in absolute coordinates.

rc_to_idx(row: int, col: int) → int

Linear index for (row, col).

xy_to_idx(x: float, y: float) → int | None

Hit-test (x, y); returns the slot index or None if outside.

Points inside the gap gutter return None.

__iter__() → Iterator[simvx.core.math.types.Vec2]

Iterate idx_to_xy for every slot in order.