btrz-liquid-templates 1.4.0 → 1.5.1

package/docs/index.md

@@ -194,6 +194,39 @@ Move to next horizontal tab
 {% raw%} {% escTab %} {% endraw %}
 ```
 
+* ## escHPos
+
+Set absolute horizontal print position  
+
+*reference **ESC $** command*
+
+```liquid
+{% raw%} {% escHPos pos %} {% endraw %}
+```
+
+#### Parameters
+
+| name | range | required | default |
+|------|------------|----------|---------|
+| pos | 0 <= pos <= 65535 | Y | 0 |
+
+### Description
+
+This command sets the absolute horizontal print position (in dots) for the next data that will be printed. It tells the printer exactly how many dots from the left margin to move the print head.
+
+### Units
+
+The measurement is in dots. For example, if the printer is configured such that 1 dot equals 1/60 inch, then setting **pos** to 360 would move the print head to approximately 360 dots, which could correspond to about 60 characters (if one character is roughly 6 dots wide).
+
+### Example
+
+Suppose you want to set the horizontal position to 360 dots
+
+#### Usage in Template
+
+{% raw %}{% escHPos 360 %}{% endraw %}
+
+This will move the print head so that the next printed data starts at 360 dots from the left margin.
 
 ## Images, barcodes and QR codes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "btrz-liquid-templates",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Extension and helpers for liquid templates to deal with our data and other things we need to encapsulate",
   "main": "src/index.js",
   "scripts": {
@@ -27,7 +27,7 @@
     "liquidjs": "^10.20.2",
     "moment": "^2.30.1",
     "moment-timezone": "^0.5.46",
-    "symbology": "^4.0.1",
+    "symbology": "4.0.1",
     "written-number": "^0.11.1"
   },
   "devDependencies": {

package/src/escp.js

@@ -117,6 +117,29 @@ function escTab(engine) {
     }
   });
 }
+
+function escHPos(engine) {
+  this.registerTag("escHPos", {
+    parse: function(tagToken, remainTokens) {
+      try {
+        const args = (tagToken.args || "").split(" ");
+        this.position = args[0] || 0;
+      } catch (err) {
+        this.position = args[0] || 0;
+      }
+    },
+    render: async function(ctx) {
+      try {
+        const nL = String.fromCharCode(this.position & 0xFF);
+        const nH = String.fromCharCode((this.position >> 8) & 0xFF);
+        const escMoveCursor = "\x1B\x24" + nL + nH;
+        return escMoveCursor;
+      } catch (e) {
+        return "PNA";
+      }
+    }
+  });
+}
 module.exports = {
   escInitQzTray,
   lineSpacing,
@@ -128,5 +151,6 @@ module.exports = {
   escCut,
   escEject,
   escCondensed,
-  escTab
+  escTab,
+  escHPos
 }

package/src/index.js

@@ -23,7 +23,9 @@ const {
   escCondensed,
   escNewLine,
   escCut,
-  escEject
+  escTab,
+  escEject,
+  escHPos
 } = require("./escp.js");
 
 function getEngine() {
@@ -102,6 +104,8 @@ module.exports = {
     engine.plugin(escCondensed);
     engine.plugin(escNewLine);
     engine.plugin(escCut);
+    engine.plugin(escTab);
+    engine.plugin(escHPos);
     engine.plugin(escEject);
     let str = await engine.parseAndRender(liquidTemplate, data);
     str = str.split(/\n/).map((line) => {