Menu

PDF417 ASP.NET Web Control Methods


Barcodes.PDF417 Namespace

PDF417WebControl Class
Barcodes.PDF417Web.dll assembly
 
About Method
Returns an about information.

Syntax
string About()
Return Value
String that specifies an about information.



WriteToBinaryStream Method
This method is similar to SaveToImageFile, but instead of saving the image to a file it represents it as a byte array.

Syntax
ErrorCodes WriteToBinaryStream(System.IO.Stream stream, int width, int height, System.Drawing.Imaging.ImageFormat fmt)

Parameters

streamSpecifies an image stream.
widthAn integer that defines the barcode width.
heightAn integer that defines the barcode height.
fmt Specifies an image format.

Return Value

ErrorCodes



SaveToImageFile Method
Saves the image of the PDF417 barcode to a file.

Syntax
ErrorCodes SaveToImageFile(double cx, double cy, string sFileName, 
int lRes, Dimensions dm)
Parameters
cxA double that defines the barcode picture width.
cyA double that defines the barcode picture height.
sFileNameA string expression defining the file name.
lResA integer value that sets the picture resolution.
dmThe Dimensions value. This value defines the units that should be used to specify cx and cy. See remarks.
Return Value
ErrorCodes
Remarks
The format the file will be saved in depends on the extension of the file name For example, if you specify sFileName as "img1.jpg", the barcode will be saved as JPEG.
The following extensions can be used - "wmf", "emf", "bmp", "jpg", "jpeg", "gif", "tiff" and "png".

If the size of an image (cx, cy) is not specified in pixels, its actual size will be calculated using the specified picture resolution - lRes.
Examples
/* 1.
Save the image to a file of the JPEG format. The size of the image will be 300x100 pixels.*/

pdf417Control1.SaveToImageFile( 300, 100, "c:\\PDF417.jpg", 0, Barcodes.PDF417.Dimensions.dmPixels );

/* 2.
Save the image to a file of the JPEG format. The size of the image will be 50x25 millimeters with the resolution of 300 dpi.*/

pdf417Control1.SaveToImageFile( 50, 25, "c:\\PDF417.jpg", 300, Barcodes.PDF417.Dimensions.dmMM ) ;

/* 3.
Calculate the required PDF417 size. See GetPDF417Size method.*/

double w, h;
pdf417Control1.GetPDF417Size( 4, 96, 96, Barcodes.PDF417.Dimensions.dmPixels, Barcodes.PDF417.Dimensions.dmPixels, out w, out h );
// Save the PDF417 image to a file of the JPEG format. The barcode will have the x-dimension of 4 pixels.
pdf417Control1.SaveToImageFile( w, h, "c:\\PDF417.jpg", 96, Barcodes.PDF417.Dimensions.dmPixels ) ;



DrawPDF417ToSize Method
Draws the PDF417 bar code in the device context or Graphics object. You can use either printer or screen.

Syntax
ErrorCodes DrawPDF417ToSize(double x, double y, double cx, double cy, Dimensions dm, IntPtr hDC)

ErrorCodes DrawPDF417ToSize(double x, double y, double cx, double cy, Dimensions dm, Graphics gr)

Parameters

XA double value that defines the X coordinate of the barcode.
YA double value that defines the Y coordinate of the barcode.
CXA double that defines the PDF417 width.
CYA double that defines the PDF417 height.
dmA Dimensions value. This value defines the units that should be used to specify cx and cy.
hDCThe handle of the device context where the barcode will be drawn.
gr A Graphics object.

Return Value

ErrorCodes



GetPDF417Size Method
This method calculate the width and height that the PDF417 must have in order to get the necessary x-dimension.

Syntax
ErrorCodes GetPDF417Size(double lModule, int xRes, int yRes, Dimensions dmIn, Dimensions dmOut, out double width, out double height)

Parameters

lModuleThis double value that defines the necessary x-dimension.
xResA long value that defines the resolution (in dpi) along x axis.
yResA long value that defines the resolution (in dpi) along y axis.
dmInA Dimensions value. This value defines the units that should be used to specify lModule.
dmOutA Dimensions value. This value defines the units that should be used to specify the width.
widthReturns the necessary PDF417 width.
heightReturns the necessary PDF417 height.

Return Value

ErrorCodes
Example
double wMM, hMM;
pdf417Control1.GetPDF417Size( 0.5, (int)ev.Graphics.DpiX, (int)ev.Graphics.DpiY, Dimensions.dmMM, Dimensions.dmMM, out wMM, out hMM );