二维条码编码平台使用说明书

二维条码编码平台

使用说明书

福州博智成软件开发有限公司

(2012-6-25)

目录

1.使用环境说明 (3)

2.信息排放格式标准 (3)

3.配置文件说明 (5)

4.库函数说明： (6)

5.接口函数说明 (7)

5.1.串口通信接口说明 (7)

5.2.位图压缩接口说明 (7)

5.3.PDF417编码接口说明 (8)

5.4.Q R_C ODE编码接口说明 (9)

5.5.D A TA M ATRIX编码接口说明 (10)

7.应用实例说明 (12)

7.1.M ICROSOFT V ISUAL C++6.0应用 (12)

7.2.M ICROSOFT V ISUAL B ASIC 6.0应用 (16)

8.版权申明 (20)

9.联系方式 (20)

1.使用环境说明

1)发行方式

采用Active X 动态链接库的方式。

2)包括文件：

EnCodePdf.dll //PDF417编码动态链接库

EnCodeQr.dll //Qr_Code编码动态链接库

EnDataMatrix.dll //DataMatrix编码动态链接库

Wcomp.dll //图像压缩动态链接库

3)支持操作系统

Windows 95/98

Windows NT

Windows 2000 Professinal / Server

4)支持开发环境有：

Microsoft Visual C++ 6.0 / .Net

Microsoft Visual Basic 5.0/6.0

Microsoft Visual Foxpro 5.0/6.0

PowerBuilder

Delphi

2.信息排放格式标准

1.

1)信息数据：信息按照文本、图形和其它三种形式依次排放。

2)信息结构：长度8 BYTE，指示信息存放形式、数量。

2.信息结构定义：

infostru {

WORD OtherLength //其它信息长度

WORD PictLength //图形信息长度

WORD TextLength //文本信息长度

CHAR IsKey //是否加密？（Y/N）

CHAR Reserver //标识位

}

说明：

1)若信息长度为0，表示没有该项信息。长度不应超过条码的容量。

2)加密：加密是指对信息数据段内容进行加密，不应包含信息结构段。

3)标识位：为各单位自己设置，作为条码用户标识

3.举例说明：

例如：

当一条码编码包含文本信息50个，包含图像压缩信息700个，其它信息（如指纹特征码）100个，不加密，用户标识位为255，则信息结构InfoStru是：

infostru {

OtherLength=100；//其它信息长度（两个字节）

PictLength=700；//图形信息长度（两个字节）

TextLength=50；//文本信息长度（两个字节）

IsKey=’N’；//是否加密？（Y/N）（1个字节）

Reserver=255；//标识位（1个字节）

}

4.信息解释流程

3.配置文件说明

1、配置说明

配置文件主要存放了条码编码参数，串口通信参数。

例如MakeBarCode.ini存放形式如下：（//为注释符）

[SCAN] //串口设置参数

Baudrate=9600 //波特率

Port=COM1 //连接的是COM1口

[PDF] //PDF417条码设置参数

Aspect=1:3 //外形比（高：宽）

Truncated=0 //是否是截短形条码（0＿否，1＿是）

ECCLevel=0 //纠错级别（Auto表按百分比设置，若0－8为纠错级别。）

ECCPercent=40 //纠错百分比（100＊纠错码词／数据码词）

XScale=1 //X方向放大系数

YScale=1 // Y方向放大系数

Rows=0 //指定码的行数（0表不指定）

Cols=0 //指定码的列数（0表不指定）

[QR] //QR条码设置参数

ECCLevel=15 //纠错百分比（100＊纠错码词／总码词数）

Scale=2 //放大系数

[DM] //DM条码设置参数

Scale=2 //放大系数

2、应用说明：

在程序调用条码制作函数前，先调用SetConfile函数，将配置文件名传递给动态链接库。否者条码制作函数使用默认参数进行编码。

如：在制作PDF417条码前，先将“MakeCode.ini”参数配置文件传递给EnCodePdf.dll：SetConFile( “MakeCode.ini” ); //设置参数配置文件

pdfbmpname=MakePdf417( TxtFileName,ImgFileName,"",outFile ); //制码

4.库函数说明：

1)接口方式：

采用Active X 动态链接库的方式。

2)动态链库：

EnCodePdf.dll //PDF417编码动态链接库

EnCodeQr.dll //Qr_Code编码动态链接库

