メインコンテンツまでスキップ

回転座標系を初期化する (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 ボタンが上