PS 프린터 목차 1. 매뉴얼안내 지원 Platform & 개발환경 지원 Platform & 지원장치 지원되는 Properties 목록 지원되는 Method 목록 상수값정의

Transcription

1 is SDK API 레퍼런스가이드 PS 프린터 Rev SRP-F310 / SRP-F312 SRP-350plus / SRP-352plus SRP-350plusII / SRP-352plusII SRP-350II / SRP-350IIBE SRP-350III / SRP-352III SRP-275 / SRP-275II

2 PS 프린터 목차 1. 매뉴얼안내 지원 Platform & 개발환경 지원 Platform & 지원장치 지원되는 Properties 목록 지원되는 Method 목록 상수값정의 Character Set International Character Set Barcode/Image/Text Alignment Text Size Text Attribute Barcode Text Position Barcode Symbology Image Width Power State Connection Control Drawer kick-out connector pin Drawer open level Model ID Connection Class Result Code BXBarcode Class Reference verview Properties barnumber name support BXPrinter Class Reference verview Properties name address port modelstr versionstr connectionclass BXPrinterController Class Reference verview Properties version delegate target lookupduration lookupcount alignment attribute textsize characterset internationalcharacterset textencoding state power AutoConnection drawerpin drawerpenlevel Rev

3 PS 프린터 5-3 Instance Methods getinstance open close lookup selecttarget connect disconnect enablelsb printtext printbox linefeed nextprintpos printbarcode printbitmap checkprinter msrreadready msrreadcancel msrreadtrack msrgettrack msrreadfulltrack directi icn icff icapdu icgetstatus nvimagelist downloadnvimage (Diffusion) downloadnvimage (Normal) printnvimage removenvimage removeallnvimages opendrawer issupport_msr issupport_ic issupport_config issupport_cashdrawer issupport_lsb getbarcodesupporttable BXPrinterControllerDelegate Protocol Reference verview Instance Methods didstart didstop didfindprinter didconnect didnotconnect willlookupprinters didlookupprinters didnotlookup didbebrokenconnection msrarrived didupdatestatus Rev

4 PS 프린터 1. 매뉴얼안내 이 SDK 매뉴얼에는 is 용응용프로그램개발에필요한 Library 에대한내용이기술되어있습니다. 저희 빅솔론은제품의기능과품질향상을위하여지속적인개선을하고있습니다. 이로인하여제품의사양과매뉴얼의내용은사전통보없이변경될수있습니다. 1-1 지원 Platform & 개발환경 - Platform is 4.3 이상 - 개발환경 XCode 이상 1-2 지원 Platform & 지원장치 아래의리스트는검증된장치리스트입니다. 이외에도 ipod touch 2 세대이상의모델에서호환성이있습니다. iphone 3GS / 4G / 5G ipad / ipad2 / ipad mini 1-3 지원되는 Properties 목록 Method/Property Version delegate Target lookupduration lookupcount alignment attribute textsize characterset internationalcharacterset State Power AutoConnection drawerpin drawerpenlevel PS Printer Rev

5 PS 프린터 1-4 지원되는 Method 목록 Method/Property getinstance open close lookup selecttarget connect disconnect enablelsb printtext printbox linefeed nextprintpos printbarcode printbitmap checkprinter msrreadready msrreadcancel msrreadtrack msrgettrack msrreadfulltrack directi icn icff icapdu icgetstatus nvimagelist downloadnvimage (Diffusion) downloadnvimage (Normal) printnvimage removenvimage removeallnvimages opendrawer issupport_msr issupport_ic issupport_config issupport_cashdrawer issupport_lsb getbarcodesupporttable PS Printer X X X X X X X X X Rev

6 PS 프린터 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

