# 🎨 Editor de Imagens (Paint)

Editor de imagens integrado, inspirado no Paint clássico. Funciona embutido no Codis ou standalone.

**Arquitetura** (separada para ser testável): `src/ui/paint_engine.py` (motor, sem Tk) · `src/ui/paint_canvas.py` (canvas) · `src/ui/paint_panel.py` (barra de ferramentas, paleta, arquivos).

## Abrindo
- Menu **Ferramentas → Editor de Imagens**, ou duplo clique em `.png/.jpg/.bmp/.gif/.webp` na árvore de arquivos.
- Linha de comando: `python run.py --paint [imagem.png]`

## Ferramentas
| Ferramenta | Comportamento |
|---|---|
| Pincel | Antialiasing real; a opacidade **não acumula** dentro do mesmo traço |
| Pixel | Traço sem suavização (pixel art) |
| Spray | Aerógrafo acumulativo |
| Borracha | Apaga com a **cor de fundo** (botão direito: cor primária) |
| Balde | Preenchimento com tolerância; **Ctrl+clique** preenche todas as áreas parecidas (não só a conectada) |
| Linha / Retângulo / Elipse | Com antialiasing; **Shift** = 45° / quadrado / círculo; "Preencher" preenche |
| Polígono | Clique adiciona pontos; duplo clique/Enter fecha; Esc cancela |
| Texto | Fonte do sistema (DejaVu/Arial/…) com antialiasing |
| Conta-gotas | Botão esquerdo = cor primária, direito = secundária |
| Seleção | Retângulo; arraste de dentro para **mover** (deixa a cor de fundo no lugar); Ctrl+C/X/V, Delete, Ctrl+A |
| Pan (mão) | Arrasta a imagem |

## Atalhos
| Atalho | Ação |
|---|---|
| Ctrl+Z / Ctrl+Y (ou Ctrl+Shift+Z) | Desfazer / refazer |
| Ctrl+S / Ctrl+Shift+S / Ctrl+O / Ctrl+N | Salvar / salvar como / abrir / novo |
| Ctrl+C / Ctrl+X / Ctrl+V / Ctrl+A | Copiar / recortar / colar (aceita imagem da área de transferência do sistema, quando a plataforma permite) / selecionar tudo |
| Roda | Rola na vertical · **Shift+roda** horizontal · **Ctrl+roda** zoom no cursor |
| Botão do meio ou **Espaço**+arrastar | Pan |
| `+` / `-` / Ctrl+0 | Zoom / ajustar à janela |
| Esc | Cancela o traço, a seleção flutuante ou o polígono |

O zoom vai de 6% a 3200%; a grade de pixels aparece a partir de 800%. O título mostra **•** quando há alterações não salvas e **Novo/Abrir** perguntam antes de descartar.

## Desempenho (por que não trava mais)
Medido no mesmo script antes/depois (800×600 | 4000×3000):

| Operação | Antes | Depois |
|---|---|---|
| Evento de pincel | 22 ms \| 650 ms | 2 ms \| 1,6 ms |
| Evento de pincel com zoom 8× (grade) | 844 ms | ~1 ms |
| Balde numa imagem em branco | 1.180 ms \| minutos | 37 ms \| 560 ms |
| Zoom 8× em 4000×3000 | **estourava a memória** | 17 ms |
| Undo | 33 ms (+PNG inteiro por ação) | 8 ms (só blocos alterados) |

Como: renderiza **só o retângulo visível/sujo** (sem reescalar a imagem inteira nem criar milhares de itens de canvas para a grade/xadrez); eventos de mouse são coalescidos em um desenho por ciclo ocioso; o pincel acumula uma máscara e compõe só a caixa afetada; o balde trabalha por trechos horizontais; o histórico guarda blocos de 256×256 (limite de ~384 MB, 200 ações).

## Salvando
PNG/WebP preservam transparência. **JPEG/BMP achatam sobre branco** (antes ficava preto onde era transparente). A gravação é atômica (arquivo temporário + `replace`): uma falha não corrompe o original. Imagens com orientação EXIF são giradas ao abrir.

## Testes
`tests/test_paint_engine.py` (motor: undo contra snapshots, flood fill contra BFS de referência, renderização parcial == total, orçamentos de tempo) e `tests_gui/test_paint_canvas.py` (compara os pixels **exibidos** com o modelo).