Спецификация формата .meb
Статус:
[x]готово — версия 3.0.0
Нормативный документ. Реализации должны ему соответствовать.
Словарь понятий: 01-glossary.md. Модель данных: 02-data-model.md. Справочник полей: 04-field-reference.md.
1. Формат файла
1.1 Расширение и MIME-тип
| Свойство | Значение |
|---|---|
| Расширение | .meb |
| MIME-тип | application/vnd.meb+json |
| Кодировка | UTF-8 без BOM |
1.2 Структура
Файл .meb — это документ JSON. Корень — объект ({}). Массивы и примитивные значения в качестве корня недопустимы.
Реализация ДОЛЖНА отклонить файл, который:
- не является корректным JSON,
- имеет корень, отличный от объекта,
- не содержит поля
meta.
1.3 Неизвестные поля
Реализация, читающая файл более новой версии MINOR в пределах той же версии MAJOR, ДОЛЖНА игнорировать поля, которые она не распознаёт, вместо того чтобы возвращать критическую ошибку (см. 05-versioning.md).
Для файлов, проверяемых на соответствие именно этой версии стандарта, единственный нормативный механизм расширений для разработчиков ПО — поля с префиксом x_. Валидатор соответствия конкретной версии МОЖЕТ отклонять другие неизвестные поля.
2. Примитивные типы
| Тип | Описание |
|---|---|
string | Строка символов UTF-8 |
number | Число JSON (целое или с плавающей точкой) |
bool | true или false |
mm | Число в миллиметрах — тип number, всегда > 0, если не указано иное |
degrees | Угол в градусах — тип number, диапазон зависит от контекста |
id | Уникальный идентификатор — тип string, непустой, не более 128 символов |
ref | Ссылка на id другого объекта — тип string |
datetime | Дата и время в формате ISO 8601, например "2025-03-15T14:30:00Z" |
Значение null в необязательном поле равнозначно отсутствию поля. Реализация ДОЛЖНА трактовать null и отсутствие поля одинаково.
3. Ключевые слова соответствия
Настоящий документ использует ключевые слова в следующем значении:
| Слово | Значение |
|---|---|
| ДОЛЖЕН / НЕ ДОЛЖЕН | Безусловное требование / запрет |
| СЛЕДУЕТ / НЕ СЛЕДУЕТ | Рекомендация — отступление требует обоснования |
| МОЖЕТ | Необязательно — решение реализации |
Реализация соответствует настоящей спецификации, если выполняет все требования, обозначенные ДОЛЖЕН / НЕ ДОЛЖЕН.
4. Корень файла (MebFile)
Корень файла содержит следующие поля:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
meta | object | да | Метаданные файла |
project | object | да | Данные проекта |
scene | array | да | Граф сцены — дерево узлов, массив корневых узлов (§7) |
materials_catalog | array | да | Библиотека материалов |
edging_catalog | array | да | Библиотека кромок |
drilling_catalog | array | да | Библиотека типов присадки |
hardware_catalog | array | да | Библиотека фурнитуры |
profiles | array | да | Каталог геометрических профилей |
grain_groups | array | нет | Группы совпадения текстуры |
biscuit_catalog | array | нет | Каталог ламелей (соединений biscuit) |
meshes_catalog | array | нет | Каталог сеток тел и фурнитуры (§11.7) |
comments | array | нет | Комментарии |
Обязательные массивы МОГУТ быть пустыми ([]). Повторяющиеся ключи на одном уровне недопустимы.
5. Метаданные (meta)
Объект meta описывает файл как артефакт, а не проект.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
version | string | да | Версия стандарта .meb (semver), например "3.0.0" |
created_at | datetime | да | Дата и время создания файла |
created_by | object | нет | Программа-источник |
checksum | string | нет | Контрольная сумма (см. §5.2) |
5.1 Объект meta.created_by
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
name | string | да | Название приложения |
version | string | нет | Версия приложения |
5.2 Контрольная сумма
Поле meta.checksum содержит контрольную сумму SHA-256 содержимого файла за исключением самого поля checksum (и его значения). Реализации, выполняющей проверку, СЛЕДУЕТ не учитывать это поле перед вычислением суммы, не изменяя структуру файла.
Формат: "sha256:<hex>", например "sha256:a3f2...".
6. Проект (project)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Идентификатор проекта |
name | string | да | Название проекта |
description | string | нет | Произвольное описание |
has_3d | bool | нет | true — файл содержит данные о 3D-положении; false — 3D-данных нет, пространственный просмотр недоступен. Отсутствие поля трактуется как true. |
client | object | нет | Данные клиента |
designer | object | нет | Данные проектировщика |
6.1 Объекты client и designer
Оба объекта имеют одинаковую структуру:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
name | string | да | Имя и фамилия или название компании |
email | string | нет | Адрес электронной почты |
phone | string | нет | Номер телефона |
company | string | нет | Название компании (для физических лиц) |
7. Граф сцены (scene)
7.1 Общий принцип
scene — это дерево узлов, массив корневых узлов. Узел — это группа (group), панель (panel), фурнитура (hardware) или тело (solid). Дочерние узлы (children) есть только у группы; панель, фурнитура и тело — листья. Дерево один к одному повторяет дерево документа программы проектирования: группа из программы — это группа в файле, панель — это панель (3.0.0).
- Каждый узел имеет положение и поворот относительно родителя (§14.3) — поворот группы поворачивает всё, что в ней находится.
- Панель, фурнитура и тело находятся в любой группе и в корне — столешнице над комплектом шкафов не нужен искусственный шкаф.
- Чем группа является для производства и правил, говорит её роль (§7.4): шкаф — это группа с ролью
"cabinet", а ящик, подсборка и комплект — группы без роли, вложенные произвольно.
7.2 Узел (node)
Поля, общие для всех узлов:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор узла во всём файле |
name | string | да | Произвольная метка |
type | string | да | "group", "panel", "hardware" или "solid" |
position | object | да¹ | Положение относительно родителя {x, y, z} в мм |
rotation | object | да¹ | Поворот Эйлера XYZ относительно родителя {x, y, z} в градусах |
production_id | string | нет | Производственный номер (см. §7.5) |
comment_refs | array | нет | Список id из comments[] |
¹ position и rotation отсутствуют у фурнитуры без положения (§12) и у узлов файла без 3D-данных (project.has_3d: false, §6).
Поле position содержит три числа {x, y, z} — каждое в мм. Поле rotation содержит три числа {x, y, z} — каждое в градусах, порядок XYZ; каждый угол СЛЕДУЕТ задавать в диапазоне (−180°, 180°] — пол-оборота как 180, никогда как -180.
7.3 Узел группы (type: "group")
Дополнительные поля:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
role | string | нет | Роль группы — "cabinet" (шкаф); отсутствует — обычная группа (§7.4) |
front | string | нет | Передняя сторона группы в её системе координат: "-Y" (по умолчанию) | "+Y" | "-X" | "+X" (§14.2) |
children | array | да | Дочерние узлы: группы, панели, фурнитура и тела |
Переднюю сторону имеет каждая группа, а не только шкаф: чертёж комплекта или ящика спереди — это взгляд со стороны front её системы координат. Поле редактируемое: программа, у которой в системе координат группы передняя сторона находится не на -Y, указывает её здесь (§14.2).
7.4 Роль группы
Роль говорит, чем группа является для производства и правил. Её присваивают существующей группе — пять панелей, сгруппированных в ящик, три ящика, сгруппированных в группу с ролью шкафа, — и группа остаётся той же группой, с теми же дочерними узлами.
role | Чем является группа |
|---|---|
| отсутствует | обычная группа: ящик, подсборка, комплект, помещение |
"cabinet" | шкаф — единица производства и производственного номера (§7.5); его система координат задаёт производственный чертёж шкафа (§14.2) |
Правила дерева:
- Шкафа нет в шкафу ни на какой глубине — группа с ролью
"cabinet"НЕ ДОЛЖНА иметь среди потомков группу с ролью"cabinet", в том числе через ящик или подсборку. - Узел, отличный от группы, НЕ ДОЛЖЕН содержать поле
children.
Новая роль — это новое значение поля (изменение MINOR, 05-versioning.md §4). Читающая реализация ДОЛЖНА трактовать неизвестную ей роль как группу без роли.
7.5 Производственный номер (production_id)
production_id — необязательный структурный идентификатор, присваиваемый экспортирующим программным обеспечением. Формат: числовые сегменты, разделённые точками, например "01.02.03". Количество сегментов соответствует глубине в дереве.
Два узла получают одинаковый production_id на своём уровне, если они структурно идентичны, то есть имеют равные значения всех полей, существенных для производства (размеры, материал, обработка, дочерние узлы), за исключением position, rotation, name, id и comment_refs. Поэтому одинаковые ящики получают один номер.
Тела, а также положение и геометрия фурнитуры не относятся к производству и не влияют на production_id ни одного узла. Фурнитуру группы сравнивают по hardware_ref и суммарному количеству.
Однажды присвоенный номер сохраняется — реализации, которая записывает объект, загруженный из файла .meb (в том числе из собственного более раннего экспорта), СЛЕДУЕТ сохранить его production_id; правила идентичности и количества сегментов относятся к номерам, которые она присваивает сама.
Поле информационное. Читающая реализация МОЖЕТ его игнорировать.
7.6 Узел тела (type: "solid")
Тело — это произвольная геометрия с материалом: стена, пол, потолок, колонна, объём встроенной мебели, бытовая техника, декор. Стандарт не различает виды тел: название — произвольная метка, а о том, относится ли объект к производству, говорит исключительно материал (§11.1.1). Тело не идёт в производство — даже если у него мебельный материал.
Дополнительные поля:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
material_ref | ref | да | Ссылка на materials_catalog[].id — внешний вид тела |
geometry | object | да | Геометрия тела (§7.6.1) |
Узел тела — лист. Он находится в корне или в любой группе: духовка и мойка во встроенной мебели — дочерние узлы шкафа и перемещаются вместе с ним. Объект geometry описывает также упрощённую геометрию фурнитуры (§12).
7.6.1 Геометрия тела (geometry)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
type | string | да | "extrusion" (контур с толщиной), "mesh" (сетка) или "polyhedron" (многогранник) |
outline | object | при extrusion | Контур — объект path (§10) с closed: true |
holes | array | нет (только extrusion) | Отверстия — объекты path с closed: true, лежащие внутри контура |
thickness | mm | при extrusion | Толщина выдавливания |
mesh_ref | ref | при mesh | Ссылка на meshes_catalog[].id |
vertices | array | при polyhedron | Вершины многогранника (§7.6.2) |
edges | array | при polyhedron | Рёбра многогранника (§7.6.2) |
faces | array | при polyhedron | Грани многогранника (§7.6.2) |
Контур с толщиной (extrusion) — та же геометрия, что и у панели: контур в плоскости XY системы координат тела, выдавленный от Z = 0 до Z = thickness (§14.5). Оконный и дверной проём — это отверстие в контуре стены, скос потолка — наклонный сегмент её контура. Сегменты line, arc и bezier имеют то же значение, что и в §10; поля сегмента id и machined здесь не применяются.
Сетка (mesh) описывает то, чего не выразит контур с толщиной: криволинейную стену с окном, нерегулярную нишу, бытовую технику, мойку. Сетка всегда встроена в файл, в meshes_catalog (§11.7); одна сетка может служить многим телам и единицам фурнитуры.
Многогранник (polyhedron) — тело из плоских многоугольных граней, такое, каким его рисует программа моделирования рёбрами и гранями: стена со сквозным окном, скос потолка, ниша, помещение с полом и стенами в одном теле (§7.6.2). Грань — произвольный многоугольник с отверстиями, поэтому многогранник точен и не нуждается в треугольниках. Каждая вершина, ребро и грань имеют id, который программа сохраняет между правками, — тело возвращается из файла в программу без потерь.
7.6.2 Многогранник (polyhedron)
Вершина (vertices[]):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Идентификатор вершины, уникальный в пределах многогранника |
x, y, z | number | да | Положение в системе координат тела (§14.5), в мм |
Ребро (edges[]):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Идентификатор ребра, уникальный в пределах многогранника |
start | ref | да | Начальная вершина — vertices[].id |
end | ref | да | Конечная вершина — vertices[].id, отличная от start |
fold | bool | нет | Ребро сгиба — возникло, когда грань перестала быть плоской и разделилась на треугольники; по умолчанию false |
Грань (faces[]):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Идентификатор грани, уникальный в пределах многогранника |
loops | array | да | Контуры грани: первый — внешний контур, следующие — отверстия; каждый контур — массив vertices[].id, мин. 3 |
Правила:
- каждые две соседние вершины контура — и последняя с первой — являются концами ребра из
edges. Ребро принадлежит любому числу граней или ни одной: ребро без грани — это линия чертежа, без поверхности, - внешний контур идёт против часовой стрелки, если смотреть на грань со стороны её нормали, а отверстия — по часовой стрелке, поэтому грань всегда лежит слева от направления обхода контура. Нормаль грани замкнутого тела направлена наружу, как в сетке (§11.7),
- вершины грани лежат в одной плоскости; отверстия лежат внутри внешнего контура и не пересекают ни внешний контур, ни друг друга,
- многогранник МОЖЕТ быть открытым — отдельная грань без толщины, ребро без грани — и МОЖЕТ состоять из нескольких несвязанных частей,
- реализация, отображающая многогранник, сама разбивает грани на треугольники; ребро сгиба она МОЖЕТ рисовать тонкой линией или не рисовать.
8. Панель (panel)
Панель — это узел дерева (type: "panel", §7.2), лист, который находится в любой группе или в корне.
8.1 Идентификационные поля
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
type | string | да | "panel" |
id | id | да | Уникальный идентификатор узла во всём файле |
name | string | да | Произвольная метка |
production_id | string | нет | Производственный номер (см. §7.5) |
comment_refs | array | нет | Список id из comments[] |
8.2 Геометрия и положение
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
dimensions | object | да | Размеры панели |
position | object | да | Положение {x, y, z} относительно родителя (группы или корня), мм |
rotation | object | да | Поворот Эйлера XYZ {x, y, z}, градусы |
Объект dimensions содержит:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
length | mm | да | Чистовая длина после кромления (вертикальная ось в виде раскроя; направление along_length) |
width | mm | да | Чистовая ширина после кромления (горизонтальная ось) |
thickness | mm | да | Чистовая толщина после кромления |
Размеры — всегда чистовой размер после кромления. Вычисление чернового размера — на стороне реализации (см. §14.4).
8.3 Материал и направление текстуры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
material_ref | ref | да | Ссылка на materials_catalog[].id |
grain | string | да | Учитывает ли панель текстуру материала и в каком направлении |
grain_group_ref | ref | нет | Ссылка на grain_groups[].id |
Допустимые значения grain: "along_length" | "along_width" | "none".
Иерархия текстуры: материал ↔ панель
Текстура (структура) — свойство исключительно материала: её наличие и базовое направление описывает material.grain (см. §11). Поле panel.grain подчинено материалу и определяет, учитывает ли данная панель текстуру:
material.grain | panel.grain | Интерпретация |
|---|---|---|
none | любое | Материал без текстуры → panel.grain игнорируется; поворот разрешён; рисунка текстуры нет |
≠ none | none | Панель не учитывает текстуру → поворот разрешён; рисунок текстуры не отображается |
≠ none | along_length / along_width | Панель учитывает текстуру в этом направлении → поворот запрещён (§15.5); рисунок текстуры отображается |
Если material.grain = "none", в panel.grain СЛЕДУЕТ указывать "none" (значение и так игнорируется).
8.4 Гнутьё (bend)
Поле bend необязательное. Наличие поля означает, что панель гнутая по цилиндру.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
axis | string | да | Ось гибки: "width" или "length" |
radius | mm | да | Радиус дуги |
radius_type | string | да | Тип радиуса: "inner" или "outer" |
angle | degrees | да | Угол дуги в градусах |
Панель может быть гнутой только по одной оси. Реализации, не поддерживающие гибку, ДОЛЖНЫ сообщить пользователю о неизвестной геометрии — НЕ ДОЛЖНЫ молча пропускать поле.
8.5 Кромки (edging)
Поле edging описывает кромление четырёх краёв панели.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
xL | object|null | нет | Кромка края по ширине при x=L (верхнего) |
x0 | object|null | нет | Кромка края по ширине при x=0 (нижнего) |
yW | object|null | нет | Кромка края по длине при y=W (левого) |
y0 | object|null | нет | Кромка края по длине при y=0 (правого) |
sequence | string | нет | Какую пару краёв кромят первой ("width_first" | "length_first", по умолчанию "width_first") |
Каждый объект края (xL, x0, yW, y0):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
ref | ref | да | Ссылка на edging_catalog[].id |
Поле sequence (по умолчанию "width_first") определяет, какую пару противоположных краёв кромят первой:
"width_first"— сначала края по ширине (xL/x0), затем края по длине (y0/yW)."length_first"— сначала края по длине (y0/yW), затем края по ширине (xL/x0).
Пара, которую кромят позже, перекрывает углы пары, кромленной раньше. Модель отражает физический порядок на кромкооблицовочном станке (противоположные края кромят парами), поэтому произвольный порядок отдельных сторон непредставим. Значение действует независимо от того, на каких краях есть кромка.
8.5.1 Отделка торца (edge_finish)
Поле edge_finish (с версии 2.2.0) необязательное и стоит рядом с edging. Оно описывает край панели, который не кромят, а отделывают на самой плите — шлифуют и/или снимают фаску. Типичный случай: компактные плиты (HPL) со шлифованным торцом и фаской 1×1 мм с лицевой и с обратной стороны.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
xL | object|null | нет | Отделка края по ширине при x=L (верхнего) |
x0 | object|null | нет | Отделка края по ширине при x=0 (нижнего) |
yW | object|null | нет | Отделка края по длине при y=W (левого) |
y0 | object|null | нет | Отделка края по длине при y=0 (правого) |
Каждый объект края (xL, x0, yW, y0):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
sanded | bool | да | Поверхность торца шлифована |
chamfer | mm | да | Размер фаски 45°, выполненной на обоих рёбрах торца — у лицевой и у обратной стороны; 0 — без фаски (значение ≥ 0) |
chamfer: 1 означает фаску 1 × 1 мм под углом 45° вдоль всего края — одну у лицевой стороны, другую у обратной.
Поле описывает результат — как выглядит готовый торец, — а не станок, инструмент или процесс (тот же принцип, что и для фрезеровки, §9.3). Чем и на каком этапе торец будет отшлифован и получит фаску, решает производственная система. Отделка не меняет размеры панели — dimensions остаётся чистовым размером (§8.2).
Значение наличия поля:
- поля
edge_finishнет — файл ничего не говорит об отделке торцов; читающая реализация МОЖЕТ применить собственную настройку по умолчанию (например, привязанную к материалу), - поле есть, край
nullили пропущен — у этого края нет отделки; пустой объект{}явно означает, что ни один край не отделан.
Край имеет либо кромку, либо отделку: edging.{side} и edge_finish.{side}, отличные от null, на одном и том же крае исключают друг друга. Фаска ДОЛЖНА помещаться в толщину: 2 × chamfer < dimensions.thickness (§15.8).
edge_finish — это не покрытие и не скос:
finishes[](§8.6) — это слои материала, наносимые на поверхность (шпон, ламинат, лак), —edge_finishничего не наносит, он описывает обработку самого торца плиты,bevels[](§9.1) — это конструктивный рез под углом, который меняет форму панели, — фаска 1 мм на ребре торца является отделкой, а не скосом.
Поле адресует стороны базового прямоугольника, как и edging. Стенки реза контура outline и выреза hole отделываются полем routing.edge_finish (§9.3.2).
Пример — компактная столешница HPL 12 мм: три торца шлифованы с фаской 1×1 мм, край yW (у стены) без отделки, вырез под мойку отделан так же по всему периметру:
{
"id": "panel_blat_hpl",
"name": "Blat kompaktowy HPL",
"dimensions": { "length": 1200, "width": 600, "thickness": 12 },
"position": { "x": 0, "y": 0, "z": 0 },
"rotation": { "x": 0, "y": 0, "z": 0 },
"material_ref": "mat_hpl_12",
"grain": "none",
"edge_finish": {
"xL": { "sanded": true, "chamfer": 1 },
"x0": { "sanded": true, "chamfer": 1 },
"y0": { "sanded": true, "chamfer": 1 },
"yW": null
},
"operations": {
"routings": [
{
"type": "hole",
"path": {
"start": { "x": 400, "y": 150 },
"closed": true,
"segments": [
{ "type": "line", "end": { "x": 800, "y": 150 } },
{ "type": "line", "end": { "x": 800, "y": 450 } },
{ "type": "line", "end": { "x": 400, "y": 450 } },
{ "type": "line", "end": { "x": 400, "y": 150 } }
]
},
"edge_finish": { "walls": "all", "sanded": true, "chamfer": 1 }
}
]
}
}8.6 Покрытия поверхности (finishes)
Поле finishes — необязательный массив покрытий, наносимых на поверхности панели.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
surface | string | да | Поверхность покрытия (см. ниже) |
material_ref | ref | да | Ссылка на materials_catalog[].id |
order | number | да | Порядок нанесения на одну и ту же поверхность (1 — первое) |
comment_refs | array | нет | Список id из comments[] |
Допустимые значения surface: "face_top" | "face_bottom" | "edge_xL" | "edge_x0" | "edge_y0" | "edge_yW".
Одно покрытие описывает одну поверхность. Несколько покрытий на одной и той же поверхности обрабатываются в порядке возрастания order.
8.7 Композиция из слоёв (composite)
Поле composite необязательное. Наличие поля означает, что панель склеивается на производстве из более тонких слоёв — например, панель 36 мм, склеенная из 2×18 мм. Отсутствие поля означает монолит (например, столешница 38 мм), который не подлежит разбиению на составляющие.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
layers | array | да | Список слоёв — мин. 2 элемента |
Объект слоя (layer):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
order | integer | да | Позиция слоя: 1 — низ / тыл, n — верх / фасад |
material_ref | ref | да | Ссылка на materials_catalog[].id |
thickness | mm | да | Толщина слоя |
Правила валидации:
- Сумма толщин всех слоёв ДОЛЖНА быть равна
panel.dimensions.thickness. - Значения
orderДОЛЖНЫ образовывать непрерывную последовательность без повторов (1, 2, …, n). - Каждый
material_refДОЛЖЕН указывать на существующую запись вmaterials_catalog[]категорииboard.
Интерпретация операций CNC, кромок и отделки на составных панелях — на стороне производственной системы: формат .meb не описывает распределение операций по отдельным слоям.
8.8 Операции (operations)
Поле operations — объект, содержащий списки операций обработки:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
bevels | array | нет | Наклонные резы (скосы) |
drillings | array | нет | Присадка |
routings | array | нет | Фрезеровка |
Отсутствие поля operations равнозначно объекту со всеми пустыми списками.
9. Операции обработки
Все координаты операций относятся к канонической ориентации панели (см. §14.1), независимо от поля rotation панели.
9.1 Скос (bevel)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
edge_side | string | одно из† | Базовая сторона: "xL" | "x0" | "yW" | "y0" |
on_segment | ref | одно из† | id сегмента line контура outline/hole (см. §9.2.2) |
from_face | string | да | Исходная плоскость: "top" | "bottom" |
angle | degrees | да | Угол реза от перпендикуляра (0° — прямой, 45° — стандартный скос) |
leave | mm | да | Толщина материала, оставляемая прямой перед скосом, ≥ 0 |
depth | mm | нет | Глубина скоса — если не указана: depth = d − leave |
edging | object | нет | Кромка на наклонной поверхности |
comment_refs | array | нет | Список id из comments[] |
† Скос адресуется либо через edge_side (базовая сторона прямоугольника), либо через on_segment (сегмент контура) — ровно одним из этих режимов.
leave = 0 означает скос от самого края плоскости from_face.
Скос всегда охватывает весь край (всю базовую сторону или весь сегмент) — полей start/end нет. Частичная фаска выполняется слотом с профилем (§9.3.1).
Скос через on_segment допускается только для сегментов типа line: скос — это прямой рез (пилой или прямым проходом фрезы). Криволинейный край (arc/bezier) скосом не обрабатывается; профильная фаска на кривой выполняется слотом с профилем (type: slot, §9.3.1). Область действия on_segment — как в §9.2.2: сквозные сегменты outline (machined) и hole.
Если на одном и том же крае (edge_side или on_segment) и с одной и той же стороны from_face задано более одного скоса, поле depth обязательно для каждого из них.
Объект edging в скосе:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
ref | ref | да | Ссылка на edging_catalog[].id |
9.2 Присадка (drilling)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
drilling_ref | ref | да | Ссылка на drilling_catalog[].id |
type | string | да | "face" (пласть) или "edge" (торец) |
face | string | при type: face | "top" | "bottom" |
edge_side | string | при type: edge на базовой стороне | "xL" | "x0" | "yW" | "y0" |
on_segment | ref | при type: edge на контуре | id сегмента траектории outline или hole (см. §9.2.2) |
x | mm | при face; при edge_side: y0/yW | Положение вдоль длины (см. §9.2.1) |
y | mm | при face; при edge_side: xL/x0 | Положение вдоль ширины (см. §9.2.1) |
s | mm | при on_segment | Расстояние вдоль сегмента контура от его начала (см. §9.2.2) |
z | mm | нет (только type: edge) | Положение поперёк толщины, от лицевой стороны; по умолчанию thickness/2. Это положение отверстия по толщине, а не глубина присадки — она следует из drilling_catalog (см. §9.2.1) |
hardware_instance_ref | ref | нет | id единицы фурнитуры, из которой следует присадка (§12.1) |
comment_refs | array | нет | Список id из comments[] |
Торцевая присадка (type: edge) адресуется либо через edge_side (базовая сторона прямоугольника), либо через on_segment (край контура) — ровно одним из этих режимов.
9.2.1 Система координат присадки
Каноническая система (§14.1): x вдоль длины (0..L, вертикаль), y вдоль ширины (0..W, горизонталь — растёт влево), z поперёк толщины — глубина от лицевой стороны (face: top), z ∈ [0, thickness], z = 0 на лицевой стороне, z = thickness на обратной стороне, по умолчанию thickness/2. Начало координат лицевой стороны — правый нижний угол (x=0 внизу, y=0 справа).
type: face—xот нижнего края (вдоль длины),yот правого края (вдоль ширины).zне применяется — глубина присадки следует изdrilling_catalog.type: edge,edge_side: y0илиyW(края по длине) —x— положение вдоль длины (снизу);yопределяется черезedge_side(y0→y=0,yW→y=W) и не указывается. Положение отверстия по толщине:z.type: edge,edge_side: xLилиx0(края по ширине) —y— положение вдоль ширины (справа);xопределяется черезedge_side(x0→x=0,xL→x=L) и не указывается. Положение по толщине:z.
Положение по толщине всегда задаётся в поле z, отсчитываемом от лицевой стороны независимо от края, — ни одна из осей x/y больше не меняет значения в зависимости от края. z — положение отверстия по толщине, а не глубина присадки (она следует из drilling_catalog). Направление входа сверла следует из edge_side.
9.2.2 Присадка в торец контура (on_segment)
Если у панели есть неосевой край, образованный сквозным резом, — скос или дуга контура (routing type: outline) либо стенка сквозного выреза (type: hole), — такой край нельзя адресовать через edge_side: ни одна координата x/y не постоянна, а направление присадки поворачивается вдоль края. Такая присадка адресуется параметрически по сегменту контура:
on_segment— ссылка наidсегмента в траекторииoutlineилиhole; сегмент ДОЛЖЕН иметьid(см. §10).s— расстояние вдоль этого сегмента от его начальной точки, в мм (длина дуги — работает дляline,arc,bezier);0 ≤ s ≤длина сегмента.z— глубина от лицевой стороны, как в §9.2.1 (по умолчаниюthickness/2); диапазон[0, thickness], поскольку контур сквозной на всю толщину.
Положение x/y отверстия вычисляется из геометрии сегмента и не указывается. Направление присадки (нормаль к краю) следует из геометрии сегмента и стороны материала (направление обхода траектории): для outline материал находится внутри контура, для hole — снаружи (со стороны панели, а не выреза). Режимы on_segment и edge_side исключают друг друга.
Примечание: в outline целью on_segment обычно является сегмент machined (реальный рез, отличающий контур от базового прямоугольника); в hole каждый сегмент — это сквозная стенка, поэтому флаг machined не применяется. pocket (несквозной) не поддерживается через on_segment — его стенка доходит только до depth, а не на всю толщину.
9.3 Фрезеровка (routing)
Формат .meb описывает исключительно результирующую геометрию операции фрезеровки — он не описывает режущий инструмент, режимы резания или стратегию CAM. Стандарт различает пять геометрических примитивов:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
type | string | да | "slot" | "outline" | "hole" | "pocket" | "biscuit" |
finishes | array | нет | Покрытия на отфрезерованной поверхности |
hardware_instance_ref | ref | нет | id единицы фурнитуры, из которой следует фрезеровка (§12.1) |
comment_refs | array | нет | Список id из comments[] |
9.3.1 Slot — протяжённый паз (type: "slot")
Слот описывает геометрию протягивания: постоянное поперечное сечение, перемещающееся вдоль траектории. Сюда относятся пазы на пласти, пазы/четверти на торце, скругления, профильные фаски, пазы под задние стенки из HDF, карнизы и т. п.
Слот имеет две ортогональные оси:
- placement — где проходит траектория:
surface(на пласти, полеpath) илиedge(вдоль края, полеedge_sideилиon_segment). Placement следует из наличия полей —path(→ surface) либоedge_side/on_segment(→ edge), ровно один режим. - section — как описано сечение:
simple(прямоугольникwidth×depth) илиprofiled(полный профильprofile_ref). Полеsectionобязательное и явное.
Общие поля:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
section | string | да | "simple" | "profiled" |
face | string | да | surface: обрабатываемая пласть ("top" | "bottom"); edge: базовое ребро ("top" — у лицевой стороны, "bottom" — у обратной стороны) |
Placement surface — траектория на пласти:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
path | object | да | Траектория оси слота (см. §10) |
Placement edge — траектория вдоль края:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
edge_side | string | одно из† | Базовая сторона: "xL" | "x0" | "yW" | "y0" |
on_segment | ref | одно из† | id сегмента контура outline/hole (§9.2.2) |
start | mm | нет‡ | Начало вдоль края/сегмента — по умолчанию 0 |
end | mm | нет‡ | Конец вдоль края/сегмента — по умолчанию до конца |
† Ровно одно из edge_side / on_segment. ‡ start и end указываются вместе или вместе опускаются.
Для edge_side start/end — это координата вдоль края, отсчитываемая от 0: для краёв по длине (y0/yW) — вдоль длины от x=0; для краёв по ширине (xL/x0) — вдоль ширины от y=0. Для on_segment это s (длина дуги) вдоль сегмента от его начала. Область действия on_segment — как в §9.2.2 (сквозные сегменты outline/hole).
Section simple — прямоугольное сечение:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
width | mm | да | Ширина паза (размер поперёк направления заглубления) |
depth | mm | да | Заглубление реза от поверхности входа |
offset | mm | нет | Смещение сечения от базовой линии, по касательной к поверхности входа — по умолчанию 0 |
offset для surface сдвигает прямоугольник вбок от оси path (в плоскости пласти); для edge — вдоль толщины от ребра face. При offset = 0 сечение surface центрировано на оси path (по width/2 в обе стороны), а сечение edge начинается на ребре face ∩ edge.
Section profiled — полный профиль:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
profile_ref | ref | да | Ссылка на profiles[].id — полное сечение реза |
В варианте profiled профиль задаёт всю геометрию реза (форму, ширину, заглубление, положение). Полей width, depth и offset нет — возможное смещение закладывается в сам профиль (у профиля есть собственный start, §11.5). Глубина фрезеровки следует из протяжённости профиля вглубь материала (ось Y, §11.5.2). Профиль ДОЛЖЕН быть открытым и привязанным к поверхности входа (§11.5.2, §15.7).
Система координат профиля и ориентация относительно траектории — см. §11.5.2.
9.3.2 Наружный контур (type: "outline")
Outline описывает сквозную фрезеровку, изменяющую наружный контур панели. Траектория — это замкнутый контур (closed: true), описывающий готовую форму панели; её направление обхода (winding) задаёт сторону материала, согласно соглашению CAD. Операция всегда сквозная на всю толщину — полей depth и through нет.
Поле dimensions по-прежнему описывает базовый прямоугольник (заготовку для раскроя); контур outline описывает форму после обработки. Реальной обработкой является разница между контуром и базовым прямоугольником: сегменты, совпадающие со сторонами прямоугольника, — это края заготовки (без реза), а отклоняющиеся сегменты — фактическая фрезеровка.
Флаг machined. Сегмент траектории может нести флаг "machined": true, означающий, что он является реальным резом (отличием от прямоугольника). Если ни один сегмент контура не имеет явного флага, реализация определяет обработку геометрически: сегмент, не лежащий на границе прямоугольника dimensions, является резом. Благодаря этому постпроцессор (например, XCS), а также pre_trim/edging работают только с реально обрабатываемыми участками, а не со всем контуром.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
path | object | да | Замкнутый контур (closed: true) готовой формы; сегменты реза помечены machined |
edging | object | array | нет | Кромка на стенках реза (одна запись или массив записей — разные материалы) |
edge_finish | object | нет | Отделка стенок реза без кромки — шлифовка и фаска (2.2.0) |
По умолчанию стенка реза прямая (вертикальный сквозной проход на всю толщину). Профилирование или фаска стенки конкретного сегмента выполняется отдельной операцией, нацеленной на этот сегмент через on_segment: слотом с профилем (§9.3.1) или скосом (§9.1). Отдельного поля «профиль стенки» в стандарте нет.
Объект edging (общий для outline и hole):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
ref | ref | да | Ссылка на edging_catalog[].id |
walls | string|array | да | "all" или массив указаний стенок |
pre_trim | bool | нет | Выполняет ли кромкооблицовочный станок прифуговку края на толщину кромки перед кромлением — по умолчанию false |
Поле walls указывает, какие стенки реза кромят:
"all"— все реальные стенки реза (дляoutline— сегментыmachined; дляhole— весь периметр).- массив — смешанные позиции: базовые стороны (
"xL","x0","yW","y0") и/илиidсегментов траектории (ссылка наsegments[].id, §10).idсегмента адресует отдельную неосевую стенку (например, конкретный скос), когда её нельзя указать базовой стороной. Сегмент, указанный черезid, ДОЛЖЕН иметьidи быть реальным резом.
pre_trim: true допускается только для type: outline, когда обрабатываемый (machined) участок контура — это один прямой сегмент (линия). Кромкооблицовочный станок не выполнит прифуговку на криволинейном или ломаном крае, поэтому для обработки из дуг, кривых или нескольких сегментов, а также для type: hole pre_trim ДОЛЖЕН оставаться false (или быть опущен).
Форма массива (2.1.0). edging может быть массивом объектов { ref, walls, pre_trim } — разные стенки одного и того же контура, облицованные разными материалами (например, каждый скос — другой кромкой). Каждая запись имеет собственный ref и собственный список walls; одна и та же стенка НЕ ДОЛЖНА встречаться более чем в одной записи. Одиночный объект равнозначен массиву из одного элемента и остаётся корректным.
Отделка стенок (edge_finish, 2.2.0). Объект edge_finish (общий для outline и hole) описывает стенки реза, которые не кромят, а шлифуют и/или снимают на них фаску, — аналог panel.edge_finish (§8.5.1) для стенок контура.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
walls | string|array | да | "all" или массив указаний стенок — как edging.walls |
sanded | bool | да | Стенки шлифованы |
chamfer | mm | да | Размер фаски 45° на обоих рёбрах стенки — у лицевой и у обратной стороны; 0 — без фаски (значение ≥ 0) |
Поле walls означает то же, что и edging.walls: "all" — все реальные стенки реза (для outline — сегменты machined, для hole — весь периметр); массив — базовые стороны и/или id сегментов траектории. Отсутствие edge_finish означает, как и у панели, что файл ничего не говорит об отделке стенок; если поле есть — стенки, не указанные в walls, не отделаны. Одна и та же стенка НЕ ДОЛЖНА одновременно встречаться в edging.walls (в любой записи) и в edge_finish.walls, а фаска ДОЛЖНА помещаться в толщину: 2 × chamfer < dimensions.thickness (§15.8). edge_finish относится только к outline и hole — slot, pocket и biscuit НЕ ДОЛЖНЫ иметь этого поля.
9.3.3 Сквозной вырез (type: "hole")
Hole описывает сквозную фрезеровку внутри панели — траектория ДОЛЖНА целиком лежать внутри прямоугольника dimensions, не касаясь его границы. Операция всегда сквозная на всю толщину — полей depth и through нет.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
path | object | да | Замкнутый контур (closed: true) внутри панели |
edging | object | array | нет | Кромка на стенках выреза (одна запись или массив записей) |
edge_finish | object | нет | Отделка стенок выреза без кромки — шлифовка и фаска (2.2.0) |
По умолчанию стенка выреза прямая (вертикальный сквозной проход). Профилирование/фаска стенки сегмента — отдельной операцией через on_segment (слот §9.3.1 или скос §9.1).
Объект edging — как для outline (выше). Поле pre_trim не применяется (контур выреза не является прямым краем) и ДОЛЖНО быть false или опущено. Объект edge_finish — как для outline (выше).
9.3.4 Карман (type: "pocket")
Pocket описывает несквозную фрезеровку на пласти панели — заглубление на заданную глубину. Траектория может лежать в любом месте (внутри или у границы прямоугольника) — это не меняет семантики: карман не изменяет наружную форму панели.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
face | string | да | "top" | "bottom" |
depth | mm | да | Глубина реза от поверхности пласти |
path | object | да | Контур кармана — ДОЛЖЕН быть замкнутым (closed: true) |
Карман имеет плоское дно на глубине depth и прямые (вертикальные) стенки. Поля профиля стенки кармана в стандарте нет. Если какая-либо стенка должна быть профилирована или иметь фаску, это выполняется отдельным слотом (type: slot, placement: surface) с траекторией path, идущей вдоль этого края, — второй обработкой. (on_segment не поддерживает карманы, поскольку их стенка не сквозная, §9.2.2.)
Карман не поддерживает кромку — стенки кармана не кромят. Кромка на стенках фрезеровки относится только к типам outline и hole. То же касается отделки стенок (edge_finish).
9.3.5 Ламель / biscuit (type: "biscuit")
Biscuit описывает точечную фрезеровку под соединение на ламелях (biscuit). Геометрия следует из размера ламели, заданной в каталоге biscuit_catalog.
Положение x, y описывает ось ламели. Это означает, что размер biscuit_catalog[].thickness распределяется симметрично по обе стороны оси: для thickness: 4 гнездо занимает по 2 мм с каждой стороны оси.
Стандарт различает два варианта ламели:
- Ламель в торце — фрезеровка выполняется со стороны торца панели. Требуется
edge_side(базовая сторона) либоon_segment(край контура), аfaceзапрещено. Положение оси гнезда вдоль края и глубинаzот лицевой стороны — система координат как для торцевой присадки (§9.2.1, §9.2.2): дляy0/yWуказываетсяx, дляxL/x0—y, для контура —on_segment+s; глубина оси по толщине —z(по умолчаниюthickness/2). На схеме панели проекция на пласть — полуэллипс протяжённостьюwidth / 2вглубь панели, а проекция на торец — прямоугольникthickness × length. - Ламель в пласти — фрезеровка выполняется со стороны пласти панели. Требуется
face, аedge_side/on_segmentзапрещены. Положение оси задаютx,y;angleопределяет поворот оси ламели в плоскости пласти. На схеме панели проекция на пласть — прямоугольникthickness × length, центрированный на оси ламели.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
face | string | для пласти | "top" | "bottom" |
edge_side | string | для базового края | "xL" | "x0" | "yW" | "y0" |
on_segment | ref | для края контура | id сегмента outline/hole (§9.2.2) |
x | mm | для пласти; при edge_side: y0/yW | Ось ламели — вдоль длины (§9.2.1) |
y | mm | для пласти; при edge_side: xL/x0 | Ось ламели — вдоль ширины (§9.2.1) |
s | mm | при on_segment | Ось ламели — вдоль сегмента контура (§9.2.2) |
z | mm | нет (для торца) | Глубина оси от лицевой стороны; по умолчанию thickness/2 |
angle | degrees | нет | Угол поворота соединения в плоскости поверхности — по умолчанию 0 |
size_ref | ref | да | Ссылка на biscuit_catalog[].id |
10. Геометрия траектории (path)
Объект path задаёт геометрию операции фрезеровки как последовательность сегментов.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
start | object | да | Начальная точка {x, y} — абсолютная в системе координат панели |
closed | bool | да | true — замкнутый контур, false — открытая траектория |
segments | array | да | Массив сегментов — мин. 1 элемент |
Точка start: x от нижнего края (вдоль длины), y от правого края (вдоль ширины), в мм.
10.1 Линейный сегмент (type: "line")
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
type | string | да | "line" |
id | string | нет* | Идентификатор сегмента — см. примечание под §10.3 |
end | object | да | Конечная точка {x, y} |
machined | bool | нет | (только outline) сегмент является реальным резом — см. §9.3.2 |
10.2 Дуговой сегмент (type: "arc")
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
type | string | да | "arc" |
id | string | нет* | Идентификатор сегмента — см. примечание под §10.3 |
center | object | да | Центр дуги {x, y} |
radius | mm | да | Радиус дуги |
angle_start | degrees | да | Начальный угол (0° — ось X+) |
angle_end | degrees | да | Конечный угол |
clockwise | bool | да | Направление вращения — соответствует G2 (true) / G3 (false) |
machined | bool | нет | (только outline) сегмент является реальным резом — см. §9.3.2 |
10.3 Сегмент Безье (type: "bezier")
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
type | string | да | "bezier" |
id | string | нет* | Идентификатор сегмента — см. примечание под §10.3 |
cp1 | object | да | Первая контрольная точка {x, y} |
cp2 | object | да | Вторая контрольная точка {x, y} |
end | object | да | Конечная точка {x, y} |
machined | bool | нет | (только outline) сегмент является реальным резом — см. §9.3.2 |
Поле machined имеет значение только для type: outline — оно обозначает сегмент, являющийся реальной обработкой (отличием контура от базового прямоугольника). Для остальных типов оно игнорируется.
* Поле id (string, необязательное) обязательно, если сегмент является целью on_segment какой-либо операции по краю — drilling, biscuit, slot или bevel (§9.2.2). id ДОЛЖЕН быть уникальным в пределах всей панели (среди всех траекторий path её операций), чтобы ссылка on_segment однозначно указывала на сегмент без указания траектории.
Каждый сегмент начинается там, где закончился предыдущий. Для первого сегмента начальной точкой является path.start.
Для замкнутой траектории (closed: true) последний сегмент ДОЛЖЕН заканчиваться в точке path.start, либо реализация ДОЛЖНА автоматически замкнуть траекторию линейным сегментом.
11. Каталоги
11.1 Каталог материалов (materials_catalog)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор в каталоге |
code | string | нет | Каталожный код производителя |
name | string | да | Название материала |
manufacturer | string | нет | Производитель |
category | string | да | "board" | "veneer" | "laminate" | "paint" | "surface" |
furniture | bool | нет | Мебельный материал — по умолчанию true (§11.1.1) |
Дополнительные поля в зависимости от category:
board, veneer, laminate:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
thickness | mm | да | Номинальная толщина |
grain | string | да | "along_length" | "along_width" | "none" |
board (только):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
sheet | object | да | Размеры листа |
Объект sheet:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
length | mm | да | Длина листа (ось along_length) |
width | mm | да | Ширина листа |
trim | mm | да | Опиловка с каждой стороны |
Максимальный полезный размер листа: sheet.length − 2×trim и sheet.width − 2×trim.
paint:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
color_system | string | нет | Система цвета, например "RAL", "NCS" |
color_code | string | нет | Код цвета, например "9016" |
description | string | нет | Произвольное описание, например "biały połysk 90%" |
surface:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
color | string | нет | Цвет #RRGGBB, например "#F2F0EB" |
Материал surface описывает только внешний вид — штукатурку, стеновую краску, сталь, стекло, пластик — без толщины и листа. Он ДОЛЖЕН иметь furniture: false.
11.1.1 Мебельный материал (furniture)
Поле furniture говорит, производят ли что-либо из материала. Немебельный материал (furniture: false) — штукатурка стены, сталь петли, стекло, зеркало — служит только для внешнего вида или заказывается вне мебельного производства.
- Производственная реализация (раскрой, потребность в материале, заказ материала, файлы для станков) ДОЛЖНА пропускать панели из немебельного материала. Панель остаётся в файле, чтобы сборщик видел её на месте.
- Реализации, отображающей модель, СЛЕДУЕТ позволять одной командой скрыть всё, что имеет немебельный материал.
- Отсутствие поля означает
true— файлы версий до 2.3.0 означают то же, что и раньше.
Тело не идёт в производство независимо от материала (§7.6), а фурнитуру считают по каталогу фурнитуры (§12), а не по материалу её геометрии.
11.2 Каталог кромок (edging_catalog)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор |
code | string | нет | Каталожный код |
name | string | да | Название кромки |
texture | bool | да | Есть ли у кромки структура (текстура) |
thickness | mm | да | Толщина кромочной ленты |
height | mm | да | Высота ленты (до обрезки) |
material_ref | ref | да | Ссылка на materials_catalog[].id |
11.3 Каталог присадки (drilling_catalog)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор |
code | string | нет | Каталожный код |
name | string | да | Название типа присадки |
diameter | mm | да | Диаметр отверстия |
depth | mm | при through: false | Глубина отверстия |
through | bool | да | Сквозная ли присадка |
Если through: true, поле depth необязательно и игнорируется. Глубину сквозной присадки определяет толщина панели.
11.4 Каталог фурнитуры (hardware_catalog)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор |
code | string | нет | Каталожный код производителя |
name | string | да | Название единицы фурнитуры |
manufacturer | string | нет | Производитель |
11.5 Каталог геометрических профилей (profiles)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор |
code | string | нет | Каталожный код |
name | string | да | Название профиля |
start | object | нет | Начальная точка сечения {x, y} — по умолчанию {0, 0} |
path | array | да | Сечение результирующей геометрии реза — массив сегментов (line / arc / bezier) |
11.5.1 Что описывает профиль
Профиль описывает поперечное сечение результирующей геометрии реза — форму, которая возникает в материале или на торце. Он не описывает геометрию режущего инструмента. Подбор инструмента для выполнения данного профиля — это знание CAM.
11.5.2 Система координат профиля
Профиль описывает поперечное сечение в локальной 2D-системе отсчёта. Первая точка сечения — start (по умолчанию (0, 0)); последующие сегменты path идут от неё. Система отсчёта зависит от placement слота (§9.3.1):
Слот edge — (0, 0) привязана к ребру торца:
Нулевая точка (0, 0) = ребро (face ∩ edge_side / on_segment)
X+ = вглубь материала от края (перпендикулярно краю, вдоль пласти)
Y+ = вглубь толщины от пласти (Y = 0 — плоскость пласти)Слот surface — (0, 0) на оси path в плоскости пласти:
Нулевая точка (0, 0) = ось path на плоскости пласти (face)
X+ = поперёк, в правую сторону траектории относительно её локального направления (в плоскости пласти)
Y+ = вглубь толщины от поля faceДля криволинейных сегментов локальное направление (а значит, и ось X) направлено по касательной к траектории в данной точке.
Поверхность входа и глубина. Линия Y = 0 — это поверхность входа инструмента (пласть для surface, край/ребро для edge). Глубина фрезеровки следует из протяжённости профиля вглубь материала — max(Y) по всем точкам сечения. Профиль ДОЛЖЕН быть открытым и привязанным к поверхности входа: его крайние концы лежат на линии Y = 0, а удаляемый материал — это область, замкнутая между профилем и этой линией. Замкнутый профиль (петля) или профиль, оторванный от Y = 0, описывает невыполнимый рез (валидация, §15.7).
Центрирование и смещение. Поскольку первая точка — это start, профиль можно произвольно расположить относительно траектории без отдельного поля — например, паз, центрированный на оси path, описывается профилем, начинающимся в start.x = −width/2. В варианте profiled всё позиционирование заложено в профиль (его start и геометрию); у слота тогда нет поля offset (§9.3.1).
11.5.3 Примеры
Скругление R5 на ребре торца:
[{ "type": "arc", "center": { "x": 5, "y": 5 }, "radius": 5,
"angle_start": 270, "angle_end": 180, "clockwise": false }]Интерпретация: новая поверхность проходит 5 мм вдоль пласти (X=0→5) и 5 мм вдоль торца (Y=0→5), соединяя эти точки дугой R5.
Паз 5×3 мм, ось в 9 мм от лицевой стороны (паз под задние стенки из HDF):
[{ "type": "line", "end": { "x": 3, "y": 6.5 } },
{ "type": "line", "end": { "x": 3, "y": 11.5 } },
{ "type": "line", "end": { "x": 0, "y": 11.5 } }]Профиль начинается на границе материала (0, 0), заглубляется на 3 мм (X=3), идёт между Y=6,5 и Y=11,5 (ширина 5 мм) и возвращается к X=0.
Паз 12 мм с полукруглым дном R6, центрированный на оси path (слот surface, profiled — использует start):
{
"start": { "x": -6, "y": 0 },
"path": [
{ "type": "line", "end": { "x": -6, "y": 4 } },
{ "type": "arc", "center": { "x": 0, "y": 4 }, "radius": 6,
"angle_start": 180, "angle_end": 0, "clockwise": true },
{ "type": "line", "end": { "x": 6, "y": 0 } }
]
}start = (−6, 0) лежит на поверхности входа, в 6 мм сбоку от оси path (оси соответствует X = 0); профиль охватывает траекторию по 6 мм в обе стороны, дно на Y = 10 (глубина фрезеровки 10 мм), оба конца на Y = 0. Здесь система отсчёта — слота surface: X поперёк траектории, Y вглубь толщины.
11.6 Каталог ламелей (biscuit_catalog)
Поле biscuit_catalog необязательное. Обязательно, если в операциях встречается type: "biscuit".
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор |
code | string | нет | Каталожный код производителя |
name | string | да | Название ламели |
length | mm | нет | Длина ламели |
width | mm | нет | Ширина ламели (глубина погружения в материал) |
thickness | mm | нет | Толщина ламели / ширина гнезда, измеряемая симметрично относительно оси |
11.7 Каталог сеток (meshes_catalog)
Поле meshes_catalog необязательное. Обязательно, если какая-либо геометрия имеет type: "mesh".
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор |
name | string | да | Название сетки |
positions | array | да | Координаты вершин x, y, z подряд, в мм, в системе координат тела (§14.5) — длина кратна 3 |
triangles | array | да | Индексы вершин, по три на треугольник, отсчёт от 0 — длина кратна 3 |
Вершины треугольника указываются против часовой стрелки, если смотреть снаружи тела, — нормаль направлена наружу (правая система координат). Сетка МОЖЕТ быть открытой (поверхность вместо тела).
Файл .meb самодостаточен: сетка всегда встроена в него самого. Стандарт не предусматривает ссылок на внешние файлы или каталоги.
12. Фурнитура (type: "hardware")
Фурнитура — это узел дерева (§7.2), лист, который находится в любой группе или в корне:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
type | string | да | "hardware" |
id | id | да | Идентификатор узла, уникальный в файле, — на него указывают обработки (§12.1) |
name | string | да | Произвольная метка |
hardware_ref | ref | да | Ссылка на hardware_catalog[].id |
quantity | number | да | Количество штук — целое число > 0 |
position | object | нет | Положение {x, y, z} относительно родителя, мм |
rotation | object | при position | Поворот Эйлера XYZ {x, y, z}, градусы |
material_ref | ref | при position | Ссылка на materials_catalog[].id — внешний вид фурнитуры |
geometry | object | при position | Упрощённая геометрия фурнитуры — как у тела (§7.6.1) |
Фурнитура без положения — это строка списка с количеством (шурупы, шканты в пакете) в своей группе: у неё нет position и rotation.
Фурнитура с положением (position) — это одна штука на своём месте: петля, направляющая, ручка, крепёж. Она ДОЛЖНА иметь rotation, material_ref и geometry, а также quantity: 1. Геометрия служит только для внешнего вида: фурнитуру считают и заказывают по hardware_ref, а не по материалу геометрии.
12.1 Обработки фурнитуры
Присадка и фрезеровка, которые следуют из фурнитуры, указывают на неё полем hardware_instance_ref. Связь идёт от обработки к фурнитуре, поскольку у одной единицы фурнитуры есть обработки на нескольких панелях — эксцентрик, направляющая, петля с монтажной планкой на боковине. Обработка МОЖЕТ указывать на фурнитуру из другой группы, в том числе из другого шкафа (стяжка, соединяющая два шкафа).
- Обработка ДОЛЖНА указывать на фурнитуру с положением.
- Реализация, которая удаляет фурнитуру, ДОЛЖНА удалить все обработки, которые на неё указывают.
- Реализация, которая перемещает фурнитуру, ДОЛЖНА переместить вместе с ней все обработки, которые на неё указывают.
Крепёж (конфирмат, эксцентрик, шкант) описывается так же: фурнитура с положением, присадка которой на обеих панелях указывает на одну и ту же штуку.
13. Группы совпадения текстуры (grain_groups)
Группа совпадения текстуры — это блок панелей, вырезанных из одного куска плиты так, что текстура переходит с панели на панель. Блок состоит из рядов, расположенных друг за другом вдоль текстуры, а ряд — из панелей, расположенных рядом друг с другом поперёк текстуры; у каждого ряда своё выравнивание (§13.2). Полоса панелей, вырезанных одна за другой (значение группы до версии 2.4.0), — это блок, в каждом ряду которого одна панель.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор группы |
name | string | да | Название группы |
material_ref | ref | да | Ссылка на materials_catalog[].id |
orientation | string | нет | Текстура относительно фасада мебели: "vertical" (по умолчанию) | "horizontal" — см. §13.1 |
kerf | mm | да | Ширина пропила пилы между панелями — между рядами и между панелями в ряду |
members | array | да | Панели в группе — мин. 2 элемента |
rows | array | нет | Выравнивание рядов — см. §13.2; ряд без записи прижат к начальному краю |
Объект member:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
panel_ref | ref | да | Ссылка на id узла панели в любом месте дерева |
row | integer | нет | Номер ряда вдоль текстуры — целое число, последовательность 1…n в группе |
order | integer | да | Позиция в ряду, отсчитываемая от начального края, — целое число, последовательность 1…m в ряду |
Объект rows[] (2.6.0):
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
row | integer | да | Номер ряда группы, к которому относится запись |
align | string | да | Выравнивание ряда: "start" | "center" | "end" — см. §13.2 |
13.1 Ряды и позиции
Блок описывается в виде на лицевую сторону панелей. Лицевая сторона (top, §14) панели группы — это сторона, видимая снаружи мебели: на неё смотрят, оценивая совпадение текстуры, и в ней лежат ряды и позиции блока. Обработки, выполняемые изнутри мебели (например, чашки петель дверей), лежат тогда на обратной стороне панели (bottom). Программа-источник ДОЛЖНА описать каждую панель группы лицевой стороной наружу — панель, описанная лицевой стороной внутрь, была бы в блоке зеркальным отражением самой себя и получила бы обработки не с той стороны текстуры.
Поле orientation говорит, как в блоке идёт текстура, и задаёт ряды, а также начальный край, от которого отсчитывается позиция в ряду:
orientation | Текстура на фасаде | Ряд | Ряд 1 | Начальный край |
|---|---|---|---|---|
"vertical" (по умолчанию) | вертикально | горизонтальная полоса на всю ширину блока | вверху | левый |
"horizontal" | горизонтально | вертикальная полоса на всю высоту блока (столбец) | слева | нижний |
- Ряды лежат друг за другом вдоль текстуры: текстура переходит из ряда
nв рядn + 1. - Панели ряда лежат рядом друг с другом поперёк текстуры; позиция
order: 1находится ближе всего к начальному краю, а каждая следующая лежит дальше от него — независимо от выравнивания ряда. - Все панели ряда имеют одинаковый размер вдоль текстуры (§15.4).
- Ряд уже самого широкого прижат к краю, указанному выравниванием (§13.2), а остаток его ширины лежит с другой стороны.
Элемент без поля row — это отдельный ряд: номер ряда = его order, позиция в ряду = 1. Поэтому группа без row означает в точности то же, что в версии 2.4.0 и более ранних, — полосу панелей, каждая в отдельном ряду. Реализация, читающая версию 2.5.0 и новее, ДОЛЖНА принимать элементы без row в этом значении.
Пример — текстура вертикальная, ряд из трёх фасадов шириной 500 мм (высота 300 мм) над рядом из двух фасадов шириной 750 мм (высота 1000 мм). Текстура переходит с трёх панелей на две, а стыки приходятся на разные места:
текстура ↓
ряд 1 │ 1: 500 │ 2: 500 │ 3: 500 │ выс. 300
ряд 2 │ 1: 750 │ 2: 750 │ выс. 1000{
"id": "gg_fronty",
"name": "Fronty zabudowy",
"material_ref": "mat_dab",
"orientation": "vertical",
"kerf": 4.4,
"members": [
{ "panel_ref": "p_szuflada_1", "row": 1, "order": 1 },
{ "panel_ref": "p_szuflada_2", "row": 1, "order": 2 },
{ "panel_ref": "p_szuflada_3", "row": 1, "order": 3 },
{ "panel_ref": "p_drzwi_lewe", "row": 2, "order": 1 },
{ "panel_ref": "p_drzwi_prawe", "row": 2, "order": 2 }
]
}13.2 Выравнивание ряда (2.6.0)
У каждого ряда своё выравнивание: оно говорит, к какому краю блока прижат ряд, а значит, с какой стороны лежит остаток ширины ряда, более узкого, чем самый широкий. Выравнивание задаёт запись в rows[]; ряд без записи имеет "start", то есть значение из версии 2.5.0.
align | Буква (§13.3) | Текстура вертикальная | Текстура горизонтальная | Остаток ширины ряда |
|---|---|---|---|---|
"start" (по умолчанию) | P — начало | к левому краю | к нижнему краю | со стороны конца |
"center" | S — центр | по центру | по центру | по половине с обеих сторон |
"end" | K — конец | к правому краю | к верхнему краю | со стороны начала |
Выравнивание не меняет нумерацию: позиции (order) всегда отсчитываются от начального края. Ряду шириной во весь блок выравнивание не нужно — запись в нём ничего не меняет. Как вырезать остаток ширины (одним или двумя кусками, их размер с учётом пропилов), решает программа раскроя.
Пример — текстура вертикальная, ряд из двух фасадов ящиков шириной 600 мм (высота 200 мм) над дверью шириной 900 мм (высота 1000 мм) по центру:
текстура ↓
ряд 1 P │ 1: 600 │ 2: 600 │ выс. 200
ряд 2 S │ … │ 1: 900 │ … │ выс. 1000{
"id": "gg_witryna",
"name": "Witryna",
"material_ref": "mat_dab",
"orientation": "vertical",
"kerf": 4.4,
"members": [
{ "panel_ref": "p_witryna_szuflada_1", "row": 1, "order": 1 },
{ "panel_ref": "p_witryna_szuflada_2", "row": 1, "order": 2 },
{ "panel_ref": "p_witryna_drzwi", "row": 2, "order": 1 }
],
"rows": [
{ "row": 2, "align": "center" }
]
}13.3 Обозначение места в блоке (2.6.0)
Место панели в блоке записывается одной строкой #B.RA.P:
| Часть | Значение | Поле |
|---|---|---|
B | номер блока — целое число ≥ 1, один на группу в проекте | группа (grain_groups[]) |
R | номер ряда | members[].row |
A | буква выравнивания ряда: P — начало, S — центр, K — конец (одна для обоих направлений текстуры) | rows[].align |
P | позиция в ряду от начального края | members[].order |
Пример: #1.2S.1 — блок 1, ряд 2 выровнен по центру, панель 1 в ряду; #2.2P.2 — блок 2, ряд 2 выровнен по началу, панель 2. Регулярное выражение записи: #(\d+)\.(\d+)([PSK])\.(\d+).
Обозначение служит двум целям:
- программа без совпадения текстуры (например, программа проектирования без групп совпадения текстуры) переносит блок в названиях панелей — проектировщик вписывает обозначение в название, глядя на мебель снаружи (§13.1), а конвертер в .meb создаёт по нему группы: одну группу на номер блока,
rowиorderиз обозначения, записьrows[]из буквы ряда. Все панели одного ряда ДОЛЖНЫ иметь одну и ту же букву. Направления текстуры блока (orientation) обозначение не несёт — конвертер берёт его из направления текстуры панелей в мебели. Конвертер МОЖЕТ удалить обозначение из названия панели, поскольку его содержание несут поля группы, - программе, показывающей блок (список панелей, этикетка, карта раскроя), СЛЕДУЕТ записывать место панели этой записью — номер блока она тогда присваивает в своих пределах (например, в заказе).
Правила валидации группы — см. §15.4.
14. Система координат
14.1 Каноническая ориентация панели
Все операции обработки (face, edge_side, x, y присадки и фрезеровки) относятся к канонической базовой позиции панели, независимо от её rotation в дереве. Соглашение: лицевая сторона вверх, длина по вертикали, ширина по горизонтали, система координат правая (согласованная с 3D-сценой, без зеркального отражения). Координата x идёт вдоль длины (0..length), y — вдоль ширины (0..width, растёт влево); начало координат — правый нижний угол лицевой стороны.
x = length (L) ▲ (вертикаль; текстура «along_length»)
│
┌────────────── xL ─────────────┐ ── x = L (верх)
│ │
yW │ ЛИЦЕВАЯ СТОРОНА │ y0
│ face: top (Z+) │
│ │
└────────────── x0 ─────────────┘ ── x = 0 (начало координат, правый нижний угол)
y = W ◄─────────────────────────────── y = 0
(горизонталь; ширина растёт влево)length(L) — длина, вертикаль; координатаx ∈ [0, L].width(W) — ширина, горизонталь (растёт влево); координатаy ∈ [0, W].thickness(T) — толщина, ось Z (Z+— лицевая сторона /face: top,Z−— обратная сторона /face: bottom).- Края
edge_side:y0/yW— края по длине;xL/x0— края по ширине.
Фрезеровка, описанная как face: top, всегда относится к лицевой стороне панели, даже если панель стоит вертикально в собранном шкафу. Поле rotation панели служит исключительно для 3D-визуализации и создания сборочных схем (локальная 3D-система: length → X, width → Y, thickness → Z).
14.2 Система координат группы и передняя сторона
Локальная система координат каждой группы — шкафа, ящика, комплекта:
Z+ (верх)
│
│ Y+ (зад)
│ /
│ /
│ /
└────── X+ (право)
front = сторона Y- (двери / фасады ящиков) — по умолчанию
начало координат шкафа = левый нижний передний угол габарита (наружный)Положения дочерних узлов задаются в системе координат группы — левая боковина шкафа начинается на x = 0.
Передняя сторона группы — это сторона, указанная полем front, по умолчанию -Y; верх — +Z. Ориентацию группы в сцене несёт её поворот (rotation) — шкаф, переставленный к другой стене, смотрит в новую сторону вместе с поворотом. Поле front редактируемое: программа, у которой в системе координат группы передняя сторона находится с другой стороны, указывает её в этом поле. Реализация МОЖЕТ пересчитать систему координат группы так, чтобы передней стороной была -Y (поворот системы вокруг Z с пересчётом положений дочерних узлов), — группа при этом в сцене не перемещается.
Производственный чертёж шкафа (группы с ролью "cabinet") всегда создаётся в его системе координат, с видом на переднюю сторону. Поле rotation шкафа в дереве игнорируется производственным ПО при создании чертежей.
14.3 Каскадный принцип преобразований
Каждый узел задаёт position и rotation относительно родителя. Глобальное положение объекта определяется композицией преобразований всех предков:
глобальное_положение = T(group_1) × T(group_2) × ... × T(group_n) × T(узел)Эта модель напрямую совместима с Object3D в Three.js и Babylon.js.
14.4 Размер панели и кромление
Размеры в поле dimensions — всегда чистовые размеры после кромления: кромка в них уже включена.
Стандарт .meb не описывает черновой размер (до кромления). Возможное уменьшение размера на толщину кромки — задача технологии кромления, реализуемой на самом станке, и зависит от его параметров. Реализации раскроя и просмотра работают исключительно с чистовыми размерами из поля dimensions.
14.5 Система координат тела и фурнитуры
Тело и фурнитура с положением имеют собственную локальную правую систему координат, размещённую через position и rotation относительно родителя (§14.3) — группы или корня.
extrusion— контур лежит в плоскостиXYсистемы координат тела, выдавливание идёт отZ = 0доZ = thickness,mesh— координатыpositionsзаданы в системе координат тела, в мм,polyhedron— координаты вершин заданы в системе координат тела, в мм.
15. Правила валидации
15.1 Уникальность идентификаторов
Реализация ДОЛЖНА сообщить об ошибке валидации, если:
- два узла дерева (группа, панель, фурнитура, тело) имеют одинаковый
id - две записи в одном и том же каталоге имеют одинаковый
id - две вершины, два ребра или две грани одного многогранника имеют одинаковый
id
Идентификаторы ЯВЛЯЮТСЯ глобальными в пределах своей коллекции. id узла глобален во всём дереве, независимо от типа узла и группы, в которой он находится. Идентификаторы элементов многогранника локальны: уникальны в пределах своего списка в одном многограннике.
15.2 Целостность ссылок
Каждая ссылка *_ref ДОЛЖНА указывать на существующий id в целевой коллекции:
| Ссылка | Цель |
|---|---|
panel.material_ref | materials_catalog[].id |
panel.composite.layers[].material_ref | materials_catalog[].id (категория board) |
panel.grain_group_ref | grain_groups[].id |
panel.edging.{side}.ref | edging_catalog[].id |
edging_catalog[].material_ref | materials_catalog[].id |
drilling.drilling_ref | drilling_catalog[].id |
routing.profile_ref (type: slot, section: profiled) | profiles[].id |
routing.size_ref (type: biscuit) | biscuit_catalog[].id |
routing.edging.ref | edging_catalog[].id |
hardware.hardware_ref (узел фурнитуры) | hardware_catalog[].id |
hardware.material_ref | materials_catalog[].id |
solid.material_ref (узел тела) | materials_catalog[].id |
geometry.mesh_ref | meshes_catalog[].id |
geometry.edges[].start, geometry.edges[].end, geometry.faces[].loops[][] | vertices[].id того же многогранника |
drilling.hardware_instance_ref, routing.hardware_instance_ref | id узла фурнитуры с положением |
grain_group.material_ref | materials_catalog[].id |
grain_group.members[].panel_ref | id узла панели в дереве |
comment_refs[] | comments[].id |
15.3 Диапазоны значений
| Поле | Условие |
|---|---|
dimensions.length, width, thickness | > 0 |
drilling.x, y | ≥ 0 |
bevel.angle | 0 < angle < 90 |
bevel.leave | ≥ 0 |
bend.radius | > 0 |
bend.angle | 0 < angle ≤ 360 |
hardware.quantity (узел фурнитуры) | целое число > 0; = 1, если у фурнитуры есть position |
geometry.thickness (extrusion) | > 0 |
grain_group.kerf | > 0 |
finish.order | целое число > 0 |
edge_finish.chamfer (панель и routing) | ≥ 0 и 2 × chamfer < dimensions.thickness |
15.4 Валидация групп совпадения текстуры
Элемент без row в этих правилах — это ряд с номером, равным его order, с позицией 1 (§13.1).
Реализация ДОЛЖНА сообщить об ошибке, если:
- Одна и та же панель входит более чем в одну группу совпадения текстуры.
- Панель в группе использует материал, отличный от
grain_group.material_ref. - Номера рядов в группе не образуют непрерывной последовательности (1, 2, …, n) или позиции в каком-либо ряду не образуют непрерывной последовательности без повторов (1, 2, …, m). В группе без
rowэто прежнее правило: значенияorderобразуют непрерывную последовательность без повторов (1, 2, …, n). - Панели одного ряда имеют разные размеры вдоль текстуры
D(panel). - Блок не помещается в полезную часть листа вдоль или поперёк текстуры:
D(panel) = dimensions.length если panel.grain = "along_length" ← размер вдоль текстуры
D(panel) = dimensions.width если panel.grain = "along_width"
C(panel) = dimensions.width если panel.grain = "along_length" ← размер поперёк текстуры
C(panel) = dimensions.length если panel.grain = "along_width"
D(ряд) = D(panel) панелей ряда (общий — п. 4)
C(ряд) = Σ C(i) + (m − 1) × kerf m — число панелей в ряду
Σ D(ряд) + (n − 1) × kerf ≤ max_along_grain n — число рядов
max C(ряд) ≤ max_across_grainгде max_along_grain = sheet.length − 2×trim и max_across_grain = sheet.width − 2×trim, если текстура материала идёт вдоль длины листа (material.grain = "along_length"); при material.grain = "along_width" — наоборот.
В группе без row в каждом ряду одна панель: п. 5 вдоль текстуры — это прежнее правило Σ D(i) + (n − 1) × kerf ≤ max_along_grain, а поперёк текстуры он совпадает с §15.5.
- Запись
rows[]указывает на ряд, которого в группе нет, или две записи указывают на один и тот же ряд (2.6.0).
Лицевую сторону панели снаружи (§13.1) валидация файла не проверит — она определяется сценой и замыслом проектировщика; за неё отвечает программа-источник.
15.5 Валидация размера панели
Панель ДОЛЖНА помещаться в лист материала:
panel.dimensions.length ≤ sheet.length − 2×trim
panel.dimensions.width ≤ sheet.width − 2×trimили после поворота на 90° — только если material.grain = "none" или panel.grain = "none":
panel.dimensions.width ≤ sheet.length − 2×trim
panel.dimensions.length ≤ sheet.width − 2×trimЕсли и материал, и панель имеют заданную текстуру (grain ≠ "none"), поворот недопустим.
Правило согласовано с иерархией текстуры (§8.3): поворот запрещает только ситуация, в которой у материала есть текстура и панель её учитывает (panel.grain ≠ "none"). Если у материала нет текстуры, panel.grain не имеет значения.
15.6 Валидация композиции (composite)
Реализация ДОЛЖНА сообщить об ошибке, если:
- Сумма толщин слоёв не равна
panel.dimensions.thickness:Σ layers[].thickness ≠ dimensions.thickness. - Значения
orderне образуют непрерывной последовательности 1…n (повторы или пропуски). material_refслоя указывает на материал, отличный отboard.
15.7 Валидация операций
| Условие | Ошибка |
|---|---|
Скос leave + depth > dimensions.thickness | ошибка |
Скос с несколькими записями на одном и том же крае с одной и той же стороны без поля depth | ошибка |
Скос без ровно одного из edge_side / on_segment | ошибка |
Скос on_segment, нацеленный на сегмент, отличный от line | ошибка |
Слот без ровно одного placement (path или edge_side/on_segment) | ошибка |
Слот section: simple без width+depth; section: profiled без profile_ref | ошибка |
Слот profiled: профиль замкнут или не привязан к Y=0 (невыполнимый рез) | предупреждение |
on_segment на сегмент без id, несуществующий или с неоднозначным в пределах панели id | ошибка |
on_segment вне сквозного сегмента (outline machined / hole) | ошибка |
| Траектория фрезеровки за пределами контура панели | предупреждение |
edging.sequence вне перечисления (width_first | length_first) | ошибка |
routing.edging.pre_trim: true вне type: outline с одним прямым сегментом machined | ошибка |
machined на сегменте операции, отличной от outline | предупреждение |
15.8 Валидация отделки торца (edge_finish)
Реализация ДОЛЖНА сообщить об ошибке, если:
- Один и тот же край панели одновременно имеет кромку и отделку —
edging.{side}иedge_finish.{side}оба отличны отnull. - Одна и та же стенка контура
outline/holeуказана одновременно вedging.walls(в любой записи) и вedge_finish.wallsтой же операции."all"указывает на все реальные стенки реза. - Фаска не помещается в толщину панели:
2 × chamfer ≥ dimensions.thickness— дляpanel.edge_finishиrouting.edge_finish.
15.9 Валидация тел и фурнитуры
Реализация ДОЛЖНА сообщить об ошибке, если:
- Контур или отверстие геометрии
extrusionне замкнуты (closed: false). - Отверстие геометрии
extrusionвыходит за пределы контура или пересекает другое отверстие. - Длина
positionsилиtrianglesсетки не кратна 3, у сетки менее 3 вершин или индекс вtrianglesуказывает на несуществующую вершину. - Фурнитура с
positionне имеетid,rotation,material_refилиgeometryлибо имеетquantity, отличное от 1. hardware_instance_refуказывает на фурнитуру без положения.- Материал
category: surfaceне имеетfurniture: false. - Узел, отличный от группы, содержит
children. - Ребро многогранника имеет
start, равныйend. - Контур грани многогранника имеет менее 3 вершин, повторяет вершину или две его соседние вершины не являются концами ни одного ребра из
edges. - Вершина грани многогранника лежит дальше чем на 0,01 мм от плоскости грани или отверстие грани выходит за пределы внешнего контура либо пересекает внешний контур или другое отверстие.
15.10 Валидация дерева (3.0.0)
Реализация ДОЛЖНА сообщить об ошибке, если:
- Узел, отличный от группы, содержит
children. - Группа с ролью
"cabinet"имеет среди потомков — на любой глубине — группу с ролью"cabinet". - В файле с 3D-данными (
project.has_3dотлично отfalse) узел, который не является фурнитурой без положения, не имеетpositionилиrotation.
Роль, которую реализация не знает, не является ошибкой — группа тогда считается группой без роли (§7.4).
16. Комментарии (comments)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | id | да | Уникальный идентификатор комментария |
author | string | нет | Автор комментария |
date | datetime | нет | Дата добавления |
text | string | да | Текст комментария |
Комментарии хранятся в глобальном списке comments[]. Объекты ссылаются на них через массив comment_refs[]. Один и тот же комментарий МОЖЕТ быть привязан к нескольким объектам.
Объекты, поддерживающие comment_refs[]: узлы дерева (group, panel, hardware, solid), bevel, drilling, routing, finish.
Приложение A — Таблица обязательных полей по объектам
| Объект | Обязательные поля |
|---|---|
MebFile | meta, project, scene, materials_catalog, edging_catalog, drilling_catalog, hardware_catalog, profiles |
meta | version, created_at |
project | id, name |
node | id, name, type + position, rotation (кроме фурнитуры без положения и файла без 3D-данных) |
group | + children |
solid (узел) | + material_ref, geometry |
geometry (extrusion) | type, outline, thickness |
geometry (mesh) | type, mesh_ref |
geometry (polyhedron) | type, vertices, edges, faces |
geometry.vertices[] | id, x, y, z |
geometry.edges[] | id, start, end |
geometry.faces[] | id, loops |
panel (узел) | type, id, name, dimensions, material_ref, grain + position, rotation в файле с 3D-данными |
panel.edge_finish.{side} | sanded, chamfer |
composite | layers (мин. 2 элемента) |
composite_layer | order, material_ref, thickness |
bevel | from_face, angle, leave + (edge_side или on_segment) |
drilling (face) | drilling_ref, type: face, face, x, y |
drilling (edge/сторона) | drilling_ref, type: edge, edge_side + x (L/R) или y (T/B); z необязательно |
drilling (edge/контур) | drilling_ref, type: edge, on_segment, s; z необязательно |
routing (slot/surface/simple) | type, section: simple, face, path, width, depth |
routing (slot/surface/profiled) | type, section: profiled, face, path, profile_ref |
routing (slot/edge/simple) | type, section: simple, face, (edge_side или on_segment), width, depth |
routing (slot/edge/profiled) | type, section: profiled, face, (edge_side или on_segment), profile_ref |
routing (outline) | type, path |
routing (hole) | type, path |
routing.edge_finish (outline / hole) | walls, sanded, chamfer |
routing (pocket) | type, face, path, depth |
routing (biscuit/edge-сторона) | type, edge_side, size_ref + x (L/R) или y (T/B); z необязательно |
routing (biscuit/edge-контур) | type, on_segment, s, size_ref; z необязательно |
routing (biscuit/face) | type, face, size_ref, x, y |
material (board) | id, name, category, thickness, grain, sheet |
material (veneer/laminate) | id, name, category, thickness, grain |
material (paint) | id, name, category |
material (surface) | id, name, category, furniture: false |
meshes_catalog | id, name, positions, triangles |
edging_catalog | id, name, texture, thickness, height, material_ref |
drilling_catalog | id, name, diameter, through + depth при through: false |
hardware_catalog | id, name |
profiles | id, name, path |
hardware (узел) | type, id, name, hardware_ref, quantity |
hardware (с положением) | + position, rotation, material_ref, geometry; quantity: 1 |
grain_group | id, name, material_ref, kerf, members |
grain_group.member | panel_ref, order |
comment | id, text |
Приложение B — Чтение файлов 2.x
Реализация, читающая версию 3.0, МОЖЕТ читать файлы 2.x. Если она их читает, ей СЛЕДУЕТ преобразовать их при чтении в дерево 3.0 и дальше работать одним путём:
| 2.x | 3.0 |
|---|---|
узел type: "cabinet" | группа type: "group", role: "cabinet", с теми же id, name, position, rotation, production_id, comment_refs и front |
cabinet.panels[] | дочерние узлы шкафа с type: "panel" |
cabinet.hardware[] | дочерние узлы шкафа с type: "hardware"; фурнитура без id получает идентификатор, уникальный в файле, а без названия — название из hardware_catalog |
cabinet.solids[] | дочерние узлы шкафа с type: "solid" |
узлы group и solid | без изменений |
grain_groups, каталоги, комментарии | без изменений — идентификаторы панелей не меняются |
Версия 2.6.0 — последняя версия 2.x.