腳本編撰
========

腳本編撰方式有三大類，您可選擇下述單一方式製作腳本，亦或使用三種編撰方式於同一腳本中 

 - :ref:`文字編輯<Script_var>` 

 - :ref:`操作錄製<Script_rec>` 

 - :ref:`圖形辨識<Script_img>` 

 
   
.. _scripts_editor_page: 
 
此頁面將為您介紹使用各編撰操作指南，再進入編撰方式前，Scripts 操作介面如下


.. _Script_toolbar:

工具列
--------
此區域新建、儲存及導入腳本，所選項目將於下方編輯區域中顯示

腳本基本設定
+++++++++++++++

 .. figure:: Images/scripts/3setting.png
    :width: 500
    :alt: Script setting
    :align: center  

    點擊上排Settings介面

.. _Script_new:

創建腳本
+++++++++++
 點擊New可新增全新Scripts,刷新編輯區畫面前，系統將詢問原編輯腳本是否須儲存

 .. tip::
        
    | 1. 點擊 **Cancel** 將回到原編輯區
    | 2. 點擊 **OK** 現編輯檔案將被刪除
    | 3. 若希望原編輯檔案被儲存再新增一全新腳本，請點擊 **Cancel** 後返回編輯頁面再 :ref:`儲存腳本<Script_save>`



 .. figure:: Images/scripts/4new.png
    :width: 500 
    :alt: New Script
    :align: center  

    點擊上排New 新建頁面將跳出視窗     



.. _Script_load:

導入腳本
+++++++++++
 點擊Load可導入Scripts,請選擇存放資料夾，並請注意有效的儲存檔案型態為 xxx.bks （xxx為檔名） 

 .. figure:: Images/scripts/5load.png
    :width: 500 
    :alt: Load Script
    :align: center  

    點擊上排Load 能夠導入您的於電腦上已儲存腳本     


.. _Script_save:

儲存腳本
+++++++++++
 點擊Save可儲存正在編輯Scripts,請輸入檔名並選擇存放資料夾，當需使用時可點擊 :ref:`導入腳本<Script_load>` 即可執行

 .. tip::
        
    輸入檔案名稱須以 **英文及數字** 編輯操作


 .. figure:: Images/scripts/6save.png
    :width: 500
    :alt: Load Script
    :align: center  

    點擊上排Load 導入您於電腦上已儲存腳本     


釋放記憶體
+++++++++++
 點擊Clean可釋放非本scripts使用資源，如 :ref:`導入腳本<Script_img>` 時鐘計時範例，啟動前進行幾次擷取及刪除步驟，造成不堪用資源仍留置記憶體內，此時即可使用 Clean鍵刪除不堪用資源

 .. error::
        
    點擊 Clean非腳本編輯頁面清空，若您需刷新畫面，請點擊 :ref:`創建腳本<Script_new>` 

 .. figure:: Images/scripts/9clean.png
    :width: 500
    :alt: clean Script resouce
    :align: center  

    點擊上排Clean 系統自動偵測不堪用資源     



圖形介面
+++++++++++++
 點擊View可幫助檢視錄製或擷取之圖案，如 :ref:`導入腳本<Script_img>` 時鐘計時範例，點擊View即可檢視腳本中已擷取圖形


 .. figure:: Images/scripts/7view.png
    :width: 500
    :alt: view Script img
    :align: center  

    點擊上排View 系統顯示已擷取或錄製之圖形     

執行次數
+++++++++++++
 右上角Loop為可配置腳本的執行參數，您可設定1-9999次或無限循環



.. figure:: Images/scripts/12Loop.gif
   :width: 500
   :alt: Loop Script
   :align: center  

   執行次數調整為5次   


內容編撰
--------

.. _Script_rec:

操作錄製
+++++++++++++
 點擊Rec.可進入腳本錄製功能，再次點擊 *R-Stp* 前您的每一個點擊、拖曳及暫停都將被紀錄至腳本運行
 
 .. tip::
        
   |  畫面右上角藍色及綠色進度bar與編輯區左邊框同步，您可隨時查看腳本執行進度

 .. figure:: Images/scripts/10recording.gif
    :width: 500
    :alt: rec script
    :align: center  

    點擊上排Rec. 系統進入腳本錄製功能     

.. _Script_img:

圖形辨識
+++++++++++
 點擊Img可進入圖形辨識功能，滑鼠左鍵可框出所需須辨識範圍，框框中心X為識別到影像時回報的座標位置（點擊點），若須調整點擊點，可使用滑鼠右鍵拖曳X

 .. figure:: Images/scripts/8img.png
    :width: 500
    :alt: Img Script
    :align: center  

    點擊上排Img 系統開啟腳本圖形辨識功能     

 .. tip::
        
      圖形擷取或錄製後，亦可於已錄製或圖形擷取視窗腳本中增添 :ref:`函數判斷條件<自定義函式>` ，如msleep()，keycode()...等


   .. figure:: Images/scripts/8img.gif
      :width: 550
      :alt: Img Script
      :align: center  

      圖形辨識操作，使計時器能於指定時間內點擊指定位置，最後歸0 

文字編輯
+++++++++++
 此項多為使用Blackey內建函式，請參考 :ref:`文字編輯<內建函式>` 頁面，進行函數型別及指令介紹...等介紹


:ref:`回到頂部<腳本編撰>`