# Fotomontaža koncepta i pokretač pogleda

**Status: AI građanski koncept · PRIJEDLOG · nije projekt. Montaža nije dokaz položaja, visine, vidljivosti, statike ni izvedivosti.** Stanje na dan 14.11.2026., dopunjeno 15.11.2026. (`--zadrzi-sliku`). Ovo nije neovisna stručna revizija.

Dvije skripte: `scripts/viz/montaza.py` uklapa render koncepta u stvarnu fotografiju iste kamere (bez Blendera), a `scripts/viz/pogledi.py` za zadani pogled iz `research/viz/pogledi.json` gradi scenu, postavlja kameru i Sunce, renderira prolaze i zove montažu.

## Što je model, a što obrada slike

| Dio slike | Izvor | Pouzdanost |
| --- | --- | --- |
| položaj i obris koncepta | 3D model (`koncept.py` iz program.json) i riješena kamera | PRETPOSTAVKA-IZRAČUN; točno onoliko koliko kamera i model |
| sjena koncepta na tlu | hvatač sjene u renderu (teren i vode), Sunce iz vremena snimke | približno: teren 20 m, bez rubnjaka i zidova |
| zaklon postojećim zgradama i drvećem | prolaz koncepta s izrezom u alfi (model) | grubo: drveće je proceduralno, krovovi ravni |
| zaklon iz fotografije | maske neba, krošnji i tankih struktura po boji i svjetlini, ručni poligoni | obrada slike; s tla bez ručnih poligona ne radi pouzdano |
| uklonjeno postojeće stanje | maska postojećeg stanja iz iste kamere i ručni poligoni, ispuna iz okoline | obrada slike; ispuna je izmišljena pozadina, ne snimka |
| boja, izmaglica, zrno | statističko usklađenje s fotografijom | približno, ne fizikalno |

## Postupak (pogledi.py izradi)

1. **Kamera** redom: `research/viz/kamere/<id>.json` (riješena), `validacija_kamere.json` (P01, DJI_0015_2020, RMS 0,12 % širine), približna kamera iz `ZADANO_POGLEDI` u `pogledi.py`, kamera iz opisa pogleda, EXIF/XMP DJI snimke. Montaža na kameri koja nije riješena na kontrolne točke radi se samo uz `--priblizna` i tada traka nosi napomenu „Kamera je približna”.
2. **Sunce**: vrijeme snimke (validacija, EXIF iz `kandidati.json` ili same datoteke), krošnje prema datumu; inače zadano 21.6. u 17:30 (rano ljeto, kasno poslijepodne).
3. **Maska postojećeg stanja**: scena postojećeg stanja (sa starim stadionom) iz iste kamere, samo maska slojeva (`<id>_postojece_maska.png`).
4. **Scena s konceptom** (`koncept.izgradi`): prolazi slika, dubina, maska, pokrivenost i koncept (RGBA s hvatačem sjene), bez zračne perspektive (izmaglicu radi montaža bojom iz fotografije). `koncept_zaklon` je zadano uključen (pogledi iz zraka); za poglede s tla isključen, jer proceduralno drveće ne odgovara stvarnom.
5. **Montaža** (`montaza.uklopi`), redom:
   - fotografija se umanjuje na izlaznu širinu; zamućuju se zadani pravokutnici (osobe, pločice);
   - tijelo koncepta = pokrivenost sloja koncept (ili alfa kad je zaklon modela isključen); sjena = ostatak alfe, samo na tlu i vodi;
   - nebo: svijetlo, glatko, plavkasto ili neutralno, povezano s gornjim rubom, samo gdje model dopušta nebo; morfološko čišćenje;
   - prednji plan iz fotografije (po pogledu): vegetacija (udio zelenog, ExG; tamno i teksturirano izvan poligona pozadine), tanke strukture na nebu (zatvaranje maske neba), ručni poligoni zaklona;
   - uklanjanje: stari stadion i zgrade iz maske postojećeg stanja koje koncept ne pokriva, i ručni poligoni (stupovi rasvjete, kojih nema u modelu); ispuna neba piramidalnom ispunom iz okolnog neba, ispuna tla klonom susjednog dijela iste fotografije s popravkom spoja, a gdje klon nije moguć glatkom ispunom i detaljem iz rendera modela;
   - usklađenje: crna i bijela točka (2. i 98. percentil svjetline na zajedničkom kopnu, nagib ograničen na 0,8–1,25), toplina iz neutralnih piksela i neba, zasićenje (0,7–1,3), meko rame iznad 0,82 da krov i beton ne pregore;
   - izmaglica po dubini s bojom neba uz obzor iz fotografije, po stupcima;
   - zamućenje prema oštrini fotografije (omjer Laplaceova operatora i gradijenta), zrno prema šumu neba;
   - slaganje u linearnom svjetlu; neobvezni zrcalni odraz koncepta u vodi oko linije obale.
