|
|
/*!
|
|
|
* \~chinese
|
|
|
* @header PTCommandTSPL.h
|
|
|
* @abstract TSPL指令
|
|
|
*
|
|
|
* \~english
|
|
|
* @header PTCommandTSPL.h
|
|
|
* @abstract TSPL Command
|
|
|
*/
|
|
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
#import "SDKDefine.h"
|
|
|
#import "PTBitmap.h"
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 打印速度
|
|
|
*
|
|
|
* \~english
|
|
|
* Print speed
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCPrintSpeed) {
|
|
|
PTTSCPrintSpeed1 = 1,
|
|
|
PTTSCPrintSpeed2 = 2,
|
|
|
PTTSCPrintSpeed3 = 3,
|
|
|
PTTSCPrintSpeed4 = 4,
|
|
|
PTTSCPrintSpeed5 = 5,
|
|
|
PTTSCPrintSpeed6 = 6,
|
|
|
PTTSCPrintSpeed10 = 10,
|
|
|
PTTSCPrintSpeed12 = 12
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 打印浓度
|
|
|
*
|
|
|
* \~english
|
|
|
* Print density
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCPrintDensity) {
|
|
|
PTTSCPrintDensity0 = 0,
|
|
|
PTTSCPrintDensity1 = 1,
|
|
|
PTTSCPrintDensity2 = 2,
|
|
|
PTTSCPrintDensity3 = 3,
|
|
|
PTTSCPrintDensity4 = 4,
|
|
|
PTTSCPrintDensity5 = 5,
|
|
|
PTTSCPrintDensity6 = 6, ///< default
|
|
|
PTTSCPrintDensity7 = 7,
|
|
|
PTTSCPrintDensity8 = 8,
|
|
|
PTTSCPrintDensity9 = 9,
|
|
|
PTTSCPrintDensity10 = 10,
|
|
|
PTTSCPrintDensity11 = 11,
|
|
|
PTTSCPrintDensity12 = 12,
|
|
|
PTTSCPrintDensity13 = 13,
|
|
|
PTTSCPrintDensity14 = 14,
|
|
|
PTTSCPrintDensity15 = 15
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 打印方向
|
|
|
*
|
|
|
* \~english
|
|
|
* DIRECTION
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCPrintDirection) {
|
|
|
|
|
|
/*! \~chinese 正常方向 \~english normal */
|
|
|
PTTSCPrintDirectionNormal = 0,
|
|
|
|
|
|
/*! \~chinese 反向 \~english Reverse */
|
|
|
PTTSCPrintDirectionReverse = 1
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 打印模式
|
|
|
*
|
|
|
* \~english
|
|
|
* Print Mode
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCPrintStyle) {
|
|
|
|
|
|
/*! \~chinese 正常模式 \~english normal */
|
|
|
PTTSCPrintStyleNormal = 0,
|
|
|
/*! \~chinese 镜像模式 \~english Mirror */
|
|
|
PTTSCPrintStyleMirror = 1
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 国际字符集类型
|
|
|
*
|
|
|
* \~english
|
|
|
* International character
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCCharacterStyle) {
|
|
|
PTTSCCharacterStyleUSA = 0,
|
|
|
PTTSCCharacterStyleBritish,
|
|
|
PTTSCCharacterStyleGerman,
|
|
|
PTTSCCharacterStyleFrench,
|
|
|
PTTSCCharacterStyleDanish,
|
|
|
PTTSCCharacterStyleItalian,
|
|
|
PTTSCCharacterStyleSpanish,
|
|
|
PTTSCCharacterStyleSwedish,
|
|
|
PTTSCCharacterStyleSwiss,
|
|
|
PTTSCCharacterStyleUnitedStates,
|
|
|
PTTSCCharacterStyleMultilingual,
|
|
|
PTTSCCharacterStyleSlavic,
|
|
|
PTTSCCharacterStylePortuguese,
|
|
|
PTTSCCharacterStyleCanadianOrFrench,
|
|
|
PTTSCCharacterStyleNordic,
|
|
|
PTTSCCharacterStyleTurkish,
|
|
|
PTTSCCharacterStyleWindowsCentralEurope,
|
|
|
PTTSCCharacterStyleWindowsLatin,
|
|
|
PTTSCCharacterStyleWindowsGreek,
|
|
|
PTTSCCharacterStyleWindowsTurkish
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 一维条码类型
|
|
|
*
|
|
|
* \~english
|
|
|
* Barcode type
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCBarcodeStyle) {
|
|
|
PTTSCBarcodeStyle128 = 0,
|
|
|
PTTSCBarcodeStyle128M,
|
|
|
PTTSCBarcodeStyleEAN128,
|
|
|
PTTSCBarcodeStyle25,
|
|
|
PTTSCBarcodeStyle25C,
|
|
|
PTTSCBarcodeStyle39,
|
|
|
PTTSCBarcodeStyle39C,
|
|
|
PTTSCBarcodeStyle93,
|
|
|
PTTSCBarcodeStyleEAN13,
|
|
|
PTTSCBarcodeStyleEAN132,
|
|
|
PTTSCBarcodeStyleEAN135,
|
|
|
PTTSCBarcodeStyleEAN8,
|
|
|
PTTSCBarcodeStyleEAN82,
|
|
|
PTTSCBarcodeStyleEAN85,
|
|
|
PTTSCBarcodeStyleCODA,
|
|
|
PTTSCBarcodeStylePOST,
|
|
|
PTTSCBarcodeStyleUPCA,
|
|
|
PTTSCBarcodeStyleUPCA2,
|
|
|
PTTSCBarcodeStyleUPCA5,
|
|
|
PTTSCBarcodeStyleUPCE,
|
|
|
PTTSCBarcodeStyleUPCE2,
|
|
|
PTTSCBarcodeStyleUPCE5,
|
|
|
PTTSCBarcodeStyleCPOST,
|
|
|
PTTSCBarcodeStyleMSI,
|
|
|
PTTSCBarcodeStyleMSIC,
|
|
|
PTTSCBarcodeStylePLESSY,
|
|
|
PTTSCBarcodeStyleITF14,
|
|
|
PTTSCBarcodeStyleEAN14,
|
|
|
PTTSCBarcodeStyle11
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 是否可识别
|
|
|
*
|
|
|
* \~english
|
|
|
* Readable
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCBarcodeReadbleStyle) {
|
|
|
|
|
|
/*! \~chinese 不可识别 \~english not */
|
|
|
PTTSCBarcodeReadbleStyleNot = 0,
|
|
|
|
|
|
/*! \~chinese 可识别 \~english human */
|
|
|
PTTSCBarcodeReadbleStyleHuman
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 旋转角度
|
|
|
*
|
|
|
* \~english
|
|
|
* Rotation
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCStyleRotation) {
|
|
|
|
|
|
/*! \~chinese 正常打印 \~english normal */
|
|
|
PTTSCStyleRotation0 = 0,
|
|
|
/*! \~chinese 顺时针旋转90度 \~english rotate 90 degrees (clockwise) */
|
|
|
PTTSCStyleRotation90 = 90,
|
|
|
/*! \~chinese 180度旋转 \~english inverted 180 degrees */
|
|
|
PTTSCStyleRotation180 = 180,
|
|
|
/*! \~chinese 270度旋转 \~english read from bottom up, 270 degrees */
|
|
|
PTTSCStyleRotation270 = 270
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 条码宽窄条比例
|
|
|
*
|
|
|
* \~english
|
|
|
* The ratio of wide to narrow bars
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCBarcodeRatio) {
|
|
|
PTTSCBarcodeRatio1 = 1, ///< 1:1
|
|
|
PTTSCBarcodeRatio2, ///< 1:2
|
|
|
PTTSCBarcodeRatio3, ///< 1:3
|
|
|
PTTSCBarcodeRatio4, ///< 2:5
|
|
|
PTTSCBarcodeRatio5 ///< 3:7
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 二维码纠错等级
|
|
|
*
|
|
|
* \~english
|
|
|
* Error correction recovery level
|
|
|
*/
|
|
|
typedef NS_ENUM(UInt8, PTTSCQRcodeEcclevel) {
|
|
|
|
|
|
/*! \~chinese ⾼密度级别 \~english high density level level */
|
|
|
PTTSCQRcodeEcclevelL = 'L',
|
|
|
|
|
|
/*! \~chinese 标准级别 \~english standard level */
|
|
|
PTTSCQRcodeEcclevelM = 'M',
|
|
|
|
|
|
/*! \~chinese 高可靠级别 \~english high reliability level */
|
|
|
PTTSCQRcodeEcclevelQ = 'Q',
|
|
|
|
|
|
/*! \~chinese 极高可靠级别 \~english ultra-high reliability level */
|
|
|
PTTSCQRcodeEcclevelH = 'H'
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 二维码大小
|
|
|
*
|
|
|
* \~english
|
|
|
* cell width
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCQRcodeWidth) {
|
|
|
PTTSCQRcodeWidth1 = 1,
|
|
|
PTTSCQRcodeWidth2,
|
|
|
PTTSCQRcodeWidth3,
|
|
|
PTTSCQRcodeWidth4,
|
|
|
PTTSCQRcodeWidth5,
|
|
|
PTTSCQRcodeWidth6,
|
|
|
PTTSCQRcodeWidth7,
|
|
|
PTTSCQRcodeWidth8,
|
|
|
PTTSCQRcodeWidth9,
|
|
|
PTTSCQRcodeWidth10
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 二维码模式
|
|
|
*
|
|
|
* \~english
|
|
|
* qrcode mode
|
|
|
*/
|
|
|
typedef NS_ENUM(UInt8, PTTSCQRCodeMode) {
|
|
|
/*! \~chinese 自动 \~english auto */
|
|
|
PTTSCQRCodeModeAuto = 'A',
|
|
|
|
|
|
/*! \~chinese 手动 \~english Manual */
|
|
|
PTTSCQRCodeModeManual = 'M'
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 二维码模型
|
|
|
*
|
|
|
* \~english
|
|
|
* qrcode model
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCQRCodeModel) {
|
|
|
|
|
|
/*! \~chinese 默认值，原始版本 \~english (default), original version */
|
|
|
PTTSCQRCodeModelM1 = 0,
|
|
|
|
|
|
/*! \~chinese 增强版本 \~english enhanced version */
|
|
|
PTTSCQRCodeModelM2 = 1
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 二维码mask
|
|
|
*
|
|
|
* \~english
|
|
|
* qrcode mask
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCQRcodeMask) {
|
|
|
PTTSCQRcodeMaskS0 = 1,
|
|
|
PTTSCQRcodeMaskS1,
|
|
|
PTTSCQRcodeMaskS2,
|
|
|
PTTSCQRcodeMaskS3,
|
|
|
PTTSCQRcodeMaskS4,
|
|
|
PTTSCQRcodeMaskS5,
|
|
|
PTTSCQRcodeMaskS6,
|
|
|
PTTSCQRcodeMaskS7,
|
|
|
PTTSCQRcodeMaskS8
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 位图模式
|
|
|
*
|
|
|
* \~english
|
|
|
* qrcode mask
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCBitmapMode) {
|
|
|
|
|
|
PTTSCBitmapModeOVERWRITE = 0,
|
|
|
PTTSCBitmapModeOR = 1,
|
|
|
PTTSCBitmapModeXOR = 2,
|
|
|
|
|
|
/*! *\~chinese 压缩模式，兼容旧的固件，新的固件已经废弃 *\~english Compatible with old models,New firmware has been deprecated */
|
|
|
PTTSCBitmapModeCompress = 3,
|
|
|
PTTSCBitmapModeOVERWRITECompress = 16,
|
|
|
PTTSCBitmapModeORCompress = 17,
|
|
|
PTTSCBitmapModeXORCompress = 18
|
|
|
};
|
|
|
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 文本字体类型(含有矢量字库的机型),中文只能选9
|
|
|
*
|
|
|
* \~english
|
|
|
* Text font type，for vector and ，chinese onlt select 9
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCTextVectorFontStyle) {
|
|
|
|
|
|
PTTSCTextVectorFontStyle0 = 0, ///< 8x12，not adjuset
|
|
|
PTTSCTextVectorFontStyle1, ///< 8x12
|
|
|
PTTSCTextVectorFontStyle2, ///< 12x20
|
|
|
PTTSCTextVectorFontStyle3, ///< 16x24
|
|
|
PTTSCTextVectorFontStyle4, ///< 24x32
|
|
|
PTTSCTextVectorFontStyle5, ///< 32x48
|
|
|
PTTSCTextVectorFontStyle6, ///< 14x19
|
|
|
PTTSCTextVectorFontStyle7, ///< 21x27
|
|
|
PTTSCTextVectorFontStyle8, ///< 14x25
|
|
|
PTTSCTextVectorFontStyle9 ///< vector font,for chinese
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* 文本字体类型,支持中英文
|
|
|
*
|
|
|
* \~english
|
|
|
* Text font type,Support Chinese and English
|
|
|
*/
|
|
|
typedef NS_ENUM(NSUInteger, PTTSCTextFontStyle) {
|
|
|
PTTSCTextFontStyle0 = 0, ///< chinese:24x24 english:12x24
|
|
|
PTTSCTextFontStyle1, ///< chinese:16x16 english:8x16
|
|
|
};
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
* DMATRIX二维码的模块尺寸
|
|
|
*
|
|
|
* \~english
|
|
|
* Module size for DMATRIX 2D bar code
|
|
|
*/
|
|
|
typedef NS_ENUM(UInt8, PTTSCDMATRIXSize) {
|
|
|
PTTSCDMATRIXSizeX6 = 0,
|
|
|
PTTSCDMATRIXSizeX8
|
|
|
};
|
|
|
|
|
|
|
|
|
@interface PTCommandTSPL : NSObject
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 下发给打印机的数据.
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Data sent to the printer.
|
|
|
*
|
|
|
*/
|
|
|
@property(strong,nonatomic,readwrite) NSMutableData *cmdData;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 指令使用的编码，默认是GBK.
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* encode，default is GBK.
|
|
|
*
|
|
|
*/
|
|
|
@property (nonatomic, assign) NSStringEncoding encoding;
|
|
|
|
|
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
/********************* Setup and System Commands ********************/
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 自检，打印打印机信息.
|
|
|
*
|
|
|
* @brief 打印自检页
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* printer Print self-test message.
|
|
|
*
|
|
|
* @brief View Printer Message
|
|
|
*/
|
|
|
- (void)selfTest;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 添加指令.
|
|
|
*
|
|
|
* @brief 拼接指令
|
|
|
* @param cmd 指令文本.使用encoding属性进行编码.
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* append command.
|
|
|
*
|
|
|
* @brief Append Command
|
|
|
* @param cmd command text. encode with encoding property.
|
|
|
*
|
|
|
*/
|
|
|
- (void)appendCommand:(NSString *)cmd;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置打印纸张范围大小,传的是毫米.1mm == 8 dot
|
|
|
*
|
|
|
* @brief 设置打印区域
|
|
|
* @param label_width 标签纸的宽度
|
|
|
* @param label_height 标签纸的高度
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command defines the label width and length(mm).1mm == 8 dot
|
|
|
*
|
|
|
* @brief Set Print Area
|
|
|
* @param label_width Label width
|
|
|
* @param label_height Label length
|
|
|
*
|
|
|
*/
|
|
|
- (void)setPrintAreaSizeWithWidth:(NSInteger)label_width
|
|
|
height:(NSInteger)label_height;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置标签纸的间距,传的是毫米.
|
|
|
*
|
|
|
* @brief 设置标签纸的间距
|
|
|
* @param distance 两张标签紙中间的垂直距离,0 ≤ distance ≤ 25.4 (mm)
|
|
|
* @param offset 垂直间距的偏移
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command sets the distance between two labels(mm).
|
|
|
*
|
|
|
* @brief Set Label Distance
|
|
|
* @param distance The gap distance between two labels,0 ≤ distance ≤ 25.4 (mm)
|
|
|
* @param offset The offset distance of the gap offset ≤ label length (mm)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setGapWithDistance:(NSInteger)distance
|
|
|
offset:(NSInteger)offset;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置黑线的高度和用户自定义的额外的标签进纸长度(毫米).(height,offset 为0,0表示连续标签)
|
|
|
*
|
|
|
* @brief 设置进纸长度
|
|
|
* @param height 黑线的高度 0~25.4 mm
|
|
|
* @param offset 黑线偏移量 0~label length
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command sets the height of the black line and the user-defined extra label feeding length each form feed takes(mm).(height,offset is 0,0 : Continuous label)
|
|
|
*
|
|
|
* @brief Bline
|
|
|
* @param height The height of black line either in mm. 0 ≤ m ≤ 25.4 (mm)
|
|
|
* @param offset The extra label feeding length. 0 ≤ offset ≤ label length
|
|
|
*
|
|
|
*/
|
|
|
- (void)setBlineWithHeight:(NSInteger)height
|
|
|
offset:(NSInteger)offset;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置打印机定位完后再走纸多少毫米.
|
|
|
*
|
|
|
* @brief 定位后走纸
|
|
|
* @param distance 纸张走纸的距离,0 ≤ distance ≤ 25.4 (mm)
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command defines the selective, extra label feeding length(mm).
|
|
|
*
|
|
|
* @brief Offset Length
|
|
|
* @param distance The offset distance,0 ≤ distance ≤ 25.4 (mm)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setOffsetWithDistance:(NSInteger)distance;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 将标签定位到下一个标签的起始处.
|
|
|
*
|
|
|
* @brief 定位
|
|
|
* \~english
|
|
|
*
|
|
|
* This command feeds label to the beginning of next label.
|
|
|
*
|
|
|
* @brief Form Feed
|
|
|
*/
|
|
|
- (void)feedToNextLabel;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置标签进纸的长度(dots).
|
|
|
*
|
|
|
* @brief 设置标签进纸的长度
|
|
|
* @param length 纸张走纸的距离,1 ≤ length ≤ 9999
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command feeds label with the specified length.
|
|
|
*
|
|
|
* @brief Feed Length
|
|
|
* @param length The length is specified by dot. 1 ≤ length ≤ 9999
|
|
|
*
|
|
|
*/
|
|
|
- (void)setFeedLength:(NSInteger)length;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置打印速度.
|
|
|
*
|
|
|
* @brief 设置打印速度
|
|
|
* @param speed 打印速度
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command defines the print speed.
|
|
|
*
|
|
|
* @brief Print Speed
|
|
|
* @param speed Printing speed in inch per second
|
|
|
*
|
|
|
*/
|
|
|
- (void)setPrintSpeed:(PTTSCPrintSpeed)speed;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置打印浓度.
|
|
|
*
|
|
|
* @brief 设置打印浓度
|
|
|
* @param density 打印浓度
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command sets the printing darkness.
|
|
|
*
|
|
|
* @brief Print Density
|
|
|
* @param density 0: specifies the lightest level,15: specifies the darkest level
|
|
|
*
|
|
|
*/
|
|
|
- (void)setPrintDensity:(PTTSCPrintDensity)density;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置打印的方向和镜像.
|
|
|
*
|
|
|
* @brief 设置打印的方向和镜像
|
|
|
* @param direction 正常或者方向打印
|
|
|
* @param mirror 正常或者镜像
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command defines the printout direction and mirror image.
|
|
|
*
|
|
|
* @brief Print Direction And Mirror
|
|
|
* @param direction normal or reverse
|
|
|
* @param mirror normal or mirror
|
|
|
*
|
|
|
*/
|
|
|
- (void)setPrintDirection:(PTTSCPrintDirection)direction mirror:(PTTSCPrintStyle)mirror;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置标签的参考起点.
|
|
|
*
|
|
|
* @brief 设置标签的参考起点
|
|
|
* @param x_pos 水平方向的坐标，以点为单位
|
|
|
* @param y_pos 垂直方向的坐标，以点为单位
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command defines the reference point of the label.
|
|
|
*
|
|
|
* @brief Set Label Reference Point
|
|
|
* @param x_pos Horizontal coordinate (in dots)
|
|
|
* @param y_pos Vertical coordinate (in dots)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setReferenceXPos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置国际字符集代码.
|
|
|
*
|
|
|
* @brief 设置国际字符集代码
|
|
|
* @param codepage 字符集类型
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command defines the code page of international character set.
|
|
|
*
|
|
|
* @brief International Character Set
|
|
|
* @param codepage Name or number of code page
|
|
|
*
|
|
|
*/
|
|
|
- (void)setCodePage:(PTTSCCharacterStyle)codepage;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 清除图像缓冲区.
|
|
|
*
|
|
|
* @brief 清除图像缓冲区
|
|
|
* \~english
|
|
|
*
|
|
|
* This command clears the image buffer.
|
|
|
*
|
|
|
* @brief Clear Buffer
|
|
|
*/
|
|
|
- (void)setCLS;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 回纸.
|
|
|
*
|
|
|
* @brief 回纸
|
|
|
* @param distance 回纸的距离，以点为单位(1,9999)
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command feeds the label in reverse. The length is specified by dot.
|
|
|
*
|
|
|
* @brief Feeds Label In Reverse
|
|
|
* @param distance unit: dot,(1,9999)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setBackFeed:(NSInteger)distance;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 回纸.
|
|
|
*
|
|
|
* @brief 回纸
|
|
|
* @param distance 回纸的距离，以点为单位(1,9999)
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command feeds the label in reverse. The length is specified by dot.
|
|
|
*
|
|
|
* @brief Feeds Label In Reverse
|
|
|
* @param distance unit: dot,(1,9999)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setBackUP:(NSInteger)distance;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置标签定位到内部传感器确定的起点.
|
|
|
*
|
|
|
* @brief 设置标签定位起点
|
|
|
* \~english
|
|
|
*
|
|
|
* This command will feed label until the internal sensor has determined the origin.
|
|
|
*
|
|
|
* @brief Feed label until the internal sensor has determined the origin
|
|
|
*/
|
|
|
- (void)setHome;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印数量.
|
|
|
*
|
|
|
* @brief 开始打印，设置打印数量
|
|
|
* @param sets 打印份数
|
|
|
* @param copies 每份打印的张数
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command prints the label format currently stored in the image buffer.
|
|
|
*
|
|
|
* @brief Begin Print,Set Print Copies
|
|
|
* @param sets Specifies how many sets of labels will be printed.
|
|
|
* @param copies Specifies how many copies should be printed for each particular label set.
|
|
|
*
|
|
|
*/
|
|
|
- (void)printWithSets:(NSInteger)sets copies:(NSInteger)copies;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 控制蜂鸣器的频率，可设置10阶的声音.
|
|
|
*
|
|
|
* @brief 控制蜂鸣器的频率
|
|
|
* @param level 音阶0~9
|
|
|
* @param interval 时间长度1~4095
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command controls the sound frequency of the beeper. There are 10 levels of sounds.
|
|
|
*
|
|
|
* @brief Control Frequency
|
|
|
* @param level Sound level: 0~9
|
|
|
* @param interval Sound interval: 1~4095
|
|
|
*
|
|
|
*/
|
|
|
- (void)setSoundWithLevel:(NSInteger)level interval:(NSInteger)interval;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置切纸.
|
|
|
* @brief 设置切纸
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command activates the cutter to immediately cut the labels without back feeding the label.
|
|
|
*
|
|
|
* @brief Set Cutter
|
|
|
*/
|
|
|
- (void)setCut;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置打印机进纸时,若无法正确的间隙位置，则会发生错误，立即停止进纸.
|
|
|
*
|
|
|
* @brief 设置进纸长度
|
|
|
* @param max_len 传感器检测的最大长度
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* If the gap sensor is not set to a suitable sensitivity while feeding labels, the printer will not be able to locate the correct position of the gap.
|
|
|
*
|
|
|
* @brief Set Feed Length
|
|
|
* @param max_len The maximum length for sensor detecting.
|
|
|
*
|
|
|
*/
|
|
|
- (void)setLimitFeed:(NSInteger)max_len;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置字体加粗.
|
|
|
*
|
|
|
* @brief 设置字体加粗
|
|
|
* @param bold true:加粗 false:不加粗
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Set font bold.
|
|
|
*
|
|
|
* @brief Font Bold
|
|
|
* @param bold true:bold false:not bold
|
|
|
*
|
|
|
*/
|
|
|
- (void)setFontBold:(BOOL)bold;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 开关打印状态回调.
|
|
|
*
|
|
|
* @brief 自动回传状态
|
|
|
* @note 开启之后，每打印一张都会返回10个字节的数据，格式：指令头4个字节(aa bb cc dd) + 4个字节的打印张数(从开启到关闭的打印总张数) + 1个字节的状态 + 结束符00,
|
|
|
返回两次数据，第一次表示返回可获取打印总张数和状态，第二次表示打印结束
|
|
|
比如：1.aabbccdd 03000000 2000
|
|
|
2.aabbccdd ffffffff 0000 -> 打印结束
|
|
|
aabbccdd 00000000 0000 -> 关闭自动回传
|
|
|
* @param status true:开启 false:关闭
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Turn on/off print status callback.
|
|
|
*
|
|
|
* @brief Automatic Return Status
|
|
|
* @note Returns 10 bytes of data,4-byte instruction header(aa bb cc dd) + 4 bytes of printed sheets + 1 byte status + Terminator(00),Returns twice the data, the first time to return to get the total number of prints and the status, the second time to end the end of printing
|
|
|
|
|
|
* @param status true:open false:close
|
|
|
*
|
|
|
*/
|
|
|
- (void)setPrinterStateAutomaticBackWithStatus:(BOOL)status;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 获取打印机状态.
|
|
|
*
|
|
|
* @brief 获取打印机状态
|
|
|
*
|
|
|
| 位(返回值) | 状态 |
|
|
|
| --------- | ----------- |
|
|
|
| 0 | 开盖 |
|
|
|
| 1 | 卡纸 |
|
|
|
| 2 | 缺纸 |
|
|
|
| 3 | 无碳带 |
|
|
|
| 4 | 暂停 |
|
|
|
| 5 | 打印中 |
|
|
|
| 6 | 开盖 |
|
|
|
| 7 | 高温 |
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Get print status.
|
|
|
* @brief Get Print Status
|
|
|
*
|
|
|
| Bit(return value) | Status |
|
|
|
| ----------------- | ------------- |
|
|
|
| 0 | Head opened |
|
|
|
| 1 | Paper jam |
|
|
|
| 2 | Out of paper |
|
|
|
| 3 | Out of ribbon |
|
|
|
| 4 | Pause |
|
|
|
| 5 | Printing |
|
|
|
| 6 | Cover opened |
|
|
|
| 7 | High |
|
|
|
*
|
|
|
*/
|
|
|
- (void)getPrinterStatus;
|
|
|
|
|
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
/********************* Label Commands ********************/
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 在标签上画一条线.
|
|
|
*
|
|
|
* @brief 画线
|
|
|
* @param x_pos 左上角水平方向起始点，以点表示
|
|
|
* @param y_pos 左上角垂直方向起始点，以点表示
|
|
|
* @param width 线宽，以点表示
|
|
|
* @param height 线高，以点表示
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command draws a bar on the label format.
|
|
|
*
|
|
|
* @brief Draws Bar
|
|
|
* @param x_pos The upper left corner x-coordinate (in dots)
|
|
|
* @param y_pos The upper left corner y-coordinate (in dots)
|
|
|
* @param width Bar width (in dots)
|
|
|
* @param height Bar height (in dots)
|
|
|
*
|
|
|
*/
|
|
|
- (void)drawBarWithXPos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
width:(NSInteger)width
|
|
|
height:(NSInteger)height;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印一维条码.
|
|
|
*
|
|
|
* @brief 打印一维条码
|
|
|
* @param x_pos 指定标签上条形码的x坐标
|
|
|
* @param y_pos 指定标签上条形码的y坐标
|
|
|
* @param type 条码类型
|
|
|
* @param height 条码高度
|
|
|
* @param readable 是否可读：0，不可读，1，可读
|
|
|
* @param rotation 旋转角度
|
|
|
* @param ratio 条码宽窄条比例
|
|
|
* @param context 条码内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command prints 1D barcodes.
|
|
|
*
|
|
|
* @brief 1D Barcodes
|
|
|
* @param x_pos Specify the x-coordinate of the bar code on the label
|
|
|
* @param y_pos Specify the y-coordinate of the bar code on the label
|
|
|
* @param type code type
|
|
|
* @param height Bar code height (in dots)
|
|
|
* @param readable 0: not readable 1: human readable
|
|
|
* @param rotation Rotation
|
|
|
* @param ratio The ratio of wide to narrow bars
|
|
|
* @param context The maximum number of digits of bar code content
|
|
|
*
|
|
|
*/
|
|
|
- (void)printBarcodeWithXPos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
type:(PTTSCBarcodeStyle)type
|
|
|
height:(NSInteger)height
|
|
|
readable:(PTTSCBarcodeReadbleStyle)readable
|
|
|
rotation:(PTTSCStyleRotation)rotation
|
|
|
ratio:(PTTSCBarcodeRatio)ratio
|
|
|
context:(NSString *)context;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印二维条码.
|
|
|
*
|
|
|
* @brief 打印二维条码
|
|
|
* @param x_pos 指定标签上二维码的x坐标
|
|
|
* @param y_pos 指定标签上二维码的y坐标
|
|
|
* @param ecc_level 纠错等级
|
|
|
* @param width 二维码大小
|
|
|
* @param mode 二维码模式
|
|
|
* @param rotation 旋转角度
|
|
|
* @param model 二维码模型
|
|
|
* @param mask 二维码mask
|
|
|
* @param context 二维码内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command prints QR code.
|
|
|
*
|
|
|
* @brief QR Code
|
|
|
* @param x_pos Specify the x-coordinate of the qr code on the label
|
|
|
* @param y_pos Specify the y-coordinate of the qr code on the label
|
|
|
* @param ecc_level Error correction recovery level
|
|
|
* @param width cell width
|
|
|
* @param mode mode
|
|
|
* @param rotation Rotation
|
|
|
* @param model model
|
|
|
* @param mask mask
|
|
|
* @param context qrcode context
|
|
|
*
|
|
|
*/
|
|
|
- (void)printQRcodeWithXPos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
eccLevel:(PTTSCQRcodeEcclevel)ecc_level
|
|
|
cellWidth:(PTTSCQRcodeWidth)width
|
|
|
mode:(PTTSCQRCodeMode)mode
|
|
|
rotation:(PTTSCStyleRotation)rotation
|
|
|
model:(PTTSCQRCodeModel)model
|
|
|
mask:(PTTSCQRcodeMask)mask
|
|
|
context:(NSString *)context;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印图片.
|
|
|
*
|
|
|
* @brief 打印图片
|
|
|
* @param xpos x起始坐标
|
|
|
* @param ypos y起始坐标
|
|
|
* @param mode 图形模式
|
|
|
* @param image 打印的图片
|
|
|
* @param bitmapMode 打印的图片模式
|
|
|
* @param compress 压缩模式
|
|
|
* @return 返回false的话，说明下发的图片数据大于打印机缓存区，应禁止下发
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Print Bitmap.
|
|
|
*
|
|
|
* @brief Print Bitmap
|
|
|
* @param xpos Specify the x-coordinate
|
|
|
* @param ypos Specify the y-coordinate
|
|
|
* @param mode Graphic modes
|
|
|
* @param image Image
|
|
|
* @param bitmapMode Bitmap mpde:binary/dithering
|
|
|
* @param compress Compress mode:TIFF/ZPL2/LZO/None
|
|
|
* @return The data is less than the cache and can be printed NO:The data exceeds the cache and cannot be printed
|
|
|
*
|
|
|
*/
|
|
|
- (BOOL)addBitmapWithXPos:(NSInteger)xpos
|
|
|
yPos:(NSInteger)ypos
|
|
|
mode:(PTTSCBitmapMode)mode
|
|
|
image:(CGImageRef)image
|
|
|
bitmapMode:(PTBitmapMode)bitmapMode
|
|
|
compress:(PTBitmapCompressMode)compress;
|
|
|
|
|
|
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印文本(针对点阵字库机型).
|
|
|
*
|
|
|
* @brief 打印文本(点阵字库)
|
|
|
* @param x_pos x起始坐标
|
|
|
* @param y_pos y起始坐标
|
|
|
* @param font 字体类型
|
|
|
* @param rotation 旋转角度
|
|
|
* @param x_multiplication 水平方向的放大倍数,1-10
|
|
|
* @param y_multiplication 垂直方向的放大倍数,1-10
|
|
|
* @param text 打印的文本内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Print Text(Printer for dot matrix font).
|
|
|
*
|
|
|
* @brief Print Text(Matrix Fonts)
|
|
|
* @param x_pos Specify the x-coordinate
|
|
|
* @param y_pos Specify the y-coordinate
|
|
|
* @param font Font type
|
|
|
* @param rotation Rotation
|
|
|
* @param x_multiplication Horizontal multiplication,up to 10x
|
|
|
* @param y_multiplication Vertical multiplication,up to 10x
|
|
|
* @param text print context
|
|
|
*
|
|
|
*/
|
|
|
- (void)appendTextWithXpos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
font:(PTTSCTextFontStyle)font
|
|
|
rotation:(PTTSCStyleRotation)rotation
|
|
|
xMultiplication:(NSInteger)x_multiplication
|
|
|
yMultiplication:(NSInteger)y_multiplication
|
|
|
text:(NSString *)text;
|
|
|
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印自动换行文本(针对点阵字库机型).
|
|
|
*
|
|
|
* @brief 打印自动换行文本(点阵字库)
|
|
|
* @param x_pos x起始坐标
|
|
|
* @param y_pos y起始坐标
|
|
|
* @param font 字体类型
|
|
|
* @param rotation 旋转角度
|
|
|
* @param x_multiplication 水平方向的放大倍数,1-10
|
|
|
* @param y_multiplication 垂直方向的放大倍数,1-10
|
|
|
* @param safeHeight 打印的安全高度，自动换行超过该高度部分不会打印
|
|
|
* @param width 打印的宽度，等于0表示不会自动换行
|
|
|
* @param lineSpacing 行间距
|
|
|
* @param text 打印的文本内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Print word wrap text(Printer for dot matrix font).
|
|
|
*
|
|
|
* @brief Print Word Wrap Text(Matrix Fonts)
|
|
|
* @param x_pos Specify the x-coordinate
|
|
|
* @param y_pos Specify the y-coordinate
|
|
|
* @param font Font type
|
|
|
* @param rotation Rotation
|
|
|
* @param x_multiplication Horizontal multiplication,up to 10x
|
|
|
* @param y_multiplication Vertical multiplication,up to 10x
|
|
|
* @param safeHeight Height of text field.Part will not print more than height
|
|
|
* @param width width of text field.if width is 0,not auto line
|
|
|
* @param lineSpacing line space.
|
|
|
* @param text print context
|
|
|
*
|
|
|
*/
|
|
|
- (NSInteger)printAutoTextWithXpos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
font:(PTTSCTextFontStyle)font
|
|
|
rotation:(PTTSCStyleRotation)rotation
|
|
|
xMultiplication:(NSInteger)x_multiplication
|
|
|
yMultiplication:(NSInteger)y_multiplication
|
|
|
safeHeight:(NSInteger)safeHeight
|
|
|
width:(NSInteger)width
|
|
|
lineSpacing:(NSInteger)lineSpacing
|
|
|
text:(NSString *)text;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印文本(矢量和点阵字库机型).
|
|
|
*
|
|
|
* @brief 打印文本
|
|
|
* @param x_pos x起始坐标
|
|
|
* @param y_pos y起始坐标
|
|
|
* @param font 字体类型
|
|
|
* @param rotation 旋转角度
|
|
|
* @param x_multiplication 水平方向的字体大小,如果字体类型是9，表示字体大小，否则表示的是放大倍数
|
|
|
* @param y_multiplication 垂直方向的字体大小,如果字体类型是9，表示字体大小，否则表示的是放大倍数
|
|
|
* @param text 打印的文本内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Print Text(Printer for vector fonts and dot fonts).
|
|
|
*
|
|
|
* @brief Print Text
|
|
|
* @param x_pos Specify the x-coordinate
|
|
|
* @param y_pos Specify the y-coordinate
|
|
|
* @param font Font type
|
|
|
* @param rotation Rotation
|
|
|
* @param x_multiplication Horizontal font size,If the type is 9, said the font size, or said is magnification
|
|
|
* @param y_multiplication Vertical font size,If the type is 9, said the font size, or said is magnification
|
|
|
* @param text print context
|
|
|
*
|
|
|
*/
|
|
|
- (void)appendTextForVectorWithXpos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
font:(PTTSCTextVectorFontStyle)font
|
|
|
rotation:(PTTSCStyleRotation)rotation
|
|
|
xMultiplication:(NSInteger)x_multiplication
|
|
|
yMultiplication:(NSInteger)y_multiplication
|
|
|
text:(NSString *)text;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印自动换行文本(矢量和点阵字库机型).
|
|
|
*
|
|
|
* @brief 打印自动换行文本(矢量字库)
|
|
|
* @param x_pos x起始坐标
|
|
|
* @param y_pos y起始坐标
|
|
|
* @param font 字体类型
|
|
|
* @param rotation 旋转角度
|
|
|
* @param x_multiplication 水平方向的字体大小,如果字体类型是9，表示字体大小，否则表示的是放大倍数
|
|
|
* @param y_multiplication 垂直方向的字体大小,如果字体类型是9，表示字体大小，否则表示的是放大倍数
|
|
|
* @param safeHeight 打印的安全高度，自动换行超过该高度部分不会打印
|
|
|
* @param width 打印的宽度，等于0表示不会自动换行
|
|
|
* @param lineSpacing 行间距
|
|
|
* @param text 打印的文本内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Print word wrap text(Printer for vector fonts and dot fonts).
|
|
|
*
|
|
|
* @brief Print Word Wrap Text(Vector Fonts)
|
|
|
* @param x_pos Specify the x-coordinate
|
|
|
* @param y_pos Specify the y-coordinate
|
|
|
* @param font Font type
|
|
|
* @param rotation Rotation
|
|
|
* @param x_multiplication Horizontal font size,If the type is 9, said the font size, or said is magnification
|
|
|
* @param y_multiplication Vertical font size,If the type is 9, said the font size, or said is magnification
|
|
|
* @param safeHeight Height of text field.Part will not print more than height
|
|
|
* @param width width of text field.if width is 0,not auto line
|
|
|
* @param lineSpacing line space.
|
|
|
* @param text print context
|
|
|
*
|
|
|
*/
|
|
|
- (NSInteger)printAutoTextForVectorWithXpos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
font:(PTTSCTextVectorFontStyle)font
|
|
|
rotation:(PTTSCStyleRotation)rotation
|
|
|
xMultiplication:(NSInteger)x_multiplication
|
|
|
yMultiplication:(NSInteger)y_multiplication
|
|
|
safeHeight:(NSInteger)safeHeight
|
|
|
width:(NSInteger)width
|
|
|
lineSpacing:(NSInteger)lineSpacing
|
|
|
text:(NSString *)text;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 将指定区域反白打印
|
|
|
*
|
|
|
* @brief 反白打印
|
|
|
* @param x_start x方向起点坐标（以点为单位）
|
|
|
* @param y_start y方向起点坐标（以点为单位）
|
|
|
* @param x_width x方向反白区域宽度（以点为单位）
|
|
|
* @param y_height y方向反白区域高度（以点为单位）
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command reverses a region in image buffer.
|
|
|
*
|
|
|
* @brief Reverses
|
|
|
* @param x_start The x-coordinate of the starting point (in dots)
|
|
|
* @param y_start The y-coordinate of the starting point (in dots)
|
|
|
* @param x_width X-axis region width (in dots)
|
|
|
* @param y_height Y-axis region height (in dots)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setReverseWithXStart:(NSInteger)x_start
|
|
|
yStart:(NSInteger)y_start
|
|
|
xWidth:(NSInteger)x_width
|
|
|
yHeight:(NSInteger)y_height;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 在标签上绘制矩形.
|
|
|
*
|
|
|
* @brief 绘制矩形
|
|
|
* @param x_start x起始坐标
|
|
|
* @param y_start y起始坐标
|
|
|
* @param x_end x终点坐标
|
|
|
* @param y_end y终点坐标
|
|
|
* @param thickness 线条宽度
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command draws rectangles on the label.
|
|
|
*
|
|
|
* @brief Draws Rectangles
|
|
|
* @param x_start Specify x-coordinate of upper left corner (in dots)
|
|
|
* @param y_start Specify y-coordinate of upper left corner (in dots)
|
|
|
* @param x_end Specify x-coordinate of lower right corner (in dots)
|
|
|
* @param y_end Specify y-coordinate of lower right corner (in dots)
|
|
|
* @param thickness Line thickness (in dots)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setBoxWithXStart:(NSInteger)x_start
|
|
|
yStart:(NSInteger)y_start
|
|
|
xEnd:(NSInteger)x_end
|
|
|
yEnd:(NSInteger)y_end
|
|
|
thickness:(NSInteger)thickness;
|
|
|
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 在标签上绘制椭圆.
|
|
|
*
|
|
|
* @brief 绘制椭圆
|
|
|
* @param x_start 指定左上角的x坐标（以点为单位）
|
|
|
* @param y_start 指定左上角的y坐标（以点为单位）
|
|
|
* @param width 椭圆的宽度（以点为单位）
|
|
|
* @param height 椭圆的高度（以点为单位）
|
|
|
* @param thickness 椭圆的厚度（以点为单位）
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Draw an ellipse on the label.
|
|
|
*
|
|
|
* @brief Draw Ellipse
|
|
|
* @param x_start Specify x-coordinate of upper left corner (in dots)
|
|
|
* @param y_start Specify y-coordinate of upper left corner (in dots)
|
|
|
* @param width Specify the width of the ellipse (in dots)
|
|
|
* @param height Specify the height of the ellipse (in dots)
|
|
|
* @param thickness Thickness of the ellipse (in dots)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setEllipseWithXStart:(NSInteger)x_start
|
|
|
yStart:(NSInteger)y_start
|
|
|
width:(NSInteger)width
|
|
|
height:(NSInteger)height
|
|
|
thickness:(NSInteger)thickness;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 在标签上绘制圆形.
|
|
|
*
|
|
|
* @brief 绘制圆形
|
|
|
* @param x_start 指定左上角的x坐标（以点为单位）
|
|
|
* @param y_start 指定左上角的y坐标（以点为单位）
|
|
|
* @param diameter 指定圆的直径（以点为单位）
|
|
|
* @param thickness 圆的厚度（以点为单位）
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command draws a circle on the label.
|
|
|
*
|
|
|
* @brief Draw Circle
|
|
|
* @param x_start Specify x-coordinate of upper left corner (in dots)
|
|
|
* @param y_start Specify y-coordinate of upper left corner (in dots)
|
|
|
* @param diameter Specify the diameter of the circle (in dots)
|
|
|
* @param thickness Thickness of the circle (in dots)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setCircleWithXStart:(NSInteger)x_start
|
|
|
yStart:(NSInteger)y_start
|
|
|
diameter:(NSInteger)diameter
|
|
|
thickness:(NSInteger)thickness;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 清除图像缓冲区中的特定区域.
|
|
|
*
|
|
|
* @brief 清除缓冲区某区域
|
|
|
* @param x_start 起点的x坐标（以点为单位）
|
|
|
* @param y_start 起点的y坐标（以点为单位）
|
|
|
* @param x_width x轴方向的区域宽度（以点为单位）
|
|
|
* @param y_height y轴方向的区域宽度（以点为单位）
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command clears a specified region in the image buffer.
|
|
|
*
|
|
|
* @brief Clear Specified BBuffer
|
|
|
* @param x_start The x-coordinate of the starting point (in dots)
|
|
|
* @param y_start The x-coordinate of the starting point (in dots)
|
|
|
* @param x_width The region width in x-axis direction (in dots)
|
|
|
* @param y_height The region height in y-axis direction (in dots)
|
|
|
*
|
|
|
*/
|
|
|
- (void)setEraseWithXStart:(NSInteger)x_start
|
|
|
yStart:(NSInteger)y_start
|
|
|
xWidth:(NSInteger)x_width
|
|
|
yHeight:(NSInteger)y_height;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印DMATRIX二维条码.
|
|
|
*
|
|
|
* @brief 打印DMATRIX二维条码
|
|
|
* @param x_pos 条形码水平方向起始位置，以点表示
|
|
|
* @param y_pos 条形码垂直方向起始位置，以点表示
|
|
|
* @param width 条码宽度，以点表示
|
|
|
* @param height 条码高度，以点表示
|
|
|
* @param xm 模块尺寸
|
|
|
* @param row 条形码列数:10-144
|
|
|
* @param col 条形码栏数:10-144
|
|
|
* @param expresssion 条形码内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command is used to define the DataMatrix 2D bar code.
|
|
|
*
|
|
|
* @brief DataMatrix 2D Barcode
|
|
|
* @param x_pos Specify the x-coordinate of the bar code on the label
|
|
|
* @param y_pos Specify the y-coordinate of the bar code on the label
|
|
|
* @param width The expected width of barcode area (in dots)
|
|
|
* @param height The expected height of barcode area (in dots)
|
|
|
* @param xm Module size (in dots)
|
|
|
* @param row Symbol size of row: 10 to 144
|
|
|
* @param col Symbol size of col: 10 to 144
|
|
|
* @param expresssion Barcode content
|
|
|
*
|
|
|
*/
|
|
|
- (void)drawDmatrixBarcodeWithXPos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
width:(NSInteger)width
|
|
|
height:(NSInteger)height
|
|
|
xm:(PTTSCDMATRIXSize)xm
|
|
|
row:(NSInteger)row
|
|
|
col:(NSInteger)col
|
|
|
expression:(NSString *)expresssion;
|
|
|
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印PDF417条码.
|
|
|
*
|
|
|
* @brief 打印PDF417条码
|
|
|
* @param x_pos 条形码水平方向起始位置，以点表示
|
|
|
* @param y_pos 条形码垂直方向起始位置，以点表示
|
|
|
* @param width 条码宽度，以点表示
|
|
|
* @param height 条码高度，以点表示
|
|
|
* @param rotate 条码码旋转
|
|
|
* @param option 可选参数，详情在文档给出
|
|
|
* @param expresssion 条形码内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command defines a PDF417 2D barcode.
|
|
|
*
|
|
|
* @brief PDF417 Barcode
|
|
|
* @param x_pos Specify the x-coordinate of the bar code on the label
|
|
|
* @param y_pos Specify the y-coordinate of the bar code on the label
|
|
|
* @param width The expected width of barcode area (in dots)
|
|
|
* @param height The expected height of barcode area (in dots)
|
|
|
* @param rotate Rotation counterclockwise.
|
|
|
* @param option Details are given in the documentation
|
|
|
* @param expresssion Barcode content
|
|
|
*
|
|
|
*/
|
|
|
- (void)printPDF417WithXPos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos
|
|
|
width:(NSInteger)width
|
|
|
height:(NSInteger)height
|
|
|
rotate:(PTTSCStyleRotation)rotate
|
|
|
option:(NSString *)option
|
|
|
expression:(NSString *)expression;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印AZTEC条码.
|
|
|
*
|
|
|
* @brief 打印AZTEC条码
|
|
|
* @param xPos 条形码水平方向起始位置，以点表示
|
|
|
* @param yPos 条形码垂直方向起始位置，以点表示
|
|
|
* @param rotate 旋转角度
|
|
|
* @param size 元素模块大小（1到20），默认为6
|
|
|
* @param ecp 错误控制（＆符号大小/类型）参数
|
|
|
* @param flg 0：输入消息是直字节 1：输入使用
|
|
|
* @param menu 菜单符号（0：否，1：是），默认为0
|
|
|
* @param multi 符号数（1到26），默认为6
|
|
|
* @param rev 输出要反转（0：否，1：是），默认为0
|
|
|
* @param aztecData 条形码内容
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command defines a AZTEC 2D barcode.
|
|
|
*
|
|
|
* @brief AZTEC Barcode
|
|
|
* @param xPos Specify the x-coordinate of the bar code on the label
|
|
|
* @param yPos Specify the y-coordinate of the bar code on the label
|
|
|
* @param rotate Rotation
|
|
|
* @param size Element module size (1 to 20), default is 6
|
|
|
* @param ecp Error control (& symbol size/type) parameter
|
|
|
* @param flg 0 : input message is straight bytes 1:input uses
|
|
|
* @param menu Menu symbol (0 : no, 1 : yes), default is 0
|
|
|
* @param multi Number of symbols (1 to 26), default is 6
|
|
|
* @param rev Output to be reversed (0 : no, 1 : yes), default is 0
|
|
|
* @param aztecData Barcode content
|
|
|
*
|
|
|
*/
|
|
|
- (void)printAztecWithXPos:(NSInteger)xPos
|
|
|
yPos:(NSInteger)yPos
|
|
|
rotate:(PTTSCStyleRotation)rotate
|
|
|
size:(NSInteger)size
|
|
|
ecp:(NSInteger)ecp
|
|
|
flg:(NSInteger)flg
|
|
|
menu:(NSInteger)menu
|
|
|
multi:(NSInteger)multi
|
|
|
rev:(NSInteger)rev
|
|
|
aztecData:(NSString *)aztecData;
|
|
|
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印BMP格式图像.
|
|
|
*
|
|
|
* @brief 打印BMP格式图像
|
|
|
* @param filename 下载的BMP文件名
|
|
|
* @param x_pos BMP格式图像的x坐标
|
|
|
* @param y_pos BMP格式图像的y坐标
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command prints BMP format images.
|
|
|
*
|
|
|
* @brief BMP Format Image
|
|
|
* @param filename The downloaded BMP filename.
|
|
|
* @param x_pos The x-coordinate of the BMP format image
|
|
|
* @param y_pos The y-coordinate of the BMP format image
|
|
|
*
|
|
|
*/
|
|
|
- (void)printBMPWithFilename:(NSString *)filename
|
|
|
xPos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 打印PCX格式图像.
|
|
|
*
|
|
|
* @brief 打印PCX格式图像
|
|
|
* @param filename 下载的PCX文件名
|
|
|
* @param x_pos PCX格式图像的x坐标
|
|
|
* @param y_pos PCX格式图像的y坐标
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This command prints PCX format images.
|
|
|
*
|
|
|
* @brief PCX Format Image
|
|
|
* @param filename The downloaded PCX filename.
|
|
|
* @param x_pos The x-coordinate of the PCX format image
|
|
|
* @param y_pos The y-coordinate of the PCX format image
|
|
|
*
|
|
|
*/
|
|
|
- (void)printPCXWithFilename:(NSString *)filename
|
|
|
xPos:(NSInteger)x_pos
|
|
|
yPos:(NSInteger)y_pos;
|
|
|
|
|
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
/********************* Device Reconfiguration Commands ********************/
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 计数器设置.
|
|
|
*
|
|
|
* @brief 计数器设置
|
|
|
* @param counterNumber 表示选择哪个计数器：0-50
|
|
|
* @param step 表示计数间隔（-99999999 ~ 99999999）
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Counters can be a real counter or a variable.This setting sets the counter number in the program and its increments.
|
|
|
*
|
|
|
* @brief Set The Counter
|
|
|
* @param counterNumber counter number. There are 51 counters available (@0~@50) in the printer.
|
|
|
* @param step The increment of the counter, can be positive or negative.（-99999999 ~ 99999999）
|
|
|
*
|
|
|
*/
|
|
|
- (void)setCounterWithCounterNumber:(NSInteger)counterNumber
|
|
|
step:(NSInteger)step;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置打印机切割器状态.
|
|
|
*
|
|
|
* @brief 切割器状态
|
|
|
* @param status true:打印结束后切割 false：禁用切刀功能
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* This setting activates or deactivates the cutter.
|
|
|
*
|
|
|
* @brief Cutter Status
|
|
|
* @param status true:Set printer to cut label at the end of printing job false：Disable cutter function
|
|
|
*
|
|
|
*/
|
|
|
- (void)setCutterStatus:(BOOL)status;
|
|
|
|
|
|
/*!
|
|
|
* \~chinese
|
|
|
*
|
|
|
* 设置每个切割的打印标签数量
|
|
|
*
|
|
|
* @brief 切割数量
|
|
|
* @param pieces 0 ~ 65535
|
|
|
*
|
|
|
* \~english
|
|
|
*
|
|
|
* Set number of printing labels per cut.
|
|
|
*
|
|
|
* @brief Number Of Cut
|
|
|
* @param pieces 0 ~ 65535
|
|
|
*
|
|
|
*/
|
|
|
- (void)setCutterPieces:(NSInteger)pieces;
|
|
|
|
|
|
|
|
|
|
|
|
@end
|
