목차 1. 매뉴얼안내 지원장치 지원 Platform & 개발환경 지원 Printer/Interface 목록 지원 Properties 목록 지원 Method 목록 SDK 프로

Transcription

1 ios SDK API 레퍼런스가이드 Rev SRP-F310 / SRP-F312 SRP-F310II / SRP-F312II SRP-F313II SRP-350plus / SRP-352plus SRP-350plusII / SRP-352plusII SRP-350II / SRP-350IIOBE SRP-350III / SRP-352III SRP-350plusIII/SRP-352plusIII SRP-275 / SRP-275II SRP-275III SRP-340 SPP-R200II / SPP-R200III SPP-R210 / SPP-R220 SPP-R300 / SPP-R310 SPP-R400 / SPP-R410 SRP-380 / SRP-382 SRP-330II / SRP-332II SRP-340II / SRP-342II SRP-S300 SRP-Q300 / SRP-Q302

2 목차 1. 매뉴얼안내 지원장치 지원 Platform & 개발환경 지원 Printer/Interface 목록 지원 Properties 목록 지원 Method 목록 SDK 프로젝트설정 ExternalAccessory.framework 추가하기 Bluetooth Protocol 추가하기 프로젝트에 Bixolon Library 추가하기 상수값 상수값정의 Character Set International Character Set Text Encoding Barcode/Image/Text Alignment Text Size Text Attribute Barcode Text Position Barcode Symbology Image Width Status Check Mask Power State Connection Control Drawer kick-out connector pin Drawer open level Model ID Connection Class Result Code BXBarcode Class Reference Overview Properties barnumber name support BXPrinter Class Reference Overview Properties name address port modelstr versionstr connectionclass Rev

3 Rev ios Printer SDK 5. BXPrinterController Class Reference Overview Properties version delegate target lookupduration lookupcount alignment attribute textsize characterset internationalcharacterset textencoding state power AutoConnection drawerpin draweropenlevel textposition Instance Methods getinstance open close lookup selecttarget connect disconnect enablelsb printtext printbox linefeed nextprintpos printbarcode printbitmap printbitmapwithimage cutpaper checkprinter msrreadready msrreadcancel msrreadtrack msrgettrack msrreadfulltrack directio icon icoff icapdu icgetstatus nvimagelist downloadnvimage (Diffusion) downloadnvimage (Normal) printnvimage removenvimage removeallnvimages opendrawer... 85

4 setasyncmode begintransaction endtransaction setpagearea setverticalposition setleftposition printdatainpagemode issupport_msr issupport_ic issupport_config issupport_cashdrawer issupport_lsb getbarcodesupporttable BXPrinterControllerDelegate Protocol Reference Overview Instance Methods didstart didstop didfindprinter didconnect didnotconnect willlookupprinters didlookupprinters didnotlookup didbebrokenconnection diddisconnect msrarrived didupdatestatus outputcomplete Appendix Error Diffusion Printer Model 분류 Transaction / Async mode 조합설정비교 Rev

5 1. 매뉴얼안내 이 SDK 매뉴얼에는 ios 용응용프로그램개발에필요한 Library 에대한내용이기술되어있습니다. 저희 빅솔론은제품의기능과품질향상을위하여지속적인개선을하고있습니다. 이로인하여제품의사양과매뉴얼의내용은사전통보없이변경될수있습니다. 1-1 지원장치 아래의리스트는검증된장치리스트입니다. iphone 4 / 5 / 5s / 6 / 6Plus / 6s / 6s Plus ipad2 / ipad mini / ipad Air / ipad Pro 1-2 지원 Platform & 개발환경 - Platform ios 이상 Rev

6 1-3 지원 Printer/Interface 목록 Method/Property Ethernet Wi-Fi Bluetooth SRP-275 O X X SRP-275II O X X SRP-275III O X X SRP-350II O X X SRP-350IIOBE O X O SRP-350III O X X SRP-352III O X X SRP-350plus O X X SRP-350plusII O X X SRP-350plusIII O O O SRP-352plus O X X SRP-352plusII O X X SRP-352plusIII O O O SRP-F310 O O X SRP-F312 O O X SRP-F310II O O O SRP-F312II O O O SRP-F313II O O O SRP-340 O X X SPP-R200II X O O SPP-R210 X O O SPP-R220 X O O SPP-R300 X O O SPP-R400 X O O SPP-R410 X O O SPP-R200III X O O SPP-R310 X O O SRP-380 O O O SRP-382 O O O SRP-330II O X X SRP-332II O X X SRP-340II O X X SRP-342II O X X SRP-S300 O O O SRP-Q300 O O O SRP-Q302 O O O Rev

7 1-4 지원 Properties 목록 Property POS Printer Mobile Printer Version O O delegate O O Target O O lookupduration O O lookupcount O O alignment O O attribute O O textsize O O characterset O O internationalcharacterset O O State O O Power O O AutoConnection O O drawerpin O X draweropenlevel O X Rev

8 1-5 지원 Method 목록 Method POS Printer Mobile Printer getinstance O O General open O O close O O lookup O O willlookupprinters O O Search didfindprinter O O didlookupprinters O O didnotlookup O O selecttarget O O connect O O disconnect O O Connection didconnect O O diddisconnect O O didnotconnect O O didbebrokenconnection O O enablelsb O O checkprinter O O issupport_msr O O Status Check issupport_ic O O issupport_config O O issupport_cashdrawer O O issupport_lsb O O getbarcodesupporttable O O printtext O O printbox O O linefeed O O Printings nextprintpos O O printbarcode O O printbitmap O O printbitmapwithimage O O msrreadready X O msrreadcancel X O MSR msrreadtrack X O msrgettrack X O msrreadfulltrack X O Direct IO directio O O Rev

9 icon X X IC Card icoff X X icapdu X X icgetstatus X X nvimagelist O O downloadnvimage (Diffusion) O O NV Image downloadnvimage (Normal) O O printnvimage O O removenvimage O O removeallnvimages O O Cash Drawer opendrawer O X Rev

10 1-6 SDK 프로젝트설정 [ 참고 ] ios 개발을위해애플개발자프로그램이등록되어있어야합니다. 자세한내용은애플개발자사이트 ( 를참조하십시오 ExternalAccessory.framework 추가하기 ) Project 파일을선택 2) Info Tab 을선택 3) 3 번의영역에서 ctrl + click 4) 팝업메뉴가보이면 Add Row 선택 5 5) Supported external accessory protocols 를입력 6) Item 항목에 com.bixolon.protocol 을입력. Rev

11 1-6-2 Bluetooth Protocol 추가하기 1) Project Info - + 를차례로선택 ) ExternalAccessory.framework 를검색후 Add 버튼을눌러추가. Rev

12 1-6-3 프로젝트에 Bixolon Library 추가하기 1) Library 폴더를프로젝트에드래그 & 드롭합니다. Drag & Drop Rev

13 2. 상수값 제공하는 SDK 에서사용하는상수값은 BXCode.h 파일에정의되어있습니다. 2-1 상수값정의 Character Set 코드페이지를정의하는속성으로기본값은 BXL_CS_437 로설정됩니다. 사용가능한코드페이지는다음과같습니다. Code Value Description BXL_CS_PC437 0 Code page PC437 BXL_CS_Katakana 1 Katakana BXL_CS_PC850 2 Code page PC850 BXL_CS_PC860 3 Code page PC860 BXL_CS_PC863 4 Code page PC863 BXL_CS_PC865 5 Code page PC860 BXL_CS_WPC Code page WPC1252 BXL_CS_PC Code page PC860 BXL_CS_PC Code page PC852 BXL_CS_PC Code page PC858 BXL_CS_PC Code page PC864 BXL_CS_THAI42 23 Code page THAI42 BXL_CS_WPC Code page WPC1253 BXL_CS_WPC Code page WPC1254 BXL_CS_WPC Code page WPC1257 BXL_CS_FARSI 27 Code page FARSI BXL_CS_WPC Code page WPC1251 BXL_CS_PC Code page PC737 BXL_CS_PC Code page PC775 BXL_CS_THAI14 31 Code page THAI14 BXL_CS_PC Code page PC862 BXL_CS_PC Code page PC855 BXL_CS_PC Code page PC857 BXL_CS_PC Code page PC928 BXL_CS_THAI16 39 Code page THAI16 BXL_CS_WPC Code page WPC1256 BXL_CS_USER 255 User set page Rev

14 2-1-2 International Character Set International character set 을정의하는속성으로기본값은 BXL_ICS_USA 로설정됩니다. 사용가능한 International Character Set은다음과같습니다. Code Value Description BXL_ICS_USA 0 U.S.A BXL_ICS_FRANCE 1 France BXL_ICS_GERMANY 2 Germany BXL_ICS_UK 3 U.K BXL_ICS_DENMARK1 4 Denmark I BXL_ICS_SWEDEN 5 Sweden BXL_ICS_ITALY 6 Italy BXL_ICS_SPAIN 7 Spain BXL_ICS_NORWAY 9 Norway BXL_ICS_DENMARK2 10 Denmark II Text Encoding Text Encoding 형식을정의하는속성으로기본값은 BXL_TEXTENCODING_SINGLEBYTEFONT 로설정됩니다. 사용가능한 Text Encoding 은다음과같습니다. Code Value Description BXL_TEXTENCODING_SINGLEBYTEFONT 0x Default. Single byte font 사용. BXL_TEXTENCODING_KSC5601 0x 한국어인코딩 BXL_TEXTENCODING_SHIFT_JIS 0x 일본어인코딩 BXL_TEXTENCODING_BIG5 0x80000a03 중국어인코딩 BIG5 BXL_TEXTENCODING_GB2312 0x 중국어인코딩 GB2312 BXL_TEXTENCODING_GB x 중국어인코딩 GB18030 더많은인코딩형식을보시려면 NSString.h NSStringEncoding 을참조하십시오. Rev

