Manual - DataMatrix

Introduction

Datamatrix code comes from the 2D barcode family. You can encode a large amount of information within a single barcode.
All the ASCII characters from 0 to 255 are supported. The barcode size will be determined by the amount of data to be encoded. The error correction level is automatically chosen.
You can enter into ECI mode with the function setAcceptECI().

This class inherits the BCGBarcode2D class.

Example

Methods

BCGdatamatrix's Methods

BCGBarcode2D's Methods

BCGBarcode's Methods

Code Example

'use strict';

import { createServer } from 'http';
import { BCGColor, BCGDrawing, createSurface, toBuffer } from '@barcode-bakery/barcode-nodejs';
import { BCGdatamatrix } from '@barcode-bakery/barcode-nodejs/datamatrix';

http.createServer(function (request, response) {
    const colorBlack = new BCGColor(0, 0, 0);
    const colorWhite = new BCGColor(255, 255, 255);

    // Barcode Part
    const code = new BCGdatamatrix();
    code.setScale(2); // Resolution
    code.setForegroundColor(colorBlack); // Color of bars
    code.setBackgroundColor(colorWhite); // Color of spaces
    code.parse('Datamatrix');

    // Drawing Part
    const drawing = new BCGDrawing(createSurface);
    toBuffer(drawing, BCGDrawing.ImageFormat.Png, function (err, buffer) {
        response.writeHead(200, { "Content-Type": "image/png" });
        response.end(buffer);
    });
}).listen(8124);

