1、接口初始化:
函數(shù):ZL_Initialization
功能:接口初始化
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:在接口程序運(yùn)行開始的時(shí)候運(yùn)行一次。
參數(shù)說明:
名稱 | 類型 | 釋義 | 備注 |
programDir | string | 中瑯條碼標(biāo)簽打印軟件程序目錄 | 如:d:\中瑯條碼標(biāo)簽打印軟件\ |
2、打開文檔
函數(shù):ZL_OpenDoc
功能:打開現(xiàn)有標(biāo)簽文檔
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:支持舊版標(biāo)簽文檔。
參數(shù)說明:
名稱 | 類型 | 釋義 | 備注 |
filePath | String | 標(biāo)簽文檔路徑 | 后綴名:zhl 或 lp |
password | String | 標(biāo)簽文檔打開密碼 | 可以為null或空值 |
3、獲取文檔總頁數(shù):
函數(shù):ZL_GetTotalPages
功能:獲取指定文檔總頁數(shù)。
返回值:總頁數(shù)(-1為失??;其它為頁數(shù))。類型:int
備注:無。
參數(shù)說明:
名稱 | 類型 | 釋義 | 備注 |
filePath | string | 標(biāo)簽文檔路徑 | 后綴名:zhl 或 lp,為null或空值時(shí)僅打開軟件主窗口 |
password | string | 標(biāo)簽文檔打開密碼 | 可以為null或空值 |
4、獲取文檔尺寸:
函數(shù):ZL_GetPageSize
功能:按照指定DPI獲取文檔尺寸。
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:無。
參數(shù)說明:
名稱 | 類型 | 釋義 | 備注 |
xDPI | int | 進(jìn)紙方向DPI |
|
yDPI | int | 噴頭方向DPI |
|
width | int& [out] | 文檔寬度 | 單位:點(diǎn) |
height | int& [out] | 文檔高度 | 單位:點(diǎn) |
5、設(shè)置接收RIP數(shù)據(jù)的回調(diào)
設(shè)置回調(diào):ZL_SetRIPReadCallback
功能:接收RIP數(shù)據(jù)
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:請?jiān)谡{(diào)用輸出指令前一次性設(shè)置。
回調(diào)聲明:
void (*pRIPReadFun)(byte* ripData, int dataLen, int lineByteWidth, int imageWidth, int imageHeight, int pageIndex, char* text, int effectPts);
回調(diào)備注:ripData行數(shù)據(jù)做了32bit對齊;pageIndex為當(dāng)前輸出頁序列,不是頁碼。
回調(diào)參數(shù)說明:
名稱 | 類型 | 釋義 | 備注 |
ripData | byte* | RIP數(shù)據(jù)數(shù)組 | 整圖RIP數(shù)據(jù) |
dataLen | int | RIP數(shù)據(jù)數(shù)組長度 |
|
lineByteWidth | int | 32bit對齊后的每行寬度 | 單位:byte |
imageWidth | int | 圖像寬度 | 單位:點(diǎn) |
ImageHeight | int | 圖像高度 | 單位:點(diǎn) |
pageIndex | int | 當(dāng)前輸出頁序列 | 從0開始 |
text | char* | 當(dāng)前標(biāo)簽數(shù)據(jù)內(nèi)容 |
|
effectPts | int | 有效點(diǎn)數(shù)量 | 當(dāng)前頁有效點(diǎn)數(shù)量 |
6、啟動(dòng)RIP輸出
函數(shù):ZL_OutputToRIP
功能:啟動(dòng)RIP輸出
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:無。
參數(shù)說明:
名稱 | 類型 | 釋義 | 備注 |
startPage | int | 起始頁碼 | 從1開始,小于結(jié)束頁碼 |
endPage | int | 結(jié)束頁碼 | 從1開始,大于起始頁碼 |
xDPI | int | 進(jìn)紙方向DPI |
|
yDPI | int | 噴頭方向DPI |
|
printUnitWidth | double | 噴頭寬度 | 單位:mm |
colorCount | int | 顏色種類 | 黑白:1;彩色:4 |
colorDepth | int | 色深(bit) | 可選值:1、2 |
threshold | int | 顏色閾值 | 最小值0,最大值100 |
isCustomOutput | bool | 自定義輸出開關(guān) | true:允許程序修改某個(gè)圖形的數(shù)據(jù) flase:根據(jù)標(biāo)簽數(shù)據(jù)源輸出。 |
7、設(shè)置接收RGB數(shù)據(jù)的回調(diào)
設(shè)置回調(diào):ZL_SetRGBReadCallback
功能:接收RGB數(shù)據(jù)
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:請?jiān)谡{(diào)用輸出指令前一次性設(shè)置。
回調(diào)聲明:
void (*pRGBReadFun)(byte* rgbData, int dataLen, int imageWidth, int imageHeight, int pageIndex, char* text);
回調(diào)備注:rgbData行數(shù)據(jù)未做32bit對齊;pageIndex為當(dāng)前輸出頁序列,不是頁碼。
回調(diào)參數(shù)說明:
名稱 | 類型 | 釋義 | 備注 |
rgbData | byte* | RGB數(shù)據(jù)數(shù)組 | 整圖RGB數(shù)據(jù) |
dataLen | int | RGB數(shù)據(jù)數(shù)組長度 |
|
imageWidth | int | 圖像寬度 | 單位:點(diǎn) |
ImageHeight | int | 圖像高度 | 單位:點(diǎn) |
pageIndex | int | 當(dāng)前輸出頁序列 | 從0開始 |
text | char* | 當(dāng)前標(biāo)簽數(shù)據(jù)內(nèi)容 |
|
8、啟動(dòng)RGB輸出
函數(shù):ZL_OutputToRGB
功能:啟動(dòng)RGB輸出
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:無。
參數(shù)說明:
名稱 | 類型 | 釋義 | 備注 |
startPage | int | 起始頁碼 | 從1開始,小于結(jié)束頁碼 |
endPage | int | 結(jié)束頁碼 | 從1開始,大于起始頁碼 |
xDPI | int | 進(jìn)紙方向DPI |
|
yDPI | int | 噴頭方向DPI |
|
isCustomOutput | bool | 自定義輸出開關(guān) | true:允許程序修改某個(gè)圖形的數(shù)據(jù) flase:根據(jù)標(biāo)簽數(shù)據(jù)源輸出。 |
9、停止輸出
函數(shù):ZL_StopOutput
功能:停止輸出
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:支持舊版標(biāo)簽文檔。
參數(shù)說明:無參數(shù)
10、關(guān)閉文檔
函數(shù):ZL_CloseDoc
功能:關(guān)閉標(biāo)簽文檔
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:非必須操作。
參數(shù)說明:無參數(shù)。
11、釋放資源
函數(shù):ZL_Release
功能:釋放接口占用資源
返回值:成功/失敗。類型:eRET(詳見附錄一:返回值eRET)
備注:在接口程序退出前運(yùn)行一次。
參數(shù)說明:無參數(shù)。
附錄一:返回值eRET
類型:enum
成員列表:
名稱 | 值(Int) | 釋義 | 備注 |
RET_OK | 0 | 執(zhí)行成功 |
|
RET_ERROR | -1 | 執(zhí)行失敗 |
|
標(biāo)簽:可變數(shù)據(jù)軟件 , 外部程序調(diào)用接口 , RIP
共有條評論 網(wǎng)友評論