EnDataMatrix.dll //DataMatrix编码动态链接库

Wcomp.dll //图像压缩动态链接库

3)支持被调用主要的开发环境有：

Microsoft Visual C++ 6.0 / .Net

Microsoft Visual Basic 5.0/6.0

Microsoft Visual Foxpro 5.0/6.0

PowerBuilder

Delphi

4)EnCodePdf.dll包含的接口函数：

int InitRead ( HWND hcallwnd, LPCTSTR lpPathName )

int CloseRead ( void )

BOOL SetPdfConFile( LPCTSTR confile )

BSTR EnPdfText( LPCTSTR strText,LPCTSTR outfile=_T(“”) )

BSTR EnCodePdf( LPCTSTR txtfile,LPCTSTR outfile=_T(“”))

BSTR MakePdf417(LPCTSTR txtfile,LPTCSTR pictfile,LPCTSTR otherfile ,LPCTSTR outfile=_T(“”))

5)EnCodeQr.dll包含的接口函数：

int InitRead ( HWND hcallwnd, LPCTSTR lpPathName )

int CloseRead ( void )

BOOL SetQrConFile( LPCTSTR confile )

BSTR EnQrText( LPCTSTR strTtext,LPCTSTR outfile=_T(“”) )

BSTR EnCodeQr( LPCTSTR txtfile ,LPCTSTR outfile=_T(“”) )

BSTR MakeQrCode( LPCTSTR txtfile,LPCTSTR imgfile,LPCTSTR othfile ,LPCTSTR outfile=_T(“”))

6)EnDataMatrix.dll包含的接口函数：

int InitRead ( HWND hcallwnd, LPCTSTR lpPathName )

int CloseRead ( void )

BOOL SetQrConFile( LPCTSTR confile )

BSTR EnDmText( LPCTSTR strTtext ,LPCTSTR outfile=_T(“”) )

BSTR EnDataMatrix( LPCTSTR txtfile ,LPCTSTR outfile=_T(“”) )

BSTR MakeDataMatrix( LPCTSTR txtfile,LPCTSTR imgfile,LPCTSTR othfile ,LPCTSTR outfile=_T(“”) )

7)Wcomp.dll包含的接口函数：

int Wcompress (LPSTR infile_name, LPSTR outfile_name, int budget)

int Wdecompress(LPSTR infile_name, LPSTR outfile_name)

int SizeDIB( LPCSTR originBMP, int BmpHeight, int BmpWidth)

5.接口函数说明

5.1. 串口通信接口说明

1)int InitRead ( HWND hcallwnd, LPCTSTR lpPathName )

功能：

初始化端口

参数：

hcallwnd为需要响应数据读入的窗体句柄，

lpPathName 读取的文本、图形和其它信息存放的路径。

其中：文本文件名：Temp.Txt

图形文件名：Temp.img

其它信息名：Temp.oth

说明：

当串口收到数据并进行分离后，将向窗口发送Keydown消息，并返回键值255,如果数据分析错误返回255。

动态连接库：EnCodePdf.dll / EnCodeQr.dll

2)int CloseRead ( void )

功能：

关闭端口

说明：

返回0代表成功，否则不成功。

动态连接库：EnCodePdf.dll / EnCodeQr.dll

5.2. 位图压缩接口说明

1)int Wcompress (LPSTR infile_name, LPSTR outfile_name, int budget)

功能：

位图压缩函数

参数：

infile_name：为输入的位图全路径文件名，

outfile_name：为输出的压缩数据全路径文件名，

budget：为预计达到的压缩后的字节数。

其中输入的位图必须经过SizeDIB函数进行预处理。

说明：

返回为0，表示成功。

动态连接库：Wcomp.dll

2)int Wdecompress(LPSTR infile_name, LPSTR outfile_name)

功能：

位图解压函数

参数：

infile_name：为压缩数据全路径文件名，

outfile_name：为解压出的位图全路径文件名。

说明：

返回为0，表示成功。

动态连接库：Wcomp.dll

3)int SizeDIB( LPCTSTR originBMP, int BmpHeight, int BmpWidth)

功能：

调整图形，进行编码的图形进行调整规格。

参数：

originBMP为要进行调整的位图全路径文件名，

BmpHeight为预期要达到的位图高度，

BmpWidth为预期要达到的位图宽度

说明：