6. **Izlaz** u zadanu mapu (konačno `dist/assets/viz/pogledi/`): `<id>_vizija.jpg`, `<id>_danas_vizija.jpg` (par danas/vizija; za snimke Grada odluka M31) i `<id>.json`; uz fotografiju sa slobodnom licencom i `<id>_danas.jpg`. Za snimke Grada umanjena snimka bez montaže ne sprema se u repo; uz `--usporedba <mapa izvan repoa>` sprema se ondje. Popratni zapis sadrži (kamera i status, Sunce, program, fotografija i navod, licenca izlaza, parametri i mjere montaže, pretpostavke). Prolazi i pregled maski (`<id>_maske.png`: plavo nebo, crveno zaklon, žuto uklonjeno, zeleno koncept) ostaju u predmemoriji izvan repoa.

Sve izlazne slike spremaju se iz piksela u novu datoteku, bez EXIF-a, XMP-a i ICC profila (`montaza.spremi`, provjera `montaza.ima_exif`).

## Naredbe

```
python scripts/viz/pogledi.py popis --foto-mapa <izvornici>
python scripts/viz/pogledi.py izradi P01 --sirina 1600 --uzorci 48 --program research/viz/program.json \
    --izlaz dist/assets/viz/pogledi --predmemorija <mapa izvan repoa> --foto-mapa <izvornici>
python scripts/viz/pogledi.py izradi P06 --priblizna ...        # kamera nije riješena
python scripts/viz/pogledi.py izradi P06 --priblizna --samo-montaza ...   # nakon promjene poligona, bez rendera
python scripts/viz/pogledi.py izradi P05 --zadrzi-sliku ...                 # nakon promjene izgleda koncepta: prolaz slika iz predmemorije ostaje
python scripts/viz/pogledi.py sve ...
python scripts/viz/montaza.py maske --foto <slika> --izlaz <png>          # pregled maski neba, krošnji, tankog
python scripts/viz/montaza.py zamuti --ulaz <slika> --izlaz <jpg> --pravokutnik x0,y0,x1,y1
python scripts/viz/montaza.py bez-exif --ulaz <slika> --izlaz <jpg>
```

`--zadrzi-sliku` (15.11.2026.): prolaz slika (`<id>.png`, oko 25 min na 2400 px) uzima se iz predmemorije, a ponovno se renderiraju dubina, maska, pokrivenost i koncept (i `<id>_bez`). Montaža prolaz slika koristi samo izvan koncepta (usklađenje boje, oštrina, detalj ispune), pa to vrijedi dok su scena postojećeg stanja i kamera iste; izmjereno na probi 960 px (P02, P05): izvan koncepta srednja razlika starog i novog prolaza 0,1 do 0,3 od 255. Popratni JSON to bilježi u `render.prolaz_slika` (iz bilješke `<id>_slika_izvor.txt` u predmemoriji: pri zadržavanju se uvijek prepisuje, a pri punom renderu briše, pa JSON tada kaže „renderiran s konceptom”).

