Suporte para vários formatos e tamanhos de tela

Este documento descreve como oferecer suporte a vários formatos e tamanhos de tela ao usar o Godot para o desenvolvimento de jogos Android.

Os dispositivos Android têm vários formatos e tamanhos de tela. Estas são algumas das categorias comuns:

  • Smartphones
  • Dispositivos dobráveis
  • Tablets
  • Televisores e conversores
  • Laptops com Android Runtime para Chrome

Essa variedade significa que seu jogo encontrará diversas resoluções de tela diferentes. Essas resoluções da tela geralmente têm proporções diferentes. Por exemplo:

  • Um smartphone na orientação paisagem com uma proporção de 19:9 (2.280 x 1.080)
  • Um smartphone diferente na orientação paisagem com proporção de 20:9 (3.200 x 1.400).
  • Uma tela interna desdobrada com proporção de 1:1 (2106 x 2106) ou 4:3 (2688 x 2016)
  • Uma televisão de alta definição de 1.080p com proporção de 16:9 (1.920 x 1.080)
  • Um tablet com proporção 4:3 (2.048 x 1.536)

O design do jogo precisa considerar essas diferenças para garantir uma apresentação correta, independentemente da resolução da tela, da proporção do dispositivo e do método de entrada do usuário.

Resolução da tela

O Godot define o tamanho e a resolução da tela usando pixels. Recomendamos que você defina uma resolução básica padrão para os projetos do Godot. O Godot tem configurações para controlar o comportamento quando as resoluções de tela são diferentes da resolução base do projeto.

Como definir a resolução básica

Para definir uma resolução básica em um projeto aberto no editor do Godot, execute as seguintes etapas:

  1. Selecione Project > Configurações do projeto na barra de menus do Godot.
  2. Na janela Configurações do projeto, encontre a lista Display na guia Category e selecione o item Window.
  3. Na categoria Size, defina os campos Width e Height como a resolução de base que você quer, medida em pixels.
Configurações de projeto para largura e altura do Godot
Figura 1. Os campos Largura e Altura em Configurações do projeto

Quando o editor do Godot é definido como visualização em 2D, ele exibe um retângulo de guia correspondente à resolução básica. A resolução básica é usada como dimensões padrão da janela do projeto durante a execução de um projeto ou uma cena do editor.

O retângulo com resolução básica na visualização em 2D do editor do Godot
Figura 2. O retângulo de resolução base na visualização 2D do editor do Godot com a resolução base definida como 640 x 360 pixels

Configurações de alongamento

Duas configurações controlam como a resolução base é ajustada quando ela é diferente da resolução da tela: Modo de alongamento e Aspecto de alongamento. Essas configurações estão na janela Project Settings, na seção Display > Window.

Configurações de alongamento do projeto do Godot
Figura 3. Os campos Stretch Mode e Stretch Aspect em Configurações do Projeto

O Stretch Mode tem três configurações: disabled, 2d e viewport. A próxima seção inclui exemplos visuais de diferentes configurações de Proporção de alongamento e Modo de alongamento. Todos os exemplos usam uma resolução básica de projeto de 320 x 180 pixels.

A configuração disabled não redimensiona nem ajusta a resolução de base. O valor de Aspecto de alongamento é sempre ignorado se o Modo de alongamento estiver definido como disabled.

Stretch Mode desativado com resolução de tela de 320 x 180
Figura 4. Modo de alongamento disabled com uma resolução de tela de 320 x 180

Se a resolução da tela for menor que a resolução base, as bordas inferior, direita ou ambas serão cortadas.

Stretch Mode desativado com resolução de tela de 256 x 128
Figura 5. Modo de alongamento disabled com uma resolução de tela de 256 x 128

Se a resolução de tela for maior que a resolução básica, a região extra será deixada em branco.

Stretch Mode desativado com resolução de tela de 512 x 256
Figura 6. Modo de alongamento disabled com uma resolução de tela de 512 x 256

A configuração 2d dimensiona a resolução básica para a resolução da tela. Para projetos que usam arte 2D, isso resulta em artefatos de dimensionamento, porque não há mais uma proporção de pixel de 1:1 entre a resolução de base e de exibição. Essa configuração pode ser adequada para determinados estilos de arte de alta resolução em projetos em que a renderização perfeita de pixels não é necessária.