7 PS 프린터 2-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_NRWAY 9 Norway BXL_ICS_DENMARK2 10 Denmark II 2-3 Barcode/Image/Text Alignment 바코드 / 이미지 / 텍스트정렬값을정의하는속성으로기본값은 BXL_ALIGNMENT _LEFT 로설정됩니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_ALIGNMENT_LEFT 0 왼쪽정렬 BXL_ALIGNMENT_CENTER 1 가운데정렬 BXL_ALIGNMENT_RIGHT 2 오른쪽정렬 2-4 Text Size 텍스트크기를설정값을정의하는속성으로가로배율과세로배율값을 R 연산으로동시에지정할수있습니다. 사용가능한속성은다음과같습니다. 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로설정합니다. Rev

8 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로설정합니다. 2-5 Text Attribute 텍스트속성을설정하며, 각속성은 R 로중첩될수있습니다. PS 프린터 사용가능한속성은다음과같습니다. Code Value Description BXL_FT_DEFAULT 0 기본속성 NT BLD, FNTA, NT UNDERLINE, NT REVERSE BXL_FT_FNTB 1 FNTB를사용합니다. BXL_FT_FNTC 16 FNTC를사용합니다. BXL_FT_BLD 2 볼드속성을지정합니다. BXL_FT_UNDERLINE 4 언더라인속성을지정합니다. BXL_FT_REVERSE 8 반전속성을지정합니다. BXL_ExFT_CHINA_FNTB Barcode Text Position 바코드데이터를출력시키는위치를설정합니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_BC_TEXT_NNE 0 바코드데이터를출력하지않습니다. BXL_BC_TEXT_ABVE 1 바코드데이터를바코드위쪽에출력합니다. BXL_BC_TEXT_BELW 2 바코드데이터를바코드아래쪽에출력합니다. Rev

9 PS 프린터 2-7 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_QRCDE 202~203 2 <= n <= <= data <= 255 BXL_BCS_DATAMATRIX <= n <= <= data <= 255 BXL_BCS_MAXICDE 205~6 2 <= n <= <= data <= Image Width 이미지의너비를설정합니다. 0~ 최대너비까지설정할수있습니다. 아래값을설정시조건에맞게이미지크기가변환됩니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_WIDTH_FULL -1 최대너비값으로설정되어용지크기에맞게이미지가변환됩니다. BXL_WIDTH_NNE -2 이미지의크기변화를주지않습니다. Rev

10 PS 프린터 2-9 Power 프린터의배터리잔량상태값이설정되는속성입니다. 읽기만가능하며프린터의배터리상태가변할때마다이속성에설정됩니다 지원기기 : PS Printer 는지원되지않습니다. 배터리잔량상태값은다음과같습니다. Code Value Description BXL_PWR_HIGH 0 배터리잔량이 95% 충전된상태입니다. BXL_PWR_MIDDLE 1 배터리잔량이 85% 충전된상태입니다. BXL_PWR_LW 2 배터리잔량이 50% 충전된상태입니다. BXL_PWR_SMALL 3 배터리잔량이 25% 충전된상태입니다. BXL_PWR_NT 4 배터리잔량이 25% 이하충전된상태입니다 State 프린터상태가설정되는속성입니다. 읽기만가능하며 CheckPrinter 함수를호출하여프린터상태를검사할때이속성이자동으로설정됩니다. 상태값은중복되어설정될수있으며비트연산을통해각각의값을확인할수있습니다. 프린터상태값은다음과같습니다. Code Value Description BXL_STS_NRMAL 0 정상상태 BXL_STS_PAPEREMPTY 1 종이가없습니다. BXL_STS_CNVERPEN 2 프린터커버가열려있습니다. BXL_STS_PWERVER 4 프린터배터리잔량이모자랍니다. BXL_STS_MSR_READY 8 인쇄불능 MSR 읽기모드상태입니다. BXL_STS_PRINTING 16 프린터가인쇄중 / 데이터전송중입니다. BXL_STS_ERRR 32 프린터와교신중오류가발생되었습니다. BXL_STS_NT_PEN 64 BXPrinterControl의 open 메소드가호출되지않았습니다. BXL_STS_ERRR_CCUR 128 프린터내부에오류가생겼습니다. BXL_STS_NT_CNNECTED -1 현재프린터에연결되지않았습니다 Connection Control 프린터접속방식을설정합니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_CNNECTINMDE_AUT 0 자동연결모드 BXL_CNNECTINMDE_NAUT 100 수동연결모드 Rev

