feat(rotation): implements rotations #31

docs/docs/options.md

@@ -21,7 +21,8 @@ The following symbology options are available:
 | `showHumanReadableText` | `Boolean`  | Show or hide the symbology data as human-readable text (if applicable).                          | No        | `true`        |
 | `encoding`              | `Encoding` | [The enumerated encoding type of input data.](encoding.md#encoding-modes)                        | No        | `DATA_MODE`   |
 | `eci`                   | `Number`   | [ECI encoding mode.](encoding.md#extended-channel-interpolation-eci)                             | No        | `0`           |
-| `primary`               | `String`   | Primary message data for more complex symbols.                                                   | No        | `null`        |
+| `primary`               | `String`   | Primary message data for more complex symbols.                                                   | No        | `null`        |v
+| `rotation`              | `Number`   | Clockwise rotation of the barcode. Valid values are `0`, `90`, `180`, or `270`.                  | No        | `0`           |
 | `text`                  | `String`   | Human-readable text to display. Defaults to the input data value.                                | No        | (Data value)  |
 
 \* required only if using [`createFile()`](api.md#createfile).

src/binding/main.cpp

@@ -39,13 +39,13 @@ namespace symbology {
   /**
    * Renders symbology and returns an object with PNG bitmap data, EPS, or SVG XML.
    */
-  Local<Object> createStreamHandle(Isolate* isolate, zint_symbol *symbol, uint8_t *data, char *str) {
+  Local<Object> createStreamHandle(Isolate* isolate, zint_symbol *symbol, uint8_t *data, char *str, int rotate_angle) {
     int status_code;
 
     if ((symbol->output_options & BARCODE_STDOUT) != 0) {
-      status_code = ZBarcode_Encode_and_Print(symbol, data, 0, 0);
+      status_code = ZBarcode_Encode_and_Print(symbol, data, 0, rotate_angle);
     } else {
-      status_code = ZBarcode_Encode_and_Buffer(symbol, data, 0, 0);
+      status_code = ZBarcode_Encode_and_Buffer(symbol, data, 0, rotate_angle);
     }
 
     v8::Local<v8::Object> obj = Object::New(isolate);
@@ -165,9 +165,13 @@ namespace symbology {
 
     struct zint_symbol *symbol = getSymbolFromArgs(context, args);
 
+    // parse `rotation` angle argument
+    int rotate_angle;
+    rotate_angle = (int)args[18]->NumberValue(context).FromJust();
+
     Nan::Utf8String data(args[0]);
 
-    obj = createStreamHandle(isolate, symbol, (unsigned char*)*data, (char*)*data);
+    obj = createStreamHandle(isolate, symbol, (unsigned char*)*data, (char*)*data, rotate_angle);
 
     ZBarcode_Delete(symbol);
     args.GetReturnValue().Set(obj);

src/index.js

@@ -34,7 +34,8 @@ const defaultConfig = {
   showHumanReadableText: true,
   encoding: exp.Encoding.DATA_MODE,
   eci: 0,
-  primary: ''
+  primary: '',
+  rotation: 0
 }
 
 /**

src/lib/__tests__/binary.test.js

@@ -36,7 +36,8 @@ describe('Binary methods', () => {
         encoding: Encoding.DATA_MODE,
         eci: 0,
         primary: '',
-        text: 'example text'
+        text: 'example text',
+        rotation: 0
       }
       const barcodeData = 'primary data'
 
@@ -60,7 +61,8 @@ describe('Binary methods', () => {
         'example text',
         symbol.encoding,
         symbol.eci,
-        symbol.primary
+        symbol.primary,
+        symbol.rotation
       )
     })
 
@@ -86,7 +88,8 @@ describe('Binary methods', () => {
         encoding: Encoding.DATA_MODE,
         eci: 0,
         primary: '',
-        text: ''
+        text: '',
+        rotation: 0
       }
       const barcodeData = 'primary data'
 
@@ -110,7 +113,8 @@ describe('Binary methods', () => {
         barcodeData,
         symbol.encoding,
         symbol.eci,
-        symbol.primary
+        symbol.primary,
+        0
       )
     })
   })

src/lib/binary.js

@@ -34,7 +34,8 @@ function createBuffer (symbol, barcodeData) {
     (symbol.text || barcodeData),
     symbol.encoding,
     symbol.eci,
-    symbol.primary
+    symbol.primary,
+    symbol.rotation
   )
 }
 

test/e2e/transformations.test.js

@@ -0,0 +1,32 @@
+const symbology = require('../../src')
+
+describe('Symbology Transformations', () => {
+  describe('rotations', () => {
+    it('should rotate the symbol 90 degrees clockwise', async () => {
+      const image = await createImageFile({
+        symbology: symbology.Barcode.CODE128,
+        rotation: 90
+      }, 'png', '12345')
+
+      expect(image).toMatchImageSnapshot()
+    })
+
+    it('should rotate the symbol 180 degrees clockwise', async () => {
+      const image = await createImageFile({
+        symbology: symbology.Barcode.CODE128,
+        rotation: 180
+      }, 'png', '12345')
+
+      expect(image).toMatchImageSnapshot()
+    })
+
+    it('should rotate the symbol 270 degrees clockwise', async () => {
+      const image = await createImageFile({
+        symbology: symbology.Barcode.CODE128,
+        rotation: 270
+      }, 'png', '12345')
+
+      expect(image).toMatchImageSnapshot()
+    })
+  })
+})