Merge branch 'Experimental'

Author: Laurence Bank

examples/custom_font/FreeSerif12pt7b.h

@@ -0,0 +1,70 @@
+//
+// Custom Font Demo
+//
+// Print Adafruit_GFX bitmap fonts on inexpensive thermal printers
+// as line-at-a-time graphics output which doesn't require any bitmap buffers
+//
+// written by Larry Bank
+// Copyright (c) 2021 BitBank Software, Inc.
+// 
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+
+#include <Thermal_Printer.h>
+#include "FreeSerif12pt7b.h"
+#include "OpenSansBold64.h"
+ 
+void setup() {
+  int iWidth;
+  // put your setup code here, to run once:
+  Serial.begin(115200);
+  while (!Serial);
+  Serial.println((char *)"Scanning for BLE printer");
+  if (tpScan()) // Scan for any supported printer name
+  {
+    Serial.println((char *)"Found a printer!, connecting...");
+    if (tpConnect())
+    {
+      char *szName = tpGetName();
+      Serial.println((char *)"Connected!");
+      iWidth = tpGetWidth();
+      Serial.print("Printer pixel width = ");
+      Serial.println(iWidth, DEC);
+      Serial.print("Reported printer name = ");
+      Serial.println(szName);
+      // optionally speed up BLE data throughput if your MCU supports it
+      //    tpSetWriteMode(MODE_WITHOUT_RESPONSE);
+      // Draw text with a custom proportional font
+      Serial.println("Printing custom fonts");
+      // You can use the tpDrawCustomText to draw these same fonts
+      // into your graphics buffer instead of sending directly to the printer
+      tpPrintCustomText((GFXfont *)&FreeSerif12pt7b, 0, (char *)"You too can print nice looking fonts");
+      tpPrintCustomText((GFXfont *)&FreeSerif12pt7b, 0, (char *)"with Adafruit_GFX bitmap format.");
+      tpPrintCustomText((GFXfont *)&Open_Sans_Bold_64, 0, (char *)"Huge fonts!");
+      tpFeed(48); // feed the paper out a little from the print head to see what was printed
+      Serial.println((char *)"Disconnecting");
+      tpDisconnect();
+      Serial.println((char *)"Done!");
+      while (1) {};      
+    } // if connected
+  } // successful scan
+  else
+  {
+    Serial.println((char *)"Didn't find a printer :( ");
+  }
+} /* setup() */
+
+void loop() {
+ // nothing going on here :)
+}

examples/custom_font/OpenSansBold64.h

@@ -0,0 +1,71 @@
+#include <Thermal_Printer.h>
+#include <JPEGDEC.h>
+
+#include "eagle_576.h"
+#include "dog_384.h"
+
+uint8_t ucDither[576 * 16]; // buffer for the dithered pixel output
+JPEGDEC jpg;
+static int iWidth;
+
+int JPEGDraw(JPEGDRAW *pDraw)
+{
+  int i, iCount;
+  uint8_t *s = (uint8_t *)pDraw->pPixels;
+  
+  tpSetBackBuffer((uint8_t *)pDraw->pPixels, pDraw->iWidth, pDraw->iHeight);
+  // The output is inverted, so flip the bits
+  iCount = (pDraw->iWidth * pDraw->iHeight)/8;
+  for (i=0; i<iCount; i++)
+     s[i] = ~s[i];
+     
+  tpPrintBuffer(); // Print this block of pixels
+  return 1; // Continue decode
+} /* JPEGDraw() */
+
+void setup() {
+  Serial.begin(115200);
+  while (!Serial);
+  Serial.println((char *)"Scanning for BLE printer");
+  if (tpScan()) // Scan for any supported printer name
+  {
+    Serial.println((char *)"Found a printer!, connecting...");
+    if (tpConnect())
+    {
+      Serial.println("Connected!");
+      tpSetWriteMode(MODE_WITHOUT_RESPONSE);
+    }
+    else
+    {
+      Serial.println("Failed to connected :(");
+      while (1) {};
+    }
+  } // if scan
+  else
+  {
+    Serial.println((char *)"Didn't find a printer :( ");
+    while (1) {};
+  }
+} /* setup () */
+
+void loop() {
+uint8_t *pImage;
+int iImageSize;
+
+  iWidth = tpGetWidth(); // get the width of the printer in pixels
+  if (iWidth == 384) {
+     pImage = (uint8_t *)dog_384;
+     iImageSize = (int)sizeof(dog_384);
+  } else { // assume 576
+     pImage = (uint8_t *)eagle_576;
+     iImageSize = (int)sizeof(eagle_576);
+  }
+  if (jpg.openFLASH(pImage, iImageSize, JPEGDraw)) {
+     jpg.setPixelType(ONE_BIT_DITHERED);
+     jpg.decodeDither(ucDither, 0);
+  }
+  tpFeed(32); // advance the paper 32 scan lines
+  tpDisconnect();
+  Serial.println("Finished printing!");
+  while (1) {};
+} /* loop() */

examples/custom_font/custom_font.ino

@@ -1,9 +1,9 @@
 name=Thermal Printer Library
-version=1.1.2
+version=2.0.0
 author=Larry Bank
 maintainer=Larry Bank <[email protected]>
 sentence=Bluetooth Low Energy Thermal Printer Library 
-paragraph=BLE thermal printer library allows you to easily scan, connect and print graphics plus text.
+paragraph=BLE thermal printer library allows you to easily scan, connect and print graphics plus text on a variety of supported printers.
 category=Device Control
 url=https://github.com/bitbank2/Thermal_Printer
 architectures=nrf52,esp32