Jak zbudować własną szafkę? (Instrukcja dla początkujących)

Witaj! Ten system pozwala Ci projektować meble bez używania kalkulatora i linijki. Zamiast liczyć, gdzie ma stać każda płyta, po prostu opisujesz, jak części mają się ze sobą stykać.

---

Krok 1: Przygotuj podstawowe dane

Każda szafka zaczyna się od czterech magicznych liter:

* $w (Szerokość) - jak szeroka jest szafka z zewnątrz.

* $h (Wysokość) - jak wysoka jest szafka od podłogi do góry.

* $d (Głębokość) - jak głęboki jest mebel.

* $t (Grubość) - jak grubą płytę używasz (standardowo 18 mm).

---

Krok 2: Stwórz formatki (płyty)

Musisz powiedzieć systemowi, jakie płyty będą potrzebne. Używamy do tego polecenia new Panel.

// Tworzymy lewy bok
$sideL = new Panel("BOK_L", "Bok Lewy", $d, $h, $t);
$sideL->orient(Axis::Vertical); // Mówimy, że ten bok stoi pionowo

Pamiętaj: Zawsze określaj orientację (orient) – czy płyta stoi pionowo (Vertical), czy leży poziomo (Horizontal).

---

Krok 3: Połącz płyty ze sobą (Magia Relacji)

To najważniejszy krok. Zamiast podawać pozycję X i Y, mówisz: "Weź dno i przymocuj je do boku".

Przykład: Montaż dna do lewego boku

$bottom->mountTo($sideL)           // Weź dno i zamontuj do boku
    ->myEdge(Edge::LEFT)           // Lewą krawędzią dna...
    ->alignX(ReferenceX::RIGHT)    // ...dotknij prawej (wewnętrznej) ściany boku
    ->alignY(ReferenceY::BOTTOM);  // ...i wyrównaj do dołu

Najważniejsze polecenia wyrównywania:

* alignX(ReferenceX::LEFT) - zrób równo z lewą krawędzią.

* alignX(ReferenceX::CENTER) - ustaw idealnie na środku.

* offsetZ(wartość) - przesuń do przodu lub do tyłu (np. żeby schować plecy HDF).

---

Krok 4: Rozróżnianie przodu i tyłu (Face)

System automatycznie wykrywa, która strona płyty jest "wewnętrzna" (skierowana do środka szafki), co jest kluczowe dla nawierceń pod mimośrody (Minifix).

Domyślnie silnik sam decyduje, na której płaszczyźnie umieścić otwory, ale możesz to wymusić ręcznie używając ontoFace():

* ontoFace(Face::INSIDE) - (Zalecane) Automatycznie wybiera stronę skierowaną do wnętrza szafki. Pozwala budować szafkę bez zastanawiania się, czy dany bok jest lewy czy prawy.

* ontoFace(Face::FRONT) - montaż do przedniej płaszczyzny płyty (lokalne Z = grubość płyty).

* ontoFace(Face::BACK) - montaż do tylnej płaszczyzny płyty (lokalne Z = 0).

Przykład:

$shelf->mountTo($sideL)
      ->myEdge(Edge::LEFT)
      ->ontoFace(Face::INSIDE); // System sam wie, że dla lewego boku to "prawa" strona, a dla prawego "lewa".

---

Krok 5: Dodaj fronty (drzwi)

Do drzwi używamy specjalnego polecenia new Front. System dzięki temu wie, że te płyty można otwierać.

$door = new Front("DRZWI", "Front", $szerokosc, $wysokosc, $t);
$door->mountTo($sideL)
     ->myEdge(Edge::HINGE_LEFT); // Powiedz, że zawias jest po lewej stronie

---

Krok 5: Sprawdź, czy wszystko pasuje

Gdy skończysz pisać kod, wejdź na stronę w przeglądarce (composer serve). System automatycznie sprawdzi Twój projekt:

* Czerwony kolor: Coś na siebie nachodzi! Musisz poprawić wymiar lub przesunąć płytę.

* Fioletowe punkty: Tutaj płyty się dotykają – system tu wywierci otwory na kołki.

* Kliknięcie w front: Zobaczysz, czy drzwi otwierają się w dobrą stronę.

---

Złota zasada

Nigdy nie wpisuj pozycji ręcznie. Jeśli zmienisz szerokość szafki z 600 na 800 mm, system sam przesunie wszystkie płyty i fronty, o ile poprawnie zdefiniowałeś ich relacje (np. "wyrównaj do prawej krawędzi").