返回0表成功；否则失败。

动态连接库：Wcomp.dll

5.3. PDF417编码接口说明

1)BOOL SetPdfConFile( LPCTSTR confile )

功能：

设置配置参数文件

参数：

confile：配置参数文件

说明：

动态连接库：EnCodePdf.dll

2)BSTR EnPdfText( LPCTSTR strText,LPCTSTR outfile=_T(“”) )

功能：

将信息生成PDF417条码，不包含编码信息结构。

输出生成条码位图文件路径

参数：

strText: 编码字符串

outfile: 输出文件名(含路径)

说明：

成功能返回条码位图文件名，否返回空。

默认位图文件名：TempPdf.bmp

动态连接库：EnCodePdf.dll

3)BSTR EnCodePdf( LPCTSTR txtfile ,LPCTSTR outfile=_T(“”))

功能：

将信息生成PDF417条码，不包含编码信息结构。

输出生成条码位图文件路径

参数：

txtfile：源文件名(含路径)

outfile: 输出文件名(含路径)

说明：

成功能返回条码位图文件名，否返回空。

默认位图文件名：TempPdf.bmp

动态连接库：EnCodePdf.dll

4)BSTR MakePdf417(LPCTSTR txtfile,LPCTSTR pictfile,LPCTSTR otherfile,LPCTSTR

outfile=_T(“”) )

功能：

将文本、图形和其它信息合成生成PDF417条码，包含编码信息结构。

输出生成条码位图文件路径。

参数：

txtfile：文本文件，可以为空

pictfile：图形压缩后文件，可以为空

otherfile：其它编码信息，可以为空

说明：

成功能返回条码文件名，否返回空。

默认位图文件名：TempPdf.bmp

动态连接库：EnCodePdf.dll

5.4. Qr_Code编码接口说明

1)BOOL SetQrConFile( LPCTSTR confile )

功能：

设置配置参数文件

参数：

confile：配置参数文件

说明：

动态连接库：EnCodeQr.dll

2)BSTR EnQrText( LPCTSTR strText,LPCTSTR outfile=_T(“”) )

将信息生成QrCode条码，不包含编码信息结构。

输出生成条码位图文件路径

参数：

strText: 编码字符串

outfile: 输出文件名(含路径)

说明：

成功能返回条码位图文件名，否返回空。

默认位图文件名：TempQr.bmp

动态连接库：EnCodeQr.dll

3)BSTR EnCodeQr( LPCTSTR txtfile,LPCTSTR outfile=_T(“”) )

功能：

将文本信息字符串生成QrCode条码，不包含编码信息结构。

输出生成条码位图文件路径

参数：

txtfile：条码文件名(含路径)

outfile: 输出文件名(含路径)

说明：

成功能返回条码文件名，否返回空。

默认位图文件名：TempQr.bmp

动态连接库：EnCodeQr.dll

4)BSTR MakeQrCode( LPCTSTR txtfile,LPCTSTR imgfile,LPCTSTR othfile,LPCTSTR

outfile=_T(“”) )

功能：

将文本、图形和其它信息合成生成QrCode条码，包含编码信息结构。

输出生成条码位图文件路径

参数：

txtfile：文本文件，可以为空

pictfile：图形压缩后文件，可以为空

otherfile：其它编码信息，可以为空

说明：

成功能返回信息文件名，否返回空。

默认位图文件名：TempQr.bmp

动态连接库：EnCodeQr.dll

5.5. DataMatrix编码接口说明

6.BOOL SetDmConFile( LPCTSTR confile )

功能：

设置配置参数文件

参数：

confile：配置参数文件

动态连接库：EnDataMatrix.dll

1)BSTR EnDmText( LPCTSTR strText,LPCTSTR outfile=_T(“”) )

功能：

将文本信息字符串生成DataMatrix条码，不包含编码信息结构。

输出生成条码位图文件路径

参数：

strText: 编码字符串

outfile: 输出文件名(含路径)

说明：

成功能返回条码位图文件名，否返回空。

默认位图文件名：TempDm.bmp

动态连接库：EnDataMatrix.dll

2)BSTR EnDataMatrix( LPCTSTR txtfile,LPCTSTR outfile=_T(“”) )

功能：

将文本文件内容编制成DataMatrix条码字符，不包含编码信息结构。

输出生成条码位图文件路径

参数：

