# Model 3D al apartamentului: pilot (09.11.2026)

Primul model 3D al întregului apartament, generat în Blender dintr-un script Python. Sursele cotelor:

- **Livingul și peretele TV:** cotele exacte din planșele peretelui TV (`scripts/tv-perete-plansa.mjs`).
- **Restul pereților:** trasați din planul B4 (`reference-images/01-Arad-Apartment-B4-Floor-Plan.png`), la ~11,15 mm/pixel, cu o toleranță de ±50–100 mm până la măsurare.

E un test de metodă, nu un proiect aprobat.

- **Generator:** `scripts/3d/apartment.py`. Toate cotele sunt constante la începutul scriptului.
- **Rulare: doar pe PC**, prin `scripts/3d/render-pc.sh`, rulat de pe Mac (pe Mac nu se mai randează deloc). Dacă `ssh pc` nu răspunde, scriptul iese cu eroare; PC-ul se pornește cu `ssh pc-wake`.
  - Copiază pe PC-ul cu RTX 4080 (`ssh pc`, în `X:\ai\apartment\design`) doar ce citește scriptul: `scripts/3d/`, planșele `output/*/*-parts.json` și `assets-3d/`. `assets-3d/` se retrimite doar când s-a schimbat.
  - Un lacăt pe PC (`X:\ai\apartment\render.lock`) pune rulările din mai multe sesiuni la rând. Fiecare rulare scrie în folderul ei (`output/_run-<id>/` pe PC) și aduce aici doar cadrele ei. Deblocare manuală: `ssh pc "rmdir /s /q X:\ai\apartment\render.lock"`.
  - Randează cu Blender 5.2 pe OPTIX, cu 512 eșantioane implicit. `apartament.blend` și `apartament.glb` vin înapoi doar la rulările fără `--suffix`. Commit-ul se face pe Mac; PC-ul nu are acces la GitHub.
  - Argumente (merg la `apartment.py`):
    - `--quick`: 960 px, 32 de eșantioane;
    - `--only 1-din,12-birou`: doar cadrele ale căror nume conțin textul;
    - `--suffix -x`: cadre de verificare, fără să le suprascrie pe cele de bază;
    - `--light day|summer|night`, `--samples N`, `--res PX` (latura lungă), `--device OPTIX|CUDA|CPU`.
  - Alt script sub același lacăt: `PC_SCRIPT=exposure_check.py scripts/3d/render-pc.sh 1-din,2-de,12-bir`.
- **Timp pe cadru (1600 px, inclusiv construcția scenei, ~10 s):** Mac M4 cu 128 de eșantioane ~40 s; RTX 4080 cu 128 ~20 s, cu 512 ~22 s, cu 512 la 2400 px ~39 s, plus ~6 s copierea dus-întors. Toate cele 12 cadre (măsurat 12.11): ~3 minute pe PC cu 512, inclusiv copierea.
- **Ieșiri:**
  - `apartament.blend`: se deschide în Blender;
  - `apartament.glb`: pentru Unreal, Twinmotion sau un viewer web;
  - randările PNG: `1-din-canapea`, `2-de-la-logie`, `3-de-la-hol`, `4-bucatarie`, `5-dormitor-2`, `6-plan-apartament`, `7-insula-din-living`, `8-insula-din-bucatarie`, `9-vestibul-dulap`, `10-vestibul-pantofar`, `11-hol-masina`, `12-birou`; pentru obiecte și QA: `13-media-colt`, `14-pult-scaune`, `15-pat`, `16-wheelstand`, `17-baie-1`, `18-baie-2`, `19-logie`, `20-birou-usa`.

## Ce e modelat

- **Pereții tuturor camerelor:**
  - Dormitor 1 (2,95 × 4,20) și Dormitor 2 (3,95 × 3,10);
  - holul, cele două băi (1,60 lățime);
  - livingul (5,30), logia (2,00 × 3,20);
  - bucătăria (3,30), vestibulul în L.
- **Golurile:** ușile (fără foi), golul spre hol, cele două uși spre logie, intrarea și ferestrele cu toc simplu.
- **Livingul:** comoda cu 4 uși, LG OLED83C6 la 750, BOMBEI, LUNDUM, BOLLSIDAN, VEJLBY la 45° și subwooferul.
- **Bucătăria:**
  - corpuri de jos Havanna cu blat Cremona pe peretele de 3,30, cu întoarcere în colț;
  - plită, cuptor, chiuvetă, suspendate și centrală.
- **Insula și coloana frigiderului (11.11.2026), din planșele insulei:**
  - piesele vin din `output/insula/insula-parts.json`, scris de `node scripts/insula-plansa.mjs` din aceeași geometrie ca PDF-ul; o cotă schimbată în `G` (`scripts/insula-ansamblu.mjs`) ajunge în model la următoarea rulare a ambelor scripturi;
  - coloana are lateralul pe peretele bucătărie / logie, aliniată cu colțul dinspre living, până aproape de ușa logiei; frigiderul se deschide spre bucătărie, vitrina spre living;
  - insula pleacă din coloană spre vestibul: 1.350 × 920, 2 coloane × 3 sertare cu Gola negru, riflaj Corbridge spre living, stâlp negru la capătul liber, suspendate de 300 cu 2 linii LED;
  - nu intră în model interiorul: cutiile sertarelor, glisierele, sursa LED și cablurile rămân doar în planșe;
  - cadre noi: `7-insula-din-living` și `8-insula-din-bucatarie`.
