🎨 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/.webpna á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).