A configuração Stretch Aspect especifica as restrições aplicadas ao escalonamento para manter a proporção da resolução básica. As opções de configuração de Proporção de alongamento são descritas na seção "Proporção". Confira abaixo exemplos da configuração 2d Modo de alongamento usando um Aspecto de alongamento de ignore, que é dimensionado para a resolução da tela sem restrições:

Stretch Mode 2D com resolução de tela de 256 x 128
Figura 7. Modo de alongamento 2d com uma resolução de tela de 256 x 128
Stretch Mode 2D com resolução de tela de 512 x 256
Figura 8. Modo de alongamento 2d com uma resolução de tela de 512 x 256

A configuração viewport define o Viewport da cena raiz como a resolução base. A saída renderizada do Viewport raiz é dimensionada para a resolução da tela. Os objetos Viewport do Godot são usados para criar visualizações na tela ou subvisualizações dentro de outro Viewport. Ao contrário da configuração 2d, a viewport não aplica filtragem ao dimensionar para a resolução da tela. A configuração viewport também usa o valor de Stretch Aspect para determinar se as restrições são aplicadas ao dimensionamento para preservar a proporção. A configuração viewport é uma opção melhor do que 2d quando é necessária uma precisão perfeita de pixels, já que a renderização principal ainda ocorre na resolução de base. Confira abaixo exemplos da configuração viewport do Modo de alongamento usando um Aspecto de alongamento de ignore:

Janela de visualização de Stretch Mode com resolução de tela de 256 x 128
Figura 9. Modo de alongamento viewport com uma resolução de tela de 256 x 128
Janela de visualização de Stretch Mode com resolução de tela de 512 x 256
Figura 10. Modo de alongamento viewport com uma resolução de tela de 512 x 256

Proporção

O Stretch Aspect tem várias opções para restringir o escalonamento de proporção. Se Stretch Aspect estiver definido como ignore, nenhuma restrição será aplicada. Quando Stretch Aspect é definido como keep, a resolução base é dimensionada para as maiores dimensões possíveis que se ajustam à resolução da tela, mantendo a proporção original. As regiões da tela que não são cobertas pela imagem dimensionada são preenchidas com barras pretas. Dependendo da dimensão dominante da diferença de proporção, as barras serão horizontais, isto é, com efeito letterbox, ou verticais, com efeito pillarbox.

Janela de visualização do Stretch Mode, Stretch Aspect keep, com resolução de tela de 384 x 256
Figura 11. Modo de alongamento viewport, proporção de alongamento keep, com uma resolução de tela de 384 x 256
Janela de visualização do Stretch Mode, Stretch Aspect keep, com resolução de tela de 512 x 200
Figura 12. Modo de alongamento viewport, proporção de alongamento keep, com uma resolução de tela de 512 x 200

O Stretch Aspect inclui duas variantes da configuração keep: keep_width e keep_height. Quando keep_width é definido, o efeito pillarbox é adicionado se a resolução da tela tem uma proporção maior que a resolução de base. No entanto, se a resolução da tela tiver uma proporção mais alta do que a básica, a área extra ficará vazia. A região vazia preenche a parte inferior da tela.

Janela de visualização do Stretch Mode, Stretch Aspect keep_width, com resolução de tela de 512 x 384
Figura 13. Modo de alongamento viewport, Aspecto de alongamento keep_width, com uma resolução de tela de 512 x 384

A configuração keep_height funciona na direção horizontal em vez da direção vertical. A região vazia preenche o lado direito da tela.

Janela de visualiação do Stretch Mode, Stretch Aspect keep_height, com resolução de tela de 512 x 200
Figura 14. Modo de alongamento viewport, proporção de alongamento keep_height, com uma resolução de tela de 512 x 200

A configuração final de Stretch Aspect é expand. A configuração expand mantém a proporção da resolução de base, mas deixa a região excedente vazia em vez de usar letterbox ou pillarbox.

Janela de visualização do Stretch Mode, Stretch Aspect expand, com resolução de tela de 384 x 256
Figura 15. Modo de alongamento viewport, proporção de alongamento expand, com uma resolução de tela de 384 x 256
Janela de visualização do Stretch Mode, Stretch Aspect expand, com resolução de tela de 512 x 256
Figura 16. Modo de alongamento viewport, Aspecto de alongamento expand, com uma resolução de tela de 512 x 256

Âncoras

