<< lib/ui/SLGridLayout.sleela SLeeLa Standard Library Definition. Definition: SLGridLayout — place children in an evenly-divided rows x cols grid, filling left-to-right, top-to-bottom. Beginner-simple (pick columns, add children) and precise (equal cells with gap + padding). Pure SLeeLa; fills SLLayoutBox[] with real pixel rects. Easy path (a 3-column gallery in a 600x400 area): SLGridLayout g = new SLGridLayout(); g.columns(3); g.gap(10); g.pad(10); g.add(); g.add(); g.add(); g.add(); g.add(); < 5 cells -> 2 rows > g.arrange(0, 0, 600, 400); SLLayoutBox b = g.boxOf(0); >> #sleela 2.5 material; < Family: ui. A standard, professional, beginner-friendly grid layout. > class SLGridLayout { < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > << Eleven catalogued attributes with getter/setter pairs. >> String metaVersion = "1.0.0"; int metaId = 11603; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-25"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-25"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 8; < metaNationalSchedule: a real, citable instrument or "none" > String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } static final int MAX_ITEMS = 256; < the assumed minimum size (px) of a single grid cell, used to derive the > < grid's natural starting size when the caller does not supply a cell size. > static final int MIN_CELL_PX = 64; int cols; int count; int gapPx; int padLeft; int padTop; int padRight; int padBottom; SLLayoutBox[] boxes; void create() { cols = 1; count = 0; gapPx = 8; padLeft = 0; padTop = 0; padRight = 0; padBottom = 0; boxes = new SLLayoutBox[MAX_ITEMS]; } < Number of columns (at least 1). > void columns(int c) { cols = (c < 1) ? 1 : c; } int getColumns() { return cols; } < The gap, in px, between adjacent cells (used by a native realizer). > int getGap() { return gapPx; } void gap(int px) { gapPx = (px < 0) ? 0 : px; } void pad(int p) { int q = (p < 0) ? 0 : p; padLeft = q; padTop = q; padRight = q; padBottom = q; } < Add one cell (grid cells are evenly sized, so no per-cell size needed). > int add() { if (count >= MAX_ITEMS) { return -1; } int idx = count; count = count + 1; return idx; } int size() { return count; } < How many rows the current cell count needs for the chosen column count. > int rows() { if (count == 0) { return 0; } return (count + cols - 1) / cols; } < ---- assumed / natural size (the "at least so large" starting size) ----- > << The natural WIDTH this grid needs to show `cols` columns at the given cell width (pass 0 to use the assumed MIN_CELL_PX): columns * cellW + the column gaps + horizontal padding. >> int naturalWidthFor(int cellW) { int cw = (cellW <= 0) ? MIN_CELL_PX : cellW; int colGaps = (cols > 1) ? (gapPx * (cols - 1)) : 0; return cols * cw + colGaps + padLeft + padRight; } << The natural HEIGHT for the current cell count at the given cell height (pass 0 to use the assumed MIN_CELL_PX): rows * cellH + row gaps + vertical padding. >> int naturalHeightFor(int cellH) { int ch = (cellH <= 0) ? MIN_CELL_PX : cellH; int r = rows(); int rowGaps = (r > 1) ? (gapPx * (r - 1)) : 0; return r * ch + rowGaps + padTop + padBottom; } < The assumed minimum width using the default assumed cell size. > int naturalWidth() { return naturalWidthFor(0); } < The assumed minimum height using the default assumed cell size. > int naturalHeight() { return naturalHeightFor(0); } void arrange(int x, int y, int w, int h) { int innerX = x + padLeft; int innerY = y + padTop; int innerW = w - padLeft - padRight; if (innerW < 0) { innerW = 0; } int innerH = h - padTop - padBottom; if (innerH < 0) { innerH = 0; } int r = rows(); int colGaps = (cols > 1) ? (gapPx * (cols - 1)) : 0; int rowGaps = (r > 1) ? (gapPx * (r - 1)) : 0; int cellW = (cols > 0) ? ((innerW - colGaps) / cols) : innerW; int cellH = (r > 0) ? ((innerH - rowGaps) / r) : innerH; if (cellW < 0) { cellW = 0; } if (cellH < 0) { cellH = 0; } int i = 0; while (i < count) { int col = i - (i / cols) * cols; int rowIdx = i / cols; int cx = innerX + col * (cellW + gapPx); int cy = innerY + rowIdx * (cellH + gapPx); SLLayoutBox b = new SLLayoutBox(); b.create(); b.set(cx, cy, cellW, cellH); boxes[i] = b; i = i + 1; } } SLLayoutBox boxOf(int index) { if (index < 0 || index >= count) { return null; } return boxes[index]; } boolean honored() { return cols >= 1 && count >= 0 && count <= MAX_ITEMS && gapPx >= 0 && padLeft >= 0 && padTop >= 0 && padRight >= 0 && padBottom >= 0; } }