11 PS 프린터 2-12 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_PENLEVEL_LW 0 Cash drawer 가열리면 Low BXL_CASHDRAWER_PENLEVEL_HIGH 1 Cash drawer 가열리면 High 2-14 Model ID 할당할프린터타입을지정합니다. 사용가능한속성은다음과같습니다. Code Value Description BXL_MDEL_ID_SPPR200II 0x SPP-R200II BXL_MDEL_ID_SRPR300 0x SPP-R300 BXL_MDEL_ID_SPPR400 0x SPP-R400 BXL_MDEL_ID_SRP350II 0x SRP-350II BXL_MDEL_ID_SRP350plus 0x SRP-350plus BXL_MDEL_ID_SRP352plus 0x SRP-352plus BXL_MDEL_ID_SRP350plusII 0x SRP-350plusII BXL_MDEL_ID_SRP352plusII 0x SRP-352plusII BXL_MDEL_ID_SRP350III 0x SRP-350III BXL_MDEL_ID_SRP352III 0x SRP-352III BXL_MDEL_ID_SRP275 0x SRP-275, SRP-275II BXL_MDEL_ID_SRPF310 0x SRP-F310 BXL_MDEL_ID_SRPF312 0x SRP-F Connection Class 프린터의연결타입을정의합니다. didfindprinter 함수가호출될때 BXPrinter class 의 connectionclass 에갱신됩니다 didfindprinter 참고 Code Value Description BXL_CNNECTINCLASS_WIFI 0x0000 WIFI Connection BXL_CNNECTINCLASS_ETHERNET 0x0001 Ethernet Connection Rev

12 PS 프린터 2-16 Result Code Code DEFINE Value Description BXL_SUCCESS 0 성공 BXL_NT_CNNECTED -1 프린터와연결되지않았습니다. BXL_NT_PENED 101 SDK가 PEN되지않았습니다. BXL_STATUS_ERRR 103 상태검사에서에러가발생되었습니다. BXL_CNNECT_ERRR 105 접속실패 BXL_NT_SUPPRT 107 지원되지않음 BXL_BAD_ARGUMENT 108 잘못된함수인자 BXL_BUFFER_ERRR 109 MSR 버퍼가정상적이지않은경우 BXL_NT_CNNECTED 110 프린터와연결되어있지않음 BXL_RGBA_ERRR 111 이미지파일을 RGBA 데이터로변환과정에서오류발생 BXL_MEMRY_ERRR 112 메모리할당실패 BXL_T_LARGE_IMAGE 113 NV 영역에이미지다운로드시너무큰이미지파일인경우 BXL_NT_SUPPRT_DEVICE 114 프린터에서지원되지않습니다. BXL_READ_ERRR 301 데이터수신이실패하였습니다. BXL_WRITE_ERRR 300 데이터전송이실패하였습니다. BXL_BITMAPLAD_ERRR 400 이미지파일을읽지못했습니다. BXL_BC_DATA_ERRR 500 바코드데이터가잘못되었습니다. BXL_BC_NT_SUPPRT 501 지원되지않는바코드타입입니다. BXLMSR_NTREADY 602 MSR READY 상태가아닙니다. BXLMSR_FAILEDMDE 601 자동읽기모드가아닙니다. BXLMSR_DATAEMPTY 603 MSR에서읽은데이터가없습니다. 1001H 알수없는명령어입니다. 1002H 동작이불가능한수행입니다. 1003H 정확하지않은인자수입니다. 1004H 알수없는명령어또는유효하지않은명령어의첫바이트입니다. 1005H 응답시간이초과되었습니다. 1010H 카드리셋으로인한응답에러입니다. 또는응답의첫번째바이트가유효하지않습니다. 1012H 메세지제한초과되었습니다. 최대 254바이트, 카드데이터는 248바이트입니다. 1013H 비동기루틴에서바이트읽기에러발생 1015H 카드모드가종료됨. 카드모드명령어전송필요 101BH 인자가부정확한명령어가전송 101DH TCK check 바이트가올바르지않음 10A0H 카드리셋응답에서에러발생 ( 알수없는프로토콜또는 TA1 바이트인식오류 ) 카드미지원. 리셋을위한카드응답값이없음 Rev