15 2-1-4 Barcode/Image/Text Alignment 바코드 / 이미지 / 텍스트정렬값을정의하는속성으로기본값은 BXL_ALIGNMENT _LEFT 로설정됩니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_ALIGNMENT_LEFT 0 왼쪽정렬 BXL_ALIGNMENT_CENTER 1 가운데정렬 BXL_ALIGNMENT_RIGHT 2 오른쪽정렬 Text Size 텍스트크기를설정값을정의하는속성으로가로배율과세로배율값을 OR 연산으로동시에지정할수있습니다. 사용가능한속성은다음과같습니다. <Width 속성 > Code Value Description BXL_TS_0WIDTH 0 가로넓이배율을 X1로설정합니다. BXL_TS_1WIDTH 16 가로넓이배율을 X2로설정합니다. BXL_TS_2WIDTH 32 가로넓이배율을 X3로설정합니다. BXL_TS_3WIDTH 48 가로넓이배율을 X4로설정합니다. BXL_TS_4WIDTH 64 가로넓이배율을 X5로설정합니다. BXL_TS_5WIDTH 80 가로넓이배율을 X6로설정합니다. BXL_TS_6WIDTH 96 가로넓이배율을 X7로설정합니다. BXL_TS_7WIDTH 112 가로넓이배율을 X8로설정합니다. <Height 속성 > Code Value Description BXL_TS_0HEIGHT 0 세로높이배율을 X1로설정합니다. BXL_TS_1HEIGHT 16 세로높이배율을 X2로설정합니다. BXL_TS_2HEIGHT 32 세로높이배율을 X3로설정합니다. BXL_TS_3HEIGHT 48 세로높이배율을 X4로설정합니다. BXL_TS_4HEIGHT 64 세로높이배율을 X5로설정합니다. BXL_TS_5HEIGHT 80 세로높이배율을 X6로설정합니다. BXL_TS_6HEIGHT 96 세로높이배율을 X7로설정합니다. BXL_TS_7HEIGHT 112 세로높이배율을 X8로설정합니다. Rev

16 2-1-6 Text Attribute 텍스트속성을설정하며, 각속성은 OR 로중첩될수있습니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_FT_DEFAULT 0 기본속성 NOT BOLD, FONTA, NOT UNDERLINE, NOT REVERSE BXL_FT_FONTB 1 FONTB를사용합니다. BXL_FT_FONTC 16 FONTC를사용합니다. BXL_FT_BOLD 2 볼드속성을지정합니다. BXL_FT_UNDERLINE 4 언더라인속성을지정합니다. BXL_FT_REVERSE 8 반전속성을지정합니다. BXL_ExFT_CHINA_FONTB Barcode Text Position 바코드데이터를출력시키는위치를설정합니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_BC_TEXT_NONE 0 바코드데이터를출력하지않습니다. BXL_BC_TEXT_ABOVE 1 바코드데이터를바코드위쪽에출력합니다. BXL_BC_TEXT_BELOW 2 바코드데이터를바코드아래쪽에출력합니다. Rev

17 2-1-8 Barcode Symbology 바코드타입을정의합니다. 사용가능한속성은다음과같습니다. Code Value 데이터개수 데이터범위 BXL_BCS_UPCA <= n <= <= data <= 57 BXL_BCS_UPCE <= n <= <= data <= 57 BXL_BCS_EAN <= n <= <= data <= 47 BXL_BCS_JAN <= n <= 8 48 <= data <= <= data <= 90 data = 32,36,37,43,45,46,47 BXL_BCS_EAN <= n <= 8 48 <= data <= 57 BXL_BCS_JAN <= n <= 8 48 <= data <= 57 BXL_BCS_Code <= n <= 255 BXL_BCS_ITF <= n <= 255 ( 짝수 ) BXL_BCS_Codabar <= n <= <= data <= <= data <= 68 data = 32,36,37,43,45,46,47 48 <= data <= <= data <= <= data <= 68 data = 36,43,45,46,47,58 BXL_BCS_Code <= n <= <= data <= 127 BXL_BCS_Code <= n <= <= data <= 127 BXL_BCS_PDF <= n <= <= data <= 255 BXL_BCS_QRCODE 202~203 2 <= n <= <= data <= 255 BXL_BCS_DATAMATRIX <= n <= <= data <= 255 BXL_BCS_MAXICODE 205~6 2 <= n <= <= data <= 255 Rev

18 2-1-9 Image Width 이미지의너비를설정합니다. 0~ 최대너비까지설정할수있습니다. 아래값을설정시조건에맞게이미지크기가변환됩니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_WIDTH_FULL -1 최대너비값으로설정되어용지크기에맞게이미지가변환됩니다. BXL_WIDTH_NONE -2 이미지의크기변화를주지않습니다 Status Check Mask 프린터상태를검사할범위를지정하는속성입니다. checkprinter Method 의 Parameter 로사용됩니다. 배터리잔량상태값은다음과같습니다. Code Value Description BXL_MASK_COVERSTATUS 1 프린터의커버상태를체크합니다. BXL_MASK_PAPERSTATUS 2 프린터의종이상태를체크합니다. BXL_MASK_POWERSTATUS 4 프린터의전원상태를체크합니다. BXL_MASK_MODELNAME 8 프린터의모델명을확인합니다. BXL_MASK_VERSION 16 프린터의 Firmware 버전을확인합니다. BXL_MASK_CASHDRAWER 32 프린터에 CashDrawer가연결되어있을경우 CashDrawer의상태를확인합니다. BXL_MASK_ALL 0XFF 위의모든상태를체크합니다 Power 프린터의배터리잔량상태값이설정되는속성입니다. 읽기만가능하며프린터의배터리상태가변할때마다이속성에설정됩니다 배터리잔량상태값은다음과같습니다. Code Value Description BXL_PWR_HIGH 0 배터리잔량이 95% 충전된상태입니다. BXL_PWR_MIDDLE 1 배터리잔량이 85% 충전된상태입니다. BXL_PWR_LOW 2 배터리잔량이 50% 충전된상태입니다. BXL_PWR_SMALL 3 배터리잔량이 25% 충전된상태입니다. BXL_PWR_NOT 4 배터리잔량이 25% 이하충전된상태입니다. Rev

19 State 프린터상태가설정되는속성입니다. 읽기만가능하며 CheckPrinter 함수를호출하여프린터상태를검사할때이속성이자동으로설정됩니다. 상태값은중복되어설정될수있으며비트연산을통해각각의값을확인할수있습니다. 프린터상태값은다음과같습니다. Code Value Description BXL_STS_NORMAL 0 정상상태 BXL_STS_PAPEREMPTY 1 종이가없습니다. BXL_STS_COVEROPEN 2 프린터커버가열려있습니다. BXL_STS_POWEROVER 4 프린터배터리잔량이모자랍니다. BXL_STS_MSR_READY 8 인쇄불능 MSR 읽기모드상태입니다. BXL_STS_PRINTING 16 프린터가인쇄중 / 데이터전송중입니다. BXL_STS_ERROR 32 프린터와교신중오류가발생되었습니다. BXL_STS_NOT_OPEN 64 BXPrinterControl의 open 메소드가호출되지않았습니다. BXL_STS_ERROR_OCCUR 128 프린터내부에오류가생겼습니다. BXL_STS_NOT_CONNECTED -1 현재프린터에연결되지않았습니다 Connection Control 프린터접속방식을설정합니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_CONNECTIONMODE_AUTO 0 자동연결모드 BXL_CONNECTIONMODE_NOAUTO 100 수동연결모드 Drawer kick-out connector pin Cash drawer 연결에사용할핀의번호를설정합니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_CASHDRAWER_PIN_2 0 Cash drawer 연결핀 : 2 BXL_CASHDRAWER_PIN_5 1 Cash drawer 연결핀 : Drawer open level Cash drawer 방식을설정합니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_CASHDRAWER_OPENLEVEL_LOW 0 Cash drawer 가열리면 Low BXL_CASHDRAWER_OPENLEVEL_HIGH 1 Cash drawer 가열리면 High Rev

20 Model ID 할당할프린터타입을지정합니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_MODEL_ID_SPPR200II 0x SPP-R200II BXL_MODEL_ID_SRPR210 0x SPP-R210 BXL_MODEL_ID_SPPR220 0x SPP-R220 BXL_MODEL_ID_SRPR300 0x SPP-R300 BXL_MODEL_ID_SPPR400 0x SPP-R400 BXL_MODEL_ID_SPPR410 0x SPP-R410 BXL_MODEL_ID_SRP350II 0x SRP-350II BXL_MODEL_ID_SRP350plus 0x SRP-350plus BXL_MODEL_ID_SRP352plus 0x SRP-352plus BXL_MODEL_ID_SRP350plusII 0x SRP-350plusII BXL_MODEL_ID_SRP352plusII 0x SRP-352plusII BXL_MODEL_ID_SRP350III 0x SRP-350III BXL_MODEL_ID_SRP352III 0x SRP-352III BXL_MODEL_ID_SRP275 0x SRP-275, SRP-275II BXL_MODEL_ID_SRP275III 0x SRP-275III BXL_MODEL_ID_SRPF310 0x SRP-F310 BXL_MODEL_ID_SRPF312 0x SRP-F312 BXL_MODEL_ID_SRPF310II 0x SRP-F310II BXL_MODEL_ID_SRPF312II 0x SRP-F312II BXL_MODEL_ID_SRPF313II 0x SRP-F313II BXL_MODEL_ID_SRP350plusIII 0x SRP-350plusIII BXL_MODEL_ID_SRP352plusIII 0x SRP-352plusIII BXL_MODEL_ID_SRP340 0x SRP-340 BXL_MODEL_ID_SPPR200III 0x SPP-R200III BXL_MODEL_ID_SRPF310 0x SPP-R310 BXL_MODEL_ID_SRP380 0x SRP-380 BXL_MODEL_ID_SRP382 0x SRP-382 BXL_MODEL_ID_SRPF310II 0x SRP-330II BXL_MODEL_ID_SRPF312II 0x SRP-332II BXL_MODEL_ID_SRP340II 0x SRP-340II BXL_MODEL_ID_SRP342II 0x SRP-342II BXL_MODEL_ID_SRPS300 0x SRP-S300 BXL_MODEL_ID_SRPQ300 0x SRP-Q300 BXL_MODEL_ID_SRPQ302 0x SRP-Q302 Rev

