BarcodeDataMatrixGetSize Method (GdPictureImaging)
In This Topic
Returns the size, in pixels, required to render a DataMatrix barcode on a Bitmap.
Syntax
'Declaration
Public Function BarcodeDataMatrixGetSize( _
ByVal As String, _
ByVal As BarcodeDataMatrixEncodingMode, _
ByRef As BarcodeDataMatrixVersion, _
ByVal As Integer, _
ByVal As Integer, _
ByRef As Integer, _
ByRef As Integer _
) As GdPictureStatus
public GdPictureStatus BarcodeDataMatrixGetSize(
string ,
BarcodeDataMatrixEncodingMode ,
ref BarcodeDataMatrixVersion ,
int ,
int ,
out int ,
out int
)
public function BarcodeDataMatrixGetSize(
: String;
: BarcodeDataMatrixEncodingMode;
var : BarcodeDataMatrixVersion;
: Integer;
: Integer;
Out : Integer;
Out : Integer
): GdPictureStatus;
public function BarcodeDataMatrixGetSize(
: String,
: BarcodeDataMatrixEncodingMode,
: BarcodeDataMatrixVersion,
: int,
: int,
: int,
: int
) : GdPictureStatus;
public: GdPictureStatus BarcodeDataMatrixGetSize(
string* ,
BarcodeDataMatrixEncodingMode ,
ref BarcodeDataMatrixVersion ,
int ,
int ,
[PARAMFLAG::Out] int ,
[PARAMFLAG::Out] int
)
public:
GdPictureStatus BarcodeDataMatrixGetSize(
String^ ,
BarcodeDataMatrixEncodingMode ,
BarcodeDataMatrixVersion% ,
int ,
int ,
[Out] int ,
[Out] int
)
Parameters
- 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.
- Width
- Output parameter. The width, in pixels, required to render the DataMatrix barcode.
- Height
- Output parameter. The height, in pixels, required to render the DataMatrix barcode.
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);
}
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);
}
See Also
Reference
GdPictureImaging Class
GdPictureImaging Members
BarcodeDataMatrixWrite(Int32,String,BarcodeDataMatrixEncodingMode,BarcodeDataMatrixVersion,Int32,Int32,Int32,Int32,Single,Color,Color) Method