Inicializar o sistema de coordenadas rotacionado (screen.init)

Declaração

sistema_de_coordenadas_anterior = screen.init(sistema_de_coordenadas)

Parâmetros

• sistema de coordenadas
  Inteiro.
  0 significa orientação vertical com o Home embaixo.
  1 significa orientação horizontal com o Home à direita.
  2 significa orientação horizontal com o Home à esquerda.
  3 significa orientação vertical com o Home em cima.

Valor retornado

• sistema de coordenadas anterior
  Inteiro; retorna o sistema de coordenadas usado antes desta chamada.

Observações

Inicializa o sistema de coordenadas usado para obter cores ou tocar na tela; isso afeta o significado dos parâmetros de coordenadas e valores retornados das funções abaixo:

screen.get_color
screen.is_colors
screen.find_color
screen.ocr_text
screen.image
touch.on
touch.move
touch.off
touch.tap

Usando um iPhone 8 como exemplo (resolução 750x1334):

O sistema de coordenadas vertical padrão é assim: screen.init(0)

(0,0) canto superior esquerdo físico
┌──────────────────────────────────▶ x+ 
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  │
▼ y+                               ▼
                                (750,1334) canto inferior direito físico
┌──────────────────────────────────┐
│               Home               │
└──────────────────────────────────┘

Na orientação horizontal com o Home à direita, fica assim: screen.init(1)

 (0,0)
   ┌────────────────────────────────────────────────▶ x+ canto inferior direito físico
   │                                                 │   ┌───┐
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │ H │
   │                                                 │   │ o │
   │                                                     │ m │
   │                                                 │   │ e │
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │   │
   │                                                 │   │   │
   │                                                 │   └───┘
   ▼ y+                                              ▼
canto superior esquerdo físico                   (1334,750)

Na orientação horizontal com o Home à esquerda, fica assim: screen.init(2)

      (0,0)
        ┌────────────────────────────────────────────────▶ x+ canto superior esquerdo físico
┌───┐   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│ H │   │                                                     
│ o │   │                                                 │   
│ m │   │                                                     
│ e │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
└───┘   │                                                 │   
        ▼ y+                                              ▼
     canto inferior direito físico                    (1334,750)

Na orientação vertical com o Home em cima, fica assim: screen.init(3)

   ┌──────────────────────────────────┐
   │               Home               │
   └──────────────────────────────────┘
 (0,0) canto inferior direito físico
   ┌──────────────────────────────────▶ x+ 
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  │
   ▼ y+                               ▼
                                  (750,1334) canto superior esquerdo físico

Exemplo

screen.init(0)    -- Home embaixo
screen.init(1)    -- Home à direita
screen.init(2)    -- Home à esquerda
screen.init(3)    -- Home em cima

As chamadas dos aliases abaixo produzem o mesmo efeito:

screen.init_home_on_bottom()    -- Home embaixo
screen.init_home_on_right()     -- Home à direita
screen.init_home_on_left()      -- Home à esquerda
screen.init_home_on_top()       -- Home em cima