`--foto-mapa` (ili varijabla `VIZ_FOTO_MAPE`) pokazuje na mape s izvornicima Gradovih snimki; traže se imena `<datoteka>`, `<godina>_<datoteka>` i `<ime>_<godina>.JPG`. Izvornici ostaju izvan repoa. Redoslijed u `sve`: jedna scena postojećeg stanja za sve montaže, jedna scena koncepta za sve montaže i rendere, zatim sheme (P16, P17) iz `koncept.py`.

## Parametri montaže (ključevi u `montaza.ZADANO`)

Postavke pogleda spajaju se redom: `ZADANO_POGLEDI` u `pogledi.py`, blok `montaza` u `pogledi.json`, `research/viz/kamere/<id>.json`. Poligoni su u pikselima zadane datoteke fotografije.

| Ključ | Zadano | Značenje |
| --- | --- | --- |
| `sirina` | 1600 | širina izlaza (px) |
| `vidljivost_km` | bez | izmaglica po dubini; P01 30, P06 12 (PRETPOSTAVKA iz izgleda snimke) |
| `prednji_plan` | isključeno | `vegetacija`, `tanko`, `tanko_px`, `tamno_percentil` |
| `poligoni_zaklon` | – | uvijek ispred koncepta |
| `poligoni_ukloni` | – | postojeće što nestaje (ispuna iz okoline) |
| `poligoni_pozadina` | – | postojeće iza koncepta: tamno i tanko tu nisu zaklon |
| `poligoni_voda`, `odraz` | – | vodena ploha i jakost odraza |
| `sjena_jakost`, `sjena_zamucenje_px` | 0,85 i 0 | za oblačno oko 0,2 i 4 |
| `uskladi`, `uskladi_jakost` | da, 1 | usklađenje boje |
| `zamucenje` | auto | sigma (px) ili prema oštrini fotografije |
| `zaklon_modela` | da | ne kad je render s `koncept_zaklon=False` |
| `zamuti` | – | pravokutnici osoba i pločica |

## Navodi i prava

| Podloga | Navod na traci | Licenca montaže |
| --- | --- | --- |
| Gradove snimke iz zraka (M21) | „Fotografija: Grad Zagreb, natječajna dokumentacija; montaža: AI građanski koncept, nije projekt ni stav Grada”, godina snimke, izmjene | fotografija se ne relicencira; ne tvrdi se suglasnost Grada |
| CC BY (S57, S58) | autor, naslov, godina, licenca s poveznicom, stranica datoteke, „Izmijenjeno: …” | navod je obvezan; autor ne podržava koncept |
| CC BY-SA (S59, S63) | isto | montaža se dijeli pod CC BY-SA 4.0 (traka i JSON) |
| model | DGU Visine INSPIRE (i DOF 2024. kad je ispuna iz modela), © OpenStreetMap contributors | – |

Svaka montaža nosi traku ispod slike (slika se ne prekriva) s oznakom „AI građanski koncept · PRIJEDLOG · nije projekt”. Slika „danas” nosi „DANAS · fotografija bez montaže · usporedba uz AI građanski koncept · PRIJEDLOG · nije projekt” i isti navod.

## Probe 14.11.2026. (program research/viz/program/kandidat_b/program.json)

| Pogled | Postavke | Što je provjereno | Nalaz |
| --- | --- | --- | --- |
| P01 (DJI_0015_2020, riješena kamera) | 960 i 1600 px, 48 uzoraka; zaklon iz modela; 2 ručna poligona uklanjanja | rub krova i šume, glave stupova rasvjete, lijevi i desni rub podija, traka | stupovi rasvjete strše iznad novog krova (nema ih u modelu): uklonjeni ručnim poligonima i klonom šume; nakon ispravka bez vidljivog šava. Ostatak starog stadiona uz istočni rub ispunjen glatko (manji sivi komad) |
| P06 (S57, jezero, približna kamera) | 960 px, 48 uzoraka; bez zaklona iz modela; vegetacija, tanko, odraz, oblačno | maska neba, krošnji i grana, uklanjanje staklene zgrade, odraz | nebo i četinjače pouzdani; gole krošnje ispred stakla boja ne odvaja (potreban ručni zaklon); tamna sjena stare tribine bila je proglašena krošnjom (ispravljeno poligonom pozadine); sjena hvatača na vodi u oblačnom danu bila je pretvrda (ispravljeno) |