- **Vestibulul (11.11.2026), după planșele dulapului din hol (`output/dulap-hol/`):**
  - dulapul U740 cu 3 uși pe peretele bucătărie / vestibul, de la peretele cu țeava de gaz spre living, oprit la 100 sub tavan; deasupra banda U740, scafa peste țeava de gaz și capacul nișei;
  - nișa de ~400 cu spătar și poliță Corbridge, cuiere, bancă corp plin cu șezut Corbridge și pernă;
  - pantofarul U740 de 1.200 × 260 pe tot peretele din dreapta ușii de intrare (în model ~1.650, după plan; real ~1.500);
  - cotele sunt deduse din plan, nu măsurate; cadre noi: `9-vestibul-dulap`, `10-vestibul-pantofar`.
- **Dormitor 2:** dulap Taupe de 600, până la tavan, cu 5 uși lungi fumurii, pe peretele scurt.
- **Dormitor 1:** biroul de 2.000 × 900 (U220) pe peretele plin, în colțul spre living, cu corpul de sertare.
- **Holul:** dulapul de rufe (Ms) pe peretele spre băi.

## Ce e presupus sau aproximativ

- **Fără cote în proiect, de măsurat:**
  - ferestrele: parapet 600, buiandrug 2.350; poziția lor e luată de pe plan;
  - golurile de ușă: înălțime 2.100;
  - grosimile pereților.
- **Poziția insulei:** după randările finale din 8 octombrie și peretele de 1.050 măsurat de proprietar. În model peretele până la ușa logiei are ~1.078, fiindcă e trasat din planul B4.
- **Bucătăria de pe peretele spre vestibul** (întoarcerea în colț) e încă interpretarea veche a planului; frigiderul de acolo a fost scos, fiindcă stă acum în coloana insulei.
- **Bucătăria e o interpretare a planului B4,** nu proiectul lui Feri. Cotele finale le ia el la fața locului.
- **Materialele mobilei** vin din `scripts/3d/finish.py`: scanările Egger din contul myEGGER (U755, U740, H3156, F229, 1300 × 2800 mm, E), puse în `assets-3d/egger/`, care nu intră în repo. Fără ele, materialele sunt procedurale, apropiate de culoare. Texturile apar doar în randări; `apartament.glb` are culori plate. Parchetul și gresia sunt procedurale.
- **Culoarea (13.11.2026):** view transform „Standard” (AgX comprima și spăla tonurile).
  - Expunerea e fixă pe mod de lumină (vezi Lumina) și se aplică în compozitor, urmată de un umăr pentru luminile tari (`light.tone`): sub sRGB ~0,70 imaginea e neatinsă, peste el canalul cel mai luminos e comprimat logaritmic, cu nuanța păstrată. Perdelele și ferestrele nu mai ard la alb.
  - Ziua, balansul de alb aduce la neutru lumina albăstruie a cerului, pe camere, cu luminanța neschimbată (`DAY_LIGHT`, măsurat cu `exposure_check`). Vara rămâne caldă; noaptea, 3.800 K.
  - Exteriorul văzut direct de cameră e tras cu −4,5 EV și desaturat, ca la expunerea separată a unui fotograf; lumina care intră în casă nu se schimbă. Calibrarea o face `scripts/3d/exposure_check.py`: suprafețele cu culoare cunoscută (vopselele PPG, decorurile Egger, albul pereților) trebuie să iasă cu albedo-ul lor. `scripts/3d/color_test.py` verifică separat lanțul de culoare pe plăci de 500 × 500 sub un cer alb uniform: vopselele ies în ±3 RGB, decorurile Egger în ±9. Se recalibrează când se schimbă lumina, camerele sau materialele. Lumina de plafon e un panou de 1 m, slab, ca să nu ardă corpurile de sus.
