# Tour com fotos reais — guia de uso

## Abrir

Arquivo principal: `reports/photo-tour.html`. Dê dois cliques e abra no Chrome ou Edge. Funciona sem servidor e sem internet; as fotos estão dentro do HTML.

1. Escolha o ambiente na faixa superior.
2. Use as setas ou miniaturas para alternar a fotografia.
3. Clique em **Todos os ângulos** para ver as vistas lado a lado.
4. Use zoom e arraste a imagem para examinar detalhes.
5. **Ajustar imagem** restaura o enquadramento completo; **Tela cheia** amplia o quadro.
6. **Salvar imagem** salva a fotografia exibida ou a montagem do ambiente.
7. Os botões de conexão conduzem ao ambiente relacionado. Ligações por janela são marcadas como contexto visual, não passagem de pessoas.

## Imagens prontas

| Ambiente / setor | Arquivo | Conteúdo |
|---|---|---|
| Quarto | `photo-tour/quarto-multiangulos.jpg` | Três direções principais |
| Sala | `photo-tour/sala-multiangulos.jpg` | Varanda, cozinha e relação entre setores |
| Cozinha | `photo-tour/cozinha-multiangulos.jpg` | Quatro vistas: bancada, cooktop, sala/quarto, geladeira/cortina |
| Banheiro | `photo-tour/banheiro-multiangulos.jpg` | Interior e janela vista pelo lado da varanda, identificada como contexto externo |
| Lavanderia | `photo-tour/lavanderia-multiangulos.jpg` | Melhor vista disponível, sem fabricar outras faces |
| Varanda | `photo-tour/varanda-multiangulos.jpg` | Fachada/acessos, sentido contrário e jardim |
| Jardim/estacionamento | `photo-tour/exterior-multiangulos.jpg` | Quatro vistas exteriores |

Sala e cozinha são setores do mesmo ambiente contínuo, separados no menu apenas para organizar a navegação das fotos.

## Cobertura e precisão

O usuário escolheu **Tour com fotos reais**, depois da avaliação da união automática. Este é um tour multiângulos, não uma fotografia 360° esférica. Não atribui graus de rotação às fotos, não inventa lados ocultos, não projeta fotografias em uma geometria presumida e não altera posição de portas, móveis ou louças.

São 33 fotos reais selecionadas das 38 disponíveis. Cinco registros foram excluídos por repetição de vista ou resolução muito baixa. Cada exclusão consta de `analysis/photo-tour.json`. O atlas foi atualizado e continua disponível com as 38 fotos. A classificação dos arquivos foi conferida em quatro folhas de contato que mostram foto, ID e nome juntos.

“Outro registro” indica diferença de enquadramento, mesa, colcha ou decoração. Essas imagens são exibidas separadamente, sem fundir estados diferentes. “Contexto externo” mostra uma relação a partir de outro ambiente. No banheiro, a vista da varanda não é apresentada como interior do banheiro.

Banheiro e lavanderia têm principalmente uma direção fotografada; duas fotos semelhantes não constituem cobertura de duas faces ou uma volta completa. Quarto, cozinha, varanda e exterior possuem mais direções, mas a cobertura angular exata não foi calibrada.

Os arquivos originais permanecem preservados. O HTML usa cópias JPEG otimizadas, com enquadramento completo; não foi feita remoção da marca d'água das fotografias.

## Reprodução

```powershell
python .\scripts\photo_tour.py --photos-dir "C:\Users\igor.bicalho\Pictures\home"
python .\scripts\photo_tour.py --check
.\scripts\validate.ps1
```

Gerador: Python e Pillow já disponíveis. Visualizador: HTML/JavaScript sem bibliotecas externas. Manifesto de entradas, fontes e saídas em `photo-tour/manifest.json`.