Rotationskoordinatensystem initialisieren (screen.init)

Deklaration

ursprüngliches_koordinatensystem = screen.init(koordinatensystem)

Parameter

• Koordinatensystem
  Ganzzahl
  0 bedeutet Hochformat mit Home unten.
  1 bedeutet Querformat mit Home rechts.
  2 bedeutet Querformat mit Home links.
  3 bedeutet Hochformat mit Home oben.

Rückgabewert

• Ursprüngliches Koordinatensystem
  Ganzzahl; gibt das vor diesem Funktionsaufruf verwendete Koordinatensystem zurück

Beschreibung

Initialisiert das Koordinatensystem für Farbabfragen oder Tippen und beeinflusst die Bedeutung der Koordinatenparameter und Rückgabewerte folgender Funktionen:

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

Am Beispiel eines iPhone 8 (Auflösung 750x1334):

Das standardmäßige Hochformat-Koordinatensystem sieht so aus: screen.init(0)

(0,0) physisch oben links
┌──────────────────────────────────▶ x+ 
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  │
▼ y+                               ▼
                                (750,1334) physisch unten rechts
┌──────────────────────────────────┐
│               Home               │
└──────────────────────────────────┘

Querformat mit Home rechts sieht so aus: screen.init(1)

 (0,0)
   ┌────────────────────────────────────────────────▶ x+ physisch unten rechts
   │                                                 │   ┌───┐
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │ H │
   │                                                 │   │ o │
   │                                                     │ m │
   │                                                 │   │ e │
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │   │
   │                                                 │   │   │
   │                                                 │   └───┘
   ▼ y+                                              ▼
physisch oben links                                        (1334,750)

Querformat mit Home links sieht so aus: screen.init(2)

      (0,0)
        ┌────────────────────────────────────────────────▶ x+ physisch oben links
┌───┐   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│ H │   │                                                     
│ o │   │                                                 │   
│ m │   │                                                     
│ e │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
└───┘   │                                                 │   
        ▼ y+                                              ▼
     physisch unten rechts                                        (1334,750)

Hochformat mit Home oben sieht so aus: screen.init(3)

   ┌──────────────────────────────────┐
   │               Home               │
   └──────────────────────────────────┘
 (0,0) physisch unten rechts
   ┌──────────────────────────────────▶ x+ 
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  │
   ▼ y+                               ▼
                                  (750,1334) physisch oben links

Beispiel

screen.init(0)    -- Home unten
screen.init(1)    -- Home rechts
screen.init(2)    -- Home links
screen.init(3)    -- Home oben

Aufrufe mit den folgenden Aliasen erzielen denselben Effekt.

screen.init_home_on_bottom()    -- Home unten
screen.init_home_on_right()     -- Home rechts
screen.init_home_on_left()      -- Home links
screen.init_home_on_top()       -- Home oben