初始化旋转坐标系 (screen.init)

声明​

原坐标系 = screen.init(坐标系)

参数​

• 坐标系 整数型 0 表示竖屏导航键在下 1 表示横屏导航键在右 2 表示横屏导航键在左 3 表示竖屏导航键在上

返回值​

• 原坐标系 整数型，返回这个函数调用之前使用的坐标系

说明​

初始化取色或点击的坐标系

将会影响以下函数坐标参数及返回值的含义

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

以主流 Android 设备为例 (1080x1920 分辨率)：

默认竖屏坐标系是这样的 screen.init(0)

(0,0) 物理左上角
┌──────────────────────────────────▶ x+ 
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  
│                                  │
│                                  │
▼ y+                               ▼
                                (1080,1920) 物理右下角
┌──────────────────────────────────┐
│          虚拟导航键区域            │
└──────────────────────────────────┘

横屏导航键在右是这样的 screen.init(1)

(0,0)
   ┌────────────────────────────────────────────────▶ x+ 物理右下角
   │                                                 │   ┌───┐
   │                                                     │   │
   │                                                 │   │ 导 │
   │                                                     │ 航 │
   │                                                 │   │ 键 │
   │                                                     │ 区 │
   │                                                 │   │ 域 │
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │   │
   │                                                 │   │   │
   │                                                     │   │
   │                                                 │   │   │
   │                                                 │   └───┘
   ▼ y+                                              ▼
物理左上角                                        (1920,1080)

横屏导航键在左是这样的 screen.init(2)

(0,0)
        ┌────────────────────────────────────────────────▶ x+ 物理左上角
┌───┐   │                                                 │   
│   │   │                                                     
│ 导 │   │                                                 │   
│ 航 │   │                                                     
│ 键 │   │                                                 │   
│ 区 │   │                                                     
│ 域 │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
│   │   │                                                     
│   │   │                                                 │   
└───┘   │                                                 │   
        ▼ y+                                              ▼
     物理右下角                                        (1920,1080)

竖屏导航键在上是这样的 screen.init(3)

┌──────────────────────────────────┐
   │          虚拟导航键区域            │
   └──────────────────────────────────┘
 (0,0) 物理右下角
   ┌──────────────────────────────────▶ x+ 
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  
   │                                  │
   │                                  │
   ▼ y+                               ▼
                                  (1080,1920) 物理左上角

示例​

screen.init(0)    -- 导航键在下（默认竖屏）
screen.init(1)    -- 导航键在右（横屏）
screen.init(2)    -- 导航键在左（横屏）
screen.init(3)    -- 导航键在上（倒置竖屏）

使用以下别名调用也可以实现相同效果

screen.init_home_on_bottom()    -- 导航键在下
screen.init_home_on_right()     -- 导航键在右
screen.init_home_on_left()      -- 导航键在左
screen.init_home_on_top()       -- 导航键在上