13 PS 프린터 Code DEFINE Value Description 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

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

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

16 PS 프린터 modelstr 프린터의모델명 펌웨어에서제공되는모델명으로 SRP-350II 프린터의경우 _ SRP-350II NSString * modelstr BXPrinterController 의 checkprinter 메소드에의해이값은갱신됩니다. SDK and later versionstr 프린터의펌웨어버전 펌웨어에서제공되는버전명으로 V01.00 STB NSString * versionstr BXPrinterController 의 checkprinter 메소드에의해이값은갱신됩니다. SDK and later connectionclass 프린터의연결방식 프린터가네트워크에연결된방식이저장됩니다 Connection Class unsigned short * connectionclass SDK and later Rev

17 PS 프린터 5. BXPrinterController Class Reference Inherits from Confirms to Framework Declared NSbject BXPrinter.a is 4.3 and later BXPrinter.h 5-1 verview BXPrinterController Class 는프린터제어를위한메인객체입니다. 5-2 Properties version SDK NSString * version 과같은형태로이뤄진문자열이며읽기전용입니다 delegate BXPrinterControlDelegate id<bxprintercontroldelegate> delegate target BXPrinter * target 제어대상이되는프린터객체로서프린터제어전지정이되어야합니다. Rev

18 PS 프린터 lookupduration 프린터검색시간 ( 단위 : 초 CGFloat lookupduration 0.5 와같이소수점부분을포함할수있습니다 lookupcount unsigned lookupcount 기본값은 1 로설정되어있으며 1 보다큰숫자가지정된경우, 프린터검색시 0.2 초단위로이숫자만큼반복해서프린터검색신호를전송합니다 alignment int alignment 기본값은좌측정렬로되어있으며, 이값은텍스트, 바코드등모든출력값에영향을미칩니다. SDK and later attribute int attribute 2-5 Text Attribute 참고 SDK and later Rev

19 PS 프린터 textsize int textsize 2-4 Text Size 참고 characterset CGFloat lookupduration 2-1 Character Set 참고기본값은 BXL_CS_437 로설정되어있습니다 char internationalcharacterset 2-2 International Character Set 참고. 기본값은 BXL_CS_437 로설정되어있습니다 textencoding Text Encoding long textencoding NSString.h NSStringEncoding 참조 SDK and later Rev

20 PS 프린터 state 프린터상태코드이값은 BXPrinterController 의 checkprinter long state 2-10 State 참고 long state 2-9 Power 참고 int AutoConnection 2-11 Connection Control 참고 SDK and later <Note> 자동연결모드에서는 connect/disconnect 함수를사용하지않아도, 자동으로프린터의연결을제어합니다. 대부분의함수의시작 / 끝부분에 connect/disconnect 작업이포함되어있으므로, printtext 함수를연달아사용할경우출력속도가느릴수있습니다. 이경우, 수동연결모드를사용하십시오 int drawerpin 2-12 Drawer kick-out connector pin 참고 SDK and later Rev

21 PS 프린터 int drawerpenlevel 2-13 Drawer open level 참고 SDK and later 5-3 Instance Methods getinstance BXPrinterController 클래스인스턴스를얻는메소드 - (BXPrinterController)getInstance 최초호출시엔 BXPrinterController 클래스를자동으로생성하여반환하고, 이후호출시엔기생성된 BXPrinterController 클래스를반환합니다. BXPrinterController 클래스는하나의프로세스에서하나의인스턴스만을사용하므로, 사용자가직접생성하지않고, 이메소드를통해얻고사용합니다. SDK and later open BXPrinterController 클래스사용을위한초기화작업 ( 메모리할당및백그라운드스레드동작 ) - (void)open (void)applicationdidbecomeactive:(uiapplication *)application 과같은 Application 의 ` 메인 delegate 호출시반드시선행되어호출되어야합니다. Rev

22 Rev PS 프린터 close BXPrinterController 클래스사용을중단또는종료하기위해할당된리소스해제작업을수행합니다. - (void)applicationwillresignactive:(uiapplication *)application 과같은 Application 의메인 delegate 호출시반드시선행되어호출되어야합니다. close 메소드가호출되지않고 BXPrinterController 를사용하는앱이백그라운드모드로동작하는경우, 또다른앱에서의 BXPrinterController 동시사용이제한될수있습니다 lookup 아이폰이연결된 WiFi 와동일한네트워크대역에서프린터를검색합니다. - (void)lookup 검색의시작 / 종료및검색된프린터는 BXPrinterControlDelegate 를통해얻을수있습니다. 아이폰의경우 3G 와 WiFi 각각 2 개의네트워크어댑터를가지며 lookup 메소드는이중 WiFi 만을사용해서검색합니다. 현재연결된 WiFi 가없는경우아무런작업을하지않습니다 selecttarget Target 으로지정된객체를초기화합니다. - (long)selecttarget - (long)selecttarget : (int) modelid modelid - 모델타입을선택합니다. - 사용하지않을경우, 자동으로할당됩니다 Model ID 참고 BXPrinterController 의 target 이미리지정되어있어야합니다. SDK and later

23 PS 프린터 connect target printer 에접속합니다. - (BL)connect AutoConnection 변수가 BXL_CNNECTINMDE_AUT (default, == 0) 으로설정된경우동작하지않습니다. BXPrinterController 의 target 이미리지정되어있어야합니다. SDK and later disconnect 현재접속된프린터와의연결을끊습니다. - (void)disconnect AutoConnection 변수가 BXL_CNNECTINMDE_AUT (default, == 0) 으로설정된경우동작하지않습니다. SDK and later enablelsb Last status back 기능을활성화합니다. - (long)enablelsb:(bl)benable benable LSB 설정. FALSE : LSB Disable TRUE : LSB Enable SDK and later Rev

24 PS 프린터 printtext 텍스트를인쇄합니다. 현재연결된프린터가없는경우아무런작업을하지않습니다. (long)printtext:(nsstring *)string string null 종결자를가진 Unicode Data. 인쇄대상텍스트스트링 텍스트의정렬, 속성이미리지정되어있어야합니다 printbox 상자모양 Text 를인쇄합니다. 현재연결된프린터가없는경우아무런작업을하지않습니다. (long)printtext:(int)width height: (int)height; int 상자의너비를지정합니다. 1 == 알파벳 1 글자만큼의너비 int 상자의길이를지정합니다. 1 == 알파벳 1 글자만큼의길이 텍스트의정렬, 속성이미리지정되어있어야합니다. SDK and later Rev

25 PS 프린터 linefeed 라인피드를수행합니다. - (long)linefeed:(int)lines lines 라인피드의개수 nextprintpos 다음라벨용지의시작지점으로용지를피딩합니다. - (long)nextprintpos 이메소드는라벨모드일때에만동작을합니다. Rev

26 PS 프린터 printbarcode 1 차원및 2 차원바코드를인쇄합니다. - (long)printbarcode:(char *)data symbology:(long)symbology width:(long)width height:(long)height alignment:(long)alignment textposition:(long)textposition data null 종결자를가진 ANSI code data 입니다. 인쇄할바코드데이터를전달합니다. symbology 바코드타입을정의합니다. height 바코드의높이. Dot 단위를가지고있으며, 1~255 값을가지고있습니다. 2 차원바코드는영향을받지않습니다. width 바코드의넓이로 2~7 의넓이단계를가지고있습니다. 바코드의인쇄크기가프린터용지를넘어갈때인쇄가되지않을수있습니다. 2 차원바코드는이값의영향을받지않습니다. alignment 바코드의정렬설정 2-3 Barcode/Text Alignment 참고 textposition 바코드텍스트위치설정 2-6 Barcode Text Position 참고 Rev

27 PS 프린터 printbitmap 이미지파일을인쇄합니다. - (long)printbitmap:(nsstring *)path width:(long)width alignment:(long)alignment level:(long)level path 이미지파일의경로 width 변환할이미지파일의넓이입니다. 0 ~ 최대너비까지설정할수있습니다. 0보다작은값을설정시조건에맞게이미지크기가변환됩니다. 2-8 Image Width 참고 alignment 이미지의정렬설정 2-3 Image Alignment 참고 level 이미지색상레벨및디퓨전처리여부를설정합니다. 값설명 0 ~ 100 색상레벨값네번째수가 1인경우디퓨전처리수행다섯번째수가 1인경우 ESC * 커맨드이용이미지출력 < 참고 > Error Diffusion 이란? 컬러영상이나흑백영상을좀더적은양의 bits/pixel 로표현하기위한기술로특정이미지의경우몇가지명백히드러나는마치뱀과같은패턴이생성될수도있지만날카로운묘사를보존하는능력이뛰어납니다. 단점은처리시간이길다는것이며이는오류를측정하고이를이웃하는화소들에게분산시키는데필요한계산량때문입니다. 본 SDK 에선에러디퓨전알고리즘의사용을권장합니다. Rev

28 PS 프린터 checkprinter 프린터상태를체크하여상태속성에값을설정합니다. - (long)checkprinter msrreadready 프린터를 MSR Ready 상태로전환합니다. Ready 상태에서는인쇄가불가능합니다. 지원기기 : PS Printer 는지원되지않습니다. - (long)msrreadready msrreadcancel 프린터를 MSR Ready 상태에서해제합니다. 지원기기 : PS Printer 는지원되지않습니다. - (long)msrreadcancel Rev

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

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

31 PS 프린터 directi 사용자정의데이터를보내고, 읽을수있습니다. - (long)directi:(nsdata *)request response:(nsdata **)response request 프린터로전송할데이터이며, ANSI CDE 데이터입니다. response 프린터에서읽은응답이저장됩니다 icn 프린터스마트카드리더에전원을인가합니다. 지원기기 : PS Printer 는지원되지않습니다. - (long)icn:(nsdata **)response response ATR(Answer to Reset) 값이저장됩니다. response 는메소드내에서 auto release 형태로저장되므로, 사용자가명시적으로 release 할필요가없습니다 icff 프린터스마트카드리더에전원을차단합니다. 지원기기 : PS Printer 는지원되지않습니다. - (long)icff Rev

32 PS 프린터 icapdu APDU 명령어를전송하고응답값을가져옵니다. 프린터스마트카드에전원이인가된상태에서만정상적으로동작합니다. 지원기기 : PS Printer 는지원되지않습니다. - (long)icapdu:(nsdata **)request response:(nsdata **)response request 프린터로전송할 APDU command 데이터입니다. ANSI CDE 데이터입니다. response 프린터에서전송된 APDU 응답값을기록합니다 icgetstatus 프린터스마트카드리더에삽입된카드상태를가져옵니다. 지원기기 : PS Printer 는지원되지않습니다. - (long)icgetstatus:(nsdata **)response response 카드상태값을저장합니다. Rev

33 PS 프린터 nvimagelist NV 영역에저장된이미지어드레스리스트를얻습니다. - (long)nvimagelist:(nsarray **)images images 어드레스리스트를제공합니다. 각어드레스는 NSNumber * 의형태로저장되며 images 는 autorelease 형태로제공되므로, 개발자가명시적으로 release 하실필요가없습니다. < 예제 > NSArray *images; [[BXPrinterController getinstance()] nvimagelist:&images]; for( NSNumber *n in images) { NSLog(@ %d, [NSNumber intvalue]); } SDK and later Rev

34 PS 프린터 downloadnvimage (Diffusion) NV 영역의지정된어드레스에해당이미지데이터를다운로드합니다. - (long)downloadnvimage:(int)address withimage:(uiimage *)image width:(long)width level:(long)level address 0 ~ 99 까지사용가능한이미지어드레스. 해당어드레스에이미지가이미저장된경우기존이미지를새로운이미지로대체합니다. images 다운로드대상이미지객체 width 이미지인쇄대상넓이 BXL_WIDTH_FULL 로지정된경우프린터의출력가능한최대넓이로이미지가출력됩니다. level 이미지의넓이가 width 보다작은경우이미지는확대되며, 이미지의넓이가 width 보다큰경우에는이미지는축소된다. 이미지색상레벨및디퓨전처리여부를설정합니다. 값설명 0 ~ 100 색상레벨값네번째수가 1인경우디퓨전처리수행다섯번째수가 1인경우 ESC * 커맨드이용이미지출력 < 참고 > Error Diffusion 이란? 컬러영상이나흑백영상을좀더적은양의 bits/pixel 로표현하기위한기술로특정이미지의경우몇가지명백히드러나는마치뱀과같은패턴이생성될수도있지만날카로운묘사를보존하는능력이뛰어납니다. 단점은처리시간이길다는것이며이는오류를측정하고이를이웃하는화소들에게분산시키는데필요한계산량때문입니다. 본 SDK 에선에러디퓨전알고리즘의사용을권장합니다. 해당이미지의크기가프린터의가로폭보다큰경우이미지는자동으로리사이즈됩니다. SDK and later Rev

35 PS 프린터 downloadnvimage (Normal) NV 영역의지정된어드레스에해당이미지데이터를다운로드합니다. - (long)downloadnvimage:(int)address withimage:(uiimage *)image address 0 ~ 99 까지사용가능한이미지어드레스. 해당어드레스에이미지가이미저장된경우기존이미지를새로운이미지로대체합니다. images 다운로드대상이미지객체 해당이미지의크기가프린터의가로폭보다큰경우이미지는자동으로리사이즈됩니다. Width 의값은 BXL_WIDTH_FULL 로지정되며, level 은 밝기 50% 및에러디퓨전알고리즘이적용 으로처리된이미지데이터가다운로드됩니다. SDK and later printnvimage NV 영역의지정된어드레스에저장된이미지를출력합니다. - (long)printnvimage:(int)address address 0 ~ 99 까지사용가능한이미지어드레스 해당어드레스에이미지가존재하지않는경우, 이미지는출력되지않습니다. SDK and later Rev

36 PS 프린터 removenvimage NV 영역의지정된어드레스에저장된이미지를삭제합니다. - (long)removenvimage:(int)address address 0 ~ 99 까지사용가능한이미지어드레스 해당어드레스에이미지가존재하지않는경우, 아무것도수행하지않습니다. SDK and later removeallnvimages NV 영역에저장된모든이미지를삭제합니다. - (long)removeallnvimages SDK and later opendrawer Cash Drawer 를 open 합니다. - (long)opendrawer SDK and later Rev

37 PS 프린터 issupport_msr MSR 관련기능의지원여부를확인합니다. - (BL)isSupport_MSR MSR 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later issupport_ic IC 관련기능의지원여부를확인합니다. - (BL)isSupport_IC IC 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later issupport_config Config 관련기능의지원여부를확인합니다.. - (BL)isSupport_MSR Config 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later issupport_cashdrawer CashDrawer 관련기능의지원여부를확인합니다. - (BL)isSupport_CashDrawer CashDrawer 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later Rev

38 PS 프린터 issupport_lsb LSB 관련기능의지원여부를확인합니다. - (BL)isSupport_MSR LSB 관련기능이지원되는경우, TRUE 를반환합니다. SDK and later getbarcodesupporttable Barcode 지원여부를확인합니다. - (NSMutableArray*)getBarcodeSupportTable BXBarcode 를가지고있는 NSMutableArray 를반환합니다. SDK and later Rev

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

40 Rev PS 프린터 didfindprinter 동일네트워크대역에서프린터가검색되면개별프린터마다이메소드가호출됩니다. - (void)didfindprinter:(bxprintercontroller *)controller printer:(bxprinter *)printer controller 이벤트의주체가된 BXPrinterController 객체 printer 검색된프린터정보 한번의프린터검색과정에서동일한프린터가여러차례응답을한경우최초한번만이메소드가호출됩니다. SDK and late didconnect 프린터에접속이완료된후호출됩니다. - (void)didconnect:(bxprintercontroller *)controller 프린터접속전사용자에게표시된진행상태를제거하기위해사용할수있습니다. 접속대상프린터정보가필요한경우 BXPrinterController 의 target property 를참조. SDK and later didnotconnect 프린터에접속을할수없을때호출됩니다. - (void)didnotconnect:(bxprintercontroller *)controller witherror:(nserror *)error controller 이벤트의주체가된 BXPrinterController 객체 error 실패된원인정보 프린터접속과정에서에러가발생된경우사용할수있습니다.

41 PS 프린터 willlookupprinters 프린터검색을시작하기전에호출됩니다. - (void)willlookupprinters:(bxprintercontroller *)controller controller 이벤트의주체가된 BXPrinterController 객체 프린터검색과정동안사용자에게별도의표시를하는경우사용할수있습니다 didlookupprinters 프린터검색이완료된후호출됩니다. - (void)didlookupprinters:(bxprintercontroller *)controller controller 이벤트의주체가된 BXPrinterController 객체 프린터검색과정동안사용자에게별도의표시를하는경우사용할수있습니다 didnotlookup 프린터검색을할수없을때호출됩니다. - (void)didnotlookup:(bxprintercontroller *)controller witherror:(nserror *)error controller 이벤트의주체가된 BXPrinterController 객체 error 실패된원인정보 와이파이에연결되지않은경우 lookup 이실패됩니다. Rev

42 PS 프린터 didbebrokenconnection 프린터와의연결이끊어진경우호출됩니다. - (void)didbebrokenconnection:(bxprintercontroller *)controller witherror:(nserror *)error controller 이벤트의주체가된 BXPrinterController 객체 error 실패된원인정보 사용자가명시적으로 BXPrinterController 의 close 메소드를호출해서접속을끊은경우에는호출되지않습니다. 이메소드는사용자가아닌외부의다른장애로인해연결이끊어진경우에만호출됩니다. 대상프린터정보가필요한경우 BXPrinterController 의 target property 를참고하십시오 msrarrived MSR Read 모드에서 MSR 데이터가정상적으로도착한경우호출됩니다. - (void)msrarrived:(bxprintercontroller *)controller track:(nsnumber *)track controller 이벤트의주체가된 BXPrinterController 객체 track MSR 데이터가발생된트랙의번호 1~3 이메소드가호출된후 BXPrinterController 의 gettrack: 메소드를통해해당트랙의 MSR 데이터를얻을수있습니다. Rev

43 PS 프린터 didupdatestatus 프린터의상태변수가변경된경우호출됩니다. - (void)didupdatestatus:(bxprintercontroller *)controller Status(NSNumber*) status controller 이벤트의주체가된 BXPrinterController 객체 status printer 의현재상태 SDK and later Rev