---
title: "Diagnóstico de Image e HUD"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/diagnostico/
---

# Diagnóstico de Image e HUD

Localize a etapa que falhou: documento, imagem, elemento, script, evento ou estado de vida.

| Sintoma | Confira | Correção |
|---|---|---|
| Image não está em Adicionar componente | É elemento do .aeui | Abra Interface ou + Elemento no Inspector da UI; use Image |
| HUD não aparece | Canvas habilitado, Documento UI, Apresentação e estado da fonte | Salve/registre o .aeui e atribua ao Canvas; HUD usa Tela |
| Ícone ausente ou indicação de erro | Recurso do projeto, nome/maiúsculas, diagnóstico da imagem | Importe o PNG para o projeto e use caminho relativo correto |
| Coração branco/esticado/cortado | Tinta, Ajuste, tamanho do retângulo e clipping | Tinta branca, Conter e 48 × 48; revise alpha e Recortar filhos |
| Tamanho muda quando escondo um coração | Ele é filho gerenciado de HBox/VBox/Grid | Use um slot Panel com vazio/cheio ou o overlay manual do tutorial |
| Campo Layout bloqueado | Pai controla composição automática | Altere tamanho/peso/ordem ou use Fora do fluxo |
| Botão funciona em Interagir mas não muda vida | Interagir não executa HeartHud C# | Compile/anexe o script e use Play |
| Find falha | Nome exato, contexto e documento | Confira Heart1–3/Status/Damage/Heal e Gui.ForCanvas no objeto HUD |
| Vida altera, corações não | Player errado, Behavior ausente/desabilitado ou handle vencido | Atribua Player, anexe PlayerHealth; reinicie Play após reload do Canvas |
| Cliques não chegam | Habilitado, sobreposição, captura e consumo de Poll | Um consumidor por fila; filtre Click; confira o Canvas correto |
| Dano contínuo a cada frame | Mecânica usando TriggerStay sem cooldown | O exemplo usa TriggerEnter; defina invulnerabilidade explicitamente se precisar |
| Alteração desapareceu ao reabrir | Editou só a cópia runtime ou não salvou UI | Faça a autoria fora de Play e Salvar UI; salve a cena para referências |
| Duas instâncias alteram a mesma fonte | Documento .aeui compartilhado | Crie outro recurso autoral se precisam divergir; overrides por instância pendentes |

Use **Gui.Diagnostic** do contexto correto para ações/alvos inválidos. GuiElement default não é um handle válido; elementos removidos e handles do Play anterior são rejeitados. O atlas atual limita fontes de imagem e dimensões: [roadmap e limites](/pt-br/snapshot-2026-10-06/ui/roadmap/).