Инициализация повёрнутой системы координат (screen.init)

Объявление

исходная_система_координат = screen.init(система_координат)

Параметры

• Система координат
  Целое число.
  0 — книжная ориентация, кнопка Home внизу.
  1 — альбомная ориентация, кнопка Home справа.
  2 — альбомная ориентация, кнопка Home слева.
  3 — книжная ориентация, кнопка Home сверху.

Возвращаемое значение

• Исходная система координат
  Целое число, система координат, использовавшаяся до вызова этой функции.

Описание

Инициализирует систему координат для получения цвета и нажатий; влияет на смысл параметров координат и возвращаемых значений следующих функций:

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

На примере iPhone 8 (разрешение 750x1334):

Система координат книжной ориентации по умолчанию: screen.init(0)

(0,0) физический левый верхний угол
┌──────────────────────────────────▶ x+ 
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  │
▼ y+                               ▼
                                (750,1334) физический правый нижний угол
┌──────────────────────────────────┐
│               Home               │
└──────────────────────────────────┘

Альбомная ориентация с кнопкой Home справа: screen.init(1)

 (0,0)
   ┌────────────────────────────────────────────────▶ x+ физический правый нижний угол
   │                                                 │   ┌───┐
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │ H │
   │                                                 │   │ o │
   │                                                     │ m │
   │                                                 │   │ e │
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │   │
   │                                                 │   │   │
   │                                                 │   └───┘
   ▼ y+                                              ▼
физический левый верхний угол                     (1334,750)

Альбомная ориентация с кнопкой Home слева: screen.init(2)

      (0,0)
        ┌────────────────────────────────────────────────▶ x+ физический левый верхний угол
┌───┐   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│ H │   │                                                     
│ o │   │                                                 │   
│ m │   │                                                     
│ e │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
└───┘   │                                                 │   
        ▼ y+                                              ▼
     физический правый нижний угол                      (1334,750)

Книжная ориентация с кнопкой Home сверху: screen.init(3)

   ┌──────────────────────────────────┐
   │               Home               │
   └──────────────────────────────────┘
 (0,0) физический правый нижний угол
   ┌──────────────────────────────────▶ x+ 
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  │
   ▼ y+                               ▼
                                  (750,1334) физический левый верхний угол

Пример

screen.init(0)    -- home внизу
screen.init(1)    -- home справа
screen.init(2)    -- home слева
screen.init(3)    -- home сверху

Того же эффекта можно добиться следующими вызовами-синонимами.

screen.init_home_on_bottom()    -- home внизу
screen.init_home_on_right()     -- home справа
screen.init_home_on_left()      -- home слева
screen.init_home_on_top()       -- home сверху