# Task: Ricostruire proceduralmente con Three.js la veduta notturna di metà autunno del padiglione 'Moon Coming with Wind' nel Giardino del Maestro delle Reti a Suzhou, eseguendo il rendering offline di un cortometraggio cinematografico di 60 secondi.
## 0. Principi generali
- Puntare a "maggiore precisione e profondità", non a "più grande e più completo". Costruire solo ciò che è visibile nell'inquadratura: lo stagno Cai Xia e gli edifici circostanti.
- Tutta la geometria, i materiali e le texture sono generati via codice; non utilizzare file immagine, modelli o mappe di texture.
Eccezione: una traccia musicale di sottofondo (vedi Sezione 7).
- Librerie CDN consentite: three.js (incluso examples/jsm), SunCalc, mp4-muxer.
- Seguire rigorosamente le fasi da 1 a 8. Al termine di ogni fase, registrare in LOG.md le azioni eseguite, i percorsi degli screenshot, le metriche e i problemi noti.
Non procedere alla fase successiva se i criteri di accettazione della fase precedente non sono soddisfatti.
## 1. Basi di riferimento (prioritarie rispetto all'immaginazione)
- Spazio: area centrale del Giardino del Maestro delle Reti. La sponda ovest ospita il padiglione 'Moon Coming with Wind' sospeso sull'acqua; la sponda est presenta il 'Shooting Duck Corridor' addossato all'alto muro a timpano di un edificio residenziale;
nell'angolo nord-est si trova il 'Bamboo Outside Branch Pavilion'; nell'angolo sud-est il 'Quiet Bridge' (un piccolo ponte ad arco in pietra, lungo circa 2,4 m) con il ruscello sottostante; sulla sponda sud sorgono la collina artificiale in pietra gialla 'Cloud Ridge' e il 'Washing Crown Water Pavilion';
sulla sponda nord si colloca il 'Reading Pine Painting Pavilion', preceduto da pini bianchi e antichi cipressi.
- Materiale fornito: planimetria scansionata (plan.png) tratta da 'Classical Gardens of Suzhou' di Liu Dunzhen e fotografie reali (cartella photos/, con lunghezza focale e posizione).
Se non forniti, costruire secondo le dimensioni indicate di seguito e segnalarli come "da misurare" in LOG.md.
- Scala (1 unità = 1 metro):
Stagno quasi quadrato di circa 20 m x 20 m, con angoli smussati a formare piccole insenature.
Pavimento del padiglione a 0,5 m sopra il livello dell'acqua; tetto a punta esagonale (verificare la forma), altezza delle grondaie ~2,6 m.
Larghezza del corridoio 1,3 m, altezza delle grondaie 2,6 m. Altezza del muro a timpano est 7 m.
Wu Wang Kao (panca con schienale): altezza della seduta 0,45 m, bordo superiore dello schienale 0,9 m.
Altezza della collina Cloud Ridge ~3,5 m.
- L'immagine di riferimento reference.png è generata dall'IA e serve esclusivamente per l'inquadratura finale e il tono cromatico, non come base strutturale.
In caso di conflitto, la struttura ha la precedenza sull'immagine di riferimento.
## 2. Componenti e materiali (procedurali)
- Tetto: piccole tegole blu (tegole a farfalla), grigio scuro, colmi realizzati tramite InstancedMesh; tegole di gocciolamento dal ritmo cadenzato lungo le gronde.
- Angoli del tetto: curvatura verso l'alto delicata in stile Suzhou, leggera ma sobria. Utilizzare curve spline, non forme a mezzaluna.
- Elementi in legno: color guscio di castagna (~#4a2f22), finitura opaca e leggermente umida. Niente rosso, niente oro.
- Infissi e tramezzi: reticoli lignei sottili in stile Wan Chuan. Le ringhiere seguono le curve Wu Wang Kao (a collo d'oca).
- Muri bianchi: intonaco di calce bianco, tendente al grigio caldo, mai bianco puro. Tracce di pioggia generate dall'alto verso il basso tramite rumore fBm; la zoccolatura di base (0,4 m) è grigio-bluastra con macchie d'umidità. La sommità è coperta dalle gronde in tegole.
- Rocce artificiali: esclusivamente pietre gialle. Blocchi spigolosi, stratificazione orizzontale, bordi taglienti. Nessuna cavità tipica delle pietre Taihu. La linea di costa e Cloud Ridge condividono lo stesso shader per la pietra.
- Terreno: all'interno del padiglione, pavimentazione in mattoni posati in diagonale con variazioni di usura. Lungo la riva, la pavimentazione tradizionale "hua jie" utilizza ciottoli e frammenti di tegole per formare un motivo a ghiaccio crepato (Voronoi procedurale).
Deve risultare impeccabile anche visto dall'alto.
- Vegetazione: pino bianco (tronco bianco screziato, L-system), ciuffi di bambù (instanced), cespugli di osmanto, qualche fico rampicante lungo la riva.
Niente fiori di ciliegio, aceri rossi o fiori di loto.
- Acqua: verde scuro quasi nero, riflessione planare, increspature sottili generate dalla brezza; i riflessi devono corrispondere fedelmente alla geometria fisica.
- Colori: bassa saturazione. Palette principale: grigio scuro, castagna, grigio argento, verde inchiostro.
## 3. Illuminazione (luce lunare, non golden hour)
- Tempo: Suzhou (Lat 31.3°, Lon 120.6°), notte di metà autunno alle 00:30. Calcolare azimut ed elevazione della luna con SunCalc,
posizionare di conseguenza una DirectionalLight e registrare i valori in LOG.md.
- Luce principale unica: luce lunare, grigio-argento neutro e freddo (~#c8d2e0). Ombre corte, bordi netti, direzione coerente.
- Opzionale: una luce calda molto debole (color candela) proveniente da una singola finestra, con intensità massima pari al 30% della luminosità del muro illuminato dalla luna.
- Cielo: blu-grigio profondo, poche stelle (procedurali). Il disco lunare è fuori campo, se ne percepisce unicamente l'effetto luminoso.
- Fisica: spazio colore lineare, tonemapping AgX, esposizione fissa (niente auto-esposizione).
Come luce ambientale usare solo una HemisphereLight molto debole per le ombre, senza schiarirle fino a renderle grigio-bianche.
- Vietato: luci colorate, catene luminose, lanterne rosse, luci paesaggistiche moderne, effetto Bloom eccessivo.
## 4. Shot list (10 inquadrature x 6s = 60s; inizio su dettagli ravvicinati, poi apertura progressiva)
- Regola generale: lunghezza focale equivalente 35-50 mm, altezza della camera a livello degli occhi (1,6 m), eccetto per l'inquadratura 9;
movimenti con easing ease-in-out, nessuna vibrazione, nessuno zoom; mantenere le linee verticali perfettamente dritte.
- Inquadrature:
1. Pavimento in mattoni all'interno del padiglione -> Carrellata indietro per rivelare la panca-ringhiera e le colonne (definire la presenza della "persona nel padiglione").
2. Riflessi frammentati della luna tra le increspature -> Carrellata indietro per mostrare il riflesso completo del muro bianco.
3. Spigoli delle pietre gialle lungo la riva e fico rampicante -> Panoramica laterale per rivelare Cloud Ridge.
4. Pietra dell'arco del Quiet Bridge -> Carrellata indietro per mostrare quanto il ponte sia piccolo, quasi scavalcabile con un passo.
5. Tracce di pioggia sul muro e zoccolatura -> Carrellata indietro per evidenziare il contrasto tra il corridoio basso e il muro alto.
6. Reticoli lignei del corridoio -> Panoramica lungo il corridoio.
7. Corteccia del pino bianco -> Tilt verso l'alto e carrellata indietro per rivelare il Bamboo Outside Branch Pavilion.
8. Tegole e angoli del tetto -> Carrellata indietro per svelare la silhouette del tetto contro il cielo notturno.
9. Vista zenitale a 15 m d'altezza della pavimentazione -> Salita fino a 40 m per rivelare l'intera planimetria del giardino (corrispondente alla pianta).
10. Dettaglio ravvicinato di colonna e reticolo -> Carrellata indietro fino a fermarsi sull'inquadratura finale: vista verso est dall'interno del padiglione 'Moon Coming', 35 mm,
rispettando la composizione di reference.png, tenuta statica negli ultimi 2 secondi.
- Completare prima i campioni di animazione in grey-box per tutte e 10 le inquadrature (Fase 3), confermando il ritmo narrativo prima di passare alla fase dei materiali.
## 5. Rendering e output (offline frame-by-frame, non real-time)
- Passo temporale fisso: dt = 1/30 sec, totale 1800 frame, risoluzione 1920x1080.
Tutte le animazioni (increspature, oscillazione del bambù) devono essere guidate esclusivamente dall'indice del frame, senza requestAnimationFrame o setTimeout.
- Anti-aliasing e prevenzione del flickering: 16 campioni di jitter sub-pixel mediati per frame; mipmap per tutte le texture;
shadow map allineate ai texel (CSM stabile); near plane >= 0,1 m per evitare z-fighting;
roughness minima 0.3 per prevenire l'aliasing speculare.
- Codifica MP4 nella pagina tramite WebCodecs VideoEncoder + mp4-muxer, con mixaggio della traccia audio.
- La pagina deve offrire: modalità di anteprima in tempo reale (qualità ridotta) e pulsante "Render Film" (rendering offline ad alta qualità).
## 6. Validazione (eseguire a ogni ciclo, registrare i risultati)
- V1 Sovrapposizione planimetria: rendering ortografico dall'alto, sovrapposto in semitrasparenza a plan.png.
Scostamento massimo di 0,5 m per gli edifici principali e le rive.
- V2 Camera match: se sono disponibili foto reali, eseguire il rendering della stessa visuale basandosi su focale e posizione della foto, sovrapponendo le mappe dei contorni.
Linea superiore del muro, linea delle gronde del corridoio e posizione delle colonne: scostamento <= 2% della larghezza del frame.
- V3 Confronto inquadratura finale: ultimo frame dell'inquadratura 10 affiancato a reference.png, con calcolo dell'SSIM.
È richiesta solo una composizione e un tono simili: SSIM >= 0,5 è sufficiente. Non alterare la struttura unicamente per alzare questo valore.
- V4 Flickering: negli ultimi 2 secondi statici dell'inquadratura 10, la differenza media di luminosità tra frame adiacenti deve essere < 0,5/255,
e la variazione di qualsiasi pixel in un singolo frame <= 8/255 (fornire statistiche separate per le aree con increspature, motivandole).
- V5 Astronomia: Registrare SunCalc...
