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.

Quando e como evitar o uso de nós para tudo

Nós são baratos de produzir, mas até eles têm os seus limites. Um projeto pode ter dezenas de milhares de nós fazendo coisas. Quanto mais complexo for o seu comportamento, maior será a tensão que cada um adiciona ao desempenho de um projeto.

O Godot fornece objetos mais leves para a criação de APIs que os nós usam. Lembre-se de ter isso em mente como opções ao projetar como deseja construir os recursos do seu projeto.

  1. Object: O supremo objeto leve, o Objeto original deve usar gerenciamento manual de memória. Dito isso, não é muito difícil criar suas próprias estruturas de dados personalizadas, mesmo estruturas de nós, que também são mais leves que a classe Node.

    • Exemplo: Veja o nó Tree. Ele suporta um alto nível de personalização para uma tabela de conteúdo com quantidade arbitrária de linhas e colunas. No entanto, os dados usados para gerar sua visualização são, na verdade, uma árvore de objetos TreeItem.

    • Vantagens: A simplificação da API para objetos com escopo menor ajuda a melhorar sua acessibilidade e melhorar o tempo de iteração. Ao invés de trabalhar com toda a biblioteca de Nós, cria-se um conjunto abreviado de Objetos a partir dos quais um nó pode gerar e gerenciar os sub-nós apropriados.

    Nota

    Deve-se ter cuidado ao manuseá-los. É possível armazenar um Objeto em uma variável, mas essas referências podem se tornar inválidas sem aviso prévio. Por exemplo, se o criador do objeto decidir excluí-lo do nada, isso acionaria um estado de erro no próximo acesso.

  2. RefCounted: Apenas um pouco mais complexo que o Object. Eles rastreiam referências a si mesmos, excluindo a memória carregada apenas quando não existirem mais referências a eles. Eles são úteis na maioria dos casos em que se necessita de dados em uma classe personalizada.

    • Exemplo: Veja o objeto FileAccess. Ele funciona exatamente como um Object regular, exceto que não é necessário que a própria pessoa o exclua.

    • Vantagens: o mesmo que o Objeto.

  3. Resource: Apenas um pouco mais complexo que RefCounted. Possui a capacidade nativa de serializar e desserializar (ou seja, salvar e carregar) suas propriedades em arquivos de recurso do Godot.

    • Exemplo: Scripts, PackedScene (para arquivos de cena) e outros tipos como cada uma das classes AudioEffect. Todos eles podem ser salvos e carregados; portanto, herdam de Resource.

    • Vantagens: Muito já foi dito sobre as vantagens de Resource em comparação aos métodos tradicionais de armazenamento de dados. No contexto do uso de Resources em vez de Nodes, sua principal vantagem é a compatibilidade com o Inspetor. Embora sejam quase tão leves quanto Object/RefCounted, ainda podem exibir e exportar propriedades no Inspetor. Isso lhes permite cumprir um papel semelhante ao de subnós em termos de usabilidade, além de melhorar o desempenho caso se planeje utilizar muitos desses Resources/Nodes em uma cena.