txtfile：条码文件名(含路径)

outfile: 输出文件名(含路径)

说明：

成功能返回条码文件名，否返回空。

默认位图文件名：TempDm.bmp

动态连接库：EnDataMatrix.dll

3)BSTR MakeDataMatrix( LPCTSTR txtfile,LPCTSTR imgfile,LPCTSTR

othfile,LPCTSTR outfile=_T(“”) )

功能：

将文本、图形和其它信息合成生成DataMatrix条码，包含编码信息结构。

输出生成条码位图文件路径

参数：

txtfile：文本文件(含路径)

pictfile：图形压缩后文件(含路径)

otherfile：其它编码信息文件(含路径)

outfile: 输出文件名(含路径)

说明：

成功能返回信息文件名，否返回空。

默认位图文件名：TempDm.bmp

动态连接库：EnDataMatrix.dll

7.应用实例说明

VC++和VB两个应用实例分别是MakeBarCode(VC)和MakeBarCode(VB)可以从https://www.sodocs.net/doc/5f18904324.html,/MakeBarCode.html进行下载。

7.1. Microsoft Visual C++ 6.0应用

采用Microsoft Visual C++ 6.00调用EnCodePdf.dll和Wcomp.dll实现图形压缩与PDF417条码编制。其实现步骤如下：

1、先将EnCodePdf.lib、Wcomp.lib加入工程中。

将EnCodePdf.lib、EnCodePdf.dll、Wcomp.lib、Wcomp.dll拷贝至微机上，在VC工程中添加EnCodePdf.lib和Wcomp.lib两个文件。

2、在应用程序中，设置条形码制码参数，保存在参数文件中。

应用程序对“外形比”、“列/行”、“X/Y放大系数”和“纠错级别”进行设置，其中当“行/列”为零时，按外形比进行排列；纠错级别设为“AUTO”则采用纠错码占总码词的百分比来计算纠错等级。设置完成后，参数保存在参数文件中，在制码前传递给动态链接库。

3、在应用程序中，进行图像压缩操作。

将应用程序提供的24位位图，进行压缩。

int SizeDIB( LPCTSTR originBMP, int BmpHeight, int BmpWidth)

调整压缩后图形像大小，

originBMP是压缩后的文件名，

BmpHeight, BmpWidth是压缩后图象显示的像素高度与宽度

int Wcompress (LPSTR infile_name, LPSTR outfile_name, int budget)

进行位图压缩，返回0表成功，否者表失败。

infile_name：是原24位图文件名，

outfile_name：是压缩后的位图文件名，

budget：压缩后的文件大小，如800，表示不超过800个字节。

4、生成条码文件

将文本信息、图形信息和其它信息以文件方式传递给动态链接库，生成PDF417条码。

应用程序再调用位图文件或图元文件进行显示或打印等操作。

BOOL SetConFile( LPCTSTR confile )

将制码参数文件名传递给动态链接库。

BSTR MakePdf417(LPCTSTR txtfile,LPCTSTR pictfile,LPCTSTR otherfile )

将文件文件、图形文件与其它文件进行编码，生成位图文件是TempPdf.bmp，增强型图元文件是TempPdf.emf，图元文件是TempPdf.wmf，返回条码位图文件名。

5、识读与解码：

识读前，调用InitRead对串口进行初始化。当动态链接库接到条码信息后，向调用窗体发送字符为254的消息，应用程序再对识读的信息进行处理。

若有图形信息，应用程序将调用Wdecompress进行压缩解码，再显示图像。

int InitRead ( HWND hcallwnd, LPCTSTR lpPathName )

其中：hcallwnd为调用窗体句柄。

LpPathName：为识读后的文本信息、图形信息和其它信息存放的路径，其文件名分别为：文本文件名是Temp.Txt ，图形文件名是Temp.img，其它文件名是Temp.oth。

int CloseRead ( void ) 关闭识读串口。

int Wdecompress(LPSTR infile_name, LPSTR outfile_name)

其中：infile_name为压缩后文件名，即接收到的图形信息文件名，

outfile_name为解压后文件名，应用程序将此图像进行显示。

打开与关闭串口实例：

在工程中添加KeyDown事件处理过程，当收到255的字符，表示有扫描信息，进行识读信息显示与处理。

对接收到的图形文件，调用Wdecompress进行解压后，再显示位图。