Method explanations

  • getSize() — Gets the size of the barcode
    Description
    Gets the size mode of the final barcode.
    See setSize() for more details.
    Returns
    int - constant value defined in setSize()
  • setSize(value) — Sets the size of the barcode
    Description
    The size of the final barcode will be decided automatically depending on the data you give.
    You can, however, specify different values to this method to get a different code. There are the possible values:
    - BCGdatamatrix.Size.Smallest : The code will be the smallest possible
    - BCGdatamatrix.Size.Square : The code will be a square
    - BCGdatamatrix.Size.Rectangle : The code will be a rectangle
    The default value is BCGdatamatrix.Size.Square.
  • getDatamatrixSize() — Gets the size to use for the barcode
    Description
    Gets the Datamatrix size.
    Returns
    int[]
  • setDatamatrixSize(row, col) — Specifies the size to use for the barcode
    Description
    Barcode Bakery will pick the smallest barcode size based on the information you provide.
    If you wish to have a specific size, you can force the size with this method.
    You must specify a valid size or this method will raise an exception.
    The default value is -1.
  • getQuietZone() — Gets if the quiet zone will be drawn
    Returns
    bool - true if activated, false otherwise
  • setQuietZone(quietZoneSize) — Specifies to draw a quiet zone around the barcode
    Description
    Gets if the quiet zone will be drawn.
  • getTilde() — Gets if the behavior for tilde ~ is modified
    Description
    Gets if the behavior for tilde ~ is modified.
    See setTilde() for more details.
    Returns
    bool - true if activated, false otherwise
  • setTilde(accept) — Modifies the use of the tilde character ~
    Description
    By setting true in this argument, the tilde characters (ASCII 126 ~) will be processed as special characters. These are the special characters you can write.
    - ~~ : Writes a simple tilde
    - ~F : Writes the FNC1 character
    The default value is false.
    Please note that it is possible to use ~F as the first character of your data, BUT it is possible that the automatic encoding changes the meaning of your barcode by not starting your data with a FNC1. So we recommend that you use the method setFNC1() and drop the first ~F from your data.
  • getAcceptECI() — Gets if ECI codes are accepted
    Description
    Gets if ECI codes are accepted.
    See setAcceptECI() for more details.
    Returns
    int - value in pixels
  • setAcceptECI(accept) — Specifies to accepts the ECI codes
    Description
    By setting true in this argument, the backslash characters (ASCII 92 \) will be processed as special characters. These are the special characters you can write.
    - \\ : Writes a simple backslash
    - \xxxxxx : Writes the ECI xxxxxx character with x representing an integer from 0 to 9
    The default value is false.
  • setStructuredAppend(snum, st, sid) — Specifies that data will be expanded between multiple barcodes
    Description
    Datamatrix code data can be separated throughout many different barcodes.
    The first argument is the barcode number (beginning with 1), the second argument is the total number of barcodes you have. The last argument specifies an identifier for your barcode group. This argument must be a number between 1 and 64516 and it must stay the same for each barcode in the group.
    It is possible to encode the data on a maximum of 16 different barcodes.
    Returns
    bool - true on success, false on failure
  • setFNC1(fnc1Type) — Transforms your barcode in GS1 or AIM standard
    Description
    This method will transform your barcode to accept FNC1 to be GS1 standard or AIM standard.
    BCGdatamatrix.Fnc1.None : The code will not follow any standards.
    BCGdatamatrix.Fnc1.Gs1 : The code will follow the GS1 standard. Separate GS1 identifiers by ~F. Don't forget to turn on setTilde().
    BCGdatamatrix.Fnc1.Aim : The code will follow the AIM standard.
    The default value is BCGdatamatrix.Fnc1.None.
    Please note that it is possible to use ~F as the first character of your data, BUT it is possible that the automatic encoding changes the meaning of your barcode by not starting your data with a FNC1. So we recommend that you use the method setFNC1() and drop the first ~F from your data.
  • getEncoding() — Gets the forced encoding
    Description
    Gets the forced encoding
    See setEncoding() for more details.
    Returns
    int - constant value defined in setEncoding()
  • setEncoding(encoding) — Sets a specific encoding
    Description
    You can force an encoding to be used for different reasons. Some readers are not able to read a specific encoding, so you can force the ASCII mode.
    Note that by forcing the encoding, you may not get an efficient result. Furthermore, some characters cannot be represented in some encodings.
    See the technical information page for more information about the encodings.
    - BCGdatamatrix.Encoding.Unknown : No specific encoding is selected
    - BCGdatamatrix.Encoding.Ascii : ASCII and extended ASCII (low compression)
    - BCGdatamatrix.Encoding.C40 : C40 encoding (capital letters)
    - BCGdatamatrix.Encoding.Text : TEXT encoding (lowercase letters)
    - BCGdatamatrix.Encoding.X12 : X12 encoding (capital letters and numbers)
    - BCGdatamatrix.Encoding.Edifact : Edifact encoding
    - BCGdatamatrix.Encoding.Base256 : Binary encoding
    The default value is BCGdatamatrix.Encoding.Unknown.
  • getMacro() — Gets if a macro is written
    Description
    Gets if a macro is written
    See setMacro() for more details.
    Returns
    int - constant defined in setMacro()
  • setMacro(macro) — Specifies to prepend and append values to your data
    Description
    The macro has been defined to make your data and barcode smaller in size. Use this method to prepend and append predefined data in your barcode when read.
    - BCGdatamatrix.Macro.None : Your data will appear raw. No prefix or suffix.
    - BCGdatamatrix.Macro._05 : Prefix: [)>RS05GS - Suffix: RSEoT
    - BCGdatamatrix.Macro._06 : Prefix: [)>RS06GS - Suffix: RSEoT
    The default value is BCGdatamatrix.Macro.None.
  • setScaleX(scaleX) — Sets the scaling X for the barcode
    Description
    The width in pixel of one module.
    The default value is 1.
    Note that this method is protected.
  • setScaleY(scaleY) — Sets the scaling Y for the barcode
    Description
    The height in pixel of one module.
    The default value is 1.
    Note that this method is protected.
  • parse(text) — Analyzes a text message to draw afterwards
    Description
    The data you pass to the text argument must be supported by the type of barcode you use.
    Check each barcode's introduction section to obtain more information on how to use this method within each symbology.
  • draw(image) — Draws the barcode on the image
    Description
    The value of the image argument must be an image resource. The size of the image can be defined by the value received from getDimension().
  • getDimension(width, height) — Returns an array containing the required size for the image
    Description
    Returns an array in which the first index is the image width and the second index is the image height.
    The arguments are used to specify the starting point of the drawing. Should be 0 for both.
    The BCGDrawing class uses this method to create the image resource.
    Returns
    array(int, int) - [0] is the width, [1] is the height
  • getScale() — Gets the scale of the barcode
    Description
    Gets the scale of the barcode. The value is the number of the "smallest" unit in pixel.
    Returns
    int - value in pixels
  • setScale(scale) — Sets the scale of the barcode
    Description
    The barcode will be x times bigger. Then a pixel will be x by x for its size.
  • getForegroundColor() — Gets the color of the bars
    Description
    Gets the color of the bars of the barcode.
    Returns
  • setForegroundColor(color) — Sets the color of the bars
    Description
    Sets the color of the bars of the barcode. By default, the color is black. This argument can be a BCGColor class or any other argument that BCGColor can accept in its constructor.
  • getBackgroundColor() — Gets the color of the spaces
    Description
    Gets the color of the spaces of the barcode.
    Returns
  • setBackgroundColor(color) — Sets the color of the spaces
    Description
    Sets the color of the spaces of the barcode. By default, the color is white. This argument can be a BCGColor class or any other argument that BCGColor can accept in its constructor.
  • setColor(foregroundColor, backgroundColor) — Sets the color of the bars and spaces
    Description
    An easy and fast method to set the color of the bars and spaces. Check the setForegroundColor() and setBackgroundColor().
  • getOffsetX() — Gets the X offset
    Description
    Gets the X offset of the barcode in pixels. The value isn't multiplied by the scale.
    Returns
    int - value in pixels
  • setOffsetX(value) — Sets the X offset
    Description
    Specifies the X offset of the barcode in pixels multiplied by the scale. The required size returned by getDimension() will be modified accordingly.
  • getOffsetY() — Gets the Y offset
    Description
    Gets the Y offset of the barcode in pixels. The value isn't multiplied by the scale.
    Returns
    int - value in pixels
  • setOffsetY(value) — Sets the Y offset
    Description
    Specifies the Y offset of the barcode in pixels multiplied by the scale. The required size returned by getDimension() will be modified accordingly.
  • addLabel(label) — Adds a label to the graphic
    Description
    Adds a BCGLabel object to the drawing.
  • removeLabel(label) — Removes a label from the graphic
    Description
    Removes a specific BCGLabel object from the drawing.
  • clearLabels() — Removes the labels from the graphic
    Description
    Clears the BCGLabel objects from the drawing.