ciontek_sdk_flutter #

Printer Functions #

This plugin provides a set of methods to interact with Ciontek printers from your Flutter app. Below are the available printer functions, their descriptions, and code examples:

Printer Connection & Status #

• connectPrinter()
  Connects to the printer service. Must be called before any print operation.

  await _ciontekSdkFlutterPlugin.connectPrinter();
  

• printerIsConnected()
  Returns true if the printer is connected, otherwise false.

  bool connected = await _ciontekSdkFlutterPlugin.printerIsConnected();
  

• getPrinterStatus() / printCheckStatus()
  Checks the current printer status.

  • 0: Success (ready)
  • -1: Need paper
  • -2: High temperature
  • -3: Low battery voltage

  int? status = await _ciontekSdkFlutterPlugin.getPrinterStatus();
  

Printer Initialization & Settings #

• printInit()
  Initializes the printer.

  await _ciontekSdkFlutterPlugin.printInit();
  

• setPrinterFont(int var1, int var2, int var3)
  Sets the printer font.

  await _ciontekSdkFlutterPlugin.setPrinterFont(16, 16, 0x33);
  

• setPrinterSpace(int var1, int var2)
  Sets the printer space.

  await _ciontekSdkFlutterPlugin.setPrinterSpace(2, 4);
  

• setPrinterVoltage(int var1)
  Sets the printer voltage.

  await _ciontekSdkFlutterPlugin.setPrinterVoltage(5);
  

• setLinPixelDis(int charVal)
  Sets line pixel distance.

  await _ciontekSdkFlutterPlugin.setLinPixelDis(10);
  

• prnSetMode(int value)
  Sets the printer mode.

  await _ciontekSdkFlutterPlugin.prnSetMode(0);
  

• prnSetGray(int value)
  Sets the gray level.

  await _ciontekSdkFlutterPlugin.prnSetGray(2);
  

• prnSetSpeed(int value)
  Sets the print speed.

  await _ciontekSdkFlutterPlugin.prnSetSpeed(3);
  

• prnSetLeftIndent(int value)
  Sets the left indent.

  await _ciontekSdkFlutterPlugin.prnSetLeftIndent(5);
  

• prnSetAlign(int value)
  Sets the alignment.

  await _ciontekSdkFlutterPlugin.prnSetAlign(1); // 0: left, 1: center, 2: right
  

• prnSetCharSpace(int value)
  Sets the character space.

  await _ciontekSdkFlutterPlugin.prnSetCharSpace(2);
  

• prnSetLineSpace(int value)
  Sets the line space.

  await _ciontekSdkFlutterPlugin.prnSetLineSpace(4);
  

• prnSetLeftSpace(int value)
  Sets the left space.

  await _ciontekSdkFlutterPlugin.prnSetLeftSpace(8);
  

• prnSetUnderline(int value)
  Sets underline mode.

  await _ciontekSdkFlutterPlugin.prnSetUnderline(1); // 1: underline on, 0: off
  

• prnSetReverse(int value)
  Sets reverse mode.

  await _ciontekSdkFlutterPlugin.prnSetReverse(1); // 1: reverse on, 0: off
  

• prnSetBold(int value)
  Sets bold mode.

  await _ciontekSdkFlutterPlugin.prnSetBold(1); // 1: bold on, 0: off
  

Printing Functions #

• prnStr(String str)
  Prints a string.

  await _ciontekSdkFlutterPlugin.prnStr("Hello, Printer!\n");
  

• prnBmp(Uint8List bmpBytes)
  Prints a bitmap image. Pass the image as a byte array.

  // Example: Load image as bytes and print
  Uint8List bmpBytes = ...; // Your bitmap bytes
  await _ciontekSdkFlutterPlugin.prnBmp(bmpBytes);
  

• prnLogo(List
  Prints a logo from a byte array.

  List<int> logoBytes = ...; // Your logo bytes
  await _ciontekSdkFlutterPlugin.prnLogo(logoBytes);
  

• prnBarcode(String data, int type, int height, String param)
  Prints a barcode.

  await _ciontekSdkFlutterPlugin.prnBarcode("1234567890", 1, 100, "CODE_128");
  

• printCutQrCode(String data, int size, int level, String param)
  Prints and cuts a QR code.

  await _ciontekSdkFlutterPlugin.printCutQrCode("https://example.com", 200, 2, "QR_CODE");
  

• printCutQrCodeStr(String data1, String data2, int param1, int param2, int param3, String param4)
  Prints and cuts a QR code with additional parameters.

  await _ciontekSdkFlutterPlugin.printCutQrCodeStr("data1", "data2", 5, 300, 300, "QR_CODE");
  

• prnFeedPaper(int value)
  Feeds paper by the specified amount.

  await _ciontekSdkFlutterPlugin.prnFeedPaper(30);
  

• prnStart()
  Starts the print job.

  await _ciontekSdkFlutterPlugin.prnStart();
  

• printerStep(int var1)
  Steps the printer by a specified amount.

  await _ciontekSdkFlutterPlugin.printerStep(10);
  

• printTableText(List
  Prints table text with formatting.

  await _ciontekSdkFlutterPlugin.printTableText(
    ["Item", "Qty", "Price"],
    [100, 50, 50],
    [0, 1, 2],
  );
  

• printSetFontTTF(String fontName, int var2, int var3)
  Sets the TTF font.

  await _ciontekSdkFlutterPlugin.printSetFontTTF("Arial", 1, 0);
  

• printSetItalic(int value)
  Sets italic mode.

  await _ciontekSdkFlutterPlugin.printSetItalic(1); // 1: italic on, 0: off
  

• printSetDirection(int value)
  Sets print direction.

  await _ciontekSdkFlutterPlugin.printSetDirection(1); // 1: vertical, 0: horizontal
  

Usage Example #

await _ciontekSdkFlutterPlugin.connectPrinter();
if (await _ciontekSdkFlutterPlugin.printerIsConnected()) {
  await _ciontekSdkFlutterPlugin.printInit();
  await _ciontekSdkFlutterPlugin.setPrinterFont(16, 16, 0x33);
  await _ciontekSdkFlutterPlugin.prnStr("Hello, Printer!\n");
  await _ciontekSdkFlutterPlugin.prnFeedPaper(30);
  await _ciontekSdkFlutterPlugin.prnStart();
}

See the example app for more