GdPicture.NET.14.API
GdPicture14 Namespace / GdPictureImaging Class / BarcodePDF417GetSize Method
The data of the barcode to encode.
A member of the BarcodePDF417EncodingMode enumeration. The encoding mode.
A member of the BarcodePDF417ErrorCorrectionLevel enumeration. The error correction level.
Specifies the number of rows constituting the barcode. Use 0 for automatic computation (recommended) or a value in the range [3 - 90].
Specifies the number of columns constituting the barcode. Use 0 for automatic computation (recommended) or a value in the range [3 - 30].
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.
The width of each module, in pixels. A value superior or equal to 4 is recommended.
The height of each row, in pixels. A value superior or equal to 10 is recommended.
Output parameter. The width, in pixels, required to render the PDF417 barcode.
Output parameter. The height, in pixels, required to render the PDF417 barcode.
Example





In This Topic
BarcodePDF417GetSize Method (GdPictureImaging)
In This Topic
Returns the size, in pixels, required to render a PDF417 barcode on a Bitmap.
Syntax
'Declaration
 
Public Function BarcodePDF417GetSize( _
   ByVal Data As String, _
   ByVal EncodingMode As BarcodePDF417EncodingMode, _
   ByRef ErrorCorrectionLevel As BarcodePDF417ErrorCorrectionLevel, _
   ByRef Rows As Integer, _
   ByRef Cols As Integer, _
   ByVal QuietZone As Integer, _
   ByVal ModuleWidth As Integer, _
   ByVal RowHeight As Integer, _
   ByRef Width As Integer, _
   ByRef Height As Integer _
) As GdPictureStatus
public GdPictureStatus BarcodePDF417GetSize( 
   string Data,
   BarcodePDF417EncodingMode EncodingMode,
   ref BarcodePDF417ErrorCorrectionLevel ErrorCorrectionLevel,
   ref int Rows,
   ref int Cols,
   int QuietZone,
   int ModuleWidth,
   int RowHeight,
   out int Width,
   out int Height
)
public function BarcodePDF417GetSize( 
    Data: String;
    EncodingMode: BarcodePDF417EncodingMode;
   var  ErrorCorrectionLevel: BarcodePDF417ErrorCorrectionLevel;
   var  Rows: Integer;
   var  Cols: Integer;
    QuietZone: Integer;
    ModuleWidth: Integer;
    RowHeight: Integer;
   Out  Width: Integer;
   Out  Height: Integer
): GdPictureStatus; 
public function BarcodePDF417GetSize( 
   Data : String,
   EncodingMode : BarcodePDF417EncodingMode,
   ErrorCorrectionLevel : BarcodePDF417ErrorCorrectionLevel,
   Rows : int,
   Cols : int,
   QuietZone : int,
   ModuleWidth : int,
   RowHeight : int,
   Width : int,
   Height : int
) : GdPictureStatus;
public: GdPictureStatus BarcodePDF417GetSize( 
   string* Data,
   BarcodePDF417EncodingMode EncodingMode,
   ref BarcodePDF417ErrorCorrectionLevel ErrorCorrectionLevel,
   ref int Rows,
   ref int Cols,
   int QuietZone,
   int ModuleWidth,
   int RowHeight,
   [PARAMFLAG::Out] int Width,
   [PARAMFLAG::Out] int Height
) 
public:
GdPictureStatus BarcodePDF417GetSize( 
   String^ Data,
   BarcodePDF417EncodingMode EncodingMode,
   BarcodePDF417ErrorCorrectionLevel% ErrorCorrectionLevel,
   int% Rows,
   int% Cols,
   int QuietZone,
   int ModuleWidth,
   int RowHeight,
   [Out] int Width,
   [Out] int Height
) 

Parameters

Data
The data of the barcode to encode.
EncodingMode
A member of the BarcodePDF417EncodingMode enumeration. The encoding mode.
ErrorCorrectionLevel
A member of the BarcodePDF417ErrorCorrectionLevel enumeration. The error correction level.
Rows
Specifies the number of rows constituting the barcode. Use 0 for automatic computation (recommended) or a value in the range [3 - 90].
Cols
Specifies the number of columns constituting the barcode. Use 0 for automatic computation (recommended) or a value in the range [3 - 30].
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.
ModuleWidth
The width of each module, in pixels. A value superior or equal to 4 is recommended.
RowHeight
The height of each row, in pixels. A value superior or equal to 10 is recommended.
Width
Output parameter. The width, in pixels, required to render the PDF417 barcode.
Height
Output parameter. The height, in pixels, required to render the PDF417 barcode.

Return Value

A member of the GdPictureStatus enumeration.
Example
Rendering a PDF417 barcode into a new image and saving the result into a png file.
using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    // String that have to be encoded into a barcode.
    string data = "PDF417 Barcode";
 
    BarcodePDF417EncodingMode encodingMode = BarcodePDF417EncodingMode.BarcodePDF417EncodingModeUndefined;
    // Level 0 to 8 are allowed, the number of error correction codewords is 2^(n+1).
    BarcodePDF417ErrorCorrectionLevel errorCorrectionLevel = BarcodePDF417ErrorCorrectionLevel.BarcodePDF417ErrorCorrectionLevelAuto;
    int moduleSize = 5;
    int fillColor = gdpictureImaging.ARGBI(255, 0, 0, 0);
    int backColor = gdpictureImaging.ARGBI(0, 255, 255, 255);
    int rows = 0, columns = 0; // Let the encoder choose the best ratio.
    int quietZone = 3; // 3 modules wide
 
    // Compute size (in pixels), required to render a PDF417 barcode.
    gdpictureImaging.BarcodePDF417GetSize(data, encodingMode, ref errorCorrectionLevel, ref rows, ref columns, quietZone, moduleSize, 17 * moduleSize, out int width, out int height);
 
    int imageID = gdpictureImaging.CreateNewGdPictureImage(width, height, 32, Color.White);
    gdpictureImaging.BarcodePDF417Write(imageID, data, encodingMode, errorCorrectionLevel, rows, columns, quietZone, moduleSize, 17 * moduleSize, 0, 0, 0, fillColor, backColor);
    gdpictureImaging.SaveAsPNG(imageID, "PDF417.png");
 
    // Release used resources.
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}
See Also