img-grid-analysis git:20260309.c8d3b6eA

Immutable. This exact content never changes and is served at /api/v1/blob/89bf263831867c8f.

---
name: img-grid-analysis
description: "Наложить пронумерованную сетку на изображение для определения пропорций колонок"
---

# /img-grid — Сетка для анализа макета

Накладывает пронумерованную сетку на изображение печатной формы. Позволяет точно определить границы колонок, их пропорции и span-ы для генерации макета табличного документа.

## Использование

```
/img-grid <ImagePath> [-c COLS] [-o OUTPUT]
```

## Параметры

| Параметр | Обязательный | По умолчанию | Описание |
|-----------|:------------:|--------------|-----------------------------------------------|
| ImagePath | да | — | Путь к изображению (PNG, JPG) |
| -c COLS | нет | 50 | Количество вертикальных делений |
| -r ROWS | нет | авто | Количество горизонтальных делений (авто = квадратные ячейки) |
| -o OUTPUT | нет | `<name>-grid.<ext>` | Путь для результата |

## Команда

```bash
python skills/img-grid-analysis/scripts/overlay-grid.py "<ImagePath>" [-c 50] [-o "<OutputPath>"]
```

Требуется Python 3 с библиотекой Pillow (`pip install Pillow`).

## Что делает

1. Рисует полупрозрачные вертикальные (красные) и горизонтальные (синие) линии
2. Нумерует линии в отдельных полях сверху и слева (не перекрывает содержимое)
3. Каждая 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

```json
{
 "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`