Ispravljene pogreške tijekom probe: alfa hvatača sjene ima slab šum na postojećim zimskim (prozirnim) krošnjama, pa se „prisutnost koncepta” određuje iz pokrivenosti i sjene na tlu, ne iz alfe; ispuna uklonjenog dijela uzimala je boje starog stadiona ispod koncepta (sada isključeno); pri renderu bez zaklona modela tijelo koncepta dolazi iz alfe, jer maska pokrivenosti vidi proceduralne krošnje ispred koncepta.

Kamera P06 (PRETPOSTAVKA): staza uz sjevernu obalu Prvog jezera, ENU-N x 15, y 257, oko 1,6 m iznad tla, azimut 186°, nagib 3°, 35 mm ekv. Odabrana od šest kandidata preklopom obrisa modela na fotografiju (vodoravni opseg istočne tribine i crta obale). Model istočne tribine niži je od snimke, pa okomito slaganje nije provjerljivo; kamera nije riješena na kontrolne točke. Opis P06 u `pogledi.json` („ENU-N oko x 40, y 125”) pada unutar današnjeg stadiona i ne odgovara fotografiji; `kandidati.json` (x 0…30, y 250…265) odgovara.

## Ograničenja

- **Zaklon iz modela je grub.** Drveće je proceduralno, zgrade su istisnuti tlocrti; stupova rasvjete, ograda, vozila i ljudi nema. U pogledima iz zraka to se vidi samo na rubovima; s tla je neupotrebljivo, pa se tamo zaklon radi iz fotografije i ručnim poligonima.
- **Zaklon iz fotografije je pravilo boje i svjetline.** Pouzdano odvaja nebo, zelene i tamne krošnje te grane na nebu; ne odvaja gole krošnje ispred stakla ili sivih pročelja, sjenu ispod tribine od krošnje ni svjetiljku od stupa rasvjete. Za svaki pogled s tla potrebni su ručni poligoni i pregled maske okom.
- **Uklanjanje je izmišljena pozadina.** Ispuna klonom ili glatkom ispunom ne pokazuje što je stvarno iza; na velikim površinama izgleda ponovljeno ili mutno. Uklanjaju se samo dijelovi koje koncept stvarno zamjenjuje.
- **Sjene i svjetlo su približni.** Sunce iz vremena snimke; hvatač sjene na terenu 20 m bez mikroreljefa; nema sjene koncepta na postojećim zgradama ni krošnjama; nema odbijenog svjetla ni odraza u staklu. Oblačno se oponaša slabom mekom sjenom.
- **Boja je statistički usklađena**: model teksturira tlo ljetnim ortofotom, a snimke su iz drugih godišnjih doba; usklađenje je zato ograničeno i ne mijenja materijale koncepta (boje su ilustracija prema M25).
- **Kamera s tla nije riješena**: na P06 položaj koncepta na slici je okviran.
- **Montaža nije dokaz.** Ne dokazuje vidljivost, visinu, položaj ni izvedivost; za vidljivost vrijedi izračun (`vidljivost.py`) s vlastitim ograničenjima.

## Najjači protuargument

Fotomontaža na stvarnoj fotografiji izgleda uvjerljivije od rendera i zato može zavarati više nego što pokazuje: ručni poligoni, odabir kamere i usklađenje boje odluke su obrađivača, a ne mjerenja. Zato JSON uz svaku sliku nosi sve poligone, status kamere i parametre, a slika „danas” stoji uz „viziju”.

## Sljedeći provjerljiv korak

Riješiti kameru P06 na 8 kontrolnih točaka (rubovi istočne tribine, stupovi rasvjete, ugao staklene zgrade, rub jezera) i spremiti je u `research/viz/kamere/P06.json` s poligonima; ponoviti montažu i usporediti položaj koncepta s približnom kamerom.
