大族激光打标机接口使用手册V1.2.docxVIP

二次开发软件接口使用手册V1.2

二次开发软件接口使用手册V1.2

第

第PAGE1页共NUMPAGES16页

HANS二次开发软件接口使用手册(V1.2)

版本号

修订日期

修订人

变更记录

1.0

2010.10.10

初版

1.1

2010.12.01

根据富士康需求，增加Unicode、取错误接口.

1.2

2011.02.16

根据定制部门的需求、增加对象及文档操作接口，提

供更丰富的应用

一、 概述

本动态库基于HansLaserMarkingSoftwareV5.3进行开发，用于满足以下情况下一些高级用户的特殊需要。

1、打标系统只是客户系统的一部分，且客户具有较强的开发能力，希望将打标系统完全集成到他们自己的系统中。

2、海外非标准用户，由于存在沟通和出差的问题，使用这种方式可以有效地解决一些自动化应用的问题。

3、其它行业或中心可以基于本动态库开发他们自己的打标系统。本动态库和打标软件一样，只支持EMCC卡。

本动态库采用和Windows相同的API方式导出接口，函数使用stdcall声明，可以供VC++、VB、Delphi、C++Builder、C＃等多种开发工具使用，使用者需要显示调用，显示调用的方法如下：

1、调用WindowsAPI函数LoadLibrary()动态加载DLL。

2、调用WindowsAPI函数GetProcAddress()取得要调用函数的指针。3、用函数指针调用DLL中函数完成相应功能。

4、程序结束或不再使用时，调用WindowsAPI函数FreeLibrary()释放动态库。

软件接口动态库名：HansAdvInterface.dll

软件提供完整安装盘，按照安装步骤安装完成后，即可正常使用，在使用之前，需要进入标准软件进行相关参数的设置，如BOX校正、打标位置校正、激光器设置等。

注：软件接口和打标软件是不能同时使用的，如果打标软件正在使用，通过接口初始化设备时会返回错误码1（另一个程序在运行），这种情况下需要关闭打标软件或校正软件。

二、 返回值及结构体定义

所有函数返回值均为一个整形的通用错误码，码值定义如下

#define

HL_ERR_SUCCESS

0

//成功

#define

HL_ERR_PROGRUN

1

//另一个程序在运行

#define

HL_ERR_PATH

2

//路径不正确

#define

HL_ERR_FAILOPEN

3

//初始化失败

#define

HL_ERR_NOINITIAL

4

//未初始化

#define

HL_ERR_WARNING

5

//报警

#define

HL_ERR_OVERTIME

6

//命令超时

#define

HL_ERR_READFILE

7

//无法读取文件

#define

HL_ERR_NOFINDFONT

8

//指定的字体不存在

#define

HL_ERR_NOPEN

9

//指定的层号不存在

#define

HL_ERR_NOOBJECT

10

//没找到指定的对象

#define

HL_ERR_PARAM

11

//参数非法

#define

HL_ERR_STATUS

12

//错误的状态,当前状态下不能执行此操作

#define

HL_ERR_ALLOCMEMORY

13

//分配内存失败

#define

HL_ERR_OVERRANGE

14

//打标范围超限

#define

HL_ERR_BUFFERSIZE

15

//缓冲区不够

#define

HL_ERR_NULLPTR

16

//空指针

#define

HL_ERR_NODOC

17

//未找到指定文档

#define

HL_ERR_UNKNOWN

100

//未知错误

#define WM_TOUCH_MSG (WM_USER+1095) //主动检测脚踏触发消息

//填充参数结构体定义

structbaseHatch

{

BOOL

bEnable;

//填充使能

BOOL

bEquaDist;

//等间距使能

BOOL

bKeepAngle;

//填充线绕轮廓旋转

int

nFillStyle;

//填充类型

double

dbSpace;

//填充间距

double

dbAngle;

//填充角度

double

dbBeamComp;

//光栅大小

double

dbLineReduce;

//线缩进量

double

dbStartOffset;

//起始缩进量

double

dbEndOffset;

//末尾缩进量

double

dbMinJump;

//最小跳转间距

BOOL

bLoop;

//缩扩使能

int

nLoopNum;