BarcodeDataMatrixWrite(Int32,String,BarcodeDataMatrixEncodingMode,BarcodeDataMatrixVersion,Int32,Int32,Int32,Int32,Single,Int32,Int32) Method

In This Topic

Draws a DataMatrix barcode on a GdPicture image.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Function BarcodeDataMatrixWrite( _
   ByVal ImageID As Integer, _
   ByVal Data As String, _
   ByVal EncodingMode As BarcodeDataMatrixEncodingMode, _
   ByRef Version As BarcodeDataMatrixVersion, _
   ByVal QuietZone As Integer, _
   ByVal ModuleSize As Integer, _
   ByVal DstLeft As Integer, _
   ByVal DstTop As Integer, _
   ByVal Angle As Single, _
   ByVal FillColor As Integer, _
   ByVal BackColor As Integer _
) As GdPictureStatus

public GdPictureStatus BarcodeDataMatrixWrite( 
   int ImageID,
   string Data,
   BarcodeDataMatrixEncodingMode EncodingMode,
   ref BarcodeDataMatrixVersion Version,
   int QuietZone,
   int ModuleSize,
   int DstLeft,
   int DstTop,
   float Angle,
   int FillColor,
   int BackColor
)

public function BarcodeDataMatrixWrite( 
    ImageID: Integer;
    Data: String;
    EncodingMode: BarcodeDataMatrixEncodingMode;
   var  Version: BarcodeDataMatrixVersion;
    QuietZone: Integer;
    ModuleSize: Integer;
    DstLeft: Integer;
    DstTop: Integer;
    Angle: Single;
    FillColor: Integer;
    BackColor: Integer
): GdPictureStatus;

public function BarcodeDataMatrixWrite( 
   ImageID : int,
   Data : String,
   EncodingMode : BarcodeDataMatrixEncodingMode,
   Version : BarcodeDataMatrixVersion,
   QuietZone : int,
   ModuleSize : int,
   DstLeft : int,
   DstTop : int,
   Angle : float,
   FillColor : int,
   BackColor : int
) : GdPictureStatus;

public: GdPictureStatus BarcodeDataMatrixWrite( 
   int ImageID,
   string* Data,
   BarcodeDataMatrixEncodingMode EncodingMode,
   ref BarcodeDataMatrixVersion Version,
   int QuietZone,
   int ModuleSize,
   int DstLeft,
   int DstTop,
   float Angle,
   int FillColor,
   int BackColor
)

public:
GdPictureStatus BarcodeDataMatrixWrite( 
   int ImageID,
   String^ Data,
   BarcodeDataMatrixEncodingMode EncodingMode,
   BarcodeDataMatrixVersion% Version,
   int QuietZone,
   int ModuleSize,
   int DstLeft,
   int DstTop,
   float Angle,
   int FillColor,
   int BackColor
)

Parameters

ImageID: GdPicture image identifier.
Data: The data of the barcode to encode.
EncodingMode: A member of the BarcodeDataMatrixEncodingMode enumeration. The encoding mode.
Version: A member of the BarcodeDataMatrixVersion enumeration. The version of the DataMatrix barcode. Use BarcodeDataMatrixVersionAuto to let the engine decide the minimum version required to encode all data.
QuietZone: The number of modules composing the quiet zone. The quiet zone defines the margin around the barcode. A value superior or equal to 4 is highly suggested.
ModuleSize: The size of each module, in pixels. A value superior or equal to 4 is recommended.
DstLeft: The left position, in pixels, of the DataMatrix barcode.
DstTop: The top position, in pixels, of the DataMatrix barcode.
Angle: The DataMatrix barcode angle.
FillColor: Color of the symbols. A suitable color value can be obtained by using the ARGBI() method.
BackColor: Color of the background. A suitable color value can be obtained by using the ARGBI() method.

Return Value

A member of the GdPictureStatus enumeration.

Example

Rendering a DataMatrix barcode into a new image and saving the result into a png file.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    // String with numbers, which have to be encoded into a barcode.
    string data = "123456";
 
    BarcodeDataMatrixEncodingMode encodingMode = BarcodeDataMatrixEncodingMode.BarcodeDataMatrixEncodingModeUndefined;
    BarcodeDataMatrixVersion dmVersion = BarcodeDataMatrixVersion.BarcodeDataMatrixVersionAuto;
    int moduleSize = 8;
    int fillColor = gdpictureImaging.ARGBI(255, 0, 0, 0);
    int backColor = gdpictureImaging.ARGBI(0, 255, 255, 255);
 
    // Compute size (in pixels), required to render the DataMatrix barcode.
    gdpictureImaging.BarcodeDataMatrixGetSize(data, encodingMode, ref dmVersion, 4, moduleSize, out int width, out int height);
 
    int imageID = gdpictureImaging.CreateNewGdPictureImage(width, height, 32, Color.White);
    gdpictureImaging.BarcodeDataMatrixWrite(imageID, data, encodingMode, ref dmVersion, 4, moduleSize, 0, 0, 0, fillColor, backColor);
    gdpictureImaging.SaveAsPNG(imageID, "output.png");
 
    // Release used resources.
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
BarcodeDataMatrixGetSize Method
ARGBI Method