# Problemas de renderização

> A tela não reflete o código — render sob demanda, alpha, invalidação de layout, GPU fraca.

Source: https://crossfly.dev/pt/docs/troubleshooting/render — CrossFly documentation. Full docs as one file: https://crossfly.dev/llms-full.txt

# Problemas de renderização

A tela não reflete o que o código fez. Formato: **sintoma → causa → correção**.

## "Mudei um valor e a tela não atualiza"
**Causa:** render é **sob demanda** — o CrossFly só redesenha quando solicitado.
**Correção:** chame `Component.repaint()`; se mudou tamanho/posição "por fora", também
`setValidLayout(false)` (a maioria dos setters do framework já faz isso; o que você muda manualmente,
não). (Cap. 4 §4.6)

## Cor definida some / componente fica invisível
**Causa:** cor é `int` ARGB `0xAARRGGBB` e você usou `0xRRGGBB` (alpha 0).
**Correção:** prefixe `0xFF…`.
```java
// 0x2196F3  → invisível (alpha 00)
// 0xFF2196F3 → azul opaco
```
(Cap. 11 — Cores)

## Layout não recalcula após trocar filhos
**Causa:** faltou invalidar o layout.
**Correção:** `container.setValidLayout(false);` + `Component.repaint();`.

## UI engasga / serrilha em device antigo
**Causa:** GPU fraca.
**Correção:** cheque **`Screen.slowGPU`** e reduza sombras/gradientes/efeito glass nesse caso.
(Cap. 8 — Rendering)

## Tema trocou, mas componentes antigos não
**Causa:** o cache de estilo se re-resolve por `styleVersion` (as cores `PalColor` re-resolvem no
próximo frame) — normalmente automático ao `setColorScheme`/`setDarkMode`.
**Correção:** se algo não acompanhou, force `restyle()` na janela ou `Component.repaint()`.
([Modo claro/escuro](/docs/ui/theming/dark-mode))

## Veja também
- [Erros de runtime](/docs/troubleshooting/runtime) · Conceito: [O pipeline de renderização](/docs/concepts/rendering-pipeline)