Multiple Barcodes

Functions for drawing multiple barcodes which are necessary if a large amount of information should be encoded. More...

Functions
BOOL	BCGet_MultiBC_Enabled (t_BarCode *pBarCode)
	Returns TRUE if drawing of multiple barcodes is enabled.
ERRCODE	BCSet_MultiBC_Enabled (t_BarCode *pBarCode, BOOL bOn)
	Enables/disables drawing of multiple barcodes for large data sets.
LONG	BCGet_MultiBC_Rows (t_BarCode *pBarCode)
	Returns number of rows for Multiple Barcodes mode.
ERRCODE	BCSet_MultiBC_Rows (t_BarCode *pBarCode, INT nNumRows)
	Sets the number of rows that should be drawn in Multiple Barcodes mode.
LONG	BCGet_MultiBC_Columns (t_BarCode *pBarCode)
	Returns number of columns for Multiple Barcodes mode.
ERRCODE	BCSet_MultiBC_Columns (t_BarCode *pBarCode, INT nNumCols)
	Sets the number of columns that should be drawn in Multiple Barcodes mode.
LONG	BCGet_MultiBC_HDist (t_BarCode *pBarCode)
	Returns the minimum horizontal distance between multiple barcodes.
ERRCODE	BCSet_MultiBC_HDist (t_BarCode *pBarCode, LONG nDistance)
	Sets the minimum horizontal distance between multiple barcodes in 1/1000 mm.
LONG	BCGet_MultiBC_VDist (t_BarCode *pBarCode)
	Returns the minimum vertical distance between multiple barcodes in 1/1000 mm.
ERRCODE	BCSet_MultiBC_VDist (t_BarCode *pBarCode, LONG nDistance)
	Sets the minimum vertical distance between multiple barcodes in 1/1000 mm.
LONG	BCGet_MultiBC_DataLimit (t_BarCode *pBarCode)
	Returns the max number of bytes per barcode.
ERRCODE	BCSet_MultiBC_DataLimit (t_BarCode *pBarCode, LONG nLimit)
	Sets the max number of bytes per barcode.
e_StructuredAppendMode	BCGet_MultiBC_StructApp (t_BarCode *pBarCode)
	Returns the structured append mode.
ERRCODE	BCSet_MultiBC_StructApp (t_BarCode *pBarCode, e_StructuredAppendMode eSAM)
	Sets the structured append mode.
e_DynamicBoundingRect	BCGet_MultiBC_DynamicBoundingRect (t_BarCode *pBarCode)
	Gets bounding rectangle mode.
ERRCODE	BCSet_MultiBC_DynamicBoundingRect (t_BarCode *pBarCode, e_DynamicBoundingRect eBoundingRect)
	Sets bounding rectangle mode.
ERRCODE	BC_MultiBC_CalculateLayout (t_BarCode *pBarCode, HDC hDC, LPCRECT pRect, INT *pnRequiredWidth, INT *pnRequiredHeight)
	Calculates the layout for multiple barcodes.

---

Detailed Description

Functions for drawing multiple barcodes which are necessary if a large amount of information should be encoded.

Multiple Barcodes Mode

If Multiple Barcodes mode is enabled, multiple barcodes are generated automatically if the given data is too much for one barcode.
Additionally multiple barcodes are generated automatically if the provided space (bounding rectangle is too small for a single large barcode. In this case TBarCode will try to encode the data into several smaller barcodes which fit into the given area.

Supported barcodes

Normally, linear barcodes are inadequate to support large amounts of data. Multiple Barcodes mode should only be used with following 2D barcodes: Data Matrix, PDF417, PDF417 Truncated, MicroPDF or QR Code.

Supported API functions

Some API functions are not supported when drawing multiple barcodes. Following functions should NOT be used if Multiple Barcodes mode is used:

• Barcode Data: BCCheck()
  
• Barcode Appearance: BCSetMirror(), BCSetRotation()
  
• Check-Digits: BCCalcCD(), BCGetCheckDigits()
  
• Size Queries: Size query functions are not supported for Multiple Barcode mode.
  
• Module Width and Barcode Quality: BCGetQuality()
  
• Customized Drawing (Callbacks): Customized Drawing (Callback) functions are not supported for Multiple Barcode mode.
• 2D Barcodes: Structured Append and Macro PDF417 functions (for example BCSet_DM_Append()) should not be used. When drawing multiple barcodes, Structured Append can be controlled with BCSet_MultiBC_StructApp().
  
• 2D Barcodes - PDF417:: BCGet_PDF417_CodeWords()
  
• Error handling: BCGetInvalidDataPos()