- **Lumina (13.11.2026, `scripts/3d/light.py`):** `--light day` (implicit; 14.11, 14:00; cadrele din `output/3d-pilot/`), `--light summer` (21.06, 20:30, golden hour; `output/3d-pilot/vara/`) și `--light night` (`output/3d-pilot/noapte/`). Orientarea (proprietarul): fațada cu geamurile din living și birou dă spre nord, cea scurtă spre est; din hartă, rotite cu ~3° în sensul acelor de ceas (E ±3°). Ziua: cer fizic (Sky Texture, împrăștiere multiplă) și soarele la Arad, cu radiația directă după elevație; lumina intră doar prin geamuri și perdele. În noiembrie soarele nu intră (e în sud-vest), vara la apus intră pe fațada de nord. Cerul e desaturat la jumătate (cer de noiembrie cu ceață ușoară, E). Expunere fixă: +6,75 EV (noiembrie), +7,15 EV (vara); +0,75 față de 13.11 dimineața, după ce tâmplăria reală (profilele PVC) a redus lumina, ca pereții să rămână calibrați. Băile n-au geam: plafonierele lor sunt aprinse și ziua, iar cadrele lor se expun ca noaptea. Planul (cadrul 6) are lumină albă uniformă de sus. Noaptea: rulourile coborâte, LED-urile decise din mobilă (560 lm/m la 2.700 K) și câte o plafonieră rotundă aplicată, cu difuzor opal, pe cameră (generică, E: living 1.200 lm, birou 900, Dormitor 2 800, bucătărie 600, băi 500, hol și vestibul 400), plus un lampadar în spatele canapelei (E); expunere fixă +3,4 EV, balans de alb 3.800 K.
- **Tâmplăria și ușile (`scripts/3d/arch.py`, după pozele 01–15; cote E):** ferestre PVC albe până în pardoseală, cu panou fix jos și canate sus, mânere albe, geamul de colț din birou fără zidărie în colț; ușile spre logie vitrate; logia cu parapet de sticlă; ușile interioare albe cu panou frezat, ușa de intrare închisă la culoare, plinte albe. Geamul îl vede doar camera, lumina trece ca prin gol.
- **Textile la geamuri:** scafa de 18 cm cu 2 șine: perdea ivory semi-opacă (transmisie difuză, nu se vede clar prin ea) la 45 mm de perete, mereu trasă, și draperii la 105 mm, strânse pe laterale; unda de 60 mm. Draperiile sunt taupe închis „pentru început”: culoarea se schimbă cu `--drape #RRGGBB`. Ușile spre logie (din living și din bucătărie) au doar perdea, fără draperie. Țesăturile sunt E. Geamul din living e până în pardoseală, cu panou fix jos (poza 09).
- **Modul catalog (`--catalog`):** lumină uniformă, fiecare suprafață cu culoarea mostrei (`finish.catalog`); opțiunea rămâne în cod, dar nu se mai randează implicit (proprietarul, 13.11), deci nu are cadre în repo. Comparații de vopsea: `--paint PPG1127-6=BM476 --suffix -bm476`.
- **Parchetul:** textura din poza 13 (Dormitor 2), îndreptată și făcută tileable de `scripts/3d/floor_texture.py`; fișierul stă în `assets-3d/floor/`, nu în repo. Placa are ~193 lățime (16 rosturi pe peretele de 3.100, confirmat în poza îndreptată), lungimea nu se vede întreagă (E). Plăcile merg pe x (spre peretele TV și spre geamul din living), ca în poze. Albedo-ul mediu ~0,32 (E). Fără fișier, parchetul e procedural.
- **Pereții vopsiți (PPG, mat):** `WALL_PAINT` din `scripts/3d/apartment.py`, vopseaua în `finish.paint_walls`. Living: stânga canapelei PPG1008-4 Gray By Me (#A1988B), în spatele TV-ului PPG1008-6 Artillery (#746F67). Dormitor 2: tăblia patului PPG1008-4. Birou: în spatele și în stânga biroului PPG1127-6 Winning Ticket (#636653), ceilalți doi PPG1008-1 Focus (#E5E0D2). Hex-urile sunt aproximări de ecran (E), din bazele de culori paintdb.com, matchmypaintcolor.com și pontata.com. Restul pereților, tavanul și scafele sunt albe.
- **Mobilierul cumpărat:** BOMBEI, scaunul Omni, LUNDUM și frigiderul Haier sunt asset-uri (`scripts/3d/assets.json`). În randări apar modelele generate cu TRELLIS din `assets-3d/`, dacă există, altfel modelele procedurale din `scripts/3d/assets.py`. Restul (fotoliul, BOLLSIDAN, TV-ul) sunt volume simple, cu gabaritul corect.
- **Nu sunt modelate:**
  - obiectele sanitare din băi;
  - paturile;
  - canapeaua extensibilă din Dormitor 1;
  - foile de ușă și decorul.

## Pașii următori

1. **Măsurători cu telemetrul:** ferestrele (parapet și înălțime), golurile și foile de ușă, ghenele și țeava de gaz din hol, pozițiile reale ale pereților din băi și din vestibul.
2. **Texturile:** Egger U755, H3156, U740 și F229 sunt în randări (12.11). Lipsesc U220 și o poză de aproape a parchetului.
3. **Modelele gata făcute (necesită descărcare):** canapea, fotoliu, sanitare, plante, din biblioteci (Poly Haven, Fab) sau de la producători.
4. **Corpurile rămase:** paturile, noptierele, corpurile de baie și restul bucătăriei după proiectul lui Feri. Insula și coloana frigiderului sunt deja după planșe.
5. **Plimbarea interactivă:** GLB-ul în Unreal sau Twinmotion pe PC-ul cu RTX 4080, sau un viewer web pe Cloudflare Pages.