O posicionamento dos elementos da interface exige considerações adicionais ao oferecer suporte a várias resoluções de tela. Por exemplo, o uso de coordenadas absolutas de pixel para colocar um controle no canto superior direito resulta em um posicionamento inconsistente em dispositivos com diferentes resoluções horizontais. O sistema de interface do Godot é compatível com o posicionamento relativo com as propriedades Anchor e Margin. As propriedades Anchor de um elemento da interface especificam um ponto de fixação no objeto de controle pai ou na janela de visualização. Os valores das propriedades Margin são usados para deslocar o controle em relação ao ponto de fixação.

Um objeto precisará derivar do objeto Godot Control se for incluir as propriedades Anchor e Margin. Todos os elementos da interface padrão do Godot derivam de Control. Os campos de propriedade de Anchor e Margin aparecem na guia Inspector quando um objeto derivado de Control é selecionado no editor do Godot.

Um controle de botão selecionado com as propriedades de Anchor e Margin visíveis no inspetor
Figura 17. Um controle Button selecionado, com as propriedades Anchor e Margin visíveis no inspetor

O Godot tem uma ferramenta Layout que pode definir rapidamente as propriedades Anchor, Margin e Size para os valores predefinidos comumente usados. Quando um objeto derivado de Control é selecionado no editor, o menu suspenso Layout fica disponível na barra de ferramentas acima da visualização de cena. As predefinições da ferramenta Layout incluem posicionamento e posicionamento combinado com tamanho. As predefinições de posicionamento são compatíveis com casos de uso como: centralizado, ancoragem no canto superior direito, ancoragem na parte central esquerda. As predefinições de posicionamento mais tamanho incluem casos de uso como ancoragem na parte inferior e, ao mesmo tempo, toda a extensão da largura do pai.

Menu suspenso de layout de editor do Godot
Figura 18. Menu suspenso Layout do editor do Godot

Âncoras são adequadas para casos de uso comuns, como avisos na tela, solicitações na tela ou caixas de diálogo básicas. O sistema de contêineres do Godot é destinado a layouts de interface mais sofisticados, como ao exibir janelas ou caixas de diálogo com um grande número de controles ou ao redimensionar conteúdo de forma dinâmica.

Campo de visão

O Godot tem configurações de campo de visão que controlam a apresentação de uma cena 3D em diferentes proporções. Os ajustes de campo de visão são controlados pela propriedade Keep Aspect de um objeto Camera. O valor padrão de Keep Height é destinado a projetos executados em orientação paisagem. Keep Height se ajusta a um campo de visão mais amplo ou mais estreito quando as proporções da resolução base e da resolução da tela são diferentes. A configuração Keep Width é melhor para projetos executados na orientação retrato. Keep Width se ajusta a um campo de visão mais alto ou mais baixo com base na diferença na proporção.

Controle da janela de visualização

Os objetos Viewport fornecem controle detalhado sobre a proporção e o escalonamento. Os projetos podem usar janelas de visualização para realizar operações como:

  • renderizar uma cena na proporção de resolução básica com uma borda independente de resolução;
  • renderizar uma cena 3D com resolução reduzida para melhorar o desempenho e exibi-la na resolução nativa de alta qualidade;
  • renderizar visualizações esquerda e direita de uma cena para aplicativos de RV;
  • gerar texturas dinâmicas.

Para ver exemplos que demonstram como usar o objeto Viewport, consulte os exemplos de Viewport do Godot (link em inglês).

Entrada do usuário

Alguns designs de jogos não são compatíveis com todos os modos de entrada aceitos pelo Android. Os jogos compatíveis com gestos multitoque costumam ter problemas para adicionar compatibilidade com a entrada de controles de jogos e de mouse. Os jogos projetados para entrada de controles de jogos podem ter dificuldades em implementar controles por toque eficazes. O Godot é compatível com todas essas formas de entrada. No entanto, você precisa decidir no início do desenvolvimento quais métodos de entrada pretende usar no projeto e fazer o design adequado.

Para projetos em que a entrada de toque e a entrada do mouse são intercambiáveis, o Godot inclui opções de proxy que geram eventos de toque emulados de eventos de mouse ou eventos de mouse emulados de eventos de toque. Essas opções eliminam a necessidade de escrever um código de processamento de entrada separado para eventos de mouse e toque. Há duas opções disponíveis: Emulate Touch from Mouse e Emulate Mouse from Touch. As duas opções estão localizadas em Project Settings, em Input Devices > Pointing.

Configurações do projeto Godot para dispositivos de entrada
Figura 19. As configurações de Dispositivos de entrada > Apontamento em Configurações do projeto

Outros recursos