Skip to content

PAL

Overview

The SynqpayPrinter module integrates with the built-in thermal printer on Synqpay devices, allowing developers to create structured print jobs using the Printer Abstraction Layer (PAL).

Printing API

1
void print(in Bundle bundle);
The print method accepts a Bundle object representing the document to be printed. The Bundle is constructed using the SynqpayPAL package.

Printer Abstraction Layer (PAL)

The SynqpayPAL package provides the necessary tools for building structured, customizable printable documents. It offers options for adjusting text direction, alignment, and line customization.

SynqpayPAL class

Direction Enum

  • LTR: Left-to-right text direction (default).
  • RTL: Right-to-left text direction.

Align Enum

  • START: Aligns text to the left.
  • END: Aligns text to the right.
  • CENTER: Centers the text.

Key Defaults

  • Direction: Left-to-Right (LTR)
  • Alignment: Start
  • Text size: 14 (inherited from the line, but can be overridden for specific text)
  • Fill last: false
  • Vertical space: None

Key Methods

1
public static IDocument newDocument();
Creates a new document for printing.

IDocument Interface

The IDocument interface provides methods for constructing and finalizing a printable document.

Key Methods

1
IDocument direction(SynqpayPAL.Direction eDirection);
Sets the text flow direction.

1
ILine addLine();
Adds a new line to the document.

1
IDocument addSpace(int space);
Adds vertical space between elements (default: none).

1
IDocument addDivider(int height);
Adds a horizontal divider with specified thickness.

1
Bundle bundle();
Finalizes the document into a Bundle for printing.

ILine Interface

The ILine interface customizes the layout of text elements within a line.

Working Modes

  1. Regular Mode: Text elements are added sequentially without spacing. Alignment applies only to the entire line, not individual text elements.
  2. Fill Last Mode: The last text element stretches to fill the remaining space in the line. Alignment can only be adjusted for the last element.
  3. Weight Mode: Space allocation is proportional to the weight of text elements. The fillLast property is ignored. Alignment can be applied to all text elements because they occupy distinct spaces.

Key Methods

1
IText addText();
Adds a text element to the line.

1
ILine align(SynqpayPAL.Align align);
Sets the alignment for the entire line (not individual text elements).

1
ILine textSize(int size);
Sets the text size for all elements in the line (default: 14). Inherited by text elements but can be overridden for specific text.

1
ILine fillLast(boolean fill);
Enables the Fill Last Mode.

1
ILine spaceTop(int spaceTop);
Adds space above the line (default: none).

1
ILine spaceBottom(int spaceBottom);
Adds space below the line (default: none).

IText Interface

The IText interface customizes the appearance and styling of text elements.

Key Methods

1
IText text(String text);
Sets the text content.

1
IText bold(boolean bold);
Applies bold styling to the text.

1
IText italic(boolean italic);
Applies italic styling to the text.

1
IText underline(boolean underline);
Underlines the text.

1
IText textSize(int size);
Sets the text size (default: inherited from the line, but can be overridden for specific text).

1
IText weight(int weight);
Defines the space allocation weight for Weight Mode.

1
IText align(SynqpayPAL.Align align);
Sets the alignment for the text element.

Example Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
import android.os.Bundle;
import SynqpayPAL.*;

// Create a new document
IDocument document = SynqpayPAL.newDocument();

ILine line1 = document.addLine();
line1.addText()
        .text("Hello");
line1.addText().text("World!");

document.addSpace(30);

document.addLine().addText().text("Fill Last Mode").bold(true);
document.addDivider(4);
ILine line2 = document.addLine();
line2.fillLast(true);
line2.addText().text("Hello");
line2.addText().text("World").align(PAL.Align.END);

document.addSpace(30);

document.addLine().addText().text("Weight Mode").bold(true);
document.addDivider(4);
ILine line3 = document.addLine();
line3.addText().text("Hello").weight(1);
line3.addText().text("World").weight(1);
ILine line4 = document.addLine();
line4.addText().text("Another").weight(1);
line4.addText().text("Text of line").weight(1);

document.addSpace(10);

ILine line5 = document.addLine();
line5.addText().text("ITEM").weight(6);
line5.addText().text("QTY").weight(2);
line5.addText().text("PRICE").weight(3).align(PAL.Align.END);

ILine line6 = document.addLine();
line6.addText().text("Apples").weight(6);
line6.addText().text("1kg").weight(2);
line6.addText().text("$1.00").weight(3).align(PAL.Align.END);

ILine line7 = document.addLine();
line7.addText().text("Coca Cola 1,5l").weight(6);
line7.addText().text("3 pcs").weight(2);
line7.addText().text("$10.00").weight(3).align(PAL.Align.END);

ILine line8 = document.addLine();
line8.addText().text("Bread 1,5l").weight(6);
line8.addText().text("3 pcs").weight(2);
line8.addText().text("$10.00").weight(3).align(PAL.Align.END);


// Finalize and print
Bundle bundle = document.bundle();
try {
    printer.print(bundle);
} catch (RemoteException e) {
    throw new RuntimeException(e);
}
Operator menu
Example