1. Introduction
Star PassPRNT (hereafter referred to as PassPRNT) is a printing application made by Star Micronics co., Ltd.
PassPRNT is called by the host application using a function called URL scheme, accepts the printing data, and then outputs it to a Star Micronics-brand printer.
This manual describes the functions of PassPRNT and the application interactions between PassPRNT and the host application.
The application interaction of this software uses the Windows 10 UWP standard URI scheme (including path and query).
The printing layout is defined using HTML or PDF. Other printer settings use the queries described in this manual.
Accordingly, this manual is intended for application/system developers who use HTML and Windows C# UWP. A basic understanding of HTML, C# and so on are assumed for the users of this manual and software.
1.1. Functions of PassPRNT
The functions of PassPRNT are described below.
(A) Starting the Software
Selecting ‘Print’ will start the software in conjunction with the host application. After printing is completed, the host application is automatically displayed. (After printing is completed, PassPRNT will send any error codes to the host application.)
Selecting ‘Settings’ will be displayed as the Configuration screen when the application is started.
(B) Functions
PassPRNT is called by the host application using a URI scheme, accepts the printing data, and then the data can be printed from a Star Micronics printer.
(C) Setting Method
Printer Settings
There are two setting methods: settings can be made from the PassPRNT settings screen, or settings can be configured using queries from the host application.Settings made using queries are given priority.For information on making settings using queries, refer to Queries.
Printer Selection
- Designation of “Peripheral (Drawers, etc…)” (excluding mobile printers)
The activation timing is for the timing before printing and after printing.
(D) Screen Configuration
Printer Configuration
On the settings screen, the settings described in C)-1 can be made.
View/select a printer from a list of available printers (The “Search” function can be used)
Select the communication interface
When selecting printer, the interface selection window is displayed (LAN/Bluetooth/All).
Show detected printers in search results
Firmware version acquisition is performed after the printer is selected
Check the selected printer supports Firmware version, and then the result (*1) is displayed. The following screen (*2) will be displayed if a communication conformation error occurs.
Based on the above result, the emulation is also determined.
Check communication with the selected printer
Check communication with the selected printer.
The following factors are considered to be the main causes of a communication confirmation error.
The device and the printer are not paired correctly
The printer is offline (the power is off or there is no paper in the printer)
Too far away from the Bluetooth printer, or poor signal conditions
In this case, the printing item will be cleared to “None configured”. Check communication with the new printer.
Settings made using queries override the above settings. If the value is not included in the query, this setting will be enabled.
If selecting drawer configuration as “before printing” and printer was offline, drawer is opened after recovering online except mPOP.
The settings made are saved in the application until it is uninstalled.
(E) Languages
This application supports the following 2 languages. If the language setting of this device is not set to Japanese, it will be set to English.
Japanese
English
(F) Cautions
During printing
- Data storage period
The period from when PassPRNT is launched by the host application until the transition back to the host application.
- Reusability
The received printing data cannot be printed unless there are instructions from the user (select “retry” during printing).
- Canceling Application
Do not hold down the “home” button to cancel the operation when printing. If the application has been canceled, the operating system may close the application even when printing. Therefore, the printing result cannot be sent to the host application.
- Tablet-mode Disabled
PassPRNT can be used for Windows 10 unlike Android and iOS, by disabling tablet-mode. When printing data is sent continuously from the host application with tablet-mode disabled, PassPRNT discards data until the previous printing process is complete. Check that the current printing process is complete, and then send the next data.
- URI Scheme Limit
URI schemes can send and receive up to 2 KBs of data for specifications similar to Android and iOS. If the maximum amount of data that can be sent and received is 2 KBs, the PDF printing function will be excluded from Windows specifications as the amount of data is not sufficient enough to create PDF files.
Printing error due to settings failure
When “Printer” are not selected on the settings screen, PassPRNT will consider the printer settings (type) as blank. The printer being used is one of the paired Star printers. Therefore, if you need to output to a printer that requires specifying the printer settings (type), please make sure to select ‘Printer’ either on the settings screen or by query.