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 Tliu2@zebra.com

• 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