Printooth aim is to provide a simple abstraction for use the Bluetooth printers regardless of its brand.
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}dependencies {
implementation 'com.github.mazenrashed:Printooth:${LAST_VERSION}'
}<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />Should be initialized once in Application.onCreate():
Printooth.init(context);Printooth is providing a scanning activity to make pairing process easy. Just start ScanningActivity and you will skip the process of pairing and saving printer.
startActivityForResult(Intent(this, ScanningActivity::class.java), ScanningActivity.SCANNING_FOR_PRINTER)When the printer is being ready:
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == ScanningActivity.SCANNING_FOR_PRINTER && resultCode == Activity.RESULT_OK)
//Printer is ready now
}If you want to make your own user interface, you can pass your paired printer to Printooth like this:
Printooth.setPrinter(printerName, printerAddress)Check if Printooth has saved printer:
Printooth.hasPairedPrinter()To get the current saved printer:
Printooth.getPairedPrinter()To remove the current saved printer:
Printooth.removeCurrentPrinter()Printooth provides a simple builder to design your paper.
To print Hello World simply, write this code:
var printables = ArrayList<Printable>()
var printable = TextPrintable.Builder()
.setText("Hello World")
.build()
printables.add(printable)
Printooth.printer().print(printables)Use all builder functionalities:
var printables = ArrayList<Printable>()
var printable = TextPrintable.Builder()
.setText("Hello World") //The text you want to print
.setAlignment(DefaultPrinter.ALLIGMENT_CENTER)
.setEmphasizedMode(DefaultPrinter.EMPHASISED_MODE_BOLD) //Bold or normal
.setFontSize(DefaultPrinter.FONT_SIZE_NORMAL)
.setUnderlined(DefaultPrinter.UNDELINED_MODE_ON) // Underline on/off
.setCharacterCode(DefaultPrinter.CHARACTER_CODE_USA_CP437) // Character code to support languages
.setLineSpacing(DefaultPrinter.LINE_SPACING_60)
.setNewLinesAfter(1) // To provide n lines after sentence
.build()
printables.add(printable)
Printooth.printer().print(printables)Printooth.printer().printingCallback = object : PrintingCallback {
override fun connectingWithPrinter() { }
override fun printingOrderSentSuccessfully() { } //printer was received your printing order successfully.
override fun connectionFailed(error: String) { }
override fun onError(error: String) { }
override fun onMessage(message: String) { }
}var printer1 = PairedPrinter(name, address)
var printer2 = PairedPrinter(name, address)
Printooth.printer(printer1).print(printables)
Printooth.printer(printer2).print(printables)Create a class from type Printer and override the initializers method, then return your printer commands from the printers command sheet ( You can find it on the Internet ), let's take an example:
open class MyPrinter : Printer() {
override fun initLineSpacingCommand(): ByteArray = byteArrayOf(0x1B, 0x33)
override fun initInitPrinterCommand(): ByteArray = byteArrayOf(0x1b, 0x40)
override fun initJustificationCommand(): ByteArray = byteArrayOf(27, 97)
override fun initFontSizeCommand(): ByteArray = byteArrayOf(29, 33)
override fun initEmphasizedModeCommand(): ByteArray = byteArrayOf(27, 69)
override fun initUnderlineModeCommand(): ByteArray = byteArrayOf(27, 45)
override fun initCharacterCodeCommand(): ByteArray = byteArrayOf(27, 116)
override fun initFeedLineCommand(): ByteArray = byteArrayOf(27, 100)
override fun initPrintingImagesHelper(): PrintingImagesHelper = DefaultPrintingImagesHelper()
}If you have issues with printing images, you can implement the process of transfaring image from bitmap to ByteArray manually by extends PrintingImagesHelper class and implement getBitmapAsByteArray, then you shold return an object from your helper to initPrintingImagesHelper() as this example:
class MyPrintingImagesHelper : PrintingImagesHelper {
override fun getBitmapAsByteArray(bitmap: Bitmap): ByteArray {
return convertBitmapToByteArray(bitmap)
}
}
//in your printer class
open class MyPrinter : Printer() {
....
....
override fun initPrintingImagesHelper(): PrintingImagesHelper = MyPrintingImagesHelper()
}
//when using printooth
private val printing = Printooth.printer(MyPrinter())
...
printing.print(printables)Then pass your printer class to Printooth:
Printooth.printer(MyPrinter()).print(printables)-keep class * implements java.io.Serializable { *; }
We welcome contributions to Printooth!
- ⇄ Pull requests and ★ Stars are always welcome.
Thanks for @lafras-h for the nice project JavaPrintooth , it's an examples to use Printooth in java