Xbase++ Requires Chilkat v11.7.0+

Choose the QR Code Version and Mask Pattern

See more QR Code Examples

Demonstrates fixing the QR version and the mask pattern. The version (1 to 40) is the size of the symbol: version 1 is 21 modules wide and each version adds 4. By default QrCode picks the smallest version that holds the data and the mask pattern that scores best under the QR standard. Fixing the version is useful when a series of codes must all be the same size, and minVersion and maxVersion bound the automatic choice instead. Xbase++

LOCAL nSuccess
LOCAL oFmt
LOCAL oJson
LOCAL oJsonOut
LOCAL oJson2

nSuccess := 0

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

oFmt := CreateObject("Chilkat.Formats")
oJson := CreateObject("Chilkat.JsonObject")
oJsonOut := CreateObject("Chilkat.JsonObject")
oJson:UpdateString("payload.text", "https://www.chilkatsoft.com/")

//  Automatic: the smallest version that holds the text, and the best-scoring mask.
nSuccess := oFmt:QrCode("generate", oJson, oJsonOut)
IF (nSuccess == 0)
    ? oFmt:LastErrorText
    oFmt:destroy()
    oJson:destroy()
    oJsonOut:destroy()
    RETURN
ENDIF

? "automatic: version " + Str(oJsonOut:IntOf("symbols[0].selectedEncoding.version")) + ", " + Str(oJsonOut:IntOf("symbols[0].dimensions.modulesWide")) + " modules wide, mask " + Str(oJsonOut:IntOf("symbols[0].selectedEncoding.mask"))

//  A fixed version.  The call fails with capacityExceeded if the text does not fit it.
oJson:UpdateInt("encoding.qr.version", 8)
nSuccess := oFmt:QrCode("generate", oJson, oJsonOut)
IF (nSuccess == 0)
    ? oFmt:LastErrorText
    oFmt:destroy()
    oJson:destroy()
    oJsonOut:destroy()
    RETURN
ENDIF

? "version 8: version " + Str(oJsonOut:IntOf("symbols[0].selectedEncoding.version")) + ", " + Str(oJsonOut:IntOf("symbols[0].dimensions.modulesWide")) + " modules wide, mask " + Str(oJsonOut:IntOf("symbols[0].selectedEncoding.mask"))

//  A fixed mask pattern, 0 to 7.  Every mask gives a valid symbol holding the same data.
oJson:UpdateInt("encoding.qr.mask", 5)
nSuccess := oFmt:QrCode("generate", oJson, oJsonOut)
IF (nSuccess == 0)
    ? oFmt:LastErrorText
    oFmt:destroy()
    oJson:destroy()
    oJsonOut:destroy()
    RETURN
ENDIF

? "version 8, mask 5: version " + Str(oJsonOut:IntOf("symbols[0].selectedEncoding.version")) + ", mask " + Str(oJsonOut:IntOf("symbols[0].selectedEncoding.mask"))

//  Bounds for the automatic choice: no smaller than version 4, no larger than version 10.
oJson2 := CreateObject("Chilkat.JsonObject")
oJson2:UpdateString("payload.text", "https://www.chilkatsoft.com/")
oJson2:UpdateInt("encoding.qr.minVersion", 4)
oJson2:UpdateInt("encoding.qr.maxVersion", 10)
nSuccess := oFmt:QrCode("generate", oJson2, oJsonOut)
IF (nSuccess == 0)
    ? oFmt:LastErrorText
    oFmt:destroy()
    oJson:destroy()
    oJsonOut:destroy()
    oJson2:destroy()
    RETURN
ENDIF

? "minVersion 4: version " + Str(oJsonOut:IntOf("symbols[0].selectedEncoding.version"))

//  The four symbols, in the order they were made.  The second and the third hold the same data
//  in the same version and differ only in the mask:

//  

//  Sample output:

//  automatic: version 3, 29 modules wide, mask 2
//  version 8: version 8, 49 modules wide, mask 2
//  version 8, mask 5: version 8, mask 5
//  minVersion 4: version 4

oFmt:destroy()
oJson:destroy()
oJsonOut:destroy()
oJson2:destroy()