Printing: Custom America Printer Settings

Custom America Printer Settings

JavaScript API Documentation & Sample Code

Related Settings


Kiosk Pro Enterprise includes support for certain Custom America thermal kiosk printers. In conjunction with this version of the app, these printers are capable of printing text, images, several types of UPC barcodes, QR codes, and basic .html.

Printing is triggered by the use of calls in our JavaScript API, which must be included in your page.

Kiosk Pro works with the following Custom America printers:

  • MY3A
  • K3
  • KPM216H ETH 200 dpi
  • KPM216H ETH 300 dpi
  • KPM302H
  • KUBE
  • Q1
  • Q3
  • VKP80II
  • TG2460H
  • TG2480H
  • D-ONE
  • KPM150H
  • KPM180H
  • VK80
  • VKP80III
  • KPM216H 200 dpi
  • KPM216H 300 dpi
  • TL60
  • TL80
  • TG02-H
  • PLUS2
  • mPLUS2
  • PLUS4

This version of Kiosk Pro has been tested with the TG2480H connected via RJ45 Ethernet cable to Custom’s Bluetooth dongle.

Printing without the API

You can print without adding the API to your page by using either the JavaScript call  window.print(); or the Print Icon in Kiosk Pro's Navigation Bar.

Select Custom America Printer

This setting will show any Custom America printers currently connected to the iPad and allow you to select which one Kiosk Pro should print from.

If your printer is not being shown, please confirm that it is connected by going to iOS Settings > Bluetooth.

Word Wrap Page Width (in characters)

This setting is designed to help Kiosk Pro provide word wrapping for multi-line text by defining the page width in characters of the printer and font being used.

This number will vary based on the printer model used, along with the print width and characters per inch set for that specific printer.

To find the print width and characters per inch currently set for the printer, you’ll need to check the printer setup.

To do this on a TG2480H, first unplug the device to power it down. Then, hold the line feed (LF) button down while plugging the printer in. As it powers up, it will print a summary of the current printer settings.

For other printers, please check the manual for instructions on how to print this diagnostic information. You can also modify the characters per inch setting for certain printers, increasing the printed font size; again for information on how to do this, please consult the manual. To find the manual for the model of printer you are using, check Custom America’s website.

Once you have these settings, you can calculate the approximate maximum characters possible for that page width.

For the TG2480H we used for testing, the printer setup page showed the following:

  • Chars / inch: A = 11 B= 15 cpi
  • Print Width: 76 mm

The ‘Chars / inch’ setting tells us that font A (generally the default) has 11 characters per inch (cpi) and font B has 15 cpi.

Convert print width (in this case, 76 mm) to inches (we used Google to convert -> 2.99213 inches) then multiply that by the cpi for the font you are using. In our testing, it was sometimes necessary to reduce this theoretical result by one or more to achieve correct word wrapping.

If we are using font A, this results in a maximum characters setting of 32 characters per line, which line-wrapped correctly when tested.

If we are using the more compact font B, this results in 44 characters per line, which in testing showed to be slightly too long (causing skipped lines in the resulting print job). Reducing this by two to 42 resulted in correct line wrapping.

To get a rough estimate for this setting without calculations, you can also consult the manual for your printer, looking for the ‘Character Specifications’ section which should include a table listing the ‘Number of Columns’ for each character density.

For the example above, the manual returned ‘35’ for the 11-cpi font A and ‘45’ for the 15-cpi font B. As shown above, both these would need to be reduced to achieve proper line wrap, but they are in the correct ballpark.

Still stuck? How can we help? How can we help?