Card Printer SDK Introduction - Zebra...
Transcript of Card Printer SDK Introduction - Zebra...
Card Printer SDK Introduction Tina Liu & James Chong (Card FW/SDK engineer/manager)
China Design Center, Guangzhou App forum HK 11/17/2015
Agenda
• Introduce Zebra Card Printers
• Card SDK Overview
• Common Use – Encoding and Printing
• Demo Show
Zebra Card Printers Introduction
ZXP Series 1
5
ZXP Series 3
• An ideal, reliable solution for applications requiring excellent print quality and minimal operator training
Versatile, Compact, Single or Dual-Sided
DIFFERENTIATION
• Compact size facilitates front-office deployments
• Ease of use
• Magnetic stripe and smart card encoding options
• Quick access to service & support tools and tips through NFC & QR code tags
• Ethernet connectivity and network monitoring software enable large-scale distributed deployments
Print Technology Direct -to-Card Printer
Print Capabilities Single or Dual-Sided
Print Speed (Single-
Sided) Color-195 CPH, Mono-700 CPH
Max. Images per
Ribbon Roll Color-280, Mono-2,000
Communications
Interface Standard: USB, Optional: Ethernet
Encoding Options Magnetic Stripe, Contact & Contactless
Smart Card
Laminator Option Not Available
RETAIL EDUCATION FINANCIAL SERVICES HEALTHCARE ACCESS CONTROL
◄ Membership & Loyalty Cards, Student ID Cards, Bank Cards, Employee ID and Access Control Cards ►
ZXP Series 1
6
ZXP Series 7
• Provides customers with fast and reliable performance combined with sharp, vivid images
Superb Image Quality, High Efficiency, Low Cost of Ownership
DIFFERENTIATION
• Robust design works in a wide range of environments and applications
• High-capacity ribbon rolls result in less operator time changing supplies
• Can process up to three jobs at the same time
• Quick access to service & support tools and tips through NFC & QR code tags
• Wasteless single or dual-sided lamination
• UHF RFID encoding and 802.11 b/g wireless connectivity
Print Technology Direct -to-Card Printer
Print Capabilities Single or Dual-Sided
Print Speed (Single-
Sided) Color-300 CPH, Mono-1,375 CPH
Max. Images per
Ribbon Roll Color-750, Mono-5,000
Communications
Interface
Standard: USB & Ethernet,
Optional: 802.11 b/g wireless
Encoding Options Magnetic Stripe, Contact & Contactless
Smart Card, UHF RFID
Laminator Option Available
ACCESS CONTROL EDUCATION GOVERNMENT HOSPITALITY
◄ Membership & Loyalty Cards, Student ID Cards, Bank Cards, Drivers Licenses, Employee ID and Access Control Cards ►
ZXP Series 1
7
ZXP Series 8
• Provides superior, photo-like image quality combined with highly durable and abrasion-resistant cards
High Security Retransfer Printer with Best in Class Throughput
DIFFERENTIATION
• Stunning photo-like cards
• Dual-sided simultaneous retransfer process provides best-in-class printing, encoding and laminating throughput
• Transfer film easily shows tamper evidence, providing built-in fraud protection
• Wasteless single or dual-sided lamination
• “Over-the-edge” card printing
Print Technology Retransfer Card Printer
Print Capabilities Single or Dual-Sided
Print Speed (Single-
Sided) Color-190 CPH
Max. Images per
Ribbon Roll Color-625, Mono-2,500
Communications
Interface
Standard: USB & Ethernet,
Optional: 802.11 b/g wireless
Encoding Options Magnetic Stripe, Contact & Contactless
Smart Card
Laminator Option Available
FINANCIAL SERVICES GOVERNMENT EDUCATION ACCESS CONTROL
◄ Government-Issued National IDs and Voting Cards, Student ID Cards, High Security Employee ID and Access Control Cards ►
Zebra Card SDK Introduction
Card SDKs Overview
Note: EoE – Encoding over Ethernet (在网络连接下的智能卡编码)
UHF Module - Ultra High Frequency Module (超高频智能卡编码模块)
Printer Scope SDK Download Address
ZXP Series 3 ZBRPrinter.dll ZBRGraphics.dll
https://www.zebra.com/us/en/forms/card/zxps3-downloads.html
ZXP Series 7 & 8 ZMotifPrinter.dll ZMotifGraphics.dll
https://www.zebra.com/us/en/forms/card/zxp-downloads.html
EoE ZXP3, 7 & 8 ZBRSXBridge.dll ZSCEncodeAP .dll
https://www.zebra.com/us/en/forms/card/zxp-downloads.html
UHF RFID ZXP 7 & 8 ZXPSCReader.dll https://www.zebra.com/us/en/forms/card/zxp-downloads.html
Content of our SDKs install package
Download these SDKs and install them, in the install folder, you can see the sdk, document and sample code.
从以上路径下载并安装,用户在安装目录下可以看到我们的SDK文件,帮助文档和示例代码。
ZXP3 - ZBRPrinter.dll & ZBRGraphics.dll
1. The both are developed by C++, they are 32 bits dynamic link library.
我们的SDK是用C++开发的32位的动态链接库。
2. ZBRPrinter.dll – basic print functions, such as connect, query status and so on.
ZBRGraphics.dll – graphics functions, like draw line, box and text.
3. These two SDKs must be used with the printer driver, can’t be used independently.
我们的SDK必须和打印机的驱动配合使用,不能单独使用。
Card
Application
ZBRPrinter.dll
Printer Driver
ZXP3 - ZBRPrinter.dll & ZBRGraphics.dll
4. When the application is developed by C#, must use the DllImport
to import the methods which will be used
如果用户的应用程序使用C#开发的,那么请使用DllImport从我们的SDK 中导出需要使用的方法。 //import the function from the dll: [DllImport("ZBRPrinter.dll", EntryPoint="ZBRPRNCheckForErrors", CharSet=CharSet.Auto, SetLastError=true)] public static extern int ZBRPRNCheckForErrors(IntPtr hPrinter, int PrinterType);
5. It’s better to copy the SDK into your application build folder
推荐将我们的SDK拷贝到应用程序的编译目录下。
ZXP7&8 -- ZMotifPrinter.dll & ZMotifGraphics.dll
• 13
1. The SDK is developed by COM, it must be register when the application use it.
我们的SDK是使用COM技术开发的,应用程序在使用前必须先对它进行注册。 例如:手动注册 regsvr32 D:\..\..\ZMotifPrinter.dll
也可以使用registrationhelper类来编程注册
Graphic COM Object
Printer COM Object
Job Class
Job Control
Device
Utilities
Laminator
Developer Graphics
ZMotif Job Methods for creating image DrawImage() DrawLine() DrawRectangle() DrawTextString() …
Creating ZMotif job and commands
GetPrinters() Open()/Close() GetJobStatus() BuildGraphicsLayers() …
JobConfiguration() MagConfiguration() SmartCardConfiguration() GetCardTypeInformation() …
GetPrinterStatus() Get/SetConfiguration() Get/SetNetworkParams() GetRibbonParams() …
General method of data type conversion ByteArrayToVariantArray() IntArrayToVariantArray() LongArrayToVariantArray() …
CalibrateLaminate() GetLaminateParams() GetLaminationSpeedOffsets() GetLaminatorSensorValues() …
ZXP7&8 -- ZMotifPrinter.dll & ZMotifGraphics.dll
• 14
2. The SDK doesn’t depend on the printer driver, they can be used independently.
我们的SDK可以单独使用,不依赖打印机驱动。
Host Application
Host Application
Host Application
Zmotif SDKs
USB Connect Network
In an Ethernet network where the printer may be shared by multiple hosts ZMotif allows the printer to receive data from only one host at a time.
ZXP7&8 -- ZMotifPrinter.dll & ZMotifGraphics.dll
• 15
3. Because the ZXP7&8 print job is based on the xml file, our SDK is used to construct
the job xml file and send to printer.
我们的ZXP7&8打印机的打印工作是基于xml文件的,所以我们SDK的主要功能是构造打印 工作的xml文件,并发送给打印机。
<?xml version="1.0" encoding="utf-8"?> <zmj_job number="2f2516f0-ee76-d210-c20d-442cf13dee31"> <card source="1" type="0" copies="1" read="no" thickness="30" delete="no"> <side name="front" orientation="landscape" rotation="0" sharpness ="normal"> <print type="color" fill="0xffffff"> <graphic type="bmp" source="job" opacity="1" x="0" y="0">1</graphic> </print> </side> <side name="back" orientation="landscape" rotation="0"> <magdata format="iso" coercivity="high" verify="yes"> <track number="1">ALPHANUMERIC DATA</track> <track number="2">NUMERIC DATA</track> <track number="3">NUMERIC DATA</track> </magdata> <print type="monok"> <graphic type="bmp" source="job" opacity="1" x="0" y="0">2</graphic> </print> </side> </card> </zmj_job>
4. Our ZXP7&8 Toolbox is a good demo for SDK, because it is developed by Zmotif SDK.
我们ZXP7&8打印机的Toolbox应用就是一个很好的SDK开发的例子。
Common Use
Encoding and Printing
Common Use -- Encoding and Printing Find Printers
Connect
Encoding Job
Printing Job
Disconnect
Get Job Status
Abort Job
Cancel Job
Resume Job
Check Printer Status
Most of customers use our printers to do the
magnetic/smart card Encoding, after verifying
the encoding successfully, do printing job.
Sample Code – Find Printers
Sample Code – Check Status
Sample Code – Magnetic Encoding
Sample Code – Smart Card Encoding
Sample Code – EoE Locate Reader
Sample Code – Create Virtual USB Connect
Sample Code – Build the Image
Sample Code - Printing
Demo Show
Card Demo
Recommendation
During the development, you can go to the Zebra Developer Community at http://developer.zebra.com when you have any questions. We have blogs, forums, and links to sample code and other documents there.
Driver & Tool Download Link
ZXP3 Driver: https://www.zebra.com/us/en/support-downloads/card/zxp-series-3.html#mainpartabscontainer_d7e3=drivers
ZXP7 Driver: https://www.zebra.com/us/en/support-downloads/card/zxp-series-7.html#mainpartabscontainer_d7e3=drivers
When you install the ZXP7 driver, the Toolbox is installed too.
ZXP8 Driver: https://www.zebra.com/us/en/support-downloads/card/zxp-series-8.html#mainpartabscontainer_d7e3=drivers+mainpartabscontainer=drivers
Card Studio: https://www.zebra.com/us/en/products/software/card-printers/zmotif-cardstudio-standard.html
Card SDK Demo: https://www.zebra.com/us/en/forms
Getting started with the ZXP 3 and ZXP 7&8 SDK guides: https://km.zebra.com/kb/index?page=content&channel=WHITE_PAPERS&carousel_category=CARD_SDKS/card/zxp-downloads.html
Let’s have some fun!
• Please send the following to [email protected]
• Your personal or family photo
• You names and company
• What do you like to get from this app forum?
• Anything you like us to follow up?
• We will print you a card and follow up on your question.
Thanks