Saves barcode to an image-file (extended version, Windows only).
Saves the content of the barcode object as image-file with respect to a specified device context (if not needed, hDC can be set to 0). The values of lXSize and lYSize should be increased, if the barcode is not readable or if the data density is high. The values of dXRes and dYRes can affect the printing size when printing from graphic- or painting programs.
The image quality sets the compression algorithm (depending on the image type):
- BMP 0 = no compression, nonzero = RLE8 compression
- PNG 0 = all filters, 2 = no filter, 4 = sub filter, 6 = up filter, 8 = avg filter, 10 = paeth filter; 1 (bit 0 set) = interlaced
- JPG 0 = lowest quality (maximum compression), 100 = highest quality
- TIF 0 = no compression, 1 = LZW, 2 = packbits, 3 = CCITT Group 3 1D, 4 = CCITT Group 4 2D
- EPS 0 = include PS drawing macros, 1 = exclude macros (value applied to buffer output only!)
A file extension according to selected image type is appended automatically if the file name does not already end with a safe file extension. Safe file extensions are ".ai", ".bmp", ".emf", ".eps", ".gif", ".jpg", ".jpeg", ".pcl", ".pcx", ".png", ".svg", ".tif", and ".tmp".
- Note:
- WINDOWS only
-
This function allows you to create colored bitmaps, taking into account the capabilities (color depth) of the current output device or graphics card.
- See also:
- BCSaveImage(), BCSaveImageToBuffer(), BCPostscriptToFile(), BCPCLToMemory(), BCGetEnhMetaFile()
- Parameters:
-
| [in] | pBarCode | Pointer to barcode structure. |
| [in] | hDC | Device context handle used for bitmap generation (default: NULL). To create colored bitmaps, use a screen DC. If NULL is passed as hDC, the created bitmap is always monochrome. |
| [in] | lpszFileName | Filename. |
| [in] | eImageType | Enumeration for the type of image. |
| [in] | lQuality | Image quality. The meaning depends on eImageType (-1 for default). |
| [in] | lXSize | X-Size of the image [pixel]. For vector formats (EPS, PCL, AI, SVG) the unit is [0.001 mms] |
| [in] | lYSize | Y-Size of the image [pixel]. For vector formats (EPS, PCL, AI, SVG) the unit is [0.001 mms] |
| [in] | dXRes | X-Resolution of the image [pixels / inch]. |
| [in] | dYRes | Y-Resolution of the image [pixels / inch}. |
- Return values:
-
| ERRCODE | ErrOk (0) in case of success. Non-zero if error occurred. |
