API函数手册

POSTEKPPLⅠAPI函数手册GSeries条码标签打印机Version2.00深圳市博思得通信发展有限公司二○○四年1/39API函数库文件说明名称：CDFPSK.dll中文版本编号：1.X.X.X英文版本编号：2.X.X.X版权所有：©2004深圳市博思得通信发展有限公司。保留所有权利。用途本API函数库为深圳市博思得通信发展有限公司条码标签打印机的用户提供一组命令，为他们编写基于Windows9X，NT，2000，XP等操作系统的应用程序提供便利。本API函数库仅支持本公司产品。缩略语对照PPLⅠ：深圳市博思得通信发展有限公司的第一套打印机编程语言（PrinterPorgramLanguageⅠ）。API：应用程序编程接口(ApplicationProgramInterface)。Dots：像素（pixel）是一种计算机科学技术尺寸单位，原指电视图像成像的最小单位，在打印机领域表示打印机的最小打印成像单位：1dot等于一英寸除以打印机的最大分辨率。-对于203DPI的打印机来说,1dot=25.4mm/203=0.125mm(1dot=1000/203=5mil)；-对于300DPI的打印机来说,1dot=25.4mm/300=0.085mm(1dot=1000/300=3mil)。TrueTypeFont：是基于Windows操作系统使用，可装卸的字体。-已经安装的TrueTypeFont，都可以被本函数使用。使用前须知字符串*字符串以双引号(“)作为起始和结束标记;*反斜杠（\）有以下作用:字符输入“\“2/39\\\0x00–0x7F\x00-\x7F*所有打印指令和名称均区分大小写。*CR为USASCII码十进制的”13”,或十六进制的”0DH”,即”回车”符号。条码标签打印机的坐标系统如下图所示:1标签进纸方向(0,0)Y0dotX打印头作用线864/1248dots3/39函数概述列表函数名称说明OpenPort打开通讯端口。ClosePort关闭使用OpenPort函数打开的通讯端口。SetPCComPort设置PC机上串口的传输波特率。GetErrState检测使用CDFPSK.DLL里的其它函数后是否有错误产生；PTK_GetInfo得到本API函数库的版本信息。PTK_DrawText打印一行文本文字，内容可以是常量、序列号、变量或组合字符串。PTK_DrawTextTrueTypeW打印一行TrueTypeFont文字，并且文字宽度和高度可以微调。PTK_DrawBarcode打印一个条码。PTK_DefineCounter定义一个序列号变量。PTK_SetDarkness设置打印头发热温度PTK_SoftFontList打印存储在RAM或FLASH存储器里的软字体的名称清单。PTK_SoftFontDel删除存储在RAM或FLASH存储器里的一个或所有的软字体。PTK_FormEnd结束存储表格(Form)，此函数与PTK_FormDownload配对使用。PTK_FormList打印存储在打印机里的表格名称清单。PTK_FormDel删除存储在打印机里的一个或所有的表格。PTK_ExecForm运行指定的表格。PTK_FormDownload存储一个表格到打印机；此命令与PTK_FormEnd函数配对使用。PTK_DrawPcxGraphics打印指定的图形。PTK_PcxGraphicsList打印已存储在打印机RAM或FLASH存储器里的图形名称清单。PTK_PcxGraphicsDel删除存储在打印机里的一个或所有图形。PTK_PcxGraphicsDownload存储一个PCX格式的图形到打印机。PTK_PrintPCX打印一个PCX格式的图形。PTK_DrawBinGraphics打印二进制格式的图形。PTK_DisableCircumgyrate取消打印回转功能。PTK_EnableCircumgyrate设置打印回转功能。PTK_DrawLineXor画直线(两直线相交处作”异或”处理)。PTK_DrawLineOr画直线(两直线相交处作”或”处理)。PTK_DrawDiagonal画斜线。PTK_DrawWhiteLine画白色直线。PTK_ClearBuffer清除打印机缓冲内存的内容。PTK_SetPrinterState设置打印机的工作状态。4/39PTK_PrintLabel命令打印机执行打印工作。PTK_PrintLabelAuto自动执行打印工作。PTK_SetLabelHeight设置标签的高度和定位间隙\黑线\穿孔的高度。PTK_SetLabelWidth设置标签的宽度。PTK_SetCoordinateOrigin设置/改变坐标原点。PTK_SetPrintSpeed设置打印速度。PTK_PrintConfigunation打印机器当前的设置/工作状态。PTK_DisableErrorReport取消错误反馈。PTK_EnableErrorReport设置错误反馈。PTK_DefineVariable定义变量。PTK_DrawRectangle画距形。PTK_SetDirection设置标签打印方向。PTK_EnableFlASH选择FLASH存储器。PTK_DisableFLASH取消选择FLASH存储器。PTK_Download下载变量或系列号变量。*PTK_Reset将打印机复位。*PTK_BackFeed要求打印机立刻反馈错误报告。PTK_CutPage设置切刀的工作周期（即每打印多少页标签后，切刀才切一次纸）。*标志的此函数暂时不能使用。5/39函数详细说明OpenPort说明：OpenPort函数的作用是打开通讯端口。使用本函数库其它函数之前，必须首先正确执行OpenPort函数。原型：intOpenPort(intxx);参数：xx：通讯端口代号；0：表示打印到文件PBuffi.txt（在执行程序目录下建立文件）；1：表示打开LPT1；2：表示打开LPT2；3:表示打开LPT3；4：表示打开COM1；5：表示打开COM2；6：表示打开COM3。返回值：0-OK；其它返回值请参考章节：CDFPSK.dll错误返回值解析。范例：OpenPort(1);//表示打开lpt1端口。ClosePort说明：ClosePort函数的作用是关闭使用OpenPort函数打开的通讯端口。用户在对打印机操作完成之后，建议调用ClosePort关闭通讯端口；否则用户的程序一直占用打开的通讯端口，直到程序被关闭。原型：6/39intClosePort(void);参数：无返回值：0-OK；其它返回值请参考章节：CDFPSK.dll错误返回值解析。范例：ClosePort();SetPCComPort说明：SetPCComPort函数的作用是设置PC机上串口的传输波特率。这个函数只有在使用串口进行通讯时才有效。注意：必须对应打印机上所选择串口波特率（通过调整DIP开关的7，8PIN，请参阅用户手册）原型：intSetPCComPort(DWORDBaudRate,BOOLHandShake);参数：BaudRate：要设置的串口波特率，可取值：9600，19200，38400，57600；HandShake：是否使用硬件握手（HandShaking）；TRUE：硬件握手（HandShaking）有效，FALSE：硬件握手（HandShaking）无效。返回值：0-OK；其它返回值请参考章节：CDFPSK.dll错误返回值解析。范例：SetPCComPort(9600,TRUE);GetErrState说明：7/39GetErrState函数的作用是检测使用CDFPSK.DLL里的其它函数后是否有错误产生；错误代码请参阅“CDFPSK.dll错误返回值解析”这个函数必须在ClosePort()函数前使用！原型：intGetErrState(void)；参数：无返回值：0-OK；其它返回值请参考章节：CDFPSK.dll错误返回值解析。示范：intstate=0;OpenPort(1);...state=GetErrState();...ClosePort();PTK_GetInfo说明：PTK_GetInfo函数作用是得到本API函数库的版本信息。原型：intPTK_GetInfo(void)参数：无返回值：0-OK；其它返回值请参考章节：CDFPSK.dll错误返回值解析。范例:PTK_GetInfo(void)8/39PTK_DrawText说明：PTK_DrawText函数作用是打印一行文本文字，内容可以是常量、序列号、变量或组合字符串。原型：intPTK_DrawText(unsignedintpx,unsignedintpy,unsignedintpdirec,unsignedintpFont,unsignedintpHorizontal,unsignedintpVertical,charptext,LPTSTRpstr);参数:px:设置X坐标,以点(dots)为单位.py:设置Y坐标,以点(dots)为单位.pdirec:选择文字的打印方向.0—不旋转;1—旋转90°;2—旋转180°;3—旋转270°.pFont:选择内置字体或软字体.1—5:为打印机内置字体;A—Z:为下载的软字体.a为打印机内置24*24简体汉字.取值描述1西文字体12西文字体23西文字体34西文字体45西文字体5a24点阵中文宋体A~Z软字体pHorizontal:设置点阵水平放大系数.可选择:1—24.pVertical:设置点阵垂直放大系数.可选择:1—24.ptext:选’N’则打印正常文本(如黑字白底文本),选’R’则打印文本反色文本(如白字黑底文本).pstr：一个长度为1-100的字符串。用户可以用”DATA”,Cn,Vn自由排列组合成一个组合字符串,“DATA”:常量字符串，必须用‘”’作为起始和结束符号，如“POSTEKPrinter”。Cn:序列号数值，此序列号必须已经定义，请参考C命令。Vn:变量字符串，此变量字符串必须已经定义，请参考V命令。如:“data1”CnVn“data2”.返回值：0-OK；其它返回值请参考章节：CDFPSK.dll错误返回值解析。9/39范例:PTK_DrawText(50,30,0,2,1,1,’N’,”\”123456789\””);PTK_DrawText(50,30,0,2,1,1,’N’,C1);PTK_DrawText(50,30,0,2,1,1,’N’,V3);PTK_DrawText(50,30,0,2,1,1,’N’,”“Printer”C2V1“isok.””);PTK_DrawBarcode说明：PTK_DrawBarcode函数作用是打印一个条码。原型：intPTK_DrawBarcode(unsignedintpx,unsignedintpy,unsignedintpdirec,LPTSTRpCode,nsignedintNarrowWidth,unsignedintpHorizontal,unsignedintpVertical,charptext,LPTSTRpstr);参数:px:设置X坐标,以点(dots)为单位.py:设置Y坐标,以点(dots)为单位.pdirec:选择条码的打印方向.0—不旋转;1—旋转90°;2—旋转180°;3—旋转270°.pCode:选择要打印的条码类型.P4值条码类型0Code128UCC(shippingcontainercode)1Code128AUTO1ACode128subsetA1BCode128subsetB1CCode128subsetC1EUCC/EAN2Interleaved2of52CInterleaved2of5withchecksumdigit2DInterleaved2of5withhumanreadablec