BARCODEWRITEDM

typedef struct _tagBARCODEWRITEDM
{
   L_UINT uStructSize;
   L_UINT32 ulFlags;
   L_CHAR cGroupNumber;
   L_CHAR cGroupTotal;
   L_UCHAR cFileIDLo;
   L_UCHAR cFileIDHi;
   L_INT nXModule;
} BARCODEWRITEDM,* pBARCODEWRITEDM;

The BARCODEWRITEDM structure contains information used to write ECC 200 Data Matrix.

Member	Description
uStructSize	Size of BARCODEWRITEDM structure in bytes. Use the sizeof() macro to calculate this value.
ulFlags	Flags that indicate how to configure the engine. You can combine values when appropriate, by using a bitwise OR ( \| ). Possible values are:
	Flags	Meaning
	BARCODE_JUSTIFY_RIGHT	[0x1000] Justify the Data Matrix symbol to the right side of the bitmap.
	BARCODE_JUSTIFY_H_CENTER	[0x2000] Justify the Data Matrix symbol in the horizontal center of the bitmap.
	BARCODE_JUSTIFY_BOTTOM	[0x4000] Justify the Data Matrix symbol to the bottom side of the bitmap.
	BARCODE_JUSTIFY_V_CENTER	[0x8000] Justify the Data Matrix symbol in the vertical center of the bitmap.
cGroupNumber	Specifies a group of Data Matrix symbols. The maximum number of symbols in a group is 16. Use this member to specify the order of each barcode in a group so that when you read each barcode's data, you can put the large piece of data back together in the correct order.
cGroupTotal	Specifies the total number of Data Matrix symbols in the group specified by the cGroupNumber member. The maximum number of symbols in a group is 16.
cFileIDLo	Specifies the low byte of the file ID number. The number must range from 1 to 254. Use this as an ID for the group since an image can have multiple groups.
cFileIDHi	Specifies the high byte of the file ID number. The number must range from 1 to 254. Use this as an ID for the group since an image can have multiple groups.
nXModule	The size of the written Data Matrix barcode, specified in 0.001 inch. If the value is too small, a minimum of 5 pixels will be used.

Comments

pBARCODEWRITEDM is a pointer to an BARCODEWRITEDM structure. When the function parameter type is pBARCODEWRITEDM, you can declare a BARCODEWRITEDM variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pBARCODEWRITEDM variable is necessary only if your program requires a pointer.

This structure is used by the L_BarCodeWrite function.

Use the cGroupNumber, CGroupTotal, CFileIDLo, cFileIDHi members whenever it is necessary to split up the information that needs to be encoded into different barcodes.

The following table contains information for writing ECC 200 Data Matrix barcodes:

Data Matrix type	Maximum Numeric Length	Maximum Alphanumeric Length	Maximum Binary Length	Maximum Correctable Error / Erasure
10 x 10	6	3	1	2
12 x 12	10	6	3	3
14 x 14	16	10	6	5/7
16 x 16	24	16	10	6/9
18 x 18	36	25	16	7/11
20 x 20	44	31	20	9/15
22 x 22	60	43	28	10/17
24 x 24	72	52	34	12/21
26 x 26	88	64	42	14/25
32 x 32	124	91	60	18/33
36 x 36	172	127	84	21/39
40 x 40	228	169	112	24/45
44 x 44	288	214	142	28/53
48 x 48	348	259	172	34/65
52 x 52	408	304	202	42/78
64 x 64	560	418	278	56/106
72 x 72	736	550	366	72/132
80 x 80	912	682	454	96/180
88 x 88	1152	862	574	112/212
96 x 96	1392	1042	694	136/260
104 x 104	1632	1222	814	168/318
120 x 120	2100	1573	1048	204/390
132 x 132	2608	1954	1302	248/472
144 x 144	3116	2335	1556	310/590
8 x 18	10	6	3	3
8 x 32	20	13	8	5
12 x 26	32	22	14	7/11
12 x 36	44	31	20	9/15
16 x 36	64	46	30	12/21
16 x 48	98	72	47	14/25