Specyfikacja formatu .meb
Status:
[x]gotowe — wersja 3.0.0
Dokument normatywny. Implementacje muszą być z nim zgodne.
Słownik pojęć: 01-glossary.md. Model danych: 02-data-model.md. Referencja pól: 04-field-reference.md.
1. Format pliku
1.1 Rozszerzenie i MIME type
| Właściwość | Wartość |
|---|---|
| Rozszerzenie | .meb |
| MIME type | application/vnd.meb+json |
| Kodowanie | UTF-8 bez BOM |
1.2 Struktura
Plik .meb jest dokumentem JSON. Korzeń jest obiektem ({}). Tablice i wartości prymitywne jako korzeń są niedozwolone.
Implementacja MUSI odrzucić plik, który:
- nie jest poprawnym JSON,
- ma korzeń inny niż obiekt,
- nie zawiera pola
meta.
1.3 Pola nieznane
Implementacja czytająca plik z nowszą wersją MINOR w ramach tego samego MAJOR MUSI ignorować pola, których nie rozpoznaje, zamiast zwracać błąd krytyczny (patrz 05-versioning.md).
Dla plików walidowanych jako dokładnie ta wersja standardu jedynym normatywnym mechanizmem rozszerzeń vendorów są pola z prefiksem x_. Walidator zgodności dla konkretnej wersji MOŻE odrzucić inne nieznane pola.
2. Typy prymitywne
| Typ | Opis |
|---|---|
string | Ciąg znaków UTF-8 |
number | Liczba JSON (całkowita lub zmiennoprzecinkowa) |
bool | true lub false |
mm | Liczba w milimetrach — typ number, zawsze > 0 jeśli nie zaznaczono inaczej |
degrees | Kąt w stopniach — typ number, zakres zależny od kontekstu |
id | Unikalny identyfikator — typ string, niepusty, max 128 znaków |
ref | Referencja do id innego obiektu — typ string |
datetime | Data i czas w formacie ISO 8601, np. "2025-03-15T14:30:00Z" |
Wartość null na polu opcjonalnym jest równoważna brakowi pola. Implementacja MUSI traktować null i absent identycznie.
3. Słowa kluczowe zgodności
Niniejszy dokument używa słów kluczowych w następującym znaczeniu:
| Słowo | Znaczenie |
|---|---|
| MUSI / MUSI NIE | Bezwzględny wymóg / zakaz |
| POWINIEN / NIE POWINIEN | Zalecenie — odejście wymaga uzasadnienia |
| MOŻE | Opcjonalne — decyzja implementacji |
Implementacja jest zgodna z niniejszą specyfikacją, jeśli spełnia wszystkie wymogi oznaczone MUSI / MUSI NIE.
4. Korzeń pliku (MebFile)
Korzeń pliku zawiera następujące pola:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
meta | object | tak | Metadane pliku |
project | object | tak | Dane projektu |
scene | array | tak | Scene graph — drzewo węzłów, tablica węzłów korzenia (§7) |
materials_catalog | array | tak | Biblioteka materiałów |
edging_catalog | array | tak | Biblioteka obrzeży |
drilling_catalog | array | tak | Biblioteka typów wierceń |
hardware_catalog | array | tak | Biblioteka akcesoriów |
profiles | array | tak | Katalog profili geometrycznych |
grain_groups | array | nie | Grupy ciągłości słoja |
biscuit_catalog | array | nie | Katalog lameli (złączy biscuit) |
meshes_catalog | array | nie | Katalog siatek brył i akcesoriów (§11.7) |
comments | array | nie | Komentarze |
Tablice wymagane MOGĄ być puste ([]). Klucze powtórzone na tym samym poziomie są niedozwolone.
5. Metadane (meta)
Obiekt meta opisuje plik jako artefakt — nie projekt.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
version | string | tak | Wersja standardu .meb (semver), np. "3.0.0" |
created_at | datetime | tak | Data i czas utworzenia pliku |
created_by | object | nie | Oprogramowanie źródłowe |
checksum | string | nie | Suma kontrolna (patrz §5.2) |
5.1 Obiekt meta.created_by
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
name | string | tak | Nazwa aplikacji |
version | string | nie | Wersja aplikacji |
5.2 Checksum
Pole meta.checksum zawiera sumę kontrolną SHA-256 zawartości pliku z wyłączeniem samego pola checksum (i jego wartości). Implementacja walidująca POWINNA zignorować pole przed obliczeniem sumy, nie modyfikując struktury pliku.
Format: "sha256:<hex>", np. "sha256:a3f2...".
6. Projekt (project)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Identyfikator projektu |
name | string | tak | Nazwa projektu |
description | string | nie | Opis swobodny |
has_3d | bool | nie | true — plik zawiera dane pozycji 3D; false — brak danych 3D, podgląd przestrzenny niedostępny. Nieobecność pola traktowana jak true. |
client | object | nie | Dane klienta |
designer | object | nie | Dane projektanta |
6.1 Obiekt client i designer
Oba obiekty mają identyczną strukturę:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
name | string | tak | Imię i nazwisko lub nazwa firmy |
email | string | nie | Adres e-mail |
phone | string | nie | Numer telefonu |
company | string | nie | Nazwa firmy (dla osób fizycznych) |
7. Scene graph (scene)
7.1 Zasada ogólna
scene to drzewo węzłów — tablica węzłów korzenia. Węzeł jest grupą (group), formatką (panel), akcesorium (hardware) albo bryłą (solid). Dzieci (children) ma wyłącznie grupa; formatka, akcesorium i bryła są liśćmi. Drzewo odwzorowuje drzewo dokumentu programu projektowego jeden do jednego: grupa z programu to grupa w pliku, formatka to formatka (3.0.0).
- Każdy węzeł ma położenie i obrót względem rodzica (§14.3) — obrót grupy obraca wszystko, co w niej stoi.
- Formatka, akcesorium i bryła stoją w każdej grupie i w korzeniu — blat nad zestawem szafek nie potrzebuje sztucznej szafki.
- Czym grupa jest dla produkcji i reguł, mówi jej rola (§7.4): szafka to grupa z rolą
"cabinet", a szuflada, podzespół i zestaw to grupy bez roli, zagnieżdżone dowolnie.
7.2 Węzeł (node)
Pola wspólne dla wszystkich węzłów:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator węzła w całym pliku |
name | string | tak | Etykieta swobodna |
type | string | tak | "group", "panel", "hardware" lub "solid" |
position | object | tak¹ | Pozycja względem rodzica {x, y, z} w mm |
rotation | object | tak¹ | Rotacja Eulera XYZ względem rodzica {x, y, z} w stopniach |
production_id | string | nie | Numer produkcyjny (patrz §7.5) |
comment_refs | array | nie | Lista id z comments[] |
¹ position i rotation nie mają: akcesorium bez położenia (§12) i węzły pliku bez danych 3D (project.has_3d: false, §6).
Pole position zawiera trzy liczby {x, y, z} — każda w mm. Pole rotation zawiera trzy liczby {x, y, z} — każda w stopniach, kolejność XYZ; każdy kąt POWINIEN leżeć w zakresie (−180°, 180°] — pół obrotu jako 180, nigdy -180.
7.3 Węzeł grupy (type: "group")
Dodatkowe pola:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
role | string | nie | Rola grupy — "cabinet" (szafka); brak — zwykła grupa (§7.4) |
front | string | nie | Przód grupy w jej układzie: "-Y" (domyślnie) | "+Y" | "-X" | "+X" (§14.2) |
children | array | tak | Węzły-dzieci: grupy, formatki, akcesoria i bryły |
Przód ma każda grupa, nie tylko szafka — rysunek z przodu zestawu albo szuflady to patrzenie od strony front jej układu. Pole jest edytowalne: program, którego układ grupy ma przód po innej stronie niż -Y, podaje ją tutaj (§14.2).
7.4 Rola grupy
Rola mówi, czym grupa jest dla produkcji i reguł. Nadaje się ją istniejącej grupie — pięć formatek zgrupowanych w szufladę, trzy szuflady zgrupowane w grupę z rolą szafki — a grupa zostaje tą samą grupą, z tymi samymi dziećmi.
role | Czym jest grupa |
|---|---|
| brak | zwykła grupa: szuflada, podzespół, zestaw, pomieszczenie |
"cabinet" | szafka — jednostka produkcji i numeru produkcyjnego (§7.5); jej układ wyznacza rysunek produkcyjny szafki (§14.2) |
Reguły drzewa:
- Szafki nie ma w szafce na żadnej głębokości — grupa z rolą
"cabinet"MUSI NIE mieć wśród potomków grupy z rolą"cabinet", także przez szufladę albo podzespół. - Węzeł inny niż grupa MUSI NIE zawierać pola
children.
Nowa rola to nowa wartość pola (zmiana MINOR, 05-versioning.md §4). Implementacja czytająca MUSI traktować rolę, której nie zna, jak grupę bez roli.
7.5 Numer produkcyjny (production_id)
production_id jest opcjonalnym identyfikatorem strukturalnym nadawanym przez oprogramowanie eksportujące. Format: segmenty liczbowe oddzielone kropkami, np. "01.02.03". Liczba segmentów odpowiada głębokości w drzewie.
Dwa węzły otrzymują ten sam production_id na swoim poziomie, jeśli są strukturalnie identyczne — tzn. mają równe wartości wszystkich pól istotnych dla produkcji (wymiary, materiał, obróbka, dzieci), z wyłączeniem position, rotation, name, id i comment_refs. Identyczne szuflady dostają więc jeden numer.
Bryły oraz pozycja i geometria akcesoriów nie należą do produkcji i nie wpływają na production_id żadnego węzła. Akcesoria grupy porównuje się po hardware_ref i łącznej ilości.
Numer raz nadany zostaje — implementacja, która zapisuje obiekt wczytany z pliku .meb (także z własnego wcześniejszego eksportu), POWINNA zachować jego production_id; reguły identyczności i liczby segmentów dotyczą numerów, które nadaje sama.
Pole jest informacyjne. Implementacja czytająca MOŻE je ignorować.
7.6 Węzeł bryły (type: "solid")
Bryła to dowolna geometria z materiałem — ściana, podłoga, sufit, słup, masa zabudowy, sprzęt AGD, dekoracja. Standard nie rozróżnia rodzajów brył: nazwa jest etykietą swobodną, a o tym, czy obiekt dotyczy produkcji, mówi wyłącznie materiał (§11.1.1). Bryła nie idzie do produkcji — także wtedy, gdy ma materiał meblowy.
Dodatkowe pola:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
material_ref | ref | tak | Referencja do materials_catalog[].id — wygląd bryły |
geometry | object | tak | Geometria bryły (§7.6.1) |
Węzeł bryły jest liściem. Stoi w korzeniu albo w dowolnej grupie — piekarnik i zlew w zabudowie są dziećmi szafki i jadą razem z nią. Obiekt geometry opisuje też uproszczoną geometrię akcesorium (§12).
7.6.1 Geometria bryły (geometry)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
type | string | tak | "extrusion" (kontur z grubością), "mesh" (siatka) lub "polyhedron" (wielościan) |
outline | object | gdy extrusion | Kontur — obiekt path (§10) z closed: true |
holes | array | nie (tylko extrusion) | Otwory — obiekty path z closed: true, leżące wewnątrz konturu |
thickness | mm | gdy extrusion | Grubość wyciągnięcia |
mesh_ref | ref | gdy mesh | Referencja do meshes_catalog[].id |
vertices | array | gdy polyhedron | Wierzchołki wielościanu (§7.6.2) |
edges | array | gdy polyhedron | Krawędzie wielościanu (§7.6.2) |
faces | array | gdy polyhedron | Lica wielościanu (§7.6.2) |
Kontur z grubością (extrusion) to ta sama geometria co formatka: kontur w płaszczyźnie XY układu bryły wyciągnięty od Z = 0 do Z = thickness (§14.5). Otwór okienny i drzwiowy jest otworem w konturze ściany, skos sufitu — ukośnym segmentem jej konturu. Segmenty line, arc i bezier mają znaczenie jak w §10; pola segmentu id i machined nie mają tu zastosowania.
Siatka (mesh) opisuje to, czego kontur z grubością nie wyrazi: ścianę łukową z oknem, nieregularną wnękę, sprzęt AGD, zlew. Siatka jest zawsze osadzona w pliku, w meshes_catalog (§11.7); jedna siatka może służyć wielu bryłom i akcesoriom.
Wielościan (polyhedron) to bryła z płaskich lic wielokątnych, tak jak rysuje ją program do modelowania krawędziami i licami: ściana z oknem na wylot, skos sufitu, wnęka, pomieszczenie z podłogą i ścianami w jednej bryle (§7.6.2). Lico jest dowolnym wielokątem z otworami, więc wielościan jest dokładny i nie potrzebuje trójkątów. Każdy wierzchołek, krawędź i lico ma id, które program zachowuje między edycjami — bryła wraca z pliku do programu bez strat.
7.6.2 Wielościan (polyhedron)
Wierzchołek (vertices[]):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Identyfikator wierzchołka, unikalny w obrębie wielościanu |
x, y, z | number | tak | Położenie w układzie bryły (§14.5), w mm |
Krawędź (edges[]):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Identyfikator krawędzi, unikalny w obrębie wielościanu |
start | ref | tak | Wierzchołek początkowy — vertices[].id |
end | ref | tak | Wierzchołek końcowy — vertices[].id, inny niż start |
fold | bool | nie | Krawędź składania — powstała, gdy lico przestało być płaskie i złożyło się na trójkąty; domyślnie false |
Lico (faces[]):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Identyfikator lica, unikalny w obrębie wielościanu |
loops | array | tak | Pętle lica: pierwsza to obrys, kolejne — otwory; każda pętla to tablica vertices[].id, min. 3 |
Zasady:
- każde dwa kolejne wierzchołki pętli — i ostatni z pierwszym — są końcami krawędzi z
edges. Krawędź należy do dowolnej liczby lic albo do żadnego: krawędź bez lica to linia rysunku, bez powierzchni, - obrys biegnie przeciwnie do ruchu wskazówek zegara, patrząc na lico od strony jego normalnej, a otwory — zgodnie z ruchem wskazówek, więc lico leży zawsze po lewej stronie kierunku pętli. Normalna lica bryły zamkniętej wychodzi na zewnątrz, jak w siatce (§11.7),
- wierzchołki lica leżą w jednej płaszczyźnie; otwory leżą wewnątrz obrysu i nie przecinają ani obrysu, ani siebie nawzajem,
- wielościan MOŻE być otwarty — samo lico bez grubości, krawędź bez lica — i MOŻE składać się z kilku rozłącznych kawałków,
- implementacja rysująca wielościan dzieli lica na trójkąty sama; krawędź składania MOŻE rysować cienko albo pominąć.
8. Formatka (panel)
Formatka to węzeł drzewa (type: "panel", §7.2) — liść, który stoi w dowolnej grupie albo w korzeniu.
8.1 Pola identyfikacyjne
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
type | string | tak | "panel" |
id | id | tak | Unikalny identyfikator węzła w całym pliku |
name | string | tak | Etykieta swobodna |
production_id | string | nie | Numer produkcyjny (patrz §7.5) |
comment_refs | array | nie | Lista id z comments[] |
8.2 Geometria i pozycja
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
dimensions | object | tak | Wymiary formatki |
position | object | tak | Pozycja {x, y, z} względem rodzica (grupy albo korzenia), mm |
rotation | object | tak | Rotacja Eulera XYZ {x, y, z}, stopnie |
Obiekt dimensions zawiera:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
length | mm | tak | Długość finalna po oklejeniu (oś pionowa w widoku rozkroju; kierunek along_length) |
width | mm | tak | Szerokość finalna po oklejeniu (oś pozioma) |
thickness | mm | tak | Grubość finalna po oklejeniu |
Wymiary są zawsze wymiarem finalnym po oklejeniu. Obliczanie wymiaru surowego jest po stronie implementacji (patrz §14.4).
8.3 Materiał i kierunek słoja
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
material_ref | ref | tak | Referencja do materials_catalog[].id |
grain | string | tak | Czy i w jakim kierunku formatka respektuje słój materiału |
grain_group_ref | ref | nie | Referencja do grain_groups[].id |
Dozwolone wartości grain: "along_length" | "along_width" | "none".
Hierarchia słoja: materiał ↔ formatka
Słój (struktura) jest cechą wyłącznie materiału — jego istnienie i bazowy kierunek opisuje material.grain (patrz §11). Pole panel.grain jest podrzędne względem materiału i rozstrzyga, czy dana formatka słój respektuje:
material.grain | panel.grain | Interpretacja |
|---|---|---|
none | dowolne | Materiał bez słoja → panel.grain ignorowane; obrót dozwolony; brak struktury |
≠ none | none | Formatka nie respektuje słoja → obrót dozwolony; struktura nierysowana |
≠ none | along_length / along_width | Formatka respektuje słój w tym kierunku → obrót zablokowany (§15.5); struktura rysowana |
Gdy material.grain = "none", wartość panel.grain POWINNA być "none" (i tak jest ignorowana).
8.4 Gięcie (bend)
Pole bend jest opcjonalne. Obecność pola oznacza, że formatka jest gięta cylindrycznie.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
axis | string | tak | Oś gięcia: "width" lub "length" |
radius | mm | tak | Promień łuku |
radius_type | string | tak | Typ promienia: "inner" lub "outer" |
angle | degrees | tak | Kąt łuku w stopniach |
Formatka może być gięta tylko po jednej osi. Implementacje nieobsługujące gięcia MUSZĄ poinformować użytkownika o nieznanej geometrii — MUSZĄ NIE cicho pominąć pole.
8.5 Obrzeża (edging)
Pole edging opisuje oklejenie czterech krawędzi formatki.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
xL | object|null | nie | Obrzeże krawędzi szerokości przy x=L (górnej) |
x0 | object|null | nie | Obrzeże krawędzi szerokości przy x=0 (dolnej) |
yW | object|null | nie | Obrzeże krawędzi długości przy y=W (lewej) |
y0 | object|null | nie | Obrzeże krawędzi długości przy y=0 (prawej) |
sequence | string | nie | Która para krawędzi oklejana pierwsza ("width_first" | "length_first", default "width_first") |
Każdy obiekt krawędzi (xL, x0, yW, y0):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
ref | ref | tak | Referencja do edging_catalog[].id |
Pole sequence (domyślnie "width_first") określa, która para przeciwległych krawędzi jest oklejana jako pierwsza:
"width_first"— najpierw krawędzie szerokości (xL/x0), potem krawędzie długości (y0/yW)."length_first"— najpierw krawędzie długości (y0/yW), potem krawędzie szerokości (xL/x0).
Para oklejana później nakrywa narożniki pary wcześniejszej. Model odzwierciedla fizyczną kolejność na okleiniarce (przeciwległe krawędzie oklejane parami) — dlatego dowolny porządek pojedynczych boków nie jest reprezentowalny. Wartość obowiązuje niezależnie od tego, które krawędzie mają obrzeże.
8.5.1 Wykończenie krawędzi (edge_finish)
Pole edge_finish (od 2.2.0) jest opcjonalne i stoi obok edging. Opisuje krawędź formatki, która nie jest oklejana, tylko wykończona na samej płycie — szlifowana i/lub sfazowana. Typowy przypadek: płyty kompaktowe (HPL) z krawędzią szlifowaną i fazką 1×1 mm od lica i od spodu.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
xL | object|null | nie | Wykończenie krawędzi szerokości przy x=L (górnej) |
x0 | object|null | nie | Wykończenie krawędzi szerokości przy x=0 (dolnej) |
yW | object|null | nie | Wykończenie krawędzi długości przy y=W (lewej) |
y0 | object|null | nie | Wykończenie krawędzi długości przy y=0 (prawej) |
Każdy obiekt krawędzi (xL, x0, yW, y0):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
sanded | bool | tak | Powierzchnia krawędzi jest szlifowana |
chamfer | mm | tak | Wymiar fazki 45° wykonanej na obu narożnikach krawędzi — przy licu i przy spodzie; 0 = bez fazki (wartość ≥ 0) |
chamfer: 1 oznacza fazkę 1 × 1 mm pod kątem 45° wzdłuż całej krawędzi — jedną przy licu, drugą przy spodzie.
Pole opisuje wynik — jak wygląda gotowa krawędź — a nie maszynę, narzędzie ani proces (ta sama zasada co przy frezowaniu, §9.3). Czym i na którym etapie krawędź zostanie wyszlifowana i sfazowana, decyduje system produkcyjny. Wykończenie nie zmienia wymiarów formatki — dimensions pozostaje wymiarem finalnym (§8.2).
Znaczenie obecności pola:
- brak pola
edge_finish— plik nie mówi nic o wykończeniu krawędzi; implementacja czytająca MOŻE zastosować własne ustawienie domyślne (np. przypisane do materiału), - pole obecne, krawędź
nulllub pominięta — ta krawędź nie ma wykończenia; pusty obiekt{}oznacza jawnie, że żadna krawędź nie jest wykończona.
Krawędź ma albo obrzeże, albo wykończenie — edging.{side} i edge_finish.{side} różne od null na tej samej krawędzi wykluczają się. Fazka MUSI mieścić się w grubości: 2 × chamfer < dimensions.thickness (§15.8).
edge_finish nie jest powłoką ani skosem:
finishes[](§8.6) to warstwy materiału nakładane na powierzchnię (fornir, laminat, lakier) —edge_finishniczego nie nakłada, opisuje obróbkę samej krawędzi płyty,bevels[](§9.1) to cięcie konstrukcyjne pod kątem, które zmienia kształt formatki — fazka 1 mm na narożniku krawędzi jest wykończeniem, nie skosem.
Pole adresuje boki prostokąta bazowego, tak jak edging. Ścianki cięcia konturu outline i otworu hole wykańcza się polem routing.edge_finish (§9.3.2).
Przykład — blat kompaktowy HPL 12 mm: trzy krawędzie szlifowane z fazką 1×1 mm, krawędź yW (przy ścianie) bez wykończenia, otwór pod zlew wykończony tak samo na całym obwodzie:
{
"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 Powłoki powierzchniowe (finishes)
Pole finishes jest opcjonalną tablicą powłok nakładanych na powierzchnie formatki.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
surface | string | tak | Powierzchnia powłoki (patrz poniżej) |
material_ref | ref | tak | Referencja do materials_catalog[].id |
order | number | tak | Kolejność nakładania na tej samej powierzchni (1 = pierwsza) |
comment_refs | array | nie | Lista id z comments[] |
Dozwolone wartości surface: "face_top" | "face_bottom" | "edge_xL" | "edge_x0" | "edge_y0" | "edge_yW".
Jedna powłoka opisuje jedną powierzchnię. Wiele powłok na tej samej powierzchni przetwarzanych jest w kolejności rosnącego order.
8.7 Kompozycja z warstw (composite)
Pole composite jest opcjonalne. Obecność pola oznacza, że formatka jest klejona produkcyjnie z cieńszych warstw — np. formatka 36 mm sklejana z 2×18 mm. Brak pola oznacza monolit (np. blat 38 mm), który nie podlega rozbijaniu na składowe.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
layers | array | tak | Lista warstw — min. 2 elementy |
Obiekt warstwy (layer):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
order | integer | tak | Pozycja warstwy: 1 = spód / tył, n = wierzch / front |
material_ref | ref | tak | Referencja do materials_catalog[].id |
thickness | mm | tak | Grubość warstwy |
Reguły walidacji:
- Suma grubości wszystkich warstw MUSI być równa
panel.dimensions.thickness. - Wartości
orderMUSZĄ tworzyć ciągłą sekwencję bez powtórzeń (1, 2, …, n). - Każde
material_refMUSI wskazywać na istniejący wpis wmaterials_catalog[]kategoriiboard.
Interpretacja operacji CNC, obrzeży i wykończeń na formatkach kompozytowych jest po stronie systemu produkcyjnego — format .meb nie opisuje przypisania operacji do poszczególnych warstw.
8.8 Operacje (operations)
Pole operations jest obiektem zawierającym listy operacji obróbczych:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
bevels | array | nie | Cięcia ukośne (skosy) |
drillings | array | nie | Wiercenia |
routings | array | nie | Frezowania |
Brak pola operations jest równoważny obiektowi ze wszystkimi listami pustymi.
9. Operacje obróbcze
Wszystkie współrzędne operacji odnoszą się do kanonicznej orientacji formatki (patrz §14.1), niezależnie od pola rotation formatki.
9.1 Skos (bevel)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
edge_side | string | jeden z† | Bok bazowy: "xL" | "x0" | "yW" | "y0" |
on_segment | ref | jeden z† | id segmentu line konturu outline/hole (patrz §9.2.2) |
from_face | string | tak | Płaszczyzna startowa: "top" | "bottom" |
angle | degrees | tak | Kąt cięcia od prostopadłej (0° = prosty, 45° = standardowy skos) |
leave | mm | tak | Grubość materiału pozostawiona prosto przed skosem, ≥ 0 |
depth | mm | nie | Głębokość skosu — gdy pominięte: depth = d − leave |
edging | object | nie | Obrzeże na skośnej powierzchni |
comment_refs | array | nie | Lista id z comments[] |
† Skos adresuje się albo przez edge_side (bok bazowy prostokąta), albo przez on_segment (segment konturu) — dokładnie jeden z tych trybów.
leave = 0 oznacza skos od samej krawędzi płaszczyzny from_face.
Skos zawsze obejmuje całą krawędź (cały bok bazowy lub cały segment) — nie ma pól start/end. Częściowe sfazowanie wykonuje się slotem z profilem (§9.3.1).
Skos przez on_segment jest dozwolony wyłącznie dla segmentów typu line — skos to cięcie proste (piłą lub prostym przejściem freza). Krawędzi krzywoliniowej (arc/bezier) nie fazuje się skosem; profilowane sfazowanie krzywej wykonuje się slotem z profilem (type: slot, §9.3.1). Zakres on_segment jak w §9.2.2: segmenty przelotowe outline (machined) i hole.
Gdy na tej samej krawędzi (edge_side lub on_segment) i od tej samej strony from_face zdefiniowanych jest więcej niż jeden skos, pole depth jest wymagane dla każdego z nich.
Obiekt edging w skosie:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
ref | ref | tak | Referencja do edging_catalog[].id |
9.2 Wiercenie (drilling)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
drilling_ref | ref | tak | Referencja do drilling_catalog[].id |
type | string | tak | "face" (płaszczyzna) lub "edge" (krawędź) |
face | string | gdy type: face | "top" | "bottom" |
edge_side | string | gdy type: edge na boku bazowym | "xL" | "x0" | "yW" | "y0" |
on_segment | ref | gdy type: edge na konturze | id segmentu ścieżki outline lub hole (patrz §9.2.2) |
x | mm | gdy face; gdy edge_side: y0/yW | Pozycja wzdłuż długości (patrz §9.2.1) |
y | mm | gdy face; gdy edge_side: xL/x0 | Pozycja wzdłuż szerokości (patrz §9.2.1) |
s | mm | gdy on_segment | Odległość wzdłuż segmentu konturu od jego startu (patrz §9.2.2) |
z | mm | nie (tylko type: edge) | Pozycja w poprzek grubości, od lica; default thickness/2. To położenie otworu w grubości, nie głębokość wiercenia — ta wynika z drilling_catalog (patrz §9.2.1) |
hardware_instance_ref | ref | nie | id akcesorium, z którego wynika wiercenie (§12.1) |
comment_refs | array | nie | Lista id z comments[] |
Wiercenie krawędziowe (type: edge) adresuje się albo przez edge_side (bok bazowy prostokąta), albo przez on_segment (krawędź konturu) — dokładnie jeden z tych trybów.
9.2.1 Układ współrzędnych wiercenia
Układ kanoniczny (§14.1): x wzdłuż długości (0..L, pion), y wzdłuż szerokości (0..W, poziom — rośnie w lewo), z w poprzek grubości — głębokość od lica (face: top), z ∈ [0, thickness], z = 0 na licu, z = thickness na spodzie, default thickness/2. Origin lica = prawy-dolny (x=0 na dole, y=0 po prawej).
type: face—xod dolnej krawędzi (wzdłuż długości),yod prawej krawędzi (wzdłuż szerokości).znie dotyczy — głębokość wiercenia wynika zdrilling_catalog.type: edge,edge_side: y0lubyW(krawędzie długości) —xpozycja wzdłuż długości (od dołu);yjest wyznaczone przezedge_side(y0→y=0,yW→y=W) i nie jest podawane. Pozycja otworu w grubości:z.type: edge,edge_side: xLlubx0(krawędzie szerokości) —ypozycja wzdłuż szerokości (od prawej);xjest wyznaczone przezedge_side(x0→x=0,xL→x=L) i nie jest podawane. Pozycja w grubości:z.
Pozycja w grubości jest zawsze w polu z, mierzonym od lica niezależnie od krawędzi — żadna z osi x/y nie zmienia już znaczenia między krawędziami. z to położenie otworu w grubości, nie głębokość wiercenia (ta wynika z drilling_catalog). Kierunek wejścia wiertła wynika z edge_side.
9.2.2 Wiercenie w krawędzi konturu (on_segment)
Gdy formatka ma krawędź nieosiową powstałą z cięcia przelotowego — skos lub łuk obrysu (routing type: outline) albo ściana otworu przelotowego (type: hole) — krawędzi nie da się zaadresować przez edge_side: żadna współrzędna x/y nie jest stała, a kierunek wiercenia obraca się wzdłuż krawędzi. Takie wiercenie adresuje się parametrycznie po segmencie konturu:
on_segment— referencja doidsegmentu w ścieżceoutlinelubhole; segment MUSI miećid(patrz §10).s— odległość wzdłuż tego segmentu od jego punktu startowego, w mm (długość łuku — działa dlaline,arc,bezier);0 ≤ s ≤długość segmentu.z— głębokość od lica jak w §9.2.1 (defaultthickness/2); zakres[0, thickness], bo kontur jest przelotowy na całą grubość.
Pozycja x/y otworu jest wyznaczana z geometrii segmentu i nie jest podawana. Kierunek wiercenia (normalna do krawędzi) wynika z geometrii segmentu oraz strony materiału (winding ścieżki): dla outline materiał jest wewnątrz konturu, dla hole — na zewnątrz (po stronie formatki, nie otworu). Tryby on_segment i edge_side wykluczają się.
Uwaga: w outline celem on_segment jest zwykle segment machined (realne cięcie różniące kontur od prostokąta bazowego); w hole każdy segment jest ścianą przelotową, więc flaga machined nie ma zastosowania. pocket (nieprzelotowy) nie jest obsługiwany przez on_segment — jego ściana sięga tylko do depth, nie na całą grubość.
9.3 Frezowanie (routing)
Format .meb opisuje wyłącznie wynikową geometrię operacji frezowania — nie opisuje narzędzia skrawającego, parametrów skrawania ani strategii CAM. Standard rozróżnia pięć geometrycznych prymitywów:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
type | string | tak | "slot" | "outline" | "hole" | "pocket" | "biscuit" |
finishes | array | nie | Powłoki na wyfrezowanej powierzchni |
hardware_instance_ref | ref | nie | id akcesorium, z którego wynika frezowanie (§12.1) |
comment_refs | array | nie | Lista id z comments[] |
9.3.1 Slot — rowek wyciągany (type: "slot")
Slot opisuje geometrię wyciągnięcia: stały przekrój poprzeczny przemieszczający się wzdłuż trajektorii. Obejmuje rowki na licu, rowki/wręgi na krawędzi, zaokrąglenia, profilowane fazowania, rowki pod plecy HDF, gzymsy itp.
Slot ma dwie ortogonalne osie:
- placement — gdzie biegnie trajektoria:
surface(na licu, polepath) alboedge(wzdłuż krawędzi, poleedge_sidelubon_segment). Placement wynika z obecności pól —path(→ surface) alboedge_side/on_segment(→ edge), dokładnie jeden tryb. - section — jak opisany jest przekrój:
simple(prostokątwidth×depth) alboprofiled(pełny profilprofile_ref). Polesectionjest wymagane i jawne.
Pola wspólne:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
section | string | tak | "simple" | "profiled" |
face | string | tak | surface: obrabiane lico ("top" | "bottom"); edge: narożnik odniesienia ("top" = od lica, "bottom" = od spodu) |
Placement surface — trajektoria na licu:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
path | object | tak | Trajektoria osi slota (patrz §10) |
Placement edge — trajektoria wzdłuż krawędzi:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
edge_side | string | jeden z† | Bok bazowy: "xL" | "x0" | "yW" | "y0" |
on_segment | ref | jeden z† | id segmentu konturu outline/hole (§9.2.2) |
start | mm | nie‡ | Początek wzdłuż krawędzi/segmentu — domyślnie 0 |
end | mm | nie‡ | Koniec wzdłuż krawędzi/segmentu — domyślnie do końca |
† Dokładnie jeden z edge_side / on_segment. ‡ start i end podaje się razem albo pomija razem.
Dla edge_side start/end to współrzędna wzdłuż krawędzi liczona od 0: dla krawędzi długości (y0/yW) — wzdłuż długości od x=0; dla krawędzi szerokości (xL/x0) — wzdłuż szerokości od y=0. Dla on_segment to s (długość łuku) wzdłuż segmentu od jego startu. Zakres on_segment jak w §9.2.2 (segmenty przelotowe outline/hole).
Section simple — przekrój prostokątny:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
width | mm | tak | Szerokość rowka (wymiar poprzeczny do kierunku zagłębienia) |
depth | mm | tak | Zagłębienie cięcia od powierzchni wejścia |
offset | mm | nie | Przesunięcie przekroju od linii odniesienia, stycznie do powierzchni wejścia — domyślnie 0 |
offset dla surface przesuwa prostokąt w bok od osi path (w płaszczyźnie lica); dla edge — wzdłuż grubości od narożnika face. Przy offset = 0 przekrój surface jest centrowany na osi path (po width/2 na obie strony), a przekrój edge startuje w narożniku face ∩ edge.
Section profiled — pełny profil:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
profile_ref | ref | tak | Referencja do profiles[].id — pełny przekrój cięcia |
W wariancie profiled profil definiuje całą geometrię cięcia (kształt, szerokość, zagłębienie, położenie). Nie ma width, depth ani offset — ewentualne przesunięcie wpieka się w sam profil (profil ma własny start, §11.5). Głębokość frezowania wynika z zasięgu profilu w głąb materiału (oś Y, §11.5.2). Profil MUSI być otwarty i zakotwiczony na powierzchni wejścia (§11.5.2, §15.7).
Układ współrzędnych profilu i orientacja względem trajektorii — patrz §11.5.2.
9.3.2 Kontur zewnętrzny (type: "outline")
Outline opisuje frezowanie przelotowe zmieniające zewnętrzny obrys formatki. Ścieżka jest zamkniętym konturem (closed: true) opisującym gotowy kształt formatki; jej orientacja (winding) wyznacza stronę materiału, zgodnie z konwencją CAD. Operacja jest zawsze przelotowa przez całą grubość — nie ma pola depth ani through.
Pole dimensions nadal opisuje prostokąt bazowy (surowy do rozkroju); kontur outline opisuje kształt po obróbce. Realną obróbką jest różnica między konturem a prostokątem bazowym: segmenty pokrywające się z bokami prostokąta to krawędzie półfabrykatu (bez cięcia), a segmenty odbiegające to faktyczne frezowanie.
Znacznik machined. Segment ścieżki może nieść flagę "machined": true, oznaczającą, że jest realnym cięciem (różnicą vs prostokąt). Gdy żaden segment konturu nie ma jawnej flagi, implementacja wyznacza obróbkę geometrycznie — segment nieleżący na granicy prostokąta dimensions jest cięciem. Dzięki temu postprocesor (np. XCS) oraz pre_trim/edging operują wyłącznie na odcinkach realnie obrabianych, a nie na całym konturze.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
path | object | tak | Zamknięty kontur (closed: true) gotowego kształtu; segmenty cięcia oznaczone machined |
edging | object | array | nie | Obrzeże na ściankach cięcia (jeden wpis lub tablica wpisów — różne materiały) |
edge_finish | object | nie | Wykończenie ścianek cięcia bez obrzeża — szlif i fazka (2.2.0) |
Domyślnie ścianka cięcia jest prosta (pionowy przelot przez całą grubość). Profilowanie lub sfazowanie ścianki konkretnego segmentu wykonuje się osobną operacją celującą w ten segment przez on_segment: slotem z profilem (§9.3.1) albo skosem (§9.1). Standard nie ma osobnego pola „profil ścianki".
Obiekt edging (wspólny dla outline i hole):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
ref | ref | tak | Referencja do edging_catalog[].id |
walls | string|array | tak | "all" lub tablica wskazań ścianek |
pre_trim | bool | nie | Czy okleiniarka wykonuje podfrez krawędzi na grubość obrzeża przed oklejeniem — domyślnie false |
Pole walls wskazuje, które ścianki cięcia są oklejane:
"all"— wszystkie realne ścianki cięcia (dlaoutlinesegmentymachined; dlaholecały obwód).- tablica — pozycje mieszane: boki bazowe (
"xL","x0","yW","y0") i/lubidsegmentów ścieżki (referencja dosegments[].id, §10).idsegmentu adresuje pojedynczą ściankę nieosiową (np. konkretny skos), gdy nie da się jej wskazać bokiem bazowym. Segment wskazany przezidMUSI miećidi być realnym cięciem.
pre_trim: true jest dozwolony wyłącznie dla type: outline, gdy obrabiany (machined) odcinek konturu jest pojedynczym, prostym segmentem (linia). Okleiniarka nie wykona podfrezu na krawędzi krzywoliniowej ani łamanej — dlatego dla obróbki z łuków, krzywych lub wielu segmentów oraz dla type: hole pre_trim MUSI pozostać false (lub być pominięty).
Forma tablicowa (2.1.0). edging może być tablicą obiektów { ref, walls, pre_trim } — różne ścianki tego samego konturu oklejone różnymi materiałami (np. każdy skos innym obrzeżem). Każdy wpis ma własny ref i własną listę walls; ta sama ścianka MUSI NIE wystąpić w więcej niż jednym wpisie. Pojedynczy obiekt jest równoważny tablicy jednoelementowej i pozostaje poprawny.
Wykończenie ścianek (edge_finish, 2.2.0). Obiekt edge_finish (wspólny dla outline i hole) opisuje ścianki cięcia, które nie są oklejane, tylko szlifowane i/lub sfazowane — odpowiednik panel.edge_finish (§8.5.1) dla ścianek konturu.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
walls | string|array | tak | "all" lub tablica wskazań ścianek — jak edging.walls |
sanded | bool | tak | Ścianki są szlifowane |
chamfer | mm | tak | Wymiar fazki 45° na obu narożnikach ścianki — przy licu i przy spodzie; 0 = bez fazki (wartość ≥ 0) |
Pole walls znaczy to samo co edging.walls: "all" — wszystkie realne ścianki cięcia (dla outline segmenty machined, dla hole cały obwód); tablica — boki bazowe i/lub id segmentów ścieżki. Brak edge_finish znaczy, jak przy formatce, że plik nie mówi nic o wykończeniu ścianek; pole obecne — ścianki spoza walls nie są wykończone. Ta sama ścianka MUSI NIE wystąpić jednocześnie w edging.walls (w którymkolwiek wpisie) i w edge_finish.walls, a fazka MUSI mieścić się w grubości: 2 × chamfer < dimensions.thickness (§15.8). edge_finish dotyczy wyłącznie outline i hole — slot, pocket i biscuit MUSZĄ NIE mieć tego pola.
9.3.3 Otwór przelotowy (type: "hole")
Hole opisuje frezowanie przelotowe wewnątrz formatki — ścieżka MUSI leżeć w całości wewnątrz prostokąta dimensions, nie dotykając jego granicy. Operacja jest zawsze przelotowa przez całą grubość — nie ma pola depth ani through.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
path | object | tak | Zamknięty kontur (closed: true) wewnątrz formatki |
edging | object | array | nie | Obrzeże na ściankach otworu (jeden wpis lub tablica wpisów) |
edge_finish | object | nie | Wykończenie ścianek otworu bez obrzeża — szlif i fazka (2.2.0) |
Domyślnie ścianka otworu jest prosta (pionowy przelot). Profilowanie/sfazowanie ścianki segmentu — osobną operacją przez on_segment (slot §9.3.1 lub skos §9.1).
Obiekt edging — jak dla outline (powyżej). Pole pre_trim nie ma zastosowania (kontur otworu nie jest prostą krawędzią) i MUSI być false lub pominięty. Obiekt edge_finish — jak dla outline (powyżej).
9.3.4 Kieszeń (type: "pocket")
Pocket opisuje frezowanie nieprzelotowe na licu formatki — zagłębienie na określoną głębokość. Ścieżka może leżeć w dowolnym miejscu (wewnątrz lub przy granicy prostokąta) — nie zmienia to semantyki: kieszeń nie modyfikuje zewnętrznego kształtu formatki.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
face | string | tak | "top" | "bottom" |
depth | mm | tak | Głębokość cięcia poniżej lica |
path | object | tak | Kontur kieszeni — MUSI być zamknięty (closed: true) |
Kieszeń ma płaskie dno na głębokości depth i proste (pionowe) ścianki. Standard nie ma pola profilu ścianki kieszeni. Jeśli któraś ściana ma być profilowana lub sfazowana, wykonuje się to osobnym slotem (type: slot, placement: surface) z trajektorią path biegnącą wzdłuż tej krawędzi — druga obróbka. (on_segment nie obsługuje kieszeni, bo jej ściana nie jest przelotowa, §9.2.2.)
Kieszeń nie obsługuje obrzeża — ścianki kieszeni nie są oklejane. Obrzeże na ściankach frezowania dotyczy wyłącznie typów outline i hole. To samo dotyczy wykończenia ścianek (edge_finish).
9.3.5 Lamela / biscuit (type: "biscuit")
Biscuit opisuje punktowe frezowanie pod złącze biscuitowe (lamelowe). Geometria wynika z rozmiaru lameli zdefiniowanej w katalogu biscuit_catalog.
Pozycja x, y opisuje oś lameli. Oznacza to, że wymiar biscuit_catalog[].thickness rozkłada się symetrycznie po obu stronach osi: dla thickness: 4 gniazdo zajmuje po 2 mm z każdej strony osi.
Standard rozróżnia dwa warianty lameli:
- Lamela w krawędzi — frezowanie wykonywane od krawędzi formatki. Wymagane jest
edge_side(bok bazowy) alboon_segment(krawędź konturu), afacejest zabronione. Pozycja osi gniazda wzdłuż krawędzi oraz głębokośćzod lica — układ jak dla wiercenia krawędziowego (§9.2.1, §9.2.2): dlay0/yWpodajeszx, dlaxL/x0—y, dla konturu —on_segment+s; głębokość osi w grubości toz(defaultthickness/2). Na schemacie formatki rzut na lico jest półelipsą o zasięguwidth / 2w głąb formatki, a rzut na krawędź jest prostokątemthickness × length. - Lamela w licu — frezowanie wykonywane od lica formatki. Wymagane jest
face, aedge_side/on_segmentjest zabronione. Pozycję osi opisująx,y;angleokreśla obrót osi lameli w płaszczyźnie lica. Na schemacie formatki rzut na lico jest prostokątemthickness × lengthcentrowanym na osi lameli.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
face | string | gdy lico | "top" | "bottom" |
edge_side | string | gdy krawędź bazowa | "xL" | "x0" | "yW" | "y0" |
on_segment | ref | gdy krawędź konturu | id segmentu outline/hole (§9.2.2) |
x | mm | gdy lico; gdy edge_side: y0/yW | Oś lameli — wzdłuż długości (§9.2.1) |
y | mm | gdy lico; gdy edge_side: xL/x0 | Oś lameli — wzdłuż szerokości (§9.2.1) |
s | mm | gdy on_segment | Oś lameli — wzdłuż segmentu konturu (§9.2.2) |
z | mm | nie (gdy krawędź) | Głębokość osi od lica; default thickness/2 |
angle | degrees | nie | Kąt obrotu złącza w płaszczyźnie powierzchni — domyślnie 0 |
size_ref | ref | tak | Referencja do biscuit_catalog[].id |
10. Geometria ścieżki (path)
Obiekt path definiuje geometrię operacji frezowania jako sekwencję segmentów.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
start | object | tak | Punkt startowy {x, y} — absolutny w układzie formatki |
closed | bool | tak | true = kontur zamknięty, false = ścieżka otwarta |
segments | array | tak | Tablica segmentów — min. 1 element |
Punkt start — x od dolnej krawędzi (wzdłuż długości), y od prawej krawędzi (wzdłuż szerokości), w mm.
10.1 Segment liniowy (type: "line")
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
type | string | tak | "line" |
id | string | nie* | Identyfikator segmentu — patrz nota pod §10.3 |
end | object | tak | Punkt końcowy {x, y} |
machined | bool | nie | (tylko outline) segment jest realnym cięciem — patrz §9.3.2 |
10.2 Segment łukowy (type: "arc")
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
type | string | tak | "arc" |
id | string | nie* | Identyfikator segmentu — patrz nota pod §10.3 |
center | object | tak | Środek łuku {x, y} |
radius | mm | tak | Promień łuku |
angle_start | degrees | tak | Kąt startowy (0° = oś X+) |
angle_end | degrees | tak | Kąt końcowy |
clockwise | bool | tak | Kierunek obrotu — mapuje się na G2 (true) / G3 (false) |
machined | bool | nie | (tylko outline) segment jest realnym cięciem — patrz §9.3.2 |
10.3 Segment Béziera (type: "bezier")
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
type | string | tak | "bezier" |
id | string | nie* | Identyfikator segmentu — patrz nota pod §10.3 |
cp1 | object | tak | Pierwszy punkt kontrolny {x, y} |
cp2 | object | tak | Drugi punkt kontrolny {x, y} |
end | object | tak | Punkt końcowy {x, y} |
machined | bool | nie | (tylko outline) segment jest realnym cięciem — patrz §9.3.2 |
Pole machined ma znaczenie wyłącznie dla type: outline — oznacza segment będący realną obróbką (różnicą konturu względem prostokąta bazowego). Dla pozostałych typów jest ignorowane.
* Pole id (string, opcjonalne) jest wymagane, gdy segment jest celem on_segment jakiejkolwiek operacji krawędziowej — drilling, biscuit, slot lub bevel (§9.2.2). id MUSI być unikalne w obrębie całej formatki (wśród wszystkich ścieżek path jej operacji), aby referencja on_segment jednoznacznie wskazywała segment bez podawania ścieżki.
Każdy segment zaczyna się tam, gdzie poprzedni się skończył. Dla pierwszego segmentu punktem startowym jest path.start.
Dla ścieżki zamkniętej (closed: true) ostatni segment MUSI kończyć się w punkcie path.start lub implementacja MUSI domknąć ścieżkę automatycznie segmentem liniowym.
11. Katalogi
11.1 Katalog materiałów (materials_catalog)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator w katalogu |
code | string | nie | Kod katalogowy producenta |
name | string | tak | Nazwa materiału |
manufacturer | string | nie | Producent |
category | string | tak | "board" | "veneer" | "laminate" | "paint" | "surface" |
furniture | bool | nie | Materiał meblowy — domyślnie true (§11.1.1) |
Dodatkowe pola zależne od category:
board, veneer, laminate:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
thickness | mm | tak | Grubość nominalna |
grain | string | tak | "along_length" | "along_width" | "none" |
board (wyłącznie):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
sheet | object | tak | Wymiary arkusza |
Obiekt sheet:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
length | mm | tak | Długość arkusza (oś along_length) |
width | mm | tak | Szerokość arkusza |
trim | mm | tak | Brzegowanie per krawędź |
Maksymalny użyteczny wymiar arkusza: sheet.length − 2×trim oraz sheet.width − 2×trim.
paint:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
color_system | string | nie | System koloru, np. "RAL", "NCS" |
color_code | string | nie | Kod koloru, np. "9016" |
description | string | nie | Opis swobodny, np. "biały połysk 90%" |
surface:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
color | string | nie | Barwa #RRGGBB, np. "#F2F0EB" |
Materiał surface opisuje wyłącznie wygląd — tynk, farbę ścienną, stal, szkło, tworzywo — bez grubości i arkusza. MUSI mieć furniture: false.
11.1.1 Materiał meblowy (furniture)
Pole furniture mówi, czy z materiału się produkuje. Materiał niemeblowy (furniture: false) — tynk ściany, stal zawiasu, szyba, lustro — służy wyłącznie wyglądowi albo zamawia się go poza produkcją mebli.
- Implementacja produkcyjna (rozkrój, zapotrzebowanie, zamówienie materiału, pliki maszynowe) MUSI pomijać formatki z materiałem niemeblowym. Formatka zostaje w pliku, żeby montażysta widział ją na miejscu.
- Implementacja wyświetlająca model POWINNA pozwalać ukryć jednym poleceniem wszystko, co ma materiał niemeblowy.
- Brak pola oznacza
true— pliki sprzed wersji 2.3.0 znaczą to samo co dotąd.
Bryła nie idzie do produkcji niezależnie od materiału (§7.6), a akcesoria liczy się z katalogu akcesoriów (§12), nie z materiału ich geometrii.
11.2 Katalog obrzeży (edging_catalog)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator |
code | string | nie | Kod katalogowy |
name | string | tak | Nazwa obrzeża |
texture | bool | tak | Czy obrzeże ma strukturę (teksturę) |
thickness | mm | tak | Grubość taśmy obrzeżowej |
height | mm | tak | Wysokość taśmy (przed przycięciem) |
material_ref | ref | tak | Referencja do materials_catalog[].id |
11.3 Katalog wierceń (drilling_catalog)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator |
code | string | nie | Kod katalogowy |
name | string | tak | Nazwa typu wiercenia |
diameter | mm | tak | Średnica otworu |
depth | mm | gdy through: false | Głębokość otworu |
through | bool | tak | Czy wiercenie przelotowe |
Gdy through: true, pole depth jest opcjonalne i ignorowane. Głębokość wiercenia przelotowego wyznacza grubość formatki.
11.4 Katalog akcesoriów (hardware_catalog)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator |
code | string | nie | Kod katalogowy producenta |
name | string | tak | Nazwa akcesorium |
manufacturer | string | nie | Producent |
11.5 Katalog profili geometrycznych (profiles)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator |
code | string | nie | Kod katalogowy |
name | string | tak | Nazwa profilu |
start | object | nie | Punkt startowy przekroju {x, y} — domyślnie {0, 0} |
path | array | tak | Przekrój wynikowej geometrii cięcia — tablica segmentów (line / arc / bezier) |
11.5.1 Co opisuje profil
Profil opisuje przekrój poprzeczny wynikowej geometrii cięcia — kształt jaki powstaje w materiale lub na krawędzi. Nie opisuje geometrii narzędzia skrawającego. Dobór narzędzia do wykonania danego profilu jest wiedzą CAM.
11.5.2 Układ współrzędnych profilu
Profil opisuje przekrój poprzeczny w lokalnej ramie 2D. Pierwszy punkt przekroju to start (domyślnie (0, 0)); kolejne segmenty path biegną od niego. Rama zależy od placement slota (§9.3.1):
Slot edge — (0, 0) zakotwiczone w narożniku krawędzi:
Punkt zerowy (0, 0) = narożnik (face ∩ edge_side / on_segment)
X+ = w głąb materiału od krawędzi (prostopadle do krawędzi, wzdłuż lica)
Y+ = w głąb grubości od lica (Y = 0 to płaszczyzna lica)Slot surface — (0, 0) na osi path w płaszczyźnie lica:
Punkt zerowy (0, 0) = oś path na płaszczyźnie lica (face)
X+ = poprzecznie, w prawą stronę ścieżki względem jej lokalnego kierunku (w płaszczyźnie lica)
Y+ = w głąb grubości od pola faceDla segmentów krzywoliniowych kierunek lokalny (a więc oś X) jest styczny do ścieżki w danym punkcie.
Powierzchnia wejścia i głębokość. Linia Y = 0 to powierzchnia wejścia narzędzia (lico dla surface, krawędź/narożnik dla edge). Głębokość frezowania wynika z zasięgu profilu w głąb materiału — max(Y) po wszystkich punktach przekroju. Profil MUSI być otwarty i zakotwiczony na powierzchni wejścia: jego skrajne końce leżą na linii Y = 0, a usuwany materiał to obszar zamknięty między profilem a tą linią. Profil zamknięty (pętla) lub oderwany od Y = 0 opisuje cięcie niewykonalne (walidacja, §15.7).
Centrowanie i przesunięcie. Ponieważ pierwszy punkt to start, profil można dowolnie spozycjonować względem trajektorii bez osobnego pola — np. rowek wyśrodkowany na osi path opisuje się profilem zaczynającym w start.x = −width/2. W wariancie profiled całe pozycjonowanie jest wpieczone w profil (jego start i geometrię); slot nie ma wtedy pola offset (§9.3.1).
11.5.3 Przykłady
Zaokrąglenie R5 na narożniku krawędzi:
[{ "type": "arc", "center": { "x": 5, "y": 5 }, "radius": 5,
"angle_start": 270, "angle_end": 180, "clockwise": false }]Interpretacja: nowa powierzchnia przebiega 5 mm wzdłuż lica (X=0→5) i 5 mm wzdłuż krawędzi (Y=0→5), łącząc te punkty łukiem R5.
Rowek 5×3 mm, oś 9 mm od lica (rowek pod plecy 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 } }]Profil zaczyna się na granicy materiału (0, 0), zagłębia 3 mm (X=3), biegnie między Y=6.5 a Y=11.5 (szerokość 5 mm), wraca do X=0.
Rowek 12 mm z dnem półokrągłym R6, wyśrodkowany na osi path (slot surface, profiled — wykorzystuje 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) leży na powierzchni wejścia, 6 mm w bok od osi path (osi odpowiada X = 0); profil straddle'uje ścieżkę po 6 mm na obie strony, dno na Y = 10 (głębokość frezowania 10 mm), oba końce na Y = 0. Tu rama to slot surface: X poprzecznie do ścieżki, Y w głąb grubości.
11.6 Katalog lameli (biscuit_catalog)
Pole biscuit_catalog jest opcjonalne. Wymagane gdy w operacjach występują type: "biscuit".
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator |
code | string | nie | Kod katalogowy producenta |
name | string | tak | Nazwa lameli |
length | mm | nie | Długość lameli |
width | mm | nie | Szerokość lameli (głębokość wpuszczenia w materiał) |
thickness | mm | nie | Grubość lameli / szerokość gniazda mierzona symetrycznie względem osi |
11.7 Katalog siatek (meshes_catalog)
Pole meshes_catalog jest opcjonalne. Wymagane, gdy którakolwiek geometria ma type: "mesh".
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator |
name | string | tak | Nazwa siatki |
positions | array | tak | Współrzędne wierzchołków x, y, z kolejno, w mm, w układzie bryły (§14.5) — długość wielokrotnością 3 |
triangles | array | tak | Indeksy wierzchołków po trzy na trójkąt, liczone od 0 — długość wielokrotnością 3 |
Wierzchołki trójkąta podaje się przeciwnie do ruchu wskazówek zegara, patrząc z zewnątrz bryły — normalna wychodzi na zewnątrz (układ prawoskrętny). Siatka MOŻE być otwarta (powierzchnia zamiast bryły).
Plik .meb jest kompletny: siatka jest zawsze osadzona w nim samym. Standard nie przewiduje odnośników do plików ani katalogów zewnętrznych.
12. Akcesorium (type: "hardware")
Akcesorium to węzeł drzewa (§7.2) — liść, który stoi w dowolnej grupie albo w korzeniu:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
type | string | tak | "hardware" |
id | id | tak | Identyfikator węzła, unikalny w pliku — wskazują go obróbki (§12.1) |
name | string | tak | Etykieta swobodna |
hardware_ref | ref | tak | Referencja do hardware_catalog[].id |
quantity | number | tak | Ilość sztuk — liczba całkowita > 0 |
position | object | nie | Pozycja {x, y, z} względem rodzica, mm |
rotation | object | gdy position | Rotacja Eulera XYZ {x, y, z}, stopnie |
material_ref | ref | gdy position | Referencja do materials_catalog[].id — wygląd akcesorium |
geometry | object | gdy position | Uproszczona geometria akcesorium — jak bryła (§7.6.1) |
Akcesorium bez pozycji jest pozycją listy z ilością (wkręty, kołki w worku) w swojej grupie — nie ma position ani rotation.
Akcesorium z pozycją (position) to jedna sztuka na swoim miejscu: zawias, prowadnica, uchwyt, łącznik. MUSI mieć rotation, material_ref i geometry oraz quantity: 1. Geometria jest wyłącznie wyglądem: akcesorium liczy się i zamawia przez hardware_ref, nie przez materiał geometrii.
12.1 Obróbki akcesorium
Wiercenie i frezowanie, które wynikają z akcesorium, wskazują je polem hardware_instance_ref. Relacja biegnie od obróbki do akcesorium, bo jedno akcesorium ma obróbki na kilku formatkach — mimośród, prowadnica, zawias z płytką montażową na boku. Obróbka MOŻE wskazywać akcesorium z innej grupy, także z innej szafki (złącze skręcające dwie szafki).
- Obróbka MUSI wskazywać akcesorium z pozycją.
- Implementacja, która usuwa akcesorium, MUSI usunąć wszystkie obróbki, które je wskazują.
- Implementacja, która przesuwa akcesorium, MUSI przesunąć razem z nim wszystkie obróbki, które je wskazują.
Łącznik (konfirmat, mimośród, kołek) opisuje się tak samo: akcesorium z pozycją, którego wiercenia na obu formatkach wskazują tę samą sztukę.
13. Grupy ciągłości słoja (grain_groups)
Grupa ciągłości słoja to blok formatek wyciętych z jednego kawałka płyty tak, że słój przechodzi z formatki na formatkę. Blok składa się z rzędów ułożonych kolejno wzdłuż słoja, a rząd — z formatek ułożonych obok siebie w poprzek słoja; każdy rząd ma własne przyciąganie (§13.2). Pas formatek wyciętych jedna za drugą (znaczenie grupy do wersji 2.4.0) to blok, w którym każdy rząd ma jedną formatkę.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator grupy |
name | string | tak | Nazwa grupy |
material_ref | ref | tak | Referencja do materials_catalog[].id |
orientation | string | nie | Słój względem frontu mebla: "vertical" (domyślnie) | "horizontal" — patrz §13.1 |
kerf | mm | tak | Szerokość szczeliny cięcia piły między formatkami — między rzędami i między formatkami w rzędzie |
members | array | tak | Formatki w grupie — min. 2 elementy |
rows | array | nie | Przyciąganie rzędów — patrz §13.2; rząd bez wpisu jest dosunięty do krawędzi początkowej |
Obiekt member:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
panel_ref | ref | tak | Referencja do id węzła formatki w dowolnym miejscu drzewa |
row | integer | nie | Numer rzędu wzdłuż słoja — liczba całkowita, sekwencja 1…n w grupie |
order | integer | tak | Pozycja w rzędzie liczona od krawędzi początkowej — liczba całkowita, sekwencja 1…m w rzędzie |
Obiekt rows[] (2.6.0):
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
row | integer | tak | Numer rzędu grupy, którego dotyczy wpis |
align | string | tak | Przyciąganie rzędu: "start" | "center" | "end" — patrz §13.2 |
13.1 Rzędy i pozycje
Blok opisuje się w widoku na lico formatek. Lico (top, §14) formatki grupy to strona widoczna od zewnątrz mebla — na nią patrzy się, oceniając ciągłość słoja, i w niej leżą rzędy i pozycje bloku. Obróbki wykonywane od środka mebla (np. puszki zawiasów drzwi) leżą wtedy na spodzie formatki (bottom). Program źródłowy MUSI opisać każdą formatkę grupy licem na zewnątrz — formatka opisana licem do środka byłaby w bloku lustrzanym odbiciem samej siebie i dostałaby obróbki po złej stronie słoja.
Pole orientation mówi, jak biegnie w bloku słój, i wyznacza rzędy oraz krawędź początkową, od której liczy się pozycję w rzędzie:
orientation | Słój we froncie | Rząd | Rząd 1 | Krawędź początkowa |
|---|---|---|---|---|
"vertical" (domyślnie) | pionowo | pas poziomy przez całą szerokość bloku | u góry | lewa |
"horizontal" | poziomo | pas pionowy przez całą wysokość bloku (kolumna) | z lewej | dolna |
- Rzędy leżą kolejno wzdłuż słoja: słój przechodzi z rzędu
ndo rzędun + 1. - Formatki rzędu leżą obok siebie w poprzek słoja; pozycja
order: 1jest najbliżej krawędzi początkowej, a każda kolejna leży dalej od niej — niezależnie od przyciągania rzędu. - Wszystkie formatki rzędu mają ten sam wymiar wzdłuż słoja (§15.4).
- Rząd węższy od najszerszego jest dosunięty do krawędzi wskazanej przyciąganiem (§13.2), a reszta jego szerokości leży po drugiej stronie.
Członek bez pola row jest osobnym rzędem: numer rzędu = jego order, pozycja w rzędzie = 1. Grupa bez row znaczy więc dokładnie to samo co w wersji 2.4.0 i starszych — pas formatek, każda w osobnym rzędzie. Implementacja czytająca wersję 2.5.0 i nowszą MUSI przyjmować członków bez row w tym znaczeniu.
Przykład — słój pionowy, rząd trzech frontów szerokości 500 mm (wysokość 300 mm) nad rzędem dwóch frontów szerokości 750 mm (wysokość 1000 mm). Słój przechodzi z trzech formatek w dwie, a styki wypadają w różnych miejscach:
słój ↓
rząd 1 │ 1: 500 │ 2: 500 │ 3: 500 │ wys. 300
rząd 2 │ 1: 750 │ 2: 750 │ wys. 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 Przyciąganie rzędu (2.6.0)
Każdy rząd ma własne przyciąganie — mówi, do której krawędzi bloku rząd jest dosunięty, a więc po której stronie leży reszta szerokości rzędu węższego od najszerszego. Przyciąganie podaje wpis w rows[]; rząd bez wpisu ma "start", czyli znaczenie z wersji 2.5.0.
align | Litera (§13.3) | Słój pionowy | Słój poziomy | Reszta szerokości rzędu |
|---|---|---|---|---|
"start" (domyślnie) | P — początek | do lewej | do dołu | po stronie końca |
"center" | S — środek | na środku | na środku | po połowie z obu stron |
"end" | K — koniec | do prawej | do góry | po stronie początku |
Przyciąganie nie zmienia numeracji: pozycje (order) liczą się zawsze od krawędzi początkowej. Rząd tak szeroki jak blok przyciągania nie potrzebuje — wpis niczego w nim nie zmienia. Jak wyciąć resztę szerokości (jeden czy dwa kawałki, ich wymiar po rzazach), rozstrzyga program rozkroju.
Przykład — słój pionowy, rząd dwóch frontów szuflad szerokości 600 mm (wysokość 200 mm) nad drzwiami szerokości 900 mm (wysokość 1000 mm) na środku:
słój ↓
rząd 1 P │ 1: 600 │ 2: 600 │ wys. 200
rząd 2 S │ … │ 1: 900 │ … │ wys. 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 Oznaczenie miejsca w bloku (2.6.0)
Miejsce formatki w bloku zapisuje się jednym tekstem #B.RA.P:
| Część | Znaczenie | Pole |
|---|---|---|
B | numer bloku — liczba całkowita ≥ 1, jeden na grupę w projekcie | grupa (grain_groups[]) |
R | numer rzędu | members[].row |
A | litera przyciągania rzędu: P — początek, S — środek, K — koniec (jedna dla obu słojów) | rows[].align |
P | pozycja w rzędzie od krawędzi początkowej | members[].order |
Przykład: #1.2S.1 — blok 1, rząd 2 przyciągnięty do środka, formatka 1 w rzędzie; #2.2P.2 — blok 2, rząd 2 przyciągnięty do początku, formatka 2. Wyrażenie regularne zapisu: #(\d+)\.(\d+)([PSK])\.(\d+).
Oznaczenie służy dwóm celom:
- program bez ciągłości słoja (np. program projektowy bez grup słoja) niesie blok w nazwach formatek — projektant wpisuje oznaczenie do nazwy, patrząc na mebel od zewnątrz (§13.1), a konwerter do .meb zakłada z niego grupy: jedną grupę na numer bloku,
rowiorderz oznaczenia, wpisrows[]z litery rzędu. Wszystkie formatki jednego rzędu MUSZĄ mieć tę samą literę. Słoju bloku (orientation) oznaczenie nie niesie — konwerter bierze go z kierunku słoja formatek w meblu. Konwerter MOŻE usunąć oznaczenie z nazwy formatki, bo jego treść niosą pola grupy, - program pokazujący blok (lista formatek, etykieta, plan cięcia) POWINIEN pisać miejsce formatki tym zapisem — numer bloku nadaje wtedy we własnym zakresie (np. w zleceniu).
Zasady walidacji grupy — patrz §15.4.
14. Układ współrzędnych
14.1 Kanoniczna orientacja formatki
Wszystkie operacje obróbcze (face, edge_side, x, y wierceń i frezowań) odnoszą się do kanonicznej pozycji bazowej formatki, niezależnie od jej rotation w drzewie. Konwencja: lico do góry, długość w pionie, szerokość w poziomie, układ prawoskrętny (spójny ze sceną 3D, bez odbicia). Współrzędna x biegnie wzdłuż długości (0..length), y wzdłuż szerokości (0..width, rośnie w lewo); origin = prawy-dolny narożnik lica.
x = length (L) ▲ (pion; słój „along_length")
│
┌────────────── xL ─────────────┐ ── x = L (góra)
│ │
yW │ LICO │ y0
│ face: top (Z+) │
│ │
└────────────── x0 ─────────────┘ ── x = 0 (origin, prawy-dolny)
y = W ◄─────────────────────────────── y = 0
(poziom; szerokość rośnie w lewo)length(L) — długość, pion; współrzędnax ∈ [0, L].width(W) — szerokość, poziom (rośnie w lewo); współrzędnay ∈ [0, W].thickness(T) — grubość, oś Z (Z+= lico /face: top,Z−= spód /face: bottom).- Krawędzie
edge_side:y0/yW= krawędzie długości;xL/x0= krawędzie szerokości.
Frez opisany jako face: top zawsze dotyczy lica formatki, nawet gdy formatka stoi pionowo w zmontowanej szafce. Pole rotation formatki służy wyłącznie do renderowania 3D i generowania schematów montażowych (lokalna rama 3D: length → X, width → Y, thickness → Z).
14.2 Układ grupy i przód
Lokalny układ współrzędnych każdej grupy — szafki, szuflady, zestawu:
Z+ (góra)
│
│ Y+ (tył)
│ /
│ /
│ /
└────── X+ (prawo)
front = strona Y- (drzwi / fronty szuflad) — domyślnie
origin szafki = lewy-dolny-przedni narożnik obrysu (zewnętrzny)Pozycje dzieci podawane są w układzie grupy — bok lewy szafki zaczyna się na x = 0.
Przód grupy to strona wskazana polem front, domyślnie -Y; góra to +Z. Orientację grupy w scenie niesie jej obrót (rotation) — szafka przestawiona na drugą ścianę patrzy w nową stronę razem z obrotem. Pole front jest edytowalne: program, którego układ grupy ma przód po innej stronie, podaje ją w polu. Implementacja MOŻE przepisać układ grupy tak, żeby przód był -Y (obrót układu wokół Z z przeliczeniem położeń dzieci) — grupa nie przesuwa się przy tym w scenie.
Rysunek produkcyjny szafki (grupy z rolą "cabinet") generowany jest zawsze z jej układu, patrząc na przód. Pole rotation szafki w drzewie jest ignorowane przez software produkcyjny przy generowaniu rysunków.
14.3 Zasada kaskadowa transformacji
Każdy węzeł definiuje position i rotation względem rodzica. Pozycja globalna obiektu jest wyznaczana przez złożenie transformacji wszystkich przodków:
pozycja_globalna = T(group_1) × T(group_2) × ... × T(group_n) × T(węzeł)Model ten jest kompatybilny bezpośrednio z Object3D w Three.js i Babylon.js.
14.4 Wymiar formatki a oklejanie
Wymiary w polu dimensions są zawsze wymiarami finalnymi po oklejeniu — zawierają już w sobie obrzeże.
Standard .meb nie opisuje wymiaru surowego (przed oklejeniem). Ewentualne pomniejszenie wymiaru o grubość obrzeża jest zadaniem technologii oklejania realizowanej na samej maszynie i zależy od jej parametrów. Implementacje rozkroju i podglądu operują wyłącznie na wymiarach finalnych z pola dimensions.
14.5 Układ bryły i akcesorium
Bryła i akcesorium z pozycją mają własny lokalny układ prawoskrętny, umieszczony przez position i rotation względem rodzica (§14.3) — grupy albo korzenia.
extrusion— kontur leży w płaszczyźnieXYukładu bryły, wyciągnięcie biegnie odZ = 0doZ = thickness,mesh— współrzędnepositionssą podane w układzie bryły, w mm,polyhedron— współrzędne wierzchołków są podane w układzie bryły, w mm.
15. Reguły walidacji
15.1 Unikalność identyfikatorów
Implementacja MUSI zgłosić błąd walidacji gdy:
- dwa węzły drzewa (grupa, formatka, akcesorium, bryła) mają identyczne
id - dwa wpisy w tym samym katalogu mają identyczne
id - dwa wierzchołki, dwie krawędzie albo dwa lica jednego wielościanu mają identyczne
id
Identyfikatory SĄ globalne w obrębie swojej kolekcji. id węzła jest globalne w całym drzewie, niezależnie od typu węzła i grupy, w której stoi. Identyfikatory elementów wielościanu są lokalne: unikalne w obrębie swojej listy w jednym wielościanie.
15.2 Integralność referencji
Każda referencja *_ref MUSI wskazywać na istniejący id w docelowej kolekcji:
| Referencja | Cel |
|---|---|
panel.material_ref | materials_catalog[].id |
panel.composite.layers[].material_ref | materials_catalog[].id (kategoria 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 (węzeł akcesorium) | hardware_catalog[].id |
hardware.material_ref | materials_catalog[].id |
solid.material_ref (węzeł bryły) | materials_catalog[].id |
geometry.mesh_ref | meshes_catalog[].id |
geometry.edges[].start, geometry.edges[].end, geometry.faces[].loops[][] | vertices[].id tego samego wielościanu |
drilling.hardware_instance_ref, routing.hardware_instance_ref | id węzła akcesorium z pozycją |
grain_group.material_ref | materials_catalog[].id |
grain_group.members[].panel_ref | id węzła formatki w drzewie |
comment_refs[] | comments[].id |
15.3 Zakresy wartości
| Pole | Warunek |
|---|---|
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 (węzeł akcesorium) | liczba całkowita > 0; = 1 gdy akcesorium ma position |
geometry.thickness (extrusion) | > 0 |
grain_group.kerf | > 0 |
finish.order | liczba całkowita > 0 |
edge_finish.chamfer (formatka i routing) | ≥ 0 oraz 2 × chamfer < dimensions.thickness |
15.4 Walidacja grup ciągłości słoja
Członek bez row jest w tych regułach rzędem o numerze równym jego order, z pozycją 1 (§13.1).
Implementacja MUSI zgłosić błąd gdy:
- Ta sama formatka należy do więcej niż jednej grupy słoja.
- Formatka w grupie używa innego materiału niż
grain_group.material_ref. - Numery rzędów w grupie nie tworzą ciągłej sekwencji (1, 2, …, n) albo pozycje w którymś rzędzie nie tworzą ciągłej sekwencji bez powtórzeń (1, 2, …, m). W grupie bez
rowto dotychczasowa reguła: wartościordertworzą ciągłą sekwencję bez powtórzeń (1, 2, …, n). - Formatki jednego rzędu mają różne wymiary wzdłuż słoja
D(panel). - Blok nie mieści się w użytecznym arkuszu wzdłuż albo w poprzek słoja:
D(panel) = dimensions.length gdy panel.grain = "along_length" ← wymiar wzdłuż słoja
D(panel) = dimensions.width gdy panel.grain = "along_width"
C(panel) = dimensions.width gdy panel.grain = "along_length" ← wymiar w poprzek słoja
C(panel) = dimensions.length gdy panel.grain = "along_width"
D(rząd) = D(panel) formatek rzędu (wspólny — pkt 4)
C(rząd) = Σ C(i) + (m − 1) × kerf m — liczba formatek w rzędzie
Σ D(rząd) + (n − 1) × kerf ≤ max_along_grain n — liczba rzędów
max C(rząd) ≤ max_across_graingdzie max_along_grain = sheet.length − 2×trim i max_across_grain = sheet.width − 2×trim, gdy słój materiału biegnie wzdłuż długości arkusza (material.grain = "along_length"); przy material.grain = "along_width" — odwrotnie.
W grupie bez row każdy rząd ma jedną formatkę: pkt 5 wzdłuż słoja to dotychczasowa reguła Σ D(i) + (n − 1) × kerf ≤ max_along_grain, a w poprzek słoja pokrywa się z §15.5.
- Wpis
rows[]wskazuje rząd, którego w grupie nie ma, albo dwa wpisy wskazują ten sam rząd (2.6.0).
Lica formatki od zewnątrz (§13.1) walidacja pliku nie sprawdzi — leży w scenie i zamiarze projektanta; odpowiada za nie program źródłowy.
15.5 Walidacja rozmiaru formatki
Formatka MUSI mieścić się w arkuszu materiału:
panel.dimensions.length ≤ sheet.length − 2×trim
panel.dimensions.width ≤ sheet.width − 2×trimlub po obróceniu o 90° — wyłącznie gdy material.grain = "none" lub panel.grain = "none":
panel.dimensions.width ≤ sheet.length − 2×trim
panel.dimensions.length ≤ sheet.width − 2×trimJeśli oba — materiał i formatka — mają zdefiniowany słój (grain ≠ "none"), obrót jest niedozwolony.
Reguła jest spójna z hierarchią słoja (§8.3): obrót blokuje wyłącznie sytuacja, w której materiał ma słój i formatka go respektuje (panel.grain ≠ "none"). Gdy materiał nie ma słoja, panel.grain nie ma znaczenia.
15.6 Walidacja kompozycji (composite)
Implementacja MUSI zgłosić błąd gdy:
- Suma grubości warstw nie jest równa
panel.dimensions.thickness:Σ layers[].thickness ≠ dimensions.thickness. - Wartości
ordernie tworzą ciągłej sekwencji 1…n (powtórzenia lub luki). material_refwarstwy wskazuje na materiał inny niżboard.
15.7 Walidacja operacji
| Warunek | Błąd |
|---|---|
Skos leave + depth > dimensions.thickness | błąd |
Skos z wieloma wpisami na tej samej krawędzi od tej samej strony bez pola depth | błąd |
Skos bez dokładnie jednego z edge_side / on_segment | błąd |
Skos on_segment celujący w segment inny niż line | błąd |
Slot bez dokładnie jednego placement (path albo edge_side/on_segment) | błąd |
Slot section: simple bez width+depth; section: profiled bez profile_ref | błąd |
Slot profiled: profil zamknięty lub niezakotwiczony na Y=0 (cięcie niewykonalne) | ostrzeżenie |
on_segment w segment bez id, nieistniejący lub o id niejednoznacznym w formatce | błąd |
on_segment poza segmentem przelotowym (outline machined / hole) | błąd |
| Ścieżka frezowania poza obrysem formatki | ostrzeżenie |
edging.sequence poza enumem (width_first | length_first) | błąd |
routing.edging.pre_trim: true poza type: outline o pojedynczym prostym segmencie machined | błąd |
machined na segmencie operacji innej niż outline | ostrzeżenie |
15.8 Walidacja wykończenia krawędzi (edge_finish)
Implementacja MUSI zgłosić błąd gdy:
- Ta sama krawędź formatki ma jednocześnie obrzeże i wykończenie —
edging.{side}iedge_finish.{side}są oba różne odnull. - Ta sama ścianka konturu
outline/holejest wskazana jednocześnie wedging.walls(w którymkolwiek wpisie) i wedge_finish.wallstej samej operacji."all"wskazuje wszystkie realne ścianki cięcia. - Fazka nie mieści się w grubości formatki:
2 × chamfer ≥ dimensions.thickness— dlapanel.edge_finishirouting.edge_finish.
15.9 Walidacja brył i akcesoriów
Implementacja MUSI zgłosić błąd gdy:
- Kontur albo otwór geometrii
extrusionnie jest zamknięty (closed: false). - Otwór geometrii
extrusionwychodzi poza kontur albo przecina inny otwór. - Długość
positionsalbotrianglessiatki nie jest wielokrotnością 3, siatka ma mniej niż 3 wierzchołki albo indeks wtriangleswskazuje nieistniejący wierzchołek. - Akcesorium z
positionnie maid,rotation,material_refalbogeometrylub maquantityróżne od 1. hardware_instance_refwskazuje akcesorium bez pozycji.- Materiał
category: surfacenie mafurniture: false. - Węzeł inny niż grupa zawiera
children. - Krawędź wielościanu ma
startrówneend. - Pętla lica wielościanu ma mniej niż 3 wierzchołki, powtarza wierzchołek albo dwa jej kolejne wierzchołki nie są końcami żadnej krawędzi z
edges. - Wierzchołek lica wielościanu leży dalej niż 0,01 mm od płaszczyzny lica, a otwór lica wychodzi poza obrys albo przecina obrys lub inny otwór.
15.10 Walidacja drzewa (3.0.0)
Implementacja MUSI zgłosić błąd gdy:
- Węzeł inny niż grupa zawiera
children. - Grupa z rolą
"cabinet"ma wśród potomków — na dowolnej głębokości — grupę z rolą"cabinet". - W pliku z danymi 3D (
project.has_3dróżne odfalse) węzeł, który nie jest akcesorium bez pozycji, nie mapositionalborotation.
Rola, której implementacja nie zna, nie jest błędem — grupa liczy się wtedy jak grupa bez roli (§7.4).
16. Komentarze (comments)
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
id | id | tak | Unikalny identyfikator komentarza |
author | string | nie | Autor komentarza |
date | datetime | nie | Data dodania |
text | string | tak | Treść komentarza |
Komentarze przechowywane są w globalnej liście comments[]. Obiekty odwołują się do nich przez tablicę comment_refs[]. Ten sam komentarz MOŻE być przypisany do wielu obiektów.
Obiekty obsługujące comment_refs[]: węzły drzewa (group, panel, hardware, solid), bevel, drilling, routing, finish.
Dodatek A — Tabela wymaganych pól według obiektu
| Obiekt | Pola wymagane |
|---|---|
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 (poza akcesorium bez pozycji i plikiem bez danych 3D) |
group | + children |
solid (węzeł) | + 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 (węzeł) | type, id, name, dimensions, material_ref, grain + position, rotation w pliku z danymi 3D |
panel.edge_finish.{side} | sanded, chamfer |
composite | layers (min. 2 elementy) |
composite_layer | order, material_ref, thickness |
bevel | from_face, angle, leave + (edge_side albo on_segment) |
drilling (face) | drilling_ref, type: face, face, x, y |
drilling (edge/bok) | drilling_ref, type: edge, edge_side + x (L/R) lub y (T/B); z opcjonalne |
drilling (edge/kontur) | drilling_ref, type: edge, on_segment, s; z opcjonalne |
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 albo on_segment), width, depth |
routing (slot/edge/profiled) | type, section: profiled, face, (edge_side albo 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-bok) | type, edge_side, size_ref + x (L/R) lub y (T/B); z opcjonalne |
routing (biscuit/edge-kontur) | type, on_segment, s, size_ref; z opcjonalne |
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 gdy through: false |
hardware_catalog | id, name |
profiles | id, name, path |
hardware (węzeł) | type, id, name, hardware_ref, quantity |
hardware (z pozycją) | + position, rotation, material_ref, geometry; quantity: 1 |
grain_group | id, name, material_ref, kerf, members |
grain_group.member | panel_ref, order |
comment | id, text |
Dodatek B — Odczyt plików 2.x
Implementacja czytająca wersję 3.0 MOŻE czytać pliki 2.x. Gdy je czyta, POWINNA zamienić je przy odczycie na drzewo 3.0 i dalej pracować jedną drogą:
| 2.x | 3.0 |
|---|---|
węzeł type: "cabinet" | grupa type: "group", role: "cabinet", z tym samym id, name, position, rotation, production_id, comment_refs i front |
cabinet.panels[] | dzieci szafki z type: "panel" |
cabinet.hardware[] | dzieci szafki z type: "hardware"; akcesorium bez id dostaje identyfikator unikalny w pliku, a bez nazwy — nazwę z hardware_catalog |
cabinet.solids[] | dzieci szafki z type: "solid" |
węzły group i solid | bez zmian |
grain_groups, katalogi, komentarze | bez zmian — identyfikatory formatek się nie zmieniają |
Wersja 2.6.0 jest ostatnią wersją 2.x.