← Biuro: jak to działa

Jak działa vistelier

Silnik robi z opisu wnętrza w Pythonie rendery, spacer w przeglądarce, rysunki i stronę. Projekt (biuro, mieszkanie B.1.4, kolejne) ma tylko dane i treść: wymiary, meble, ujęcia, teksty. Wszystko inne jest wspólne.

Droga od sceny do strony

1. Scena (src/scene.py projektu) buduje wnętrze w Blenderze z zestawu silnika (blender/zestaw.py): materiały, bryły, szafki z ruchomymi frontami, lampy, kamery. Różnice między projektami (liczba segmentów walców, fazy krawędzi, rodzaj szkła, moc lamp) są w profilu (profil(...)), żeby przenosiny kodu nie zmieniały obrazu.
2. Odcisk sceny (vistelier fingerprint) zapisuje położenie, wymiar, materiał i modyfikatory każdego obiektu oraz świat i ustawienia renderu. Budowa sceny bez renderu trwa sekundy, więc to podstawowa kontrola: zmiana kodu, która nie ma zmieniać wyglądu, musi dać 0 różnic względem baza/.
3. Rendery (vistelier render) i wypalanie spaceru (vistelier bake) liczą się wyłącznie w chmurze. Silnik zakłada maszynę RunPod, przygotowuje ją (Blender, biblioteki, log karty, wyłącznik czasowy), wysyła źródła, czeka, pobiera wynik i zawsze usuwa maszynę — także po błędzie, Ctrl+C i zamknięciu terminala. Limit czasu i kwoty pilnuje laptop, a na wypadek uśpienia laptopa maszyna usuwa się sama. Wydatki: vistelier costs.
4. Wypalanie (wypalanie/fpp_bake.py) dostaje od sceny słownik SPACER (grupy świateł, łączniki, drzwi, elementy, strefy, siatka kolizji, miejsca). Liczy kolor i światło każdej grupy lamp do atlasów, usuwa ściany niewidoczne z wnętrza, zapisuje siatkę kolizji, sondy światła i model z nazwanymi elementami. Odcisk wypalenia pozwala liczyć potem tylko to, co się zmieniło.
5. Składanie spaceru (spacer/build_spacer.py) koduje mapy światła do JPEG, a przeglądarka (spacer/spacer.html, three.js) sumuje włączone grupy świateł, pozwala chodzić, otwierać drzwi i szuflady, przełączać noc, warstwy i warianty. Ustawienia przeglądarki dla projektu są w spacer.json. Muzykę, dźwięki, tło za oknem, teksturę podłogi i nagrania lektora robi vistelier extras (lektor nagrywa od nowa tylko te strefy, których tekst się zmienił).
6. Rysunki (rysunki/svg.py) i strona projektu korzystają ze wspólnych arkuszy, wymiarów, tabel i znaczków „nieaktualne”. PDF do druku (A3) i PNG z rysunków SVG robi Chromium bez okna (rysunki/druk.py), na laptopie, bo to sekundy. Rzut z podkładem renderu, numerami, legendą i listą zakupów: rysunki/rzut.py; kosztorys z wariantami i XLSX: wycena/; film promo z orbity i renderów: film/promo.py.
7. Plik stanu (vistelier status) zapamiętuje, z jakiej wersji źródeł powstał każdy wynik, i mówi, co trzeba przeliczyć. Wersje (vistelier version): zaakceptowana paczka zmian dostaje tag gita (v1, v2…), a numer bieżącej wersji trafia do spaceru i do komentarzy, więc wiadomo, do której wersji odnosi się uwaga.
8. Wgrywanie (vistelier deploy) wysyła cele z projekt.toml na serwer przez ssh; zrzuty spaceru z testem chodzenia (vistelier screenshots) też liczą się w chmurze.
9. Komentarze (komentarze/): w spacerze można nagrać uwagę, zaznaczyć element i dostać odpowiedź głosem od agenta (Whisper → Claude tylko do odczytu → podgląd zmiany i wpis w rejestrze). Serwer działa na two71.io, agent na laptopie.

Co potrafi silnik

Pełna lista funkcji, które dostaje każdy projekt. W nawiasach: polecenie, parametr adresu albo klucz ustawień projektu (spacer.json, projekt.toml). Funkcja oznaczona „(projekt)” wymaga wpisu po stronie projektu.

Spacer w przeglądarce (telefon i komputer)

