BCSet_DM_Append
ERRCODE BCSet_DM_Append(t_BarCode *pBarCode, LONG nSum, LONG nIndex, LONG nFileID)Activates Data Matrix "Structured Append" mode.
Data Matrix allows user data to be spread across several symbols. This might be done if the data is too large to fit into a single symbol or for reasons of appearance and geometry. The so called "Structured Append" mode encodes additional control information to enable the reading device to reconstruct the data of all symbols in the correct order. This function sets the total number of symbols and the index of the actual Data Matrix symbol within the symbol chain. Depending on this index, the data will be reconstructed by the scanner during the reading process. The scanner returns the data of all symbols in the correct order at once. Default: Standard Structured Append is used.
Note
All symbols within a symbol chain must be identified by a unique File-ID.
Parameters
| Parameter / type | Description |
|---|---|
[in] pBarCode |
Pointer to barcode structure. |
[in] nSum |
Number of symbols [2..16] (reset to default/disable = -1). |
[in] nIndex |
Index of symbol [1..16]. |
[in] nFileID |
File ID (must be the same in all symbols). |
Return values
| Name | Description |
|---|---|
ERRCODE |
ErrOk (0) in case of success. Non-zero if error occurred. |