Referencja pól standardu .meb
Status:
[x]gotowe — wersja 3.0.0
Szybka referencja dla implementatorów. Dokument zawiera wyłącznie tabele — bez opisów behawioralnych.
Pełna specyfikacja: 03-specification.md. Model danych: 02-data-model.md.
Jednostki
| Typ | Jednostka | Format | Przykład |
|---|---|---|---|
| Wymiary liniowe | mm | number | 600, 18.5 |
| Kąty | stopnie (°) | number | 45, 90 |
| Daty i czasy | ISO 8601 | string | "2025-03-15T14:30:00Z" |
| Identyfikatory | — | string, max 128 znaków | "panel_001" |
MebFile — korzeń pliku
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
meta | object | tak | — | {...} |
project | object | tak | — | {...} |
scene | array | tak | — | [...] |
materials_catalog | array | tak | — | [...] |
edging_catalog | array | tak | — | [...] |
drilling_catalog | array | tak | — | [...] |
hardware_catalog | array | tak | — | [...] |
profiles | array | tak | — | [...] |
grain_groups | array | nie | [] | [...] |
biscuit_catalog | array | nie | [] | [...] |
meshes_catalog | array | nie | [] | [...] |
comments | array | nie | [] | [...] |
meta
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
version | string | tak | — | "3.0.0" |
created_at | datetime | tak | — | "2025-03-15T14:30:00Z" |
created_by | object | nie | — | {...} |
checksum | string | nie | — | "sha256:a3f2..." |
meta.created_by
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
name | string | tak | — | "Systemex" |
version | string | nie | — | "3.2.1" |
project
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
id | id | tak | — | "proj_001" |
name | string | tak | — | "Kuchnia Kowalskich" |
description | string | nie | — | "Zabudowa kuchenna 3m" |
client | object | nie | — | {...} |
designer | object | nie | — | {...} |
project.client / project.designer
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
name | string | tak | — | "Jan Kowalski" |
email | string | nie | — | "jan@example.com" |
phone | string | nie | — | "+48 600 000 000" |
company | string | nie | — | "FHU Kowalski" |
node — pola wspólne (group, panel, hardware, solid)
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
id | id | tak | — | "node_001" — unikalne w całym pliku |
name | string | tak | — | "Szafki wiszące" |
type | enum | tak | — | "group" |
position | object {x,y,z} | tak — poza akcesorium bez pozycji i plikiem bez danych 3D (has_3d: false) | — | {"x":0,"y":0,"z":0} |
rotation | object {x,y,z} | tak — poza akcesorium bez pozycji i plikiem bez danych 3D (has_3d: false) | — | {"x":0,"y":0,"z":0} — kąty w (−180°, 180°] |
production_id | string | nie | — | "01.02.03" |
comment_refs | array | nie | [] | ["c_001"] |
Dzieci (children) ma wyłącznie grupa; formatka, akcesorium i bryła są liśćmi w dowolnej grupie albo w korzeniu.
Węzeł group — dodatkowe pola
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
role | enum | nie | brak — zwykła grupa | "cabinet" — szafka |
front | enum | nie | "-Y" | "-Y" — przód grupy w jej układzie, edytowalny |
children | array | tak | — | [...] |
Szafki (grupy z role: "cabinet") nie ma w szafce na żadnej głębokości. Nieznana rola liczy się jak brak roli.
Węzeł panel
Wszystkie pola formatki (panel, niżej) i type: "panel".
Węzeł hardware
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
hardware_ref | ref → hardware_catalog | tak | — | "hw_zawias" |
quantity | integer | tak | — | 1 — = 1 gdy akcesorium ma position |
material_ref | ref → materials_catalog | gdy position | — | "mat_stal" |
geometry | object | gdy position | — | {...} |
Akcesorium bez position jest pozycją listy z ilością w swojej grupie — bez position i rotation.
Węzeł solid — dodatkowe pola
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
material_ref | ref → materials_catalog | tak | — | "mat_tynk" |
geometry | object | tak | — | {...} |
geometry (bryła, akcesorium z pozycją)
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
type | enum | tak | — | — | "extrusion" |
outline | path | gdy extrusion | — | closed: true | {...} |
holes | array path | nie | [] | closed: true, wewnątrz outline | [...] |
thickness | mm | gdy extrusion | — | > 0 | 120 |
mesh_ref | ref → meshes_catalog | gdy mesh | — | — | "mesh_zawias" |
vertices | array | gdy polyhedron | — | min. 3 | [...] |
edges | array | gdy polyhedron | — | — | [...] |
faces | array | gdy polyhedron | — | — | [...] |
extrusion: kontur w płaszczyźnie XY bryły, wyciągnięty od Z = 0 do Z = thickness (§14.5). polyhedron: wierzchołki w układzie bryły, lica wielokątne z otworami (§7.6.2).
geometry.vertices[], edges[], faces[] (wielościan)
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
vertices[].id | id | tak | — | unikalne w wielościanie | "1" |
vertices[].x, y, z | number | tak | — | mm, układ bryły | 3000 |
edges[].id | id | tak | — | unikalne w wielościanie | "1" |
edges[].start, end | ref → vertices | tak | — | start ≠ end | "1" |
edges[].fold | bool | nie | false | krawędź składania | true |
faces[].id | id | tak | — | unikalne w wielościanie | "1" |
faces[].loops | array array ref → vertices | tak | — | obrys, potem otwory; pętla min. 3, kolejne wierzchołki połączone krawędzią | [["1","2","6","5"]] |
panel
Identyfikacja
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
type | enum | tak | — | "panel" — węzeł drzewa |
id | id | tak | — | "panel_001" |
name | string | tak | — | "Bok lewy" |
production_id | string | nie | — | "01.01.01" |
comment_refs | array | nie | [] | ["c_001"] |
Geometria
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
dimensions | object | tak | — | {"length":720,"width":560,"thickness":18} |
dimensions.length | mm | tak | — | 720 |
dimensions.width | mm | tak | — | 560 |
dimensions.thickness | mm | tak | — | 18 |
position | object {x,y,z} | tak | — | {"x":0,"y":0,"z":0} |
rotation | object {x,y,z} | tak | — | {"x":0,"y":90,"z":0} |
Materiał i słój
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
material_ref | ref → materials_catalog | tak | — | "mat_001" |
grain | enum | tak | — | "along_length" |
grain_group_ref | ref → grain_groups | nie | — | "gg_001" |
panel.grain jest podrzędne względem material.grain (źródło istnienia słoja): znaczenie ma tylko gdy material.grain ≠ "none"; wartość "none" = formatka nie respektuje słoja. Szczegóły: specyfikacja §8.3.
Gięcie (bend) — opcjonalne
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
bend.axis | enum | tak | — | "width" |
bend.radius | mm | tak | — | 300 |
bend.radius_type | enum | tak | — | "inner" |
bend.angle | degrees | tak | — | 90 |
Kompozycja z warstw (composite) — opcjonalna
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
composite | object | nie | — | {...} |
composite.layers | array | tak | — | [...] |
Warstwa (composite.layers[])
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
order | integer | tak | — | sekwencja 1…n | 1 |
material_ref | ref → materials_catalog | tak | — | kategoria board | "mat_18mm" |
thickness | mm | tak | — | > 0 | 18 |
Walidacja: sum(layers[].thickness) = panel.dimensions.thickness. Brak pola composite oznacza monolit.
Obrzeża (edging)
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
edging.xL | object|null | nie | null | {...} |
edging.x0 | object|null | nie | null | {...} |
edging.yW | object|null | nie | null | {...} |
edging.y0 | object|null | nie | null | {...} |
edging.sequence | string | nie | "width_first" | "width_first" | "length_first" |
Obiekt krawędzi obrzeża
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
ref | ref → edging_catalog | tak | — | "edg_001" |
Wykończenie krawędzi (edge_finish) — opcjonalne
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
edge_finish.xL | object|null | nie | null | {"sanded":true,"chamfer":1} |
edge_finish.x0 | object|null | nie | null | {...} |
edge_finish.yW | object|null | nie | null | {...} |
edge_finish.y0 | object|null | nie | null | {...} |
Obiekt krawędzi wykończenia
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
sanded | bool | tak | — | — | true |
chamfer | mm | tak | — | ≥ 0; 2 × chamfer < thickness | 1 |
Od 2.2.0. chamfer — fazka 45° na obu narożnikach krawędzi (lico i spód), 0 = bez fazki. Brak pola edge_finish = plik nie mówi nic o wykończeniu; krawędź null/pominięta = bez wykończenia. Krawędź nie ma jednocześnie edging i edge_finish (specyfikacja §8.5.1, §15.8).
Powłoki powierzchniowe (finishes[]) — opcjonalne
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
surface | enum | tak | — | "face_top" |
material_ref | ref → materials_catalog | tak | — | "mat_002" |
order | integer > 0 | tak | — | 1 |
comment_refs | array | nie | [] | [] |
Operacje obróbcze
bevel (skos)
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
edge_side | enum | jeden z† | — | — | "y0" |
on_segment | ref → segment line outline/hole | jeden z† | — | — | "seg_skos" |
from_face | enum | tak | — | — | "top" |
angle | degrees | tak | — | 0 < angle < 90 | 45 |
leave | mm | tak | — | ≥ 0 | 0 |
depth | mm | nie* | — | > 0 | 12 |
edging | object | nie | — | — | {...} |
comment_refs | array | nie | [] | — | [] |
† Skos adresuje się przez edge_side (bok bazowy) albo on_segment (prosty segment line konturu) — dokładnie jeden. Zawsze obejmuje całą krawędź (bez start/end). * Wymagane gdy więcej niż jeden skos od tej samej strony na tej samej krawędzi.
bevel.edging
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
ref | ref → edging_catalog | tak | — | "edg_001" |
drilling (wiercenie)
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
drilling_ref | ref → drilling_catalog | tak | — | "dr_001" |
type | enum | tak | — | "face" |
face | enum | gdy type: face | — | "top" |
edge_side | enum | gdy type: edge na boku | — | "y0" |
on_segment | ref → segment outline/hole | gdy type: edge na konturze | — | "seg_skos" |
x | mm | gdy face; gdy edge_side: y0/yW | — | 32 |
y | mm | gdy face; gdy edge_side: xL/x0 | — | 96 |
s | mm | gdy on_segment | — | 70 |
z | mm | nie (tylko type: edge) | thickness/2 | 9 |
hardware_instance_ref | ref → id węzła akcesorium | nie | — | "hw_zawias_1" |
comment_refs | array | nie | [] | [] |
x/y/z: układ §9.2.1 — x wzdłuż długości, y wzdłuż szerokości, z pozycja w grubości od lica (nie głębokość wiercenia — ta z drilling_catalog). Krawędź bazowa: podajesz oś biegnącą wzdłuż niej (y0/yW→x, xL/x0→y) + z; oś prostopadła implikowana przez edge_side. Krawędź konturu: on_segment + s (§9.2.2). Tryby edge_side i on_segment wykluczają się.
routing (frezowanie) — pola wspólne
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
type | enum | tak | — | "slot" |
finishes | array | nie | [] | [...] |
hardware_instance_ref | ref → id węzła akcesorium | nie | — | "hw_prowadnica_1" |
comment_refs | array | nie | [] | [] |
routing.finishes[]
Powłoka routingu opisuje wykończenie powierzchni wyfrezowanej przez daną operację. W odróżnieniu od panel.finishes[] nie zawiera pola surface.
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
material_ref | ref → materials_catalog | tak | — | "mat_lakier" |
order | integer > 0 | tak | — | 1 |
comment_refs | array | nie | [] | [] |
routing — type: slot (placement surface)
Slot na licu: face + path. section wymagane.
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
section | enum | tak | — | "profiled" |
face | enum | tak | — | "top" |
path | object | tak | — | {...} |
width | mm | gdy section: simple | — | 5 |
depth | mm | gdy section: simple | — | 8 |
offset | mm | nie (tylko simple) | 0 | 0 |
profile_ref | ref → profiles | gdy section: profiled | — | "prof_001" |
simple: prostokąt width × depth centrowany na osi path; offset przesuwa go w bok. profiled: profile_ref to pełna geometria cięcia (głębokość = zasięg profilu w głąb, §11.5.2); bez width/depth/offset.
routing — type: slot (placement edge)
Slot wzdłuż krawędzi: edge_side albo on_segment, brak path. section wymagane.
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
section | enum | tak | — | "profiled" |
face | enum | tak | — | "top" |
edge_side | enum | jeden z† | — | "x0" |
on_segment | ref → segment outline/hole | jeden z† | — | "seg_skos" |
start | mm | nie‡ | — | 70 |
end | mm | nie‡ | — | 230 |
width | mm | gdy section: simple | — | 5 |
depth | mm | gdy section: simple | — | 8 |
offset | mm | nie (tylko simple) | 0 | 0 |
profile_ref | ref → profiles | gdy section: profiled | — | "prof_001" |
† Dokładnie jeden z edge_side / on_segment. ‡ start/end razem albo pominięte (= cała krawędź/segment). simple: offset przesuwa prostokąt wzdłuż grubości od narożnika face. profiled: profil zakotwiczony w narożniku face ∩ edge, definiuje całą geometrię.
routing — type: outline
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
path | object | tak | — | {...} |
edging | object | nie | — | {...} |
edge_finish | object | nie | — | {...} |
Zawsze przelotowe. Ścieżka jest zamkniętym konturem (closed: true) opisującym gotowy kształt formatki (orientacja = strona materiału, konwencja CAD). Segmenty będące realnym cięciem (różnica vs prostokąt bazowy) oznacza się flagą machined; przy jej braku obróbka jest wyznaczana geometrycznie (segment poza granicą prostokąta). Ścianka cięcia jest domyślnie prosta; profilowanie/sfazowanie segmentu — slotem lub skosem przez on_segment.
routing — type: hole
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
path | object | tak | — | {...} |
edging | object | nie | — | {...} |
edge_finish | object | nie | — | {...} |
Zawsze przelotowe. Ścieżka musi leżeć wewnątrz prostokąta formatki. Ścianka domyślnie prosta; profilowanie/sfazowanie segmentu — slotem lub skosem przez on_segment.
routing — type: pocket
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
face | enum | tak | — | "top" |
depth | mm | tak | — | 10 |
path | object | tak | — | {...} |
Płaskie dno i proste ścianki. Profilowanie ścianki — osobnym slotem (placement: surface) wzdłuż tej krawędzi. Kieszeń nie ma pól edging ani edge_finish — obrzeże i wykończenie ścianek dotyczą tylko outline i hole.
routing.edging (outline / hole)
edging to pojedynczy obiekt (jeden materiał) albo — od 2.1.0 — tablica takich obiektów (różne materiały na różnych ściankach jednego konturu). Pola pojedynczego obiektu:
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
ref | ref → edging_catalog | tak | — | "edg_001" |
walls | string|array | tak | — | ["seg_skos_1"] |
pre_trim | bool | nie | false | false |
walls: "all" (wszystkie ścianki cięcia) albo tablica z bokami bazowymi ("xL"/"x0"/"yW"/"y0") i/lub id segmentów (segments[].id, §10) — np. ["seg_skos_1"] okleja tylko ten skos.
Forma tablicowa (2.1.0). edging jako tablica okleja różne ścianki różnymi materiałami: [{"ref":"edg_dab","walls":["seg_skos_1"]},{"ref":"edg_bialy","walls":["seg_skos_2"]}]. Każdy wpis ma własny ref i walls; jedna ścianka MUSI NIE wystąpić w dwóch wpisach.
pre_trim: true tylko dla type: outline z prostą (pojedynczy odcinek) oklejaną ścianką — okleiniarka nie podfrezuje krawędzi krzywoliniowej.
routing.edge_finish (outline / hole)
Od 2.2.0. Wykończenie ścianek cięcia bez obrzeża — pojedynczy obiekt:
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
walls | string|array | tak | — | jak edging.walls | "all" |
sanded | bool | tak | — | — | true |
chamfer | mm | tak | — | ≥ 0; 2 × chamfer < thickness | 1 |
walls jak w routing.edging: "all" albo boki bazowe i/lub id segmentów. Ścianka nie występuje jednocześnie w edging.walls i edge_finish.walls (specyfikacja §15.8).
routing — type: biscuit
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
face | enum | gdy lico | — | "top" |
edge_side | enum | gdy krawędź bazowa | — | "y0" |
on_segment | ref → segment outline/hole | gdy krawędź konturu | — | "seg_skos" |
x | mm | gdy lico; gdy edge_side: y0/yW | — | 100 |
y | mm | gdy lico; gdy edge_side: xL/x0 | — | 200 |
s | mm | gdy on_segment | — | 70 |
z | mm | nie (gdy krawędź) | thickness/2 | 9 |
angle | degrees | nie | 0 | 0 |
size_ref | ref → biscuit_catalog | tak | — | "bisc_001" |
Pozycja osi lameli — układ jak dla wiercenia (§9.2.1, §9.2.2). biscuit_catalog[].thickness rozkłada się symetrycznie względem osi.
Wariant licowy: face + x, y (bez edge_side/on_segment).
Wariant krawędziowy (bok): edge_side + x (L/R) lub y (T/B) + z.
Wariant krawędziowy (kontur): on_segment + s + z.
Geometria ścieżki (path)
Obiekt path
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
start | object {x,y} | tak | — | {"x":0,"y":0} |
closed | bool | tak | — | true |
segments | array | tak | — | [...] |
Segment line
| Pole | Typ | Wymagane | Przykład |
|---|---|---|---|
type | "line" | tak | "line" |
id | string | nie* | "seg_skos" |
end | object {x,y} | tak | {"x":560,"y":0} |
machined | bool | nie | true |
Segment arc
| Pole | Typ | Wymagane | Przykład |
|---|---|---|---|
type | "arc" | tak | "arc" |
id | string | nie* | "seg_luk" |
center | object {x,y} | tak | {"x":560,"y":50} |
radius | mm | tak | 50 |
angle_start | degrees | tak | 270 |
angle_end | degrees | tak | 0 |
clockwise | bool | tak | false |
machined | bool | nie | true |
Segment bezier
| Pole | Typ | Wymagane | Przykład |
|---|---|---|---|
type | "bezier" | tak | "bezier" |
id | string | nie* | "seg_krzywa" |
cp1 | object {x,y} | tak | {"x":100,"y":0} |
cp2 | object {x,y} | tak | {"x":460,"y":0} |
end | object {x,y} | tak | {"x":560,"y":0} |
machined | bool | nie | true |
Pole machined (bool, opcjonalne) ma znaczenie tylko dla type: outline — oznacza segment będący realnym cięciem (różnica konturu vs prostokąt bazowy). Brak jawnej flagi ⇒ obróbka wyznaczana geometrycznie.
* Pole id (string, opcjonalne) jest wymagane, gdy segment jest celem drilling.on_segment / lameli na konturze (§9.2.2); unikalne w obrębie path.
Katalogi
materials_catalog — pola wspólne
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
id | id | tak | — | "mat_001" |
code | string | nie | — | "W980 ST2" |
name | string | tak | — | "Biały Lux" |
manufacturer | string | nie | — | "Egger" |
category | enum | tak | — | "board" |
furniture | bool | nie | true | false |
materials_catalog — category: board
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
thickness | mm | tak | — | 18 |
grain | enum | tak | — | "along_length" |
sheet.length | mm | tak | — | 2800 |
sheet.width | mm | tak | — | 2070 |
sheet.trim | mm | tak | — | 16 |
materials_catalog — category: veneer / laminate
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
thickness | mm | tak | — | 0.6 |
grain | enum | tak | — | "along_length" |
materials_catalog — category: paint
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
color_system | string | nie | — | "RAL" |
color_code | string | nie | — | "9016" |
description | string | nie | — | "biały połysk 90%" |
materials_catalog — category: surface
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
furniture | bool | tak | — | false | false |
color | string | nie | — | #RRGGBB | "#F2F0EB" |
edging_catalog
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
id | id | tak | — | "edg_001" |
code | string | nie | — | "ABS-W980" |
name | string | tak | — | "ABS Biały Lux 0.4" |
texture | bool | tak | — | false |
thickness | mm | tak | — | 0.4 |
height | mm | tak | — | 23 |
material_ref | ref → materials_catalog | tak | — | "mat_001" |
drilling_catalog
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
id | id | tak | — | — | "dr_001" |
code | string | nie | — | — | "HINGE35" |
name | string | tak | — | — | "Miseczka zawiasu 35mm" |
diameter | mm | tak | — | > 0 | 35 |
depth | mm | gdy through: false | — | > 0 | 13 |
through | bool | tak | — | — | false |
hardware_catalog
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
id | id | tak | — | "hw_001" |
code | string | nie | — | "H771.1290" |
name | string | tak | — | "Zawias Clip Top 110°" |
manufacturer | string | nie | — | "Blum" |
hardware (węzeł akcesorium)
Pola węzła akcesorium — patrz „Węzeł hardware” przy polach wspólnych węzła; akcesorium bez position jest pozycją listy z ilością w swojej grupie, z position — jedną sztuką (quantity: 1) z rotation, material_ref i geometry.
profiles
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
id | id | tak | — | "prof_001" |
code | string | nie | — | "R3-TOP" |
name | string | tak | — | "Zaokrąglenie R3 od lica" |
start | object | nie | {0, 0} | { "x": -6, "y": 0 } |
path | array | tak | — | [...] |
Segmenty path mają identyczną strukturę jak segmenty ścieżki frezowania (line / arc / bezier). Pierwszy punkt przekroju to start (domyślnie (0, 0)).
Profil opisuje wynikową geometrię cięcia (kształt jaki powstaje w materiale), nie geometrię narzędzia. Używany w type: slot, section: profiled jako pełny przekrój.
Rama (§11.5.2): slot edge → (0, 0) w narożniku face ∩ edge_side/on_segment, X+ w głąb materiału od krawędzi, Y+ w głąb grubości; slot surface → (0, 0) na osi path, X+ poprzecznie, Y+ w głąb grubości. Y = 0 to powierzchnia wejścia — profil musi być otwarty i na niej zakotwiczony.
biscuit_catalog
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
id | id | tak | — | "bisc_001" |
code | string | nie | — | "P-20" |
name | string | tak | — | "Lamela P-20" |
length | mm | nie | — | 56 |
width | mm | nie | — | 23 |
thickness | mm | nie | — | 4 |
meshes_catalog
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
id | id | tak | — | — | "mesh_zawias" |
name | string | tak | — | — | "Zawias puszkowy" |
positions | array number | tak | — | x, y, z kolejno, mm; długość wielokrotnością 3 | [0,0,0, 48,0,0, 48,35,0] |
triangles | array integer | tak | — | indeksy od 0, po trzy; przeciwnie do wskazówek zegara z zewnątrz | [0,1,2] |
Siatka jest zawsze osadzona w pliku — bez odnośników zewnętrznych.
grain_groups
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
id | id | tak | — | — | "gg_001" |
name | string | tak | — | — | "Fronty lewa kolumna" |
material_ref | ref → materials_catalog | tak | — | — | "mat_001" |
orientation | enum | nie | "vertical" | "vertical" | "horizontal" — słój względem frontu | "vertical" |
kerf | mm | tak | — | > 0 | 4.4 |
members | array | tak | — | min. 2 elementy | [...] |
rows | array | nie | — | jeden wpis na rząd grupy (2.6.0) | [...] |
grain_group.member
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
panel_ref | ref → panel.id | tak | — | — | "panel_001" |
row | integer | nie | = order | ≥ 1; sekwencja 1…n w grupie | 2 |
order | integer | tak | — | ≥ 1; sekwencja 1…m w rzędzie, od krawędzi początkowej | 1 |
Członek bez row jest osobnym rzędem o numerze równym order, z pozycją 1 — tak czyta się pliki 2.4.0 i starsze. Rzędy i krawędź początkowa: specyfikacja §13.1, walidacja: §15.4.
grain_group.rows[] (2.6.0)
| Pole | Typ | Wymagane | Default | Ograniczenia | Przykład |
|---|---|---|---|---|---|
row | integer | tak | — | ≥ 1; rząd istniejący w grupie, każdy raz | 2 |
align | enum | tak | — | "start" | "center" | "end" — przyciąganie rzędu | "center" |
Rząd bez wpisu ma "start". Lico formatki grupy to strona widoczna od zewnątrz mebla (§13.1); przyciąganie: §13.2, oznaczenie #1.2S.1: §13.3.
comments
| Pole | Typ | Wymagane | Default | Przykład |
|---|---|---|---|---|
id | id | tak | — | "c_001" |
author | string | nie | — | "Jan Kowalski" |
date | datetime | nie | — | "2025-03-15T14:30:00Z" |
text | string | tak | — | "Sprawdzić wymiar po montażu" |
Enums — pełna lista wartości
| Pole | Dozwolone wartości |
|---|---|
node.type | "group" | "panel" | "hardware" | "solid" |
group.role | "cabinet" (brak — zwykła grupa) |
geometry.type | "extrusion" | "mesh" | "polyhedron" |
group.front | "-Y" | "+Y" | "-X" | "+X" |
panel.grain | "along_length" | "along_width" | "none" |
panel.bend.axis | "width" | "length" |
panel.bend.radius_type | "inner" | "outer" |
finish.surface | "face_top" | "face_bottom" | "edge_xL" | "edge_x0" | "edge_y0" | "edge_yW" |
bevel.edge_side | "xL" | "x0" | "yW" | "y0" |
bevel.from_face | "top" | "bottom" |
drilling.type | "face" | "edge" |
drilling.face | "top" | "bottom" |
drilling.edge_side | "xL" | "x0" | "yW" | "y0" |
routing.type | "slot" | "outline" | "hole" | "pocket" | "biscuit" |
routing.section (type: slot) | "simple" | "profiled" |
routing.face | "top" | "bottom" |
routing.edge_side | "xL" | "x0" | "yW" | "y0" |
path.segment.type | "line" | "arc" | "bezier" |
material.category | "board" | "veneer" | "laminate" | "paint" | "surface" |
material.grain | "along_length" | "along_width" | "none" |
grain_group.orientation | "vertical" | "horizontal" |
grain_group.rows[].align | "start" | "center" | "end" |
Tabela referencji
| Pole | Wskazuje na |
|---|---|
panel.material_ref | materials_catalog[].id |
panel.grain_group_ref | grain_groups[].id |
panel.composite.layers[].material_ref | materials_catalog[].id |
panel.edging.{side}.ref | edging_catalog[].id |
finish.material_ref | materials_catalog[].id |
bevel.edging.ref | edging_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, 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ą |
edging_catalog[].material_ref | materials_catalog[].id |
grain_group.material_ref | materials_catalog[].id |
grain_group.members[].panel_ref | id węzła formatki w drzewie |
comment_refs[] | comments[].id |