Model danych standardu .meb
Status:
[x]gotowe — wersja 3.0.0
Ten dokument opisuje hierarchię obiektów w pliku .meb, relacje między nimi oraz ogólne założenia struktury. Szczegółowa specyfikacja pól znajduje się w 03-specification.md.
Drzewo obiektów
MebFile
├── meta ← metadane pliku (wersja standardu, data, generator)
├── project ← dane projektu
│ └── designer ← dane projektanta
├── scene[] ← scene graph — drzewo węzłów, tablica węzłów korzenia (3.0.0)
│ └── node (rekurencja)
│ ├── id ← unikalny w całym pliku
│ ├── name ← etykieta swobodna
│ ├── type: group | panel | hardware | solid
│ ├── position {x, y, z} ← względem rodzica, mm (bez nich: akcesorium bez pozycji, plik has_3d: false)
│ ├── rotation {x, y, z} ← Euler XYZ, stopnie, zakres (−180°, 180°]
│ ├── production_id ← opcjonalny, np. "01.02"
│ ├── comment_refs[] ← referencje do comments[].id
│ │
│ ├── [gdy type: group]
│ │ ├── role: cabinet ← opcjonalna; "cabinet" = szafka, brak = szuflada, podzespół, zestaw
│ │ ├── front: "-Y" | "+Y" | "-X" | "+X" ← przód grupy w jej układzie, domyślnie "-Y", edytowalny
│ │ └── children[] ← dzieci: grupy, formatki, akcesoria i bryły
│ │
│ ├── [gdy type: solid] ← 2.3.0: dowolna geometria z materiałem; nie idzie do produkcji
│ │ ├── material_ref ───────────────────► materials_catalog[].id
│ │ └── geometry
│ │ ├── type: extrusion | mesh | polyhedron
│ │ ├── [extrusion] outline (path, closed), holes[] (path, closed), thickness
│ │ ├── [mesh] mesh_ref ─────────────► meshes_catalog[].id
│ │ └── [polyhedron] vertices[] {id, x, y, z}, edges[] {id, start, end, fold}, faces[] {id, loops[][]} ← 2.4.0
│ │
│ ├── [gdy type: panel] ← 3.0.0: formatka to węzeł drzewa, liść w dowolnej grupie albo w korzeniu
│ │ ├── id, name
│ │ ├── dimensions {length, width, thickness}
│ │ ├── position {x, y, z}
│ │ ├── rotation {x, y, z}
│ │ ├── production_id
│ │ ├── material_ref ──────────────────► materials_catalog[].id
│ │ ├── grain: along_length | along_width | none
│ │ ├── grain_group_ref ─────────────────► grain_groups[].id ← opcjonalne
│ │ ├── bend ← opcjonalne, tylko dla formatek giętych
│ │ │ ├── axis: width | length ← oś gięcia
│ │ │ ├── radius ← mm
│ │ │ ├── radius_type: inner | outer
│ │ │ └── angle ← stopnie łuku
│ │ ├── composite ← opcjonalne, formatka klejona z warstw
│ │ │ └── layers[] ← min. 2 warstwy; sum(thickness) = dimensions.thickness
│ │ │ ├── order ← 1 = spód/tył, n = wierzch/front
│ │ │ ├── material_ref ───────────► materials_catalog[].id
│ │ │ └── thickness ← grubość warstwy, mm
│ │ ├── edging
│ │ │ ├── xL: { ref } | null ← x=L (góra)
│ │ │ ├── x0: { ref } | null ← x=0 (dół)
│ │ │ ├── yW: { ref } | null ← y=W (lewa)
│ │ │ ├── y0: { ref } | null ← y=0 (prawa)
│ │ │ ├── sequence: "width_first" | "length_first" ← para oklejana pierwsza
│ │ │ └── {xL,x0,yW,y0}.ref ─► edging_catalog[].id
│ │ ├── edge_finish ← opcjonalne (2.2.0), krawędź bez obrzeża: szlif + fazka
│ │ │ ├── xL, x0, yW, y0: { sanded, chamfer } | null ← chamfer = fazka 45° przy licu i spodzie, mm
│ │ │ └── brak pola = plik nie mówi nic; null = krawędź bez wykończenia; wyklucza edging na tej krawędzi
│ │ ├── finishes[] ← opcjonalne, powłoki powierzchniowe
│ │ │ └── finish
│ │ │ ├── surface: face_top | face_bottom |
│ │ │ │ edge_xL | edge_x0 | edge_y0 | edge_yW
│ │ │ ├── type: veneer | laminate | paint
│ │ │ ├── material_ref ───────────► materials_catalog[].id
│ │ │ ├── order ← kolejność nakładania (1 = pierwsza)
│ │ │ └── comment_refs[]
│ │ ├── comment_refs[] ← referencje do comments[].id
│ │ └── operations
│ │ ├── bevels[]
│ │ │ └── bevel
│ │ │ ├── edge_side: xL | x0 | yW | y0 ← bok bazowy
│ │ │ │ LUB on_segment ──► outline/hole segments[].id (tylko line)
│ │ │ ├── from_face: top | bottom ← od której płaszczyzny liczymy
│ │ │ ├── angle ← stopnie (0=prosty, 45=skos)
│ │ │ ├── leave ← mm materiału zostawionego prosto
│ │ │ ├── depth ← mm głębokości skosu, opcjonalne
│ │ │ │ (pominięcie = do końca grubości)
│ │ │ ├── edging ← opcjonalne, obrzeże na skosie
│ │ │ │ └── ref ────────────────► edging_catalog[].id
│ │ │ └── comment_refs[] ← referencje do comments[].id
│ │ ├── drillings[]
│ │ │ └── drilling
│ │ │ ├── drilling_ref ───────► drilling_catalog[].id
│ │ │ ├── type: face | edge
│ │ │ ├── [face] face: top | bottom
│ │ │ ├── [edge/bok] edge_side: xL | x0 | yW | y0
│ │ │ ├── [edge/kontur] on_segment ──► outline/hole path segments[].id
│ │ │ ├── x ← face; edge_side y0/yW (wzdłuż długości)
│ │ │ ├── y ← face; edge_side xL/x0 (wzdłuż szerokości)
│ │ │ ├── s ← edge/kontur (wzdłuż segmentu)
│ │ │ ├── z ← edge: pozycja w grubości od lica (default thickness/2)
│ │ │ ├── hardware_instance_ref ──► id węzła akcesorium ← opcjonalne (2.3.0), obróbka akcesorium
│ │ │ └── comment_refs[] ← referencje do comments[].id
│ │ └── routings[]
│ │ └── routing
│ │ ├── type: slot | outline | hole | pocket | biscuit
│ │ ├── [slot] section: simple | profiled ← jawny dyskryminator przekroju
│ │ ├── [slot] face: top | bottom ← surface: obrabiane lico; edge: narożnik odniesienia
│ │ ├── [slot/surface] path ← trajektoria osi slota
│ │ ├── [slot/edge] edge_side: xL | x0 | yW | y0
│ │ │ LUB on_segment ──► outline/hole segments[].id
│ │ ├── [slot/edge] start, end ← opcjonalne (wzdłuż krawędzi/segmentu)
│ │ ├── [slot/simple] width, depth, offset ← prostokąt; offset styczny, default 0
│ │ ├── [slot/profiled] profile_ref ─────────► profiles[].id (pełna geometria, bez offset)
│ │ ├── [outline] path ← zamknięty kontur gotowego kształtu; segmenty cięcia oznaczone machined (różnica vs prostokąt)
│ │ │ ścianka prosta; profil/skos ścianki = slot/bevel on_segment
│ │ ├── [outline] edging ← opcjonalne { ref, walls, pre_trim } LUB tablica wpisów (2.1.0: różne materiały)
│ │ │ walls: "all" | [boki bazowe i/lub segments[].id]
│ │ ├── [outline] edge_finish ← opcjonalne { walls, sanded, chamfer } (2.2.0): szlif + fazka ścianek bez obrzeża
│ │ ├── [hole] path ← zamknięty kontur wewnątrz formatki
│ │ ├── [hole] edging ← opcjonalne { ref, walls } LUB tablica (2.1.0); pre_trim niedozwolony
│ │ ├── [hole] edge_finish ← opcjonalne { walls, sanded, chamfer } (2.2.0)
│ │ ├── [pocket] face: top | bottom
│ │ ├── [pocket] depth ← mm poniżej lica (płaskie dno, proste ściany; profil ściany = osobny slot)
│ │ ├── [pocket] path ← zamknięty kontur
│ │ │ ├── start {x, y} ← absolutne, od prawego dolnego rogu
│ │ │ ├── closed: bool ← true = kontur, false = otwarty
│ │ │ └── segments[]
│ │ │ └── segment
│ │ │ ├── type: line | arc | bezier
│ │ │ ├── id ← opcjonalne (wymagane gdy cel on_segment)
│ │ │ ├── [line] end {x, y}
│ │ │ ├── [arc] center {x, y}, radius,
│ │ │ │ angle_start, angle_end,
│ │ │ │ clockwise: bool
│ │ │ └── [bezier] cp1 {x, y}, cp2 {x, y},
│ │ │ end {x, y}
│ │ ├── [biscuit] face (lico) LUB edge_side (bok)
│ │ │ LUB on_segment (kontur)
│ │ ├── [biscuit] x, y / s ← oś lameli (§9.2.1/§9.2.2)
│ │ ├── [biscuit] z ← głębokość osi od lica (krawędź; default thickness/2)
│ │ ├── [biscuit] angle ← opcjonalne
│ │ ├── [biscuit] size_ref ─────────────────► biscuit_catalog[].id
│ │ ├── finishes[] ← opcjonalne, wykończenie powierzchni frezowanej
│ │ │ └── { material_ref ──► materials_catalog[].id, order }
│ │ ├── hardware_instance_ref ──► id węzła akcesorium ← opcjonalne (2.3.0), obróbka akcesorium
│ │ └── comment_refs[] ← referencje do comments[].id
│ │
│ └── [gdy type: hardware] ← 3.0.0: akcesorium to węzeł drzewa, liść w dowolnej grupie albo w korzeniu
│ ├── hardware_ref ───────────────────► hardware_catalog[].id
│ ├── quantity ← 1 gdy akcesorium ma pozycję
│ ├── position, rotation ← opcjonalne; bez nich pozycja listy z ilością w swojej grupie
│ ├── material_ref ───────────────────► materials_catalog[].id ← gdy position
│ └── geometry ← gdy position; jak bryła
│
├── drilling_catalog[]
│ └── drilling_item
│ ├── id, code, name
│ ├── diameter ← mm
│ ├── depth ← mm, opcjonalne gdy through: true
│ └── through: true | false
│
├── materials_catalog[]
│ └── material
│ ├── id, code, name
│ ├── manufacturer
│ ├── category: board | veneer | laminate | paint | surface
│ ├── furniture: true | false ← 2.3.0, materiał meblowy; domyślnie true
│ │
│ ├── [board / veneer / laminate]
│ │ ├── thickness ← grubość nominalna, mm
│ │ └── grain: along_length | along_width | none
│ │
│ ├── [board]
│ │ └── sheet ← wymagane
│ │ ├── length ← długość arkusza, mm
│ │ ├── width ← szerokość arkusza, mm
│ │ └── trim ← brzegowanie per krawędź, mm
│ │
│ ├── [paint]
│ │ ├── color_system ← np. "RAL", "NCS"
│ │ ├── color_code ← np. "9016", "S 0500-N"
│ │ └── description ← dowolny string, np. "biały połysk 90%"
│ │
│ └── [surface] ← 2.3.0, sam wygląd: tynk, stal, szkło; furniture: false
│ └── color ← #RRGGBB
│
├── edging_catalog[]
│ └── edging_item
│ ├── id, code, name
│ ├── texture: true | false
│ ├── thickness ← grubość taśmy, mm
│ ├── height ← wysokość taśmy, mm
│ └── material_ref ──────────────► materials_catalog[].id
│
├── hardware_catalog[]
│ └── hardware_item
│ ├── id, code, name
│ └── manufacturer
│
├── meshes_catalog[] ← 2.3.0, siatki brył i akcesoriów, zawsze osadzone w pliku
│ └── mesh
│ ├── id, name
│ ├── positions[] ← x, y, z kolejno, mm, w układzie bryły
│ └── triangles[] ← indeksy po trzy, od 0
│
├── comments[]
│ └── comment
│ ├── id
│ ├── author ← opcjonalne
│ ├── date ← opcjonalne, ISO 8601
│ └── text
│
├── grain_groups[] ← grupy ciągłości słoja — bloki z rzędów
│ └── grain_group
│ ├── id, name
│ ├── material_ref ───────────────────────────────► materials_catalog[].id
│ ├── orientation ← słój względem frontu: vertical (domyślnie) | horizontal ← 2.5.0
│ ├── kerf ← szczelina podziału między formatkami, mm
│ ├── members[] ← formatki bloku: rząd wzdłuż słoja i pozycja w rzędzie
│ │ └── { panel_ref ───────────► id węzła formatki (type: panel), row, order }
│ │ ← row: rzędy 1…n (2.5.0; brak = rząd równy order, pozycja 1)
│ │ ← order: pozycja w rzędzie 1…m od krawędzi początkowej
│ └── rows[] ← przyciąganie rzędów ← 2.6.0
│ └── { row, align } ← align: start (domyślnie) | center | end
│
└── profiles[] ← katalog profili geometrycznych krawędzi
└── profile
├── id, code, name
└── path ← wynikowa geometria cięcia (segmenty line/arc/bezier)
← (0,0) = narożnik (face ∩ edge_side lub face ∩ ściana konturu)
← X+ = wzdłuż lica w głąb materiału, Y+ = w głąb grubości
← materiał przed cięciem zajmuje ćwiartkę X≥0, Y≥0Relacje i referencje
| Pole | Referencja do | Typ |
|---|---|---|
drilling.drilling_ref | drilling_catalog[].id | wymagana |
on_segment (drilling / biscuit / slot / bevel) | id segmentu outline/hole — unikalny w obrębie formatki | wymagana gdy krawędź konturu |
panel.material_ref | materials_catalog[].id | wymagana |
panel.edging.{side}.ref | edging_catalog[].id | wymagana gdy side != null |
edging_catalog[].material_ref | materials_catalog[].id | wymagana |
routing.profile_ref | profiles[].id | wymagana dla slot section: profiled |
routing.size_ref | biscuit_catalog[].id | wymagana dla type: biscuit |
routing.edging.ref | edging_catalog[].id | wymagana gdy routing ma edging |
hardware.hardware_ref (węzeł akcesorium) | hardware_catalog[].id | wymagana |
hardware.material_ref | materials_catalog[].id | wymagana gdy akcesorium ma position |
solid.material_ref (węzeł bryły) | materials_catalog[].id | wymagana |
geometry.mesh_ref | meshes_catalog[].id | wymagana gdy type: mesh |
geometry.edges[].start, end, geometry.faces[].loops[][] | vertices[].id tego samego wielościanu | wymagana gdy type: polyhedron |
{drilling/routing}.hardware_instance_ref | id węzła akcesorium z pozycją — także w innej grupie albo szafce | opcjonalna |
panel.grain_group_ref | grain_groups[].id | opcjonalna |
panel.composite.layers[].material_ref | materials_catalog[].id | wymagana gdy warstwa istnieje |
grain_group.members[].panel_ref | id węzła formatki w drzewie | wymagana |
grain_group.material_ref | materials_catalog[].id | wymagana |
{węzeł/drilling/routing}.comment_refs[] | comments[].id | opcjonalna |
Wszystkie id muszą być unikalne w obrębie swojej listy. Referencje krzyżowe między listami są jednokierunkowe. Wyjątek stanowi grain_groups[], który przez members[].panel_ref odwołuje się do formatek w scene graphie — jest to jedyna lista katalogowa z referencją zwrotną do scene[].
Układ współrzędnych
Zasada kaskadowa
Każdy obiekt definiuje swoją position i rotation względem rodzica. Pozycja globalna jest wyznaczana przez złożenie transformacji wszystkich przodków w drzewie:
pozycja_globalna = T(group_1)
× T(group_2) ← np. zestaw szafek
× T(group_3) ← szafka (grupa z rolą cabinet)
× T(group_4) ← szuflada
× T(panel)To jest standardowy model scene graphu kompatybilny bezpośrednio z Three.js (Object3D), Babylon.js i innymi silnikami 3D.
Rotacja
Kąty Eulera w kolejności XYZ, w stopniach. Dla typowych elementów meblowych stosowane są wyłącznie wielokrotności 90°, co eliminuje praktyczny problem gimbal lock.
Kanoniczna orientacja formatki — konwencja L / W / T
Formatka jest zawsze opisana tak, jak leży w widoku rozkroju / na stole maszyny: licem do góry, długością w pionie, szerokością w poziomie, niezależnie od jej faktycznego ułożenia w zmontowanej szafce. To jest jedyna, wspólna konwencja dla całego standardu — pliku .meb, podglądów 2D, podglądów 3D oraz oprogramowania rozkroju. Układ jest prawoskrętny, spójny ze sceną 3D (three.js): widok lica 2D nie jest lustrzanym odbiciem widoku 3D. Nie ma żadnej transpozycji ani odbicia między warstwami.
Wymiary i współrzędne:
length(L) — długość, pionowo (rośnie w górę); domyślny kierunek słoja (along_length). Współrzędna operacjixbiegnie wzdłuż długości,x ∈ [0, L].width(W) — szerokość, poziomo (rośnie w lewo). Współrzędna operacjiybiegnie wzdłuż szerokości,y ∈ [0, W].thickness(T) — grubość, oś Z (Z+= lico /face: top,Z−= spód /face: bottom).- origin
(0,0)= prawy-dolny narożnik lica (x=0na dole,y=0po prawej).
Uwaga: współrzędna
xjest pionowa (bo długość jest pionowa), aypozioma — celowo, zgodnie z danymi (xzawsze odmierza długość,yszerokość). To nie jest klasyczne „x=poziom". Origin w prawym-dolnym rogu (yrośnie w lewo) zapewnia, że patrząc na lico (Z+) układ jest prawoskrętny — identyczny jak w scenie 3D, bez odbicia lustrzanego.
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)
KRAWĘDZIE BOCZNE (edge_side):
y0 = y=0 (po prawej), yW = y=W (po lewej) → krawędzie DŁUGOŚCI (pionowe boki, biegną wzdłuż length)
xL = x=L (u góry), x0 = x=0 (u dołu) → krawędzie SZEROKOŚCI (poziome boki, biegną wzdłuż width)
WSPÓŁRZĘDNE OPERACJI (wiercenia / frezy / lamele na licu):
x ∈ [0, L] — wzdłuż długości (pion, od dołu)
y ∈ [0, W] — wzdłuż szerokości (poziom, od prawej)
z ∈ [0, T] — głębokość od lica (krawędź; mierzona w głąb grubości, przeciwnie do Z+)Zasady:
- Wymiary:
dimensions.length(L) ×dimensions.width(W) ×dimensions.thickness(T). - Słój:
along_length= wzdłuż długości (pion, ośx);along_width= wzdłuż szerokości (poziom, ośy);none= brak. - Krawędzie
edge_side:y0/yWto krawędzie długości;xL/x0to krawędzie szerokości. Nazwy są zakotwiczone we współrzędnej (y0=y=0,yW=y=W,xL=x=L,x0=x=0) — niezależne od orientacji widoku. - Wszystkie współrzędne operacji (
face,edge_side,on_segment,x,y,z,s) odnoszą się do tego kanonicznego układu — są niezależne odrotationformatki w drzewie. Frez naface: topzawsze dotyczy lica, nawet gdy panel stoi pionowo w zmontowanej szafce. Głębokość krawędziowazmierzona zawsze od lica.
Odwzorowanie na osie sceny 3D (dla implementacji)
Lokalna rama 3D formatki (na potrzeby position/rotation w scenie): length → oś X, width → oś Y, thickness → oś Z. „Pion" długości dotyczy wyłącznie widoku 2D (rozkrój/schemat) — w scenie 3D rotation mapuje tę ramę na układ rodzica (patrz „Układ grupy i przód”). Odwzorowanie krawędzi na ściany lokalne:
edge_side | rodzaj | ściana lokalna |
|---|---|---|
y0 | krawędź długości | Y− (y = 0) |
yW | krawędź długości | Y+ (y = W) |
xL | krawędź szerokości | X+ (x = L) |
x0 | krawędź szerokości | X− (x = 0) |
Układ grupy i przód
Każda grupa — szafka, szuflada, zestaw — ma własny lokalny układ współrzędnych, w którym opisane są położenia jej dzieci:
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)Pole front grupy mówi, po której stronie jej układu leży przód — domyślnie "-Y", jak przód bloku w programie projektowym; jest edytowalne dla programów, których układ ma przód po innej stronie, i dla szafek narożnych. Orientację grupy w scenie niesie jej obrót.
Pozycje formatek (np. position: {x: 18, y: 0, z: 360}) są podawane w układzie rodzica — półka na wysokości 360 mm ma z: 360 niezależnie od tego, gdzie szafka stoi w pokoju.
Rysunek produkcyjny szafki (grupy z rolą cabinet) zawsze generowany jest z jej układu — rotation szafki w drzewie jest ignorowana przez software produkcyjny.
Układ bryły
Bryła i akcesorium z pozycją mają własny układ prawoskrętny, umieszczony przez position i rotation względem rodzica — grupy albo korzenia. Kontur extrusion leży w płaszczyźnie XY bryły i jest wyciągnięty od Z = 0 do Z = thickness; wierzchołki siatki i wielościanu są podane w tym samym układzie.
Hierarchia scene graphu — przykład
scene
└── group "Mieszkanie Kowalskich" production_id: "01"
├── group "Kuchnia" production_id: "01.01"
│ ├── solid "Ściana północna" ← bryła: bez production_id
│ ├── group "Szafki wiszące" production_id: "01.01.01"
│ │ ├── group "W60" role: cabinet production_id: "01.01.01.01"
│ │ │ position: {x:0, y:0, z:0}
│ │ ├── group "W60" role: cabinet production_id: "01.01.01.01" ← identyczna
│ │ │ position: {x:600, y:0, z:0}
│ │ └── group "W80" role: cabinet production_id: "01.01.01.02"
│ │ position: {x:1200, y:0, z:0}
│ ├── group "Szafki stojące" production_id: "01.01.02"
│ │ └── group "S60" role: cabinet production_id: "01.01.02.01"
│ │ ├── panel "Bok lewy" production_id: "01.01.02.01.01"
│ │ ├── group "Szuflada górna" production_id: "01.01.02.01.02"
│ │ │ └── panel "Front" production_id: "01.01.02.01.02.01"
│ │ └── hardware "Zawias" ← akcesorium: bez production_id
│ └── panel "Blat" production_id: "01.01.03" ← formatka nad zestawem, bez szafki
└── group "Łazienka" production_id: "01.02"
└── group "L-umywalka" role: cabinet production_id: "01.02.01"Dwie szafki W60 mają ten sam production_id (01.01.01.01) bo są strukturalnie identyczne — różnią się tylko position. Szafki nie ma w szafce na żadnej głębokości — szuflada to grupa bez roli.
Zasady identyczności strukturalnej
Dwa węzły są strukturalnie identyczne (dostają ten sam numer na swoim poziomie) jeśli mają równe:
Dla formatek (panel):
dimensionsmaterial_refgraingrain_group_ref+rowiorderw grupie ← dwie formatki w różnych grupach lub na różnych miejscach (rząd, pozycja) w tej samej grupie są strukturalnie różneedging(wszystkie krawędzie +sequence)edge_finish(wszystkie krawędzie)operations(wszystkie wiercenia i frezowania)
Dla grup (group, także z rolą cabinet):
- rola
- zestaw dzieci (po ich
production_id) — bryły się nie liczą - zestaw akcesoriów (po
hardware_refi łącznej ilości — pozycja i geometria akcesorium się nie liczą)
Ignorowane przy porównaniu: position, rotation, name, id, comment_refs.
Ilości
Ilości nie są przechowywane bezpośrednio na formatce ani węźle. Wielokrotność szafek i grup wyraża się przez wiele węzłów w drzewie, każdy z własną pozycją.
Nie istnieje pole quantity na poziomie grupy ani formatki — ma je wyłącznie akcesorium.
Walidacja rozmiaru formatki
Maksymalny użyteczny wymiar arkusza po brzegowaniu:
max_length = sheet.length - (2 × trim)
max_width = sheet.width - (2 × trim)Formatka jest prawidłowa jeśli mieści się w arkuszu — bezpośrednio lub po obróceniu o 90° (gdy grain to dopuszcza):
panel.dimensions.length ≤ max_length AND panel.dimensions.width ≤ max_widthlub po obróceniu (tylko gdy material.grain = "none" lub panel.grain = "none"):
panel.dimensions.width ≤ max_length AND panel.dimensions.length ≤ max_widthJeśli oba kierunki mają zdefiniowany słój, obrót jest niedozwolony — formatka musi się mieścić bez obrotu.
Walidacja grup słoja
Formatka może należeć do co najwyżej jednej grupy słoja. Próba dodania tej samej formatki do dwóch grup jest błędem walidacji.
Wszystkie formatki w grupie muszą używać tego samego materiału co grain_group.material_ref.
Grupa jest blokiem: rzędy kolejno wzdłuż słoja, w rzędzie formatki obok siebie w poprzek słoja. Członek bez row jest osobnym rzędem o numerze równym order, z pozycją 1 — tak czyta się grupy z plików 2.4.0 i starszych.
Blok opisuje się w widoku na lico formatek, a lico formatki grupy to strona widoczna od zewnątrz mebla — obróbki od środka leżą na spodzie (specyfikacja §13.1). Każdy rząd ma własne przyciąganie (rows[], 2.6.0): do początku, do środka albo do końca; rząd bez wpisu jest dosunięty do początku, a pozycje liczą się zawsze od krawędzi początkowej (§13.2). Miejsce formatki zapisuje się tekstem #B.RA.P, np. #1.2S.1 (§13.3).
Numery rzędów (row) muszą tworzyć ciągłą sekwencję (1, 2, …, n), a pozycje (order) w każdym rzędzie — ciągłą sekwencję bez powtórzeń (1, 2, …, m).
Wszystkie formatki rzędu mają ten sam wymiar wzdłuż słoja, a blok musi zmieścić się w użytecznym arkuszu w obu kierunkach:
D = panel.dimensions.length jeśli panel.grain = "along_length" ← wzdłuż słoja
D = panel.dimensions.width jeśli panel.grain = "along_width"
C = drugi wymiar formatki ← w poprzek słoja
Σ D(rząd) + (n − 1) × kerf ≤ max_along_grain n — liczba rzędów
max ( Σ C(i w rzędzie) + (m − 1) × kerf ) ≤ max_across_grain m — liczba formatek w rzędziegdzie max_along_grain i max_across_grain to wymiary użyteczne arkusza wzdłuż i w poprzek słoja materiału (sheet.length - 2×trim i sheet.width - 2×trim gdy material.grain = "along_length", odwrotnie gdy along_width). Szczegóły: specyfikacja §13.1 i §15.4.
Wymiary a obrzeża
Wymiar formatki jest zawsze wymiarem finalnym po oklejeniu — zawiera już w sobie obrzeże.
Standard nie opisuje wymiaru surowego (przed oklejeniem). Pomniejszenie wymiaru o grubość obrzeża jest zadaniem technologii oklejania na maszynie i zależy od jej parametrów — viewer i oprogramowanie rozkroju operują wyłącznie na wymiarach finalnych z pola dimensions.