接到识读器译码后信息，程序进行处理，转换成文本与图像信息，并显示如下。

7.2. Microsoft Visual Basic 6.0应用

采用Microsoft Visual Basic 6.00调用EnCodePdf.dll和Wcomp.dll实现图形压缩与PDF417条码编制，先将EnCodePdf.dll、Wcomp.dll拷贝至微机上，再在VB中申明以下接口程序，在程序中函数的调用类似VC的操作。

接口函数的申明如下：

Private Declare Function InitRead Lib "EnCodePdf.dll" (ByVal hcallwnd As Long, ByVal pathname As String) As Long

Private Declare Function CloseRead Lib "EnCodePdf.dll" () As Long

Private Declare Sub SetPdfConFile Lib "EnCodePdf.dll" (ByVal confile As String)

Private Declare Function EnPdfText Lib "EnCodePdf.dll" (ByVal txtData As String, ByVal outfile As String) As String

Private Declare Function EnCodePdf Lib "EnCodePdf.dll" (ByVal txtfile As String, ByVal outfile As String) As String

Private Declare Function MakePdf417 Lib "EnCodePdf.dll" (ByVal txtfile As String, ByVal pictfile As String, ByVal otherfile As String, ByVal outfile As String) As String Private Declare Function SizeDIB Lib "Wcomp.dll" (ByVal oldmap As String, ByVal BmpHeight As Integer, ByVal BmpWidth As Integer) As Long

Private Declare Function Wcompress Lib "Wcomp.dll" (ByVal infile As String, ByVal outfile As String, ByVal budget As Long) As Long

Private Declare Function Wdecompress Lib "Wcomp.dll" (ByVal infile As String, ByVal outfile As String) As Long

制码参数设置

设置外形比例、行列、X/Y放大系数、ECC纠错等级、百分比以及是否是缩短条码等设置至条码设置文件中。

串口参数设置

对串的波特率与串口进行设置。

生成条码函数调

第一步：对图形文件进行压缩处理。

第二步：设置制码参数文件名。

第三步：调用制码函数，将压缩后的图形文件与文本文件制作成条码第四步：若条码文件名非空，显示条码，否者报告错误。

串口打开与关闭

在识读前，调用InitRead与CloseRead打开与关串口，

数据接收与显示

当动态链接库接到扫描器送来的信息，先进行分析后，然后给调用窗体发送字符为255的KEYDOWN信息，接收信息按照信息存放的标准被分解成文本、图形和其它三个文件。

文本文件读出，直接显示；若有图形文件，先进行解压，然后显示；其它文件根据用户定义进行处理。

8.版权申明

在https://www.sodocs.net/doc/5f18904324.html,和https://www.sodocs.net/doc/5f18904324.html,及其它网站下载的有关博智成或条码公社的软件版本都归福州博智成软件开发有限公司所有。未经授权使用者，是属于试用用户，不能使用于商业应用，同时造成的损失与本公司无关，本公司保留法律追究权利。

发行条码软件版本有：

I EBarCodePlus.dll //IE编码插件(WEB和WIN客户端应用)

n pBarCodePlus.dll //FF编码插件(WEB和WIN客户端应用)

E nCodePdf.dll //PDF编码动态链接库(WIN客户端应用)

E nCodeQr.dll // QR编码动态链接库(WIN客户端应用)

E nDataMatrix.dll // DM编码动态链接库(WIN客户端应用)

D eCodePdf.dll //PDF译码动态链接库(WIN客户端应用)

D eCodeQr.dll // QR译码动态链接库(WIN客户端应用)

D eDataMatrix.dll // DM译码动态链接库(WIN客户端应用)

B arCode.exe //条码制作WIN客户端应用程序

B arWin.exe //QR条码自动识别WIN客户端应用程序

Q rDecodeEvc.exe //QR条码自动识别mobile应用程序

9.联系方式

公司网站: https://www.sodocs.net/doc/5f18904324.html, https://www.sodocs.net/doc/5f18904324.html,

公司邮箱: fzBozc@https://www.sodocs.net/doc/5f18904324.html, webmaster@https://www.sodocs.net/doc/5f18904324.html,

联系电话：0591-******** 传真：0591-********

联系人: 何老师QQ: 409487486

相关案例DEMO程序可以到公司网站下载

需要技术支持与开发援助，请与我们联系.