/img-grid — Сетка для анализа макета
Накладывает пронумерованную сетку на изображение печатной формы. Позволяет точно определить границы колонок, их пропорции и span-ы для генерации макета табличного документа.
Использование
/img-grid <ImagePath> [-c COLS] [-o OUTPUT]
Параметры
| Параметр |
Обязательный |
По умолчанию |
Описание |
| ImagePath |
да |
— |
Путь к изображению (PNG, JPG) |
| -c COLS |
нет |
50 |
Количество вертикальных делений |
| -r ROWS |
нет |
авто |
Количество горизонтальных делений (авто = квадратные ячейки) |
| -o OUTPUT |
нет |
<name>-grid.<ext> |
Путь для результата |
Команда
python .claude/skills/img-grid/scripts/overlay-grid.py "<ImagePath>" [-c 50] [-o "<OutputPath>"]
Требуется Python 3 с библиотекой Pillow (pip install Pillow).
Что делает
- Рисует полупрозрачные вертикальные (красные) и горизонтальные (синие) линии
- Нумерует линии в отдельных полях сверху и слева (не перекрывает содержимое)
- Каждая 5-я и 10-я линия выделены ярче для удобства счёта
Как использовать результат
1. Определить границы колонок
Посмотреть на изображение с сеткой и записать координаты вертикальных границ каждой колонки таблицы (в номерах grid-линий).
2. Найти базовую решётку
Если на форме несколько таблиц с разной раскладкой (например, шапка документа и основная таблица), объединить все граничные точки. Каждый сегмент между соседними границами — одна колонка MXL.
Пример для М-11:
- Шапка: границы 0, 2, 4, 9, 14, 21, 28, 34, 40, 48
- Таблица: границы 0, 2, 4, 11, 16, 19, 23, 28, 32, 36, 42, 48
- Объединение: 0, 2, 4, 9, 11, 14, 16, 19, 21, 23, 28, 32, 34, 36, 40, 42, 48
- Результат: 16 базовых колонок с пропорциями 2, 2, 5, 2, 3, 2, 3, 2, 2, 5, 4, 2, 2, 4, 2, 6
3. Записать в JSON DSL
{
"columns": 16,
"page": "A4-landscape",
"columnWidths": {
"1": "2x", "2": "2x", "3": "5x", "4": "2x", "5": "3x",
"6": "2x", "7": "3x", "8": "2x", "9": "2x", "10": "5x",
"11": "4x", "12": "2x", "13": "2x", "14": "4x", "15": "2x", "16": "6x"
}
}
Поле "page" позволяет компилятору автоматически вычислить абсолютные ширины из пропорций.
4. Скомпилировать
/mxl-compile → /mxl-validate → /mxl-info
1---2name: img-grid3description: Наложить пронумерованную сетку на изображение для определения пропорций колонок4---5
6# /img-grid — Сетка для анализа макета
7
8Накладывает пронумерованную сетку на изображение печатной формы. Позволяет точно определить границы колонок, их пропорции и span-ы для генерации макета табличного документа.
9
10## Использование
11
12```
13/img-grid <ImagePath> [-c COLS] [-o OUTPUT]
14```
15
16## Параметры
17
18| Параметр | Обязательный | По умолчанию | Описание |
19|-----------|:------------:|--------------|-----------------------------------------------|
20| ImagePath | да | — | Путь к изображению (PNG, JPG) |
21| -c COLS | нет | 50 | Количество вертикальных делений |
22| -r ROWS | нет | авто | Количество горизонтальных делений (авто = квадратные ячейки) |
23| -o OUTPUT | нет | `<name>-grid.<ext>` | Путь для результата |
24
25## Команда
26
27```bash
28python .claude/skills/img-grid/scripts/overlay-grid.py "<ImagePath>" [-c 50] [-o "<OutputPath>"]
29```
30
31Требуется Python 3 с библиотекой Pillow (`pip install Pillow`).
32
33## Что делает
34
351. Рисует полупрозрачные вертикальные (красные) и горизонтальные (синие) линии
362. Нумерует линии в отдельных полях сверху и слева (не перекрывает содержимое)
373. Каждая 5-я и 10-я линия выделены ярче для удобства счёта
38
39## Как использовать результат
40
41### 1. Определить границы колонок
42
43Посмотреть на изображение с сеткой и записать координаты вертикальных границ каждой колонки таблицы (в номерах grid-линий).
44
45### 2. Найти базовую решётку
46
47Если на форме несколько таблиц с разной раскладкой (например, шапка документа и основная таблица), объединить все граничные точки. Каждый сегмент между соседними границами — одна колонка MXL.
48
49Пример для М-11:
50- Шапка: границы 0, 2, 4, 9, 14, 21, 28, 34, 40, 48
51- Таблица: границы 0, 2, 4, 11, 16, 19, 23, 28, 32, 36, 42, 48
52- Объединение: 0, 2, 4, 9, 11, 14, 16, 19, 21, 23, 28, 32, 34, 36, 40, 42, 48
53- Результат: **16 базовых колонок** с пропорциями 2, 2, 5, 2, 3, 2, 3, 2, 2, 5, 4, 2, 2, 4, 2, 6
54
55### 3. Записать в JSON DSL
56
57```json
58{
59 "columns": 16,
60 "page": "A4-landscape",
61 "columnWidths": {
62 "1": "2x", "2": "2x", "3": "5x", "4": "2x", "5": "3x",
63 "6": "2x", "7": "3x", "8": "2x", "9": "2x", "10": "5x",
64 "11": "4x", "12": "2x", "13": "2x", "14": "4x", "15": "2x", "16": "6x"
65 }
66}
67```
68
69Поле `"page"` позволяет компилятору автоматически вычислить абсолютные ширины из пропорций.
70
71### 4. Скомпилировать
72
73`/mxl-compile` → `/mxl-validate` → `/mxl-info`
majiayu000