Metadata-Version: 2.1
Name: pydmsoft
Version: 1.0.1
Summary: A Simple python Wrapper for DM
Home-page: https://github.com/130347665/PyDmSoft
Author: Relaxing
Author-email: bneson901203@yahoo.com.tw
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# 一個使用Python封裝大漠插件的庫

這個模組是為了封裝大漠7.2213版本，並封裝了大漠插件的API，以便讓IDE都可以有代碼提示。

這些方法是從大漠插件DLL的倒出函數，生成的Python方法，因為目前沒有看到封裝比較完整python調用大漠的Libary，便有了這個。

## 安裝

```pip install pydmsoft```

## 功能
### 初始化
```
# 已在系統註冊大漠調用
dm = DM()
# 使用免註冊調用 只需要在第一次調用一次即可 其餘的可直接使用 dm=DM()
dm = DM(DmRegPath="path_to_dmreg.dll", DMPath="path_to_dm.dll")
```
### 導入
```from pydmsoft import DM```
## 使用範例
1. 註冊
   ```
   dm = DM()
   result = dm.Reg(code, Ver)
   print(result)
   ```

2. OCR 辨識
    ```
    dm = DM()
    result = dm.Ocr(0, 0, 100, 100, "ffffff-000000", 0.9)
    print(result)
    ```

3. 尋找文字
    ```
    dm = DM()
    result = dm.FindStr(0, 0, 500, 500, "example", "ffffff-000000", 0.9)
    print(result)
    ```

4. 截圖
    ```
    dm = DM()
    dm.Capture(0, 0, 200, 200, "screenshot.png")
    ```

5. 模擬鍵盤操作
    ```
    dm = DM()
    # 按下 'A' 鍵
    dm.KeyPress(65) 
    ```
6. 部分找圖找色可使用wait_until(等待秒數,間隔)
   ```
    try:
        print(m_dm.Reg('xxxx','xxx'))
        print(m_dm.FindColor(0,0,100,100,"ffffff",0.9,0).wait_until(5))
        print(m_dm.FindColorE(0,0,100,100,"ffffff",0.9,0).wait_until(5))
        print(m_dm.FindMultiColorE(0,0,100,100,"ffffff-000000",0.9,0,0).wait_until(10))
    except TimeOutException as e:
        print(e)
   ```
## 注意事項
請確保大漠的dll檔案和註冊檔案路徑正確。另外，當使用免註冊調用時，需同時提供DmRegPath和DMPath。

## 開發者資訊

這是一個開源的封裝項目，歡迎貢獻及提供建議。

