画面画像を取得 (screen.image)

宣言

画像 = screen.image([ 左端, 上端, 右端, 下端 ])

パラメータ

• 左端、上端、右端、下端
  整数。省略可能です。画像の領域を指定します。デフォルトは画面全体です

戻り値

• 画像
  画像オブジェクト。画像オブジェクトを返します。使用方法は 画像オブジェクトモジュール (image) を参照してください

説明

画面の指定領域または画面全体の画像を取得します
この関数の座標値パラメータは、screen.init 関数で初期化された座標系の影響を受けます
このメソッドは新しい画像オブジェクトを生成します。頻繁に効率よく使用するには、image:destroy メソッドと併用してください

例

-- screen.image のコード例です
--
screen.image():save_to_album() -- 画面全体のスクリーンショットを撮影してアルバムに保存します
--
screen.image():save_to_png_file("/var/mobile/1.png") -- 画面全体のスクリーンショットを撮影してファイル /var/mobile/1.png に保存します
--
screen.image(100, 100, 200, 200):save_to_album() -- 左上座標が 100, 100、右下座標が 200, 200 の領域を撮影してアルバムに保存します
--
pasteboard.write(screen.image(100, 100, 200, 200):png_data(), "public.png")
-- 左上座標が 100, 100、右下座標が 200, 200 の領域を撮影してクリップボードへ書き込みます

注記：上記のコードでは、この章で扱わない関数 :save_to_album、:save_to_png_file、:png_data、pasteboard.write を使用しています