• Chodzenie: na telefonie lewy kciuk chodzi, prawy się rozgląda; na komputerze W A S D albo strzałki i przeciąganie myszą. Ściany i meble zatrzymują (siatka kolizji co 5 cm, przy ścianie można się ślizgać), wysokość oczu 1,58 m.
• Miejsca: przyciski szybkiego przejścia do pokojów; start w wybranym miejscu i kierunku (start, kat_startu).
• Mapka w rogu: gdzie można chodzić, gdzie stoisz i dokąd patrzysz.
• Drzwi otwierane dotknięciem, z animacją i dźwiękiem.
• Meble z otwieranymi frontami: drzwi szaf i szafek, klapy, szuflady wysuwane razem z zawartością (w scenie: Szafka, ruchome()).
• Światło: łączniki na ścianach (złoty pierścień) i dotykanie lamp włączają grupy światła; panel „Światła” z każdą grupą osobno; przycisk „Noc”/„Dzień” z zestawem lamp na wieczór i ciemniejącym niebem; ekspozycja dopasowuje się do jasności pokoju jak oko.
• Warstwy: ukrywanie mebli, zasłon, dekoracji, gniazd; bez mebli ściany pokazują światło pustego mieszkania (warstwy, warstwy_mebli).
• Warianty: przełączanie zestawów wypalonych w pełnej jakości (inny układ, inny styl) bez zmiany miejsca (zestawy.json, ?zestaw=).
• Telewizor gra film z YouTube po dotknięciu, ekran na dowolnej ścianie (tv: element, film, strona; ?tv=). (projekt)
• Lektor opowiada w wybranych miejscach, gdy patrzysz we właściwą stronę; napis na ekranie, dotknięcie przerywa; strefy mogą dotyczyć tylko niektórych zestawów (lektor, pole zestawy, zestaw_glowny). Nagrania: Gemini, nagrywane od nowa tylko po zmianie tekstu. (projekt)
• Dźwięk: spokojna muzyka w tle (cichnie przy lektorze i filmie), kroki, klik łącznika, drzwi; przycisk „Dźwięk” (dodatki: muzyka, dzwieki).
• Za oknem panorama ulicy w dzień i jej nocna wersja z zapalonymi oknami (dodatki: niebo).
• Wygląd: połysk płytek, frontów i ekranu (polysk), prawdziwe lustra, półprzezroczyste szkło i firany (firany), ostra tekstura desek podłogi (podloga), przycisk „HD” (ostrzejsze tekstury), cień w stykach (SSAO), tryb „Żywe” (światło liczone na żywo, eksperyment).
• Na ekranie telefonu jak aplikacja (manifest, ikona), pełny ekran z blokadą poziomo.
• Adres z pozycją: ?x=&y=&kat= otwiera spacer w danym miejscu (link do konkretnego widoku).
• Komentarze (komentarze): nagranie uwagi głosem, zaznaczenie palcem elementu, odpowiedź głosem od agenta (Whisper → Claude tylko do odczytu), propozycje zmian widoczne od razu w spacerze (kolor, przesunięcie, ukrycie mebla), rejestr zmian do akceptacji, odtworzenie komentarza torem komentującego. (projekt: serwer i agent)
• Podgląd zmian: przestawianie i obracanie mebli oznaczonych jako przestawne, z przybliżonym światłem i cieniem w nowym miejscu.

Rendery, film i spacer w chmurze

• Rendery Cycles na karcie graficznej w chmurze, podgląd szybki i pełny (vistelier render [--shots] [--preview]).
• Wypalanie spaceru w chmurze: światło każdej grupy lamp, model z nazwanymi elementami, siatka kolizji, sondy światła; przyrostowo — liczy tylko to, co się zmieniło (vistelier bake [--draft], --fpp-auto).
• Tryby światła ujęcia: dzień, noc, widok z góry bez sufitu („domek”), kamery ortogonalne do rzutów.
• Film promo z orbity nad mieszkaniem i renderów: plansza tytułowa, ujęcia z podpisami, rzut z opisem pomieszczeń, plansza z danymi (film/promo.py, treść w promo.json). (projekt)
• Chmura pod kontrolą: maszyna RunPod zakładana i zawsze usuwana (także po błędzie i zamknięciu terminala), limit czasu i kwoty na przebieg i na konto, wyłącznik na maszynie, rejestr wydatków (vistelier cloud, vistelier costs).
• Zrzuty spaceru z testem chodzenia w chmurze (vistelier screenshots).

Rysunki, strona, kosztorys

• Arkusze A3 z tabliczką, wymiarami, kreskowaniem i notatkami; rzut z podkładem renderu, numerami, legendą i listą zakupów; druk do PDF i PNG bez dodatkowych programów (rysunki/).
• Strona projektu: galeria z powiększaniem, znaczki „nieaktualne” przy ujęciach i filmie (z listą zmian od tamtego czasu), strona „Wspólny silnik” (ta).
• Kosztorys: pozycje z produktem, sklepem, linkiem i statusem ceny (potwierdzona, częściowa, szacunek), warianty wykończenia, sumy z rezerwą, XLSX z porównaniem (wycena/).

Kontrola i porządek

• Odcisk sceny bez renderu (sekundy): zmiana, która ma nie zmieniać wyglądu, musi dać 0 różnic (vistelier fingerprint).
• Plik stanu: z jakiej wersji źródeł powstał każdy wynik i co trzeba przeliczyć (vistelier status).
• Wersje projektu jako tagi gita, numer widoczny w spacerze i komentarzach (vistelier version).
• Wgrywanie na serwer przez ssh, z archiwum poprzedniego spaceru (vistelier deploy).
• Nowy projekt z szablonu: pokój z oknem, drzwiami, szafką z szufladami, lampą, ujęciami i spacerem (vistelier new).
• Narzędzia SketchUp: drzewo modelu, rzut, wycięcie pokoju, wymiary, import do Blendera (narzedzia/sketchup/).

Nowy projekt

vistelier new KATALOG --title "..." tworzy pokój z oknem, drzwiami, stołem, szafką i lampą, z ujęciami i spacerem. Dalej: silnik/vistelier fingerprint /dev/shm/o.json, silnik/vistelier render --preview, silnik/vistelier bake --draft. Plan przenosin i lista kontrolna: docs/PLAN.html.