BARCODEWRITEAZTEC

Summary

The BARCODEWRITEAZTEC structure contains information for writing Aztec symbols.

Syntax

typedef struct _tagBARCODEWRITEAZTEC 
{ 
   L_UINT uStructSize; 
   L_UINT32 ulFlags; 
   L_INT nXModule; 
   L_INT SymbolSize; 
   L_INT ErrorCorrectionRate; 
   L_INT QuietZone; 
   L_BOOL AztecRune; 
   L_INT AztecRuneValue; 
} BARCODEWRITEAZTEC, * pBARCODEWRITEAZTEC; 

Members

uStructSize

Size of this structure in bytes. Use the sizeof() operator to calculate this value.

ulFlags

Reserved for future use.

nXModule

Specifies the module size of the printed AZTEC barcode, in 0.001 inches. The module size = (the value of nXModule) X (the number of Modules in each row). The module is a "cell" that is used to make the symbol's grid. In the middle of the symbol is a set of concentric squares (used to orient the symbol), at the center of which is a single, black "module".

SymbolSize

Specifies which symbol size to use when writing an Aztec barcode. The following values are possible:

BARCODE_AZTEC_CODE        
BARCODE_AZTEC_CODE_Compact1
BARCODE_AZTEC_CODE_Compact2
BARCODE_AZTEC_CODE_Compact3
BARCODE_AZTEC_CODE_Compact4
BARCODE_AZTEC_CODE_Full1  
BARCODE_AZTEC_CODE_Full2  
BARCODE_AZTEC_CODE_Full3  
BARCODE_AZTEC_CODE_Full4  
BARCODE_AZTEC_CODE_Full5  
BARCODE_AZTEC_CODE_Full6  
BARCODE_AZTEC_CODE_Full7  
BARCODE_AZTEC_CODE_Full8  
BARCODE_AZTEC_CODE_Full9  
BARCODE_AZTEC_CODE_Full10 
BARCODE_AZTEC_CODE_Full11 
BARCODE_AZTEC_CODE_Full12 
BARCODE_AZTEC_CODE_Full13 
BARCODE_AZTEC_CODE_Full14 
BARCODE_AZTEC_CODE_Full15 
BARCODE_AZTEC_CODE_Full16 
BARCODE_AZTEC_CODE_Full17 
BARCODE_AZTEC_CODE_Full18 
BARCODE_AZTEC_CODE_Full19 
BARCODE_AZTEC_CODE_Full20 
BARCODE_AZTEC_CODE_Full21 
BARCODE_AZTEC_CODE_Full22 
BARCODE_AZTEC_CODE_Full23 
BARCODE_AZTEC_CODE_Full24 
BARCODE_AZTEC_CODE_Full25 
BARCODE_AZTEC_CODE_Full26 
BARCODE_AZTEC_CODE_Full27 
BARCODE_AZTEC_CODE_Full28 
BARCODE_AZTEC_CODE_Full29 
BARCODE_AZTEC_CODE_Full30 
BARCODE_AZTEC_CODE_Full31 
BARCODE_AZTEC_CODE_Full32 

The default value is BARCODE_AZTEC_CODE, which allows the function to choose the smallest value that can contain the complete input message.

ErrorCorrectionRate

Specifies the error detection and correction rate (Reed-Solomon error encoding) when writing an Aztec barcode, in percent. Possible values range from 5% to 95%. The specification suggests that 23% be used. The ErrorCorrectionRate is the percentage of error correction codewords out of all codewords. The default value is 23%.

QuietZone

(Optional) Specifies the quiet zone value when writing an Aztec barcode. The default value is 0.

AztecRune

Specifies whether to write an Aztec Rune barcode.

AztecRuneValue

Specifies the value to be encoded when writing an Aztec Rune barcode. Possible values range from 0 to 255.

Comments

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

The smallest symbol size is 15 x 15 pixels. Sizes increase by increments of 4.

The AZTEC standard specifies 37 different sizes of the Aztec code (see the values for SymbolSize). The maximum data capacity varies, depending on the size and Error Correction level.

LEADTOOLS supports the ECI 000003 encodable character set:

• All 8-bit values can be encoded.
• Values 0 to 127 are interpreted according to the U.S. national version of ISO/IEC 646.
• Values 128-255 are interpreted in accordance with ISO/IEC 8859-1.

Usage

• LBarCode::Write