21 Connection Class 프린터의연결타입을정의합니다. didfindprinter 함수가호출될때 BXPrinter class 의 connectionclass 에갱신됩니다. Code Value Description BXL_CONNECTIONCLASS_WIFI 0x0000 WIFI Connection BXL_CONNECTIONCLASS_ETHERNET 0x0001 Ethernet Connection BXL_CONNECTIONCLASS_BLUETOOTH 0x0002 Bluetooth Connection Result Code Method 에서특정기능을수행후반환하는결과값을정의합니다. Code DEFINE Value Description BXL_SUCCESS 0 성공 BXL_NOT_CONNECTED -1 프린터와연결되지않았습니다. BXL_NOT_OPENED 101 SDK가 OPEN되지않았습니다. BXL_STATUS_ERROR 103 상태검사에서에러가발생되었습니다. BXL_CONNECT_ERROR 105 접속실패 BXL_NOT_SUPPORT 107 지원되지않음 BXL_BAD_ARGUMENT 108 잘못된함수인자 BXL_BUFFER_ERROR 109 MSR 버퍼가정상적이지않은경우 BXL_NOT_CONNECTED 110 프린터와연결되어있지않음 BXL_RGBA_ERROR 111 이미지파일을 RGBA 데이터로변환과정에서오류발생 BXL_MEMORY_ERROR 112 메모리할당실패 BXL_TOO_LARGE_IMAGE 113 NV 영역에이미지다운로드시너무큰이미지파일인경우 BXL_NOT_SUPPORT_DEVICE 114 프린터에서지원되지않습니다. BXL_READ_ERROR 301 데이터수신이실패하였습니다. BXL_WRITE_ERROR 300 데이터전송이실패하였습니다. BXL_BITMAPLOAD_ERROR 400 이미지파일을읽지못했습니다. BXL_BC_DATA_ERROR 500 바코드데이터가잘못되었습니다. BXL_BC_NOT_SUPPORT 501 지원되지않는바코드타입입니다. BXLMSR_NOTREADY 602 MSR READY 상태가아닙니다. BXLMSR_FAILEDMODE 601 자동읽기모드가아닙니다. BXLMSR_DATAEMPTY 603 MSR에서읽은데이터가없습니다. 1001H 알수없는명령어입니다. 1002H 동작이불가능한수행입니다. 1003H 정확하지않은인자수입니다. 1004H 알수없는명령어또는유효하지않은명령어의첫바이트입니다. 1005H 응답시간이초과되었습니다. Rev

22 Code DEFINE Value Description 1010H 카드리셋으로인한응답에러입니다. 또는응답의첫번째바이트가유효하지않습니다. 1012H 메세지제한초과되었습니다. 최대 254바이트, 카드데이터는 248바이트입니다. 1013H 비동기루틴에서바이트읽기에러발생 1015H 카드모드가종료됨. 카드모드명령어전송필요 101BH 인자가부정확한명령어가전송 101DH TCK check 바이트가올바르지않음 10A0H 카드리셋응답에서에러발생 ( 알수없는프로토콜또는 TA1 바이트인식오류 ) 카드미지원. 리셋을위한카드응답값이없음 10A1H 카드프로토콜에러 (T=0/T=1) 10A2H 카드응답이없어타임아웃발생 10A3H 패러티에러 10A4H 카드의연결이끊어졌습니다.(T=1) 10A5H 리더의연결이끊어졌습니다.(T=2) 10A6H IC 모듈과 RESYNCH가성공적으로수행 10A7H PPS 에러 10A8H IC 모듈이이미 IC CARD 모드로되어있음 10B0H PC 링크명령어를지원하지않음 10E4H 카드가유효하지않은 Procedure byte를보냈습니다. 10E5H 카드교환이중단되었습니다.. 10E7H 카드에서에러가리턴 10F7H 명렁어처리중카드가제거 10F8H 카드가전기적으로소모되어사용할수없습니다. 10FBH 카드인식불량또는카드입력이되지않습니다. Rev

23 3. BXBarcode Class Reference Inherits from Confirms to Framework Declared NSObject BXPrinter.a ios 4.3 and later BXBarcodeInfo.h 3-1 Overview BXBarcode Class 는제어대상이되는프린터의 Barcode Type 별지원여부에대한정보를가지는객체입니다. 3-2 Properties barnumber Barcode Define int barnumber [Discussion] 접속된프린터의정보수집을통해자동으로저장됩니다. [See Also] Barcode Symbology SDK and later name Barcode NSString * barname [Discussion] 접속된프린터의정보수집을통해자동으로저장됩니다. SDK and later Rev

24 3-2-3 support BOOL support [Discussion] 접속된프린터의정보수집을통해자동으로저장됩니다. SDK and later Rev

25 4. BXPrinter Class Reference Inherits from Confirms to Framework Declared NSObject BXPrinter.a ios 4.3 and later BXPrinterObject.h 4-1 Overview BXPrinter Class 는제어대상이되는프린터의정보 ( 이름 / 네트워크주소 / 포트 ) 를가지는객체입니다. 4-2 Properties name NSString * name [Discussion] 접속된프린터의정보수집을통해이름은자동으로저장됩니다. SDK and later address NSString * address [Discussion] 접속전프린터의네트워크주소를먼저지정해주어야합니다. SDK and later Rev

26 4-2-3 port unsigned short port [Discussion] 접속전프린터의네트워크포트를먼저지정해주어야합니다. SDK and later modelstr 프린터의모델명 펌웨어에서제공되는모델명으로 SRP-350II 프린터의경우 _ SRP-350II NSString * modelstr [Discussion] BXPrinterController 의 checkprinter 메소드에의해이값은갱신됩니다. [See Also] checkprinter SDK and later versionstr 프린터의펌웨어버전펌웨어에서제공되는버전명으로 V01.00 STOB NSString * versionstr [Discussion] BXPrinterController 의 checkprinter 메소드에의해이값은갱신됩니다. [See Also] checkprinter SDK and later Rev

27 4-2-6 connectionclass 프린터의연결방식 unsigned short * connectionclass [See Also] Connection Class SDK and later Rev

28 5. BXPrinterController Class Reference Inherits from Confirms to Framework Declared NSObject BXPrinter.a ios 4.3 and later BXPrinter.h 5-1 Overview BXPrinterController Class 는프린터제어를위한메인객체입니다. 5-2 Properties version SDK NSString * version [Discussion] 과같은형태로이뤄진문자열이며읽기전용입니다. [See Also] checkprinter SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController == nil) NSLog(@ SDK Version : %@, pcontroller.version); Rev

29 5-2-2 delegate BXPrinterControlDelegate id<bxprintercontroldelegate> delegate SDK and delegatetestclass : NSObject<BXPrinterControllerDelegate> TestClass // process -(void) printerinitialize { BXPrinterControler * pcontroller = [BXPrinterController getinstance]; If(pController == nil) pcontroller.delegate = self; Implementation Rev

30 5-2-3 target BXPrinter * target [Discussion] 제어대상이되는프린터객체로서프린터제어전지정이되어야합니다. [See Also] selecttarget SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [pcontroller Open]; // lookup 함수를이용하여검색된프린터객체를사용할수도있습니다. BXPrinter* printer = [BXPrinter new]; printer.connectionclass=bxl_connectionclass_bt; printer.macaddress XX:XX:XX:XX:XX:XX ; pcontroller.target = printer; If(BXL_SUCCESS == [pcontroller selecttarget]) { NSLog(@ Select Target Success ); // [printer release]; // Rev

31 5-2-4 lookupduration 프린터검색시간 ( 단위 : 초 CGFloat lookupduration [Discussion] 0.5 와같이소수점부분을포함할수있습니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.lookupduration = 2.0; pcontroller.lookupcount = 5; [pcontroller lookup] Rev

32 5-2-5 lookupcount unsigned lookupcount [Discussion] 기본값은 1 로설정되어있으며 1 보다큰숫자가지정된경우, 프린터검색시 0.2 초단위로이숫자만큼반복해서프린터검색신호를전송합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.lookupduration = 2.0; pcontroller.lookupcount = 5; [pcontroller lookup] Rev

33 5-2-6 alignment int alignment [Discussion] 기본값은좌측정렬로되어있으며, 이값은텍스트, 바코드등모든출력값에영향을미칩니다. SDK and later [See Also] Barcode/Image/Text Alignment printtext BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.alignment = BXL_ALIGNMENT_LEFT; If(BXL_SUCCESS == [pcontroller printtext:@ This is alignment Test - left ]) NSLog(@ printtext Success ); pcontroller.alignment = BXL_ALIGNMENT_CENTER; If(BXL_SUCCESS == [pcontroller printtext:@ This is alignment Test - center ]) NSLog(@ printtext Success ); pcontroller.alignment = BXL_ALIGNMENT_RIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is alignment Test - right ]) NSLog(@ printtext Success ); Rev

34 5-2-7 attribute int attribute SDK and later [See Also] Text Attribute printtext BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.attribute = BXL_ALIGNMENT_LEFT; If(BXL_SUCCESS == [pcontroller printtext:@ This is alignment Test - left ]) NSLog(@ printtext Success ); pcontroller.alignment = BXL_ALIGNMENT_CENTER; If(BXL_SUCCESS == [pcontroller printtext:@ This is alignment Test - center ]) NSLog(@ printtext Success ); pcontroller.alignment = BXL_ALIGNMENT_RIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is alignment Test - right ]) NSLog(@ printtext Success ); Rev

35 5-2-8 textsize int textsize SDK and later [See Also] Text Size printtext BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.textsize = BXL_TS_0WIDTH BXL_TS_1HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 0x0-default ]) NSLog(@ printtext Success ); pcontroller.textsize = BXL_TS_1WIDTH BXL_TS_1HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 1x1 ]) NSLog(@ printtext Success ); pcontroller.textsize = BXL_TS_2WIDTH BXL_TS_2HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 2x2 ]) NSLog(@ printtext Success ); pcontroller.textsize = BXL_TS_2WIDTH BXL_TS_4HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 2x4 ]) NSLog(@ printtext Success ); pcontroller.textsize = BXL_TS_7WIDTH BXL_TS_7HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 7x7 ]) NSLog(@ printtext Success ); Rev

