Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Painel de saída
O painel de saída (Output) encontra-se na parte inferior da tela. Clique em Output para abri-lo.
O painel de saída oferece vários recursos para facilitar a visualização do texto impresso pelo projeto (e pelo editor).
Nota
O painel de saída abre automaticamente ao executar um projeto por padrão. Você pode controlar esse comportamento alterando a configuração do editor em Run > Bottom Panel > Action on Play (Executar > Painel Inferior > Ação ao Reproduzir).
Categorias de mensagens
Quatro categorias de mensagem estão disponíveis:
Log: Mensagens padrão impressas pelo projeto. Exibidas em branco ou preto (dependendo do tema do editor).
Error: Mensagens impressas pelo projeto ou editor que indicam uma falha de algum tipo. Exibidas em vermelho.
Warning: Mensagens impressas pelo projeto ou editor que relatam informações importantes, mas não indicam uma falha. Exibidas em amarelo.
Editor: Mensagens impressas pelo editor, normalmente destinadas a rastrear ações de desfazer/refazer (undo/redo). Exibidas em cinza.
Filtrando mensagens
Ao clicar nos botões à direita, você pode ocultar certas categorias de mensagens. Isso pode facilitar a busca por mensagens específicas que você está procurando.
Você também pode filtrar as mensagens por seu conteúdo de texto usando a caixa Filter Messages (Filtrar Mensagens) na parte inferior do painel Output.
Limpando mensagens
Ao executar o projeto, as mensagens existentes são limpas automaticamente por padrão. Isso é controlado pela configuração do editor em Run > Output > Always Clear Output on Play (Executar > Saída > Sempre Limpar Saída ao Reproduzir). Além disso, você pode limpar as mensagens manualmente clicando no ícone da "vassoura de limpeza" no canto superior direito do painel Output.
Imprimindo mensagens
Vários métodos estão disponíveis para imprimir mensagens:
print(): Imprime uma mensagem. Este método aceita múltiplos argumentos que são concatenados ao serem impressos. Este método possui variantes que separam os argumentos com tabulações e espaços, respectivamente: printt() e prints().
print_rich(): O mesmo que
print(), mas o BBCode pode ser usado para formatar o texto impresso (veja abaixo).push_error(): Imprime uma mensagem de erro. Quando um erro é impresso em um projeto em execução, ele é exibido na aba Debugger > Errors (Depurador > Erros).
push_warning(): Imprime uma mensagem de aviso. Quando um aviso é impresso em um projeto em execução, ele é exibido na aba Debugger > Errors.
For use cases mais complexos, estes podem ser usados:
print_verbose(): O mesmo que
print(), mas só imprime quando o modo detalhado (verbose) está ativado nas Configurações do Projeto ou se o projeto for executado com o argumento de linha de comando--verbose.printerr(): O mesmo que
print(), mas imprime no fluxo de erro padrão (standard error) em vez da string de saída padrão.push_error()deve ser preferido na maioria dos casos.printraw(): O mesmo que
print(), mas imprime sem uma linha em branco no final. Este é o único método que não imprime no painel Output do editor. Ele imprime apenas no fluxo de saída padrão (standard output), o que significa que ainda é incluído no registro de arquivos.print_debug(): O mesmo que
print(), mas adiciona o quadro de pilha (stack frame) atual em uma nova linha no final. Suportado apenas quando executado a partir do editor ou quando o projeto é exportado em modo de depuração.print_stack(): Imprime um rastreamento de pilha (stack trace) a partir do local atual. Suportado apenas quando executado a partir do editor ou quando o projeto é exportado em modo de depuração.
print_tree(): Imprime a árvore de cena relativa ao nó atual. Útil para depurar estruturas de nós criadas em tempo de execução.
print_tree_pretty(): O mesmo que
print_tree(), mas com caracteres Unicode para uma aparência mais semelhante a uma árvore. Isso depende de caracteres de desenho de caixa, por isso pode não ser renderizado corretamente em todas as fontes.
To obter recursos de formatação mais avançados, considere usar Formatação de Strings em GDScript junto com as funções de impressão acima.
Ver também
As facilidades de registro de log da engine são abordadas na documentação de logging.
Imprimindo rich text
Usando print_rich(), você pode imprimir texto formatado (rich text) no painel Output do editor e na saída padrão (visível quando o usuário executa o projeto a partir de um terminal). Isso funciona convertendo o BBCode em códigos de escape ANSI que o terminal entende.
Na saída do editor, todas as tags BBCode são reconhecidas normalmente. Na saída do terminal, apenas um subconjunto de tags BBCode funcionará, conforme documentado na descrição do método print_rich() vinculado acima. No terminal, as cores parecerão diferentes dependendo do tema do usuário, enquanto as cores no editor usarão as mesmas cores que usariam no projeto.
Nota
O suporte aos códigos de escape ANSI varia entre os emuladores de terminal. As cores exatas exibidas na saída do terminal também dependem do tema do terminal escolhido pelo usuário.