36 5-2-9 characterset char characterset [Discussion] 기본값은 BXL_CS_437 로설정되어있습니다. SDK and later [See Also] Character Set BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.characterset = BXL_CS_437; If(BXL_SUCCESS == [pcontroller printtext:@ ]) NSLog(@ printtext Success ); pcontroller.textsize = BXL_TS_1WIDTH BXL_TS_1HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 1x1 ]) NSLog(@ printtext Success ); pcontroller.textsize = BXL_TS_2WIDTH BXL_TS_2HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 2x2 ]) NSLog(@ printtext Success ); pcontroller.textsize = BXL_TS_2WIDTH BXL_TS_4HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 2x4 ]) NSLog(@ printtext Success ); pcontroller.textsize = BXL_TS_7WIDTH BXL_TS_7HEIGHT; If(BXL_SUCCESS == [pcontroller printtext:@ This is textsizetest 7x7 ]) NSLog(@ printtext Success ); Rev

37 internationalcharacterset char internationalcharacterset [Discussion] International Character Set 참고. 기본값은 BXL_ICS_USA 로설정되어있습니다. SDK and later [See Also] internationalcharacter Set BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.characterset = BXL_CS_437; If(BXL_SUCCESS == [pcontroller printtext:@ ]) NSLog(@ printtext Success ); Rev

38 textencoding Text Encoding long textencoding [Discussion] characterset 은 1 바이트폰트내에서사용가능한확장코드셋입니다. 2 바이트폰트및일부문자의경우별도의텍스트인코딩이필요할수있습니다. [See Also] Text Encoding SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.textencoding = BXL_TEXTENCODING_KSC5601; If(BXL_SUCCESS == [pcontroller printtext:@ ]) NSLog(@ 한국어출력성공 ); pcontroller.textencoding = BXL_TEXTENCODING_SHIFT_JIS; If(BXL_SUCCESS == [pcontroller printtext:@ ]) NSLog(@ にほんご出力か完了しました ); pcontroller.textencoding = BXL_TEXTENCODING_GB18030; If(BXL_SUCCESS == [pcontroller printtext:@ ]) NSLog(@ 完成中國輸出 ); KSC5601 Shift-JIS GB18030 Rev

39 state 프린터상태코드이값은 BXPrinterController 의 checkprinter long state SDK and later [See Also] State checkprinter BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS== [pcontroller checkstatus:bxl_mask_coveropen ] ) { If(pController.state & BXL_STS_COVEROPEN) NSLog(@ printer Cover is open ); If (BXL_SUCCESS== [pcontroller checkstatus:bxl_mask_all ] ) { If(pController.state & BXL_STS_COVEROPEN) NSLog(@ printer Cover is open ); 커버상태만체크 If(pController.state & BXL_STS_PAPEREMPTY) NSLog(@ Paper is empty. ); 모든상태체크 Rev

40 power 프린터의전원상태를속성이값은 BXPrinterController 의 checkprinter long state [Discussion] 배터리를사용하지않는모델의경우항상 BXL_PWR_HIGH 를리턴합니다. [See Also] Power checkprinter SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS== [pcontroller checkstatus:bxl_mask_powerstatus] ) { switch(pcontroller.power) { case BXL_PWR_HIGH: NSLog(@ Power Status is High ); break; case BXL_PWR_MIDDLE: NSLog(@ Power Status is Middle ); break; case BXL_PWR_LOW: NSLog(@ Power Status is Low ); break; Rev

41 AutoConnection int AutoConnection [Discussion] 이속성을 BXL_CONNECTIONMODE_AUTO 로설정하면 connect / disconnect 메소드를사용할수없으며, 접속이필요한기능의경우자동으로접속하도록기능이구현되어있습니다. 매번 connect 와 disconnect 를반복하므로출력속도가느려질수있으며, Bluetooth 모드에서는지원하지않습니다. [See Also] Connection Control connect disconnect SDK and later Rev

42 drawerpin CashDrawer int drawerpin [Discussion] 잘못된 Pin 속성을지정할경우 CashDrawer 가동작하지않을수있습니다. 이경우속성을확인바랍니다. SDK and later [See Also] Drawer kick-out connector pin Rev

43 draweropenlevel Cash Drawer 의 Open 을인식하는 Level int draweropenlevel [Discussion] 잘못된 Open Level 속성을지정할경우 CashDrawer 의 Open/Close 의상태가반대로지정될수있습니다. 이경우 Open Level 을확인하시기바랍니다. SDK and later [See Also] Drawer open level Rev

44 textposition int textposition [See Also] Barcode Text Position Barcode Symbology printbarcode SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) pcontroller.textposition = BXL_BC_TEXT_NONE; lresult = [pcontroller printbarcode: symbology: BXL_BCS_EAN13 width: 3 height:100]; If(BXL_SUCCESS == lresult) NSLog(@ printbarcode Success. ); Rev

45 5-3 Instance Methods getinstance BXPrinterController 클래스인스턴스를얻는메소드 - (BXPrinterController)getInstance [Return Value] 최초호출시 BXPrinterController 클래스를자동으로생성하여반환하고, 이후호출시먼저생성된 BXPrinterController 클래스를반환합니다. [Discussion] BXPrinterController 클래스는하나의프로세스에서하나의인스턴스만사용하므로, 사용자가직접생성하지않고, 이메소드를통해얻고사용합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController == nil) Rev

46 5-3-2 open BXPrinterController 클래스사용을위한초기화작업 ( 메모리할당및백그라운드스레드동작 ) - (void)open [Discussion] (void)applicationdidbecomeactive:(uiapplication *)application 과같은 Application 의 ` 메인 delegate 호출시반드시선행되어호출되어야합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController == nil) [pcontroller open]; Rev

47 5-3-3 close BXPrinterController 클래스사용을중단또는종료하기위해할당된리소스해제작업을수행합니다. [Discussion] - (void)applicationwillresignactive:(uiapplication *)application 과같은 Application 의메인 delegate 호출시반드시선행되어호출되어야합니다. close 메소드가호출되지않고 BXPrinterController 를사용하는앱이백그라운드모드로동작하는경우, 또다른앱에서의 BXPrinterController 동시사용이제한될수있습니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController == nil) [pcontroller Open]; //Do Something [pcontroller close]; Rev

48 5-3-4 lookup 아이폰이연결된 WiFi 와동일한네트워크대역에서프린터를검색합니다. - (void)lookup [Discussion] 검색의시작 / 종료및검색된프린터는 BXPrinterControlDelegate 를통해얻을수있습니다. 아이폰의경우 3G 와 WiFi 각각 2 개의네트워크어댑터를가지며 lookup 메소드는이중 WiFi 만을사용해서검색합니다. 현재연결된 WiFi 가없는경우아무런작업을하지않습니다. [See Also] didfindprinter willlookupprinters didlookupprinters didnotlookup SDK and later - (IBAction) buttonup_lookup:(id)sender { NSLog(@" Lookup / Targetting Button Up."); BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [pcontroller lookup]; // 프린터검색이시작될때아래함수가호출됩니다. - (void)willlookupprinters:(bxprintercontroller *)controller { NSLog( will Lookup Printers. ); 검색예정 // 프린터검색이완료되면아래함수가호출됩니다. - (void)didlookupprinters:(bxprintercontroller *)controller { NSLog( printer Lookup Finish. ); 검색완료 // 프린터가검색될때마다호출됩니다.. - (void)didfindprinter:(bxprintercontroller *)controller printer:(bxprinter*) printer { NSLog( printer Find. ); 검색중 Rev

49 // 프린터가검색될때마다호출됩니다.. - (void)didnotlookup:(bxprintercontroller *)controller witherror:(nserror*) error { NSLog( didnotlookup. ); 검색실패 Rev

50 5-3-5 selecttarget Target 으로지정된객체를초기화합니다. - (long)selecttarget - (long)selecttarget : (int) modelid [Parameters] modelid - 모델타입을선택합니다. - 사용하지않을경우, 자동으로할당됩니다 Model ID 참고 [Return Value] Result Code 참고 [Discussion] BXPrinterController 의 target 이미리지정되어있어야합니다. [See Also] target SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [pcontroller Open]; // lookup 함수를이용하여검색된프린터객체를사용할수도있습니다. BXPrinter* printer = [BXPrinter new]; printer.connectionclass=bxl_connectionclass_bt; printer.macaddress XX:XX:XX:XX:XX:XX ; pcontroller.target = printer; If(BXL_SUCCESS == [pcontroller selecttarget]) { NSLog(@ Select Target Success ); // [printer release]; // Rev

51 5-3-6 connect target printer 에접속합니다. - (BOOL)connect [Discussion] AutoConnection 변수가 BXL_CONNECTIONMODE_AUTO (default, == 0) 으로설정된경우동작하지않습니다. BXPrinterController 의 target 이미리지정되어있어야합니다. [See Also] didconnect didnotconnect didbebrokenconnection SDK and later [Return Value] 성공시 YES Connect 요청에대한결과입니다. 접속에대한결과를확인하시려면 delegate 함수설명을참조하시기바랍니다. - (void ) buttonup_disconnect:(id)sender { BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If(BXL_SUCCESS == [pcontroller connect]) NSLog(@ Connect Request is Success. ); // connect 성공시아래함수가호출됩니다. - (void)didconnect:(bxprintercontroller *)controller printer:(bxprinter*) printer { NSLog( Connect Complete ); SUCCESS // connect 성공시아래함수가호출됩니다. - (void)didnotconnect:(bxprintercontroller *)controller witherror:(nserror*) error { NSLog( Connect Fail ); FAIL Rev

52 5-3-7 disconnect 현재접속된프린터와의연결을끊습니다. - (void)disconnect [Discussion] AutoConnection 변수가 BXL_CONNECTIONMODE_AUTO (default, == 0) 으로설정된경우동작하지않습니다. SDK and later [See Also] Disconnect 가완료되면아래 delegate 함수가호출됩니다 diddisconnect - (void ) buttonup_disconnect:(id)sender { // process [pcontroller disconnect]; // process // Disconnect 완료시아래함수가호출됩니다. - (void)diddisconnect:(bxprintercontroller *)controller printer:(bxprinter*) printer { NSLog( Disconnect Complete ); disconnect 완료 Rev

53 5-3-8 enablelsb Last status back 기능을활성화합니다. - (long)enablelsb:(bool)benable [Parameters] benable LSB 설정. FALSE : LSB Disable TRUE : LSB Enable [Return Value] Result Code 참고 [See Also] State didupdatestatus SDK and later - (void) enablelsbtest { // Enable If( BXL_SUCCESS == [pcontroller enablelsb:yes];) NSLog(@ enablelsb:yes Success ); // disable If(BXL_SUCCESS == [pcontroller enablelsb:no]) NSLog(@ enablelsb:no Success ); // 상태가변경되면아래함수가호출됩니다. - (void)didupdatestatus:(bxprintercontroller *)controller status:(nsnumber*)status { NSLog( did Update Status ); 상태가변경됨. If(status & BXL_STS_NORMAL) NSLog(@ Printer Status is Normal. ); If(status & BXL_STS_PAPEREMPTY) NSLog(@ Paper is empty. ); If(status & BXL_STS_COVEROPEN) NSLog(@ Printer Status is Normal. ); Rev

54 5-3-9 printtext 텍스트를인쇄합니다. 현재연결된프린터가없는경우아무런작업을하지않습니다. (long)printtext:(nsstring *)string [Parameters] string null 종결자를가진 Unicode Data. 인쇄대상텍스트스트링 [Return Value] Result Code 참고 [Discussion] 텍스트의정렬, 속성이미리지정되어있어야합니다. [See Also] 2-1 Character Set internationalcharacter Set Barcode/Image/Text Alignment Text Size Text Attribute alignment textsize attribute characterset internationalcharacterset textencoding SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) // 기본인쇄방법 If(BXL_SUCCESS == [pcontroller printtext:@ This is printtext\r\n ]) NSLog(@ printtext Success ); Rev

55 // 중앙정렬, 굵은글씨체로출력 pcontroller.alignment = BXL_ALIGNMENT_CENTER; // 중앙정렬 pcontroller.attribute = BXL_FT_BOLD; // 굵은글씨 If(BXL_SUCCESS == [pcontroller printtext:@ Center alignment and Bold Font. ]) NSLog(@ printtext Success ); // 오른쪽정렬, 밑줄글씨체로출력 pcontroller.alignment = BXL_ALIGNMENT_RIGHT; // 오른쪽정렬 pcontroller.attribute = BXL_FT_UNDERLINE; // 밑줄체 If(BXL_SUCCESS == [pcontroller printtext:@ Right alignment and Underline Font. ]) NSLog(@ printtext Success ); // 왼쪽정렬, 굵고밑줄글씨체, Font Size가가로세로 2배씩보이게출력 pcontroller.alignment = BXL_ALIGNMENT_LEFT; // 왼쪽정렬 pcontroller.attribute = BXL_FT_BOLD BXL_FT_UNDERLINE; // 굵고, 밑줄체 pcontroller.textsize = BXL_TS_1WIDTH BXL_TS_1HEIGHT; // 가로세로각각 2배 If(BXL_SUCCESS == [pcontroller printtext:@ Left alignment and BOLD, Underline Font and Big Font. ]) NSLog(@ printtext Success ); Rev

56 printbox 상자모양 Text 를인쇄합니다. 현재연결된프린터가없는경우아무런작업을하지않습니다. (long)printtext:(int)width height: (int)height; [Parameters] int 상자의너비를지정합니다. 1 == 알파벳 1 글자만큼의너비 int 상자의길이를지정합니다. 1 == 알파벳 1 줄만큼의길이 [Return Value] Result Code 참고 [Discussion] 텍스트의정렬, 속성이미리지정되어있어야합니다. [See Also] Barcode/Image/Text Alignment Text Size Text Attribute alignment textsize attribute SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If(BXL_SUCCESS == [pcontroller printbox:43 height:3]) NSLog(@ printbox Suceess. ); Rev

57 linefeed 라인피드를수행합니다. - (long)linefeed:(int)lines [Parameters] lines 라인피드의개수 [Return Value] Result Code 참고 SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If(BXL_SUCCESS == [pcontroller linefeed:3]) NSLog(@ linefeed Success. ); Rev

58 nextprintpos 다음라벨용지의시작지점으로용지를피딩합니다. - (long)nextprintpos [Return Value] Result Code 참고 [Discussion] 이메소드는라벨모드일때에만동작을합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If(BXL_SUCCESS == [pcontroller nextprintpos]) NSLog(@ nextprintpos Success. ); Rev

59 printbarcode 1 차원및 2 차원바코드를인쇄합니다. - (long)printbarcode:(char *)data symbology:(long)symbology width:(long)width height:(long)height alignment:(long)alignment [Parameters] data null 종결자를가진 ANSI code data 입니다. 인쇄할바코드데이터를전달합니다. symbology 바코드타입을정의합니다 Barcode Symbology 참고 height 바코드의높이. Dot 단위를가지고있으며, 1~255 값을가지고있습니다. 2 차원바코드는영향을받지않습니다. width 바코드의넓이로 2~7 의넓이단계를가지고있습니다. 바코드의인쇄크기가프린터용지를넘어갈때인쇄가되지않거나일부만인쇄될수있습니다. 2 차원바코드는이값의영향을받지않습니다. alignment 바코드의정렬설정 Barcode/Text/Image Alignment 참고 [Return Value] Result Code 참고 [See Also] Barcode/Text/Image Alignment Barcode Text Position Barcode Symbology textposition SDK and later Rev

60 long lresult = BXL_SUCCESS; BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) // 바코드데이터를바코드아래쪽에출력합니다. pcontroller.textposition = BXL_BC_TEXT_BELOW; // 1D 바코드중 EAN13 바코드출력 lresult = [pcontroller printbarcode: symbology: BXL_BCS_EAN13 width: 3 height:100]; If(BXL_SUCCESS == lresult) NSLog(@ printbarcode Success. ); // 1D 바코드중 Code128 바코드출력 If(BXL_SUCCESS == [pcontroller printbarcode:3]) NSLog(@ linefeed Success. ); // 1D 바코드중 QR 바코드출력 If(BXL_SUCCESS == [pcontroller printbarcode:3]) NSLog(@ linefeed Success. ); Rev

61 printbitmap 이미지파일을인쇄합니다. - (long)printbitmap:(nsstring *)path width:(long)width level:(long)level [Parameters] path 이미지파일의경로 width 변환할이미지파일의넓이입니다. 0 ~ 최대너비까지설정할수있습니다. 0보다작은값을설정시조건에맞게이미지크기가변환됩니다 Image Width 참고 level 이미지색상레벨및디퓨전처리여부를설정합니다. 값설명 0 ~ 100 색상레벨값네번째수가 1인경우디퓨전처리수행다섯번째수가 1인경우 ESC * 커맨드이용이미지출력 [See Also] Barcode/Text/Image Alignment Error Diffusion 이란? [Return Value] Result Code 참고 SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) NSString *path = [[NSBundle mainbundle] pathforresource:@ Sample oftype:@ png ]]; If (BXL_SUCCESS == [pcontroller printbitmap:path width:bxl_width_full level:1050 ] ) NSLog(@ printbitmap Success. ); Rev

62 printbitmapwithimage 이미지파일을인쇄합니다. - (long)printbitmapwithimage:(uiimage *) image width:(long)width level:(long)level [Parameters] path 이미지파일의경로 width 변환할이미지파일의넓이입니다. 0 ~ 최대너비까지설정할수있습니다. 0보다작은값을설정시조건에맞게이미지크기가변환됩니다 Image Width 참고 level 이미지색상레벨및디퓨전처리여부를설정합니다. 값설명 0 ~ 100 색상레벨값네번째수가 1인경우디퓨전처리수행다섯번째수가 1인경우 ESC * 커맨드이용이미지출력 [See Also] Barcode/Text/Image Alignment Error Diffusion 이란? [Return Value] Result Code 참고 SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) UIImage* image = [UIImage imagenamed:@ sample.png ]; If (BXL_SUCCESS == [pcontroller printbitmapwithimage:image width:bxl_width_full level:1050 ] ) NSLog(@ printbitmap Success. ); Rev

63 cutpaper 프린터에출력된용지를자릅니다. - (long) cutpaper; [Discussion] 프린터의기구적인차이로인해용지컷팅위치가출력물보다위에위치하여, 인쇄물이잘린것처럼보일수있습니다. 이경우 linefeed 를이용하여컷팅위치를조절하십시오. [See Also] Barcode/Text/Image Alignment Error Diffusion 이란? [Return Value] Result Code 참고 BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS == [pcontroller printtext:@ printtext\r\n ] ) NSLog(@ printtext Success. ); If (BXL_SUCCESS == [pcontroller linefeed:3] ) NSLog(@ linefeed Success. ); If (BXL_SUCCESS == [pcontroller cutpaper] ) NSLog(@ cutpaper Success. ); Rev

64 checkprinter 프린터상태를체크하여상태속성에값을설정합니다. - (long)checkprinter : (int) mask [Return Value] Result Code 참고 SDK and later [See Also] Barcode/Text/Image Alignment Status check Mask SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS== { [pcontroller checkstatus:bxl_mask_coveropen ] ) If(pController.state & BXL_STS_COVEROPEN) NSLog(@ printer Cover is open ); 커버상태만체크 If (BXL_SUCCESS== { [pcontroller checkstatus:bxl_mask_coverstatus BXL_MASK_PAPERSTATUS ] ) If(pController.state & BXL_STS_COVEROPEN) NSLog(@ printer Cover is open ); If(pController.state & BXL_STS_PAPEREMPTY) NSLog(@ Paper is empty. ); 커버 / 종이상태체크 Rev

65 msrreadready 프린터를 MSR Ready 상태로전환합니다. Ready 상태에서는인쇄가불가능합니다. 지원기기 : POS Printer 는지원되지않습니다. - (long)msrreadready [Return Value] Result Code 참고 [Discussion] MSR Data 가발생하면 msrarrived 메소드가호출됩니다. [See Also] msrreadcancel msrreadtrack msrgettrack msrreadfulltrack msrarrived SDK and later Rev

66 BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS == [pcontroller msrreadready] ) NSLog(@ msrreadready Success. ); // MSR Data 가발생하면아래함수가호출됩니다. - (void)msrarrived:(bxprintercontroller *)controller track:(nsnumber *)track { NSLog(@ MSR Data Arrived. ); NSData* data = nil; if( [track intvalue] & BXL_MSG_TRACK1 ) { If(BXL_SUCCESS == [controller msrgettrack:bxl_msg_track1 response: &data] ) { NSLog(@ Track 1 : %s, data.bytes); if( [track intvalue] & BXL_MSG_TRACK2 ) { If(BXL_SUCCESS == [controller msrgettrack:bxl_msg_track2 response: &data] ) { NSLog(@ Track 2 : %s, data.bytes); if( [track intvalue] & BXL_MSG_TRACK3 ) { If(BXL_SUCCESS == [controller msrgettrack:bxl_msg_track3 response: &data] ) { NSLog(@ Track 3 : %s, data.bytes); Rev

67 msrreadcancel 프린터를 MSR Ready 상태에서해제합니다. 지원기기 : POS Printer 는지원되지않습니다. - (long)msrreadcancel [Return Value] Result Code 참고 [See Also] msrreadready msrreadtrack msrgettrack msrreadfulltrack msrarrived SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS == [pcontroller msrreadcancel] ) NSLog(@ msrreadcancel Success. ); Rev

68 msrreadtrack MSR 데이터를읽어옵니다. MSR 읽기모드이고 BXLMSR_DATAEMPTY 가리턴된다면아직 MSR 에카드가읽히지않은것입니다. 카드를다시 MSR 에스캔하거나이기능을 msrreadcancel 메소드를사용하여읽기모드를취소할수있습니다. 지원기기 : POS Printer 는지원되지않습니다. - (long)msrreadtrack:(nsdata **)data1 data2:(nsdata **)data2 data3:(nsdata **)data3 [Parameters] data1 MSR Data Track 1 번을읽어저장합니다. data2 MSR Data Track 2 번을읽어저장합니다. data3 MSR Data Track 3 번을읽어저장합니다. [Return Value] Result Code 참고 [Discussion] data1, data2, data3 은모두할당되지않은 NSData *data 를전해주고, 메소드내부적으로 NSData 객체를할당해줍니다. 할당된 data1, data2, data3 는 auto release 되는객체이므로사용자가명시적으로 release 할필요가없습니다. [See Also] msrreadready msrreadcancel msrgettrack msrreadfulltrack msrarrived SDK and later Rev

69 BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS == [pcontroller msrreadready] ) NSLog(@ msrreadready Success. ); // MSR Data 가발생하면아래함수가호출됩니다. - (void)msrarrived:(bxprintercontroller *)controller track:(nsnumber *)track { NSLog(@ MSR Data Arrived. ); NSData *data1 = nil; NSData *data2 = nil; NSData *data3 = nil; if(bxl_success == [pcontroller msrreadtrack:&data1 data2:&data2 data3:&data3]) { NSLog(@ track 1 : %s, data1.bytes); NSLog(@ track 2 : %s, data2.bytes); NSLog(@ track 3 : %s, data3.bytes); Rev

70 msrgettrack MSR 데이터를읽어옵니다. MSR 읽기모드이고 BXLMSR_DATAEMPTY 가리턴된다면아직 MSR 에카드가읽히지않은것입니다. 카드를다시 MSR 에스캔하거나이기능을 msrreadcancel 메소드를사용하여읽기모드를취소할수있습니다. 지원기기 : POS Printer 는지원되지않습니다. - (long)msrgettrack:(int)track response:(nsdata **)response [Parameters] track MSR Data Track 번호 1 ~ 3 response MSR Data Track 의값 [Return Value] Result Code 참고 [Discussion] response 는할당되지않은 NSData *data 를전해주고, 메소드내부적으로 NSData 객체를할당해줍니다. 할당된 response 는 auto release 되는객체이므로사용자가명시적으로 release 할필요가없습니다. [See Also] msrreadready msrreadcancel msrreadtrack msrreadfulltrack msrarrived SDK and later Rev

71 BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) NSData* data = nil; If(BXL_SUCCESS == { NSLog(@ Track 1 : %s, data.bytes); If(BXL_SUCCESS == { NSLog(@ Track 2 : %s, data.bytes); If(BXL_SUCCESS == { NSLog(@ Track 3 : %s, data.bytes); [controller msrgettrack:bxl_msg_track1 response: &data] ) Track 1 [controller msrgettrack:bxl_msg_track2 response: &data] ) Track 2 [controller msrgettrack:bxl_msg_track3 response: &data] ) Track 3 Rev

72 msrreadfulltrack MSR 전체데이터를읽어옵니다. MSR 읽기모드이고 BXLMSR_DATAEMPTY 가리턴된다면아직 MSR 에카드가읽히지않은것입니다. 카드를다시 MSR 에스캔하거나이기능을 msrreadcancel 메소드를사용하여읽기모드를취소할수있습니다. 지원기기 : POS Printer 는지원되지않습니다. - (long)msrreadfulltrack:(nsdata **)response [Return Value] Result Code 참고 [Parameters] response MSR Data Track 의값 [Discussion] response 는할당되지않은 NSData *data 를전해주고, 메소드내부적으로 NSData 객체를할당해줍니다. 할당된 response 는 auto release 되는객체이므로사용자가명시적으로 release 할필요가없습니다. [See Also] msrreadready msrreadcancel msrreadtrack msrgettrack msrarrived SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS == [pcontroller msrreadready] ) NSLog(@ msrreadready Success. ); // MSR Data 가발생하면아래함수가호출됩니다. - (void)msrarrived:(bxprintercontroller *)controller track:(nsnumber *)track { NSLog(@ MSR Data Arrived. ); NSData *data = nil; if(bxl_success == [pcontroller msrreadfulltrack:&data]) { NSLog(@ full : %s, data.bytes); Rev

73 directio 사용자정의데이터를보내고, 읽을수있습니다. - (long)directio:(nsdata *)request requiredsize:(nsinteger) requiredsize response:(nsdata **)response [Return Value] Result Code 참고 [Parameters] request 프린터로전송할데이터이며, ANSI CODE 데이터입니다. requiredsize 프린터로부터응답받기를원하는데이터의크기입니다. response 프린터에서읽은응답이저장됩니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If (BXL_SUCCESS == [pcontroller msrreadready] ) NSLog(@ msrreadready Success. ); BYTE test1[] = {0x30, 0x31, 0x32, 0x0d, 0x0a; if(bxl_success == [pcontroller directio:[nsdata datawithbytes:test length:sizeof(test1)] requiredsize:0 response:nil]) { NSLog(@ directio Succes. ); BYTE test2[] = {0x10, 0x04, 0x02; NSData* dataresponse = nil; if(bxl_success == [pcontroller directio:[nsdata datawithbytes:test length:sizeof(test2)] requiredsize:1 response:&dataresponse]) { NSLog(@ directio Success. Response : %d, datarespons.bytes); 전송만하는경우 응답이있는데이터전송 Rev

74 icon 프린터스마트카드리더에전원을인가합니다. - (long)icon:(nsdata **)response [Parameters] response ATR(Answer to Reset) 값이저장됩니다. [Return Value] Result Code 참고 [Discussion] response 는메소드내에서 auto release 형태로저장되므로, 사용자가명시적으로 release 할필요가없습니다. SDK and later Rev

75 icoff 프린터스마트카드리더에전원을차단합니다. 지원기기 : POS Printer 는지원되지않습니다. - (long)icoff [Return Value] Result Code 참고 SDK and later Rev

76 icapdu APDU 명령어를전송하고응답값을가져옵니다. 프린터스마트카드에전원이인가된상태에서만정상적으로동작합니다. 지원기기 : POS Printer 는지원되지않습니다. - (long)icapdu:(nsdata **)request response:(nsdata **)response [Parameters] request 프린터로전송할 APDU command 데이터입니다. ANSI CODE 데이터입니다. response 프린터에서전송된 APDU 응답값을기록합니다. [Return Value] Result Code 참고 SDK and later Rev

77 icgetstatus 프린터스마트카드리더에삽입된카드상태를가져옵니다. 지원기기 : POS Printer 는지원되지않습니다. - (long)icgetstatus:(nsdata **)response [Parameters] response 카드상태값을저장합니다. [Return Value] Result Code 참고 SDK and later Rev

78 nvimagelist NV 영역에저장된이미지어드레스리스트를얻습니다. - (long)nvimagelist:(nsarray **)images [Parameters] images 어드레스리스트를제공합니다. 각어드레스는 NSNumber * 의형태로저장되며 images 는 autorelease 형태로제공되므로, 명시적으로 release 할필요가없습니다. [Return Value] Result Code 참고 BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) NSArray *images; If(BXL_SUCCESS!= [pcontroller nvimagelist:&images] ) NSLog(@ get List is Fail. ); for( NSNumber *n in images) { NSLog(@ %d, [NSNumber intvalue]); SDK and later Rev

79 downloadnvimage (Diffusion) NV 영역의지정된어드레스에해당이미지데이터를다운로드합니다. - (long)downloadnvimage:(int)address withimage:(uiimage *)image width:(long)width level:(long)level [Parameters] address 0 ~ 99 까지사용가능한이미지어드레스. 해당어드레스에이미지가이미저장된경우기존이미지를새로운이미지로대체합니다. images 다운로드대상이미지객체 width 이미지인쇄대상넓이 BXL_WIDTH_FULL 로지정된경우프린터의출력가능한최대넓이로이미지가출력됩니다. level 이미지의넓이가 width 보다작은경우이미지는확대되며, 이미지의넓이가 width 보다큰경우에는이미지는축소된다. 이미지색상레벨및디퓨전처리여부를설정합니다. 값설명 0 ~ 100 색상레벨값네번째수가 1인경우디퓨전처리수행다섯번째수가 1인경우 ESC * 커맨드이용이미지출력 [Return Value] Result Code 참고 [Discussion] 해당이미지의크기가프린터의가로폭보다큰경우이미지는자동으로크기가조절됩니다. [See Also] Error Diffusion 이란? SDK and later Rev

80 BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) UIImage* image = [UIImage imagenamed:@ sample.png ]; If (BXL_SUCCESS == [pcontroller downloadnvimage: 0 withimage:image width:bxl_width_full level:1050 ] ) NSLog(@ downloadnvimage Success. ); Rev

81 downloadnvimage (Normal) NV 영역의지정된어드레스에해당이미지데이터를다운로드합니다. - (long)downloadnvimage:(int)address withimage:(uiimage *)image [Parameters] address 0 ~ 99 까지사용가능한이미지어드레스. 해당어드레스에이미지가이미저장된경우기존이미지를새로운이미지로대체합니다. images 다운로드대상이미지객체 [Return Value] Result Code 참고 [Discussion] 해당이미지의크기가프린터의가로폭보다큰경우이미지는자동으로크기가조절됩니다. [See Also] Error Diffusion 이란? SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) UIImage* image = [UIImage imagenamed:@ sample.png ]; If (BXL_SUCCESS == [pcontroller downloadnvimage: 0 NSLog(@ downloadnvimage Success. ); withimage:image] ) Rev

82 printnvimage NV 영역의지정된어드레스에저장된이미지를출력합니다. - (long)printnvimage:(int)address [Parameters] address 0 ~ 99 까지사용가능한이미지어드레스 [Return Value] Result Code 참고 [Discussion] 해당어드레스에이미지가존재하지않는경우, 이미지는출력되지않습니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) UIImage* image = [UIImage imagenamed:@ sample.png ]; If (BXL_SUCCESS == [pcontroller printnvimage:0] ) NSLog(@ printnvimage Success. ); Rev

83 removenvimage NV 영역의지정된어드레스에저장된이미지를삭제합니다. - (long)removenvimage:(int)address [Parameters] address 0 ~ 99 까지사용가능한이미지어드레스 [Return Value] Result Code 참고 [Discussion] 해당어드레스에이미지가존재하지않는경우, 아무것도수행하지않습니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) UIImage* image = [UIImage imagenamed:@ sample.png ]; If (BXL_SUCCESS == [pcontroller removenvimage:0] ) NSLog(@ removenvimage Success. ); Rev

84 removeallnvimages NV 영역에저장된모든이미지를삭제합니다. - (long)removeallnvimages [Return Value] Result Code 참고 SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) UIImage* image = [UIImage imagenamed:@ sample.png ]; If (BXL_SUCCESS == [pcontroller removeallnvimages] ) NSLog(@ removeallnvimages Success. ); Rev

85 opendrawer Cash Drawer 를 open 합니다. - (long)opendrawer [Return Value] Result Code 참고 SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) If(BXL_SUCCESS== [pcontroller opendrawer]) NSLog(@ OpenDrawer Success. ); else NSLog(@ OpenDrawer Fail. ); Rev

86 setasyncmode Async Mode 의사용여부를선택합니다. - (long)setasyncmode:(bool) set [Return Value] Result Code 참고 outputcomplete 참고 Transaction / Async mode 조합설정비교참고 SDK and later -(void) printprocess { BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [pcontroller setasyncmode:yes]; [pcontroller printtext:@ test Print\r\n ]; // 인쇄가성공하면아래 delegate 가호출됩니다.. - (void)outputcomplete:(bxprintercontroller *)controller outputid:(nsnumber*)outputid errorstatus:(nsnumber*)errorstatuss { NSLog(@ outputcomplete. ID is %d, outputid.integervalue); // outputid 는프린팅이성공할때마다 1 씩증가됩니다. Rev

87 begintransaction transaction Mode 를시작합니다. - (long)begintransaction [Return Value] Result Code 참고 endtransaction 참고 Transaction / Async mode 조합설정비교 [Discussion] Transaction mode 가시작되면요청하는인쇄에대해서모두버퍼에저장만해두었다가, endtransaction 이호출될때인쇄를시작합니다. SDK and later -(void) printprocess { BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [pcontroller begintransaction]; [pcontroller printtext:@ test Print 1\r\n ]; [pcontroller printtext:@ test Print 2\r\n ]; [pcontroller printtext:@ test Print 3\r\n ]; // 인쇄버퍼에 data 만쌓아둠 // 인쇄버퍼에 data 만쌓아둠 // 인쇄버퍼에 data 만쌓아둠 [pcontroller endtransaction]; /// 버퍼에쌓인 data 를인쇄함. Rev

88 endtransaction 인쇄 buffer 에쌓여있는 Data 를모두인쇄하고 transaction Mode 를종료합니다. - (long)endtransaction [Return Value] Result Code 참고 begintransaction 참고 Transaction / Async mode 조합설정비교 [Discussion] Transaction mode 가시작되면요청하는인쇄에대해서모두버퍼에저장만해두었다가, endtransaction 이호출될때인쇄를시작합니다. SDK and later -(void) printprocess { BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [pcontroller begintransaction]; [pcontroller printtext:@ test Print 1\r\n ]; [pcontroller printtext:@ test Print 2\r\n ]; [pcontroller printtext:@ test Print 3\r\n ]; // 인쇄버퍼에 data 만쌓아둠 // 인쇄버퍼에 data 만쌓아둠 // 인쇄버퍼에 data 만쌓아둠 [pcontroller endtransaction]; /// 버퍼에쌓인 data 를인쇄함. Rev

89 setpagearea 페이지모드를사용하고인쇄영역의크기를정의합니다. - (long)setpagearea:(nsinteger)startingx startingy:(nsinteger)startingy width:(nsinteger)width height:(nsinteger)height; [Parameters] startingx 인쇄영역의시작지점중 X 좌표를의미. 일반적으로 0. startingy 인쇄영역의시작지점중 Y 좌표를의미. 일반적으로 0. width 인쇄영역의가로크기를정의. height 인쇄영역의세로크기. Parameter 단위 : dot. (1mm == 7dots) [Return Value] Refer to Result Code SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [_pcontroller setpagearea:0 startingy:0 width:500 height:700]; // Configuring the page scope [_pcontroller directio:[nsdata datawithbytes:"\x1b\x54\x03" length:3] requiredsize:0 response:nil]; // Change the printing direction to the vertical [_pcontroller setverticalposition:0]; // Configuring Vertical coordinate [_pcontroller setleftposition:10]; // Configuring left coordinate [_pcontroller printtext:@"v-l10 V0\r\n"]; // Printing the text on the coordinate configured in the above. // Another API can be sued such as PrintText, printbitmap and so on here // The method of use is same as before (you can check the manual) _pcontroller printdatainpagemode]; // printing the content configured in the above. Rev

90 setverticalposition 페이지모드에서인쇄할컨텐츠의위치를좌표로표시하는데, 그중세로좌표를설정합니다. - (long)setverticalposition:(nsinteger)positiony; [Parameters] positiony To set Vertical Position, you can set the position by positiony As increasing a value of VerticalPositio, the printing location moves down. 단위 : dot. (1mm == 7dots) [Return Value] Refer to Result Code SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [_pcontroller setpagearea:0 startingy:0 width:500 height:700]; // Configuring the page scope [_pcontroller directio:[nsdata datawithbytes:"\x1b\x54\x03" length:3] requiredsize:0 response:nil]; // Change the printing direction to the vertical [_pcontroller setverticalposition:0]; // Configuring Vertical coordinate [_pcontroller setleftposition:10]; // Configuring left coordinate [_pcontroller printtext:@"v-l10 V0\r\n"]; // Printing the text on the coordinate configured in the above. // Another API can be sued such as PrintText, printbitmap and so on here // The method of use is same as before (you can check the manual) _pcontroller printdatainpagemode]; // printing the content configured in the above. Rev

91 setleftposition 페이지모드에서인쇄할컨텐츠의위치를좌표로표시하는데, 그중가로좌표를설정합니다. - (long)setleftposition:(nsinteger)positionx; [Parameters] positionx To set Left Position, you can set the position by positionx As increasing a value of Left Position, the printing moves to the right. 단위 : dot. (1mm == 7dots) [Return Value] Refer to Result Code SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [_pcontroller setpagearea:0 startingy:0 width:500 height:700]; // Configuring the page scope [_pcontroller directio:[nsdata datawithbytes:"\x1b\x54\x03" length:3] requiredsize:0 response:nil]; // Change the printing direction to the vertical [_pcontroller setverticalposition:0]; [pcontroller setleftposition:10]; // Configuring Vertical coordinate // Configuring left coordinate [_pcontroller printtext:@"v-l10 V0\r\n"]; // Printing the text on the coordinate configured in the above. // Another API can be sued such as PrintText, printbitmap and so on here // The method of use is same as before (you can check the manual) _pcontroller printdatainpagemode]; // printing the content configured in the above. Rev

92 printdatainpagemode 페이지모드의페이지영역에정의한 Data 를인쇄합니다. - (long)printdatainpagemode; [Return Value] 0 Refer to Result Code SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [_pcontroller setpagearea:0 startingy:0 width:500 height:700]; // 인쇄영역을설정합니다. [_pcontroller directio:[nsdata datawithbytes:"\x1b\x54\x03" length:3] requiredsize:0 response:nil]; // Change the printing direction to the vertical [_pcontroller setverticalposition:0]; // 세로좌표를설정합니다. [_pcontroller setleftposition:10]; // 가로좌표를설정합니다. [_pcontroller printtext:@"v-l10 V0\r\n"]; // 위에서설정한좌표의위치에텍스트를인쇄합니다. // 다른인쇄 API(printText, printbarcode, printimage 등 ) 를사용하려하는경우이위치에코딩할수있습니다. // 해당메소드의사용방법은기존매뉴얼내의방법과동일합니다. [_pcontroller printdatainpagemode]; 쇄합니다. // 위에서설정하고, 저장한컨텐츠를인 Rev

93 issupport_msr MSR 관련기능의지원여부를확인합니다. - (BOOL)isSupport_MSR [Return Value] MSR 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) BOOL issupportmsr= [pcontroller issupport_msr]; If(isSupportMSR) NSLog(@ MSR Functions is Supported. ); else NSLog(@ MSR Functions is not Supported. ); Rev

94 issupport_ic IC 관련기능의지원여부를확인합니다. - (BOOL)isSupport_IC [Return Value] IC 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) BOOL issupportic= [pcontroller issupport_ic]; If(isSupportIC) NSLog(@ IC Functions is Supported. ); else NSLog(@ IC Functions is not Supported. ); Rev

95 issupport_config Config 관련기능의지원여부를확인합니다.. - (BOOL)isSupport_Config [Return Value] Config 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) BOOL issupportconfig= [pcontroller issupport_config]; If(isSupportConfig) NSLog(@ Config Functions is Supported. ); else NSLog(@ Config Functions is not Supported. ); Rev

96 issupport_cashdrawer CashDrawer 관련기능의지원여부를확인합니다. - (BOOL)isSupport_CashDrawer [Return Value] CashDrawer 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) BOOL issupportcashdrawer= [pcontroller issupport_cashdrawer]; If(isSupportCashDrawer) NSLog(@ CashDrawerFunctions is Supported. ); else NSLog(@ CashDrawerFunctions is not Supported. ); Rev

97 issupport_lsb LSB 관련기능의지원여부를확인합니다. - (BOOL)isSupport_MSR [Return Value] LSB 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) BOOL issupportlsb = [pcontroller issupport_lsb]; If(isSupportLSB) NSLog(@ LastStatusBack is Supported. ); else NSLog(@ LastStatusBack is not Supported. ); Rev

98 getbarcodesupporttable Barcode 지원여부를확인합니다. - (NSMutableArray*)getBarcodeSupportTable [Return Value] BXBarcode 를가지고있는 NSMutableArray 를반환합니다. SDK and later BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) NSMutableArray *tbl = [printercontroller getbarcode SupportTable]; If( nil == tbl) NSLog(@ getbarcodesupporttable Fail. ); for(bxbarcode *p in tbl) { NSLog( barcode number: %d, p.barnumber ); NSLog( barcode name : %@, priner.name); NSLog( is Support : %d, p.support); Rev

99 6. BXPrinterControllerDelegate Protocol Reference Inherits from Confirms to Framework Declared NSObject BXPrinter.a ios 4.3 and later BXPrinteControlDelegater.h 6-1 Overview BXPrinterController Class 내에서일어나는이벤트를받기위한프로토콜입니다. 6-2 Instance Methods didstart BXPrinterControll 의 open 메소드를이용하여클래스사용이시작될때호출됩니다. 프린터에접속이완료된후호출됩니다. - (void) didstart [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 [Discussion] 프린터클래스사용시작을사용자에게별도의표시를하는경우사용할수있습니다. SDK and later Rev

100 6-2-2 didstop BXPrinterControll 의 close 메소드를이용하여클래스사용이시작될때호출됩니다. - (void) didstop [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 [Discussion] 프린터클래스사용종료를사용자에게별도의표시를하는경우사용할수있습니다. SDK and later Rev

101 6-2-3 didfindprinter 동일네트워크대역에서프린터가검색되면개별프린터마다이메소드가호출됩니다. - (void)didfindprinter:(bxprintercontroller *)controller printer:(bxprinter *)printer [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 printer 검색된프린터정보 SDK and late // connect 성공시아래함수가호출됩니다. - (void)didfindprinter:(bxprintercontroller *)controller printer:(bxprinter*) printer { NSLog( did Find Printer, ); NSLog( printer Name : %@, priner.name); NSLog( printer Address : %@, priner.address); NSLog( printer MacAddress : %@, priner.macaddress); Rev

102 6-2-4 didconnect 프린터에접속이완료된후호출됩니다. - (void)didconnect:(bxprintercontroller *)controller printer:(bxprinter*) printer [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 printer 이벤트의주체가된 BXPrinter 객체 [Discussion] 프린터접속전사용자에게표시된진행상태를제거하기위해사용할수있습니다. 접속대상프린터정보가필요한경우 BXPrinterController 의 target property 를참조. SDK and later [See Also] connect SDK and later [Return Value] 성공시 YES Connect 요청에대한결과입니다. 접속에대한결과를확인하시려면 delegate 함수설명을참조하시기바랍니다. // connect 성공시아래함수가호출됩니다. - (void)didconnect:(bxprintercontroller *)controller printer:(bxprinter*) printer { NSLog( Connect Complete ); Rev

103 6-2-5 didnotconnect 프린터에접속을할수없을때호출됩니다. - (void)didnotconnect:(bxprintercontroller *)controller witherror:(nserror *)error [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 error 실패된원인정보 [Discussion] 프린터접속과정에서에러가발생된경우사용할수있습니다. SDK and later // Disconnect 완료시아래함수가호출됩니다. - (void)didnotconnect::(bxprintercontroller *)controller witherror:(nserror*) error { NSLog( cannot connect to the printer. ); Rev

104 6-2-6 willlookupprinters 프린터검색을시작하기전에호출됩니다. - (void)willlookupprinters:(bxprintercontroller *)controller [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 [Discussion] 프린터검색과정동안사용자에게별도의표시를하는경우사용할수있습니다. SDK and later // Disconnect 완료시아래함수가호출됩니다. - (void)willlookupprinters::(bxprintercontroller *)controller { NSLog( the lookup did start. ); Rev

105 6-2-7 didlookupprinters 프린터검색이완료된후호출됩니다. - (void)didlookupprinters:(bxprintercontroller *)controller [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 [Discussion] 프린터검색과정동안사용자에게별도의표시를하는경우사용할수있습니다. SDK and later // Disconnect 완료시아래함수가호출됩니다. - (void)didnotlookup::(bxprintercontroller *)controller witherror:(nserror*) error { NSLog( printer lookup fail. ); Rev

106 6-2-8 didnotlookup 프린터검색을할수없을때호출됩니다. - (void)didnotlookup:(bxprintercontroller *)controller witherror:(nserror *)error [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 error 실패된원인정보 SDK and later // Disconnect 완료시아래함수가호출됩니다. - (void)didnotlookup::(bxprintercontroller *)controller witherror:(nserror*) error { NSLog( printer lookup fail. ); Rev

107 6-2-9 didbebrokenconnection 프린터와의연결이끊어진경우호출됩니다. - (void)didbebrokenconnection:(bxprintercontroller *)controller witherror:(nserror *)error [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 error 실패된원인정보 [Discussion] 사용자가명시적으로 BXPrinterController 의 close 메소드를호출해서접속을끊은경우에는호출되지않습니다. 이메소드는사용자가아닌외부의다른장애로인해연결이끊어진경우에만호출됩니다. 대상프린터정보가필요한경우 BXPrinterController 의 target property 를참고하십시오. SDK and later // Disconnect 완료시아래함수가호출됩니다. - (void)didbebrokenconnection::(bxprintercontroller *)controller witherror:(nserror*) error { NSLog( connection is broken. ); Rev

108 diddisconnect 프린터와의연결해제가완료된경우호출됩니다. - (void)diddisconnection:(bxprintercontroller *)controller printer:(bxprinter*) printer [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 printer 이벤트의주체가된 BXPrinter 객체 [See Also] disconnect SDK and later // Disconnect 완료시아래함수가호출됩니다. - (void)diddisconnect:(bxprintercontroller *)controller printer:(bxprinter*) printer { NSLog( Disconnect Complete ); Rev

109 msrarrived MSR Read 모드에서 MSR 데이터가정상적으로도착한경우호출됩니다. - (void)msrarrived:(bxprintercontroller *)controller track:(nsnumber *)track [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 track MSR 데이터가발생된트랙의번호 1~3 [Discussion] 이메소드가호출된후 BXPrinterController 의 gettrack: 메소드를통해해당트랙의 MSR 데이터를얻을수있습니다. [See Also] msrreadready msrreadcancel msrreadtrack msrgettrack msrreadfulltrack msrarrived SDK and later - (void)msrarrived:(bxprintercontroller *)controller track:(nsnumber *)track { NSLog(@ MSR Data Arrived. ); NSData *data1 = nil; NSData *data2 = nil; NSData *data3 = nil; if(bxl_success == [pcontroller msrreadtrack:&data1 data2:&data2 data3:&data3]) { NSLog(@ track 1 : %s, data1.bytes); NSLog(@ track 2 : %s, data2.bytes); NSLog(@ track 3 : %s, data3.bytes); Rev

110 didupdatestatus 프린터의상태변수가변경된경우호출됩니다. - (void)didupdatestatus:(bxprintercontroller *)controller Status(NSNumber*) status [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 status printer 의현재상태 [See Also] State enablelsb SDK and later // Printer 접속이완료된후 BXPrinterController * pcontroller = [BXPrinterController getinstance]; [pcontroller enablelsb:yes]; // 이후부터는상태가변경될때마다, 아래 delegate 함수가호출됩니다. - (void)didupdatestatus:(bxprintercontroller *)controller status:(nsnumber*)status { NSLog( did Update Status ); If(status & BXL_STS_NORMAL) NSLog(@ Printer Status is Normal. ); If(status & BXL_STS_PAPEREMPTY) NSLog(@ Paper is empty. ); If(status & BXL_STS_COVEROPEN) NSLog(@ Printer Status is Normal. ); Rev

111 outputcomplete 인쇄성공시발생하는 delegate 입니다. - (void)outputcomplete:(bxprintercontroller *)controller outputid:(nsnumber*) outputid errorstatus:(nsnumber*) errorstatus; [Parameters] controller 이벤트의주체가된 BXPrinterController 객체 outputid 인쇄성공후본 delegate 가호출될때마다증가되는일련번호. errorstatus 프린터의상태값이전달됩니다. [See Also] State asyncmode Transaction / Async mode 조합설정비교 SDK and later -(void) printprocess { BXPrinterController* pcontroller = [BXPrinterController getinstance]; If(pController!= nil) [pcontroller setasyncmode:yes]; [pcontroller printtext:@ test Print\r\n ]; // 인쇄가성공하면아래 delegate 가호출됩니다.. - (void)outputcomplete:(bxprintercontroller *)controller outputid:(nsnumber*)outputid errorstatus:(nsnumber*)errorstatuss { NSLog(@ outputcomplete. ID is %d, outputid.integervalue); // outputid 는프린팅이성공할때마다 1 씩증가됩니다. Rev

112 7. Appendix Error Diffusion 컬러영상이나흑백영상을좀더적은양의 bits/pixel 로표현하기위한기술특정이미지의경우몇가지명백히드러나는마치뱀과같은패턴이생성될수도있지만날카로운묘사를보존하는능력이뛰어납니다. 단점은처리시간이길다는것이며이는오류를측정하고이웃하는화소들에게분산시키는데필요한계산량때문입니다. 본 SDK 에선에러디퓨전알고리즘의사용을권장합니다. [ 원본이미지 ] Diffusion 적용여부 결과물 X [Level : 50] O [Level : 1020] [Level : 1035] O [Level : 1050] [Level : 1070] Rev