FoxBarcodeQR es una aplicación de software libre que ofrece una herramienta de código de barras para la comunidad de Visual FoxPro. Es un complemento de la clase FoxBarcode sólo para códigos QR.

FoxBarcodeQR utiliza las librerías BarCodeLibrary.dll (Darío Álvarez Aranda, México) .

A partir de la versión 2.0 de FoxBarcodeQR utiliza QRCodeLib.dll (www.validacfd.com) agregando soporte para codificar mas de 255 caracteres y mayor control en la generación del código QR.

La nueva versión 2.25 usa la API de QR Server (https://goqr.me/api/) reemplazando la API de Google (https://developers.google.com/chart/infographics/docs/qr_codes) que fué discontinuada  para generar los códigos QR.

Puede escoger mediante distintos métodos cual librería utilizará.

Esta clase es una solución alternativa para todos los desarrolladores que solicitaron soporte para el Código QR ​​con la clase FoxBarcode.

Características de las librerías externas

BarCodeLibrary.dll 

• Genera códigos QR  funcionales, pero sólo se puede establecer el tamaño y el tipo de la imagen generada. 

• No tiene ajustes para el nivel de corrección de errores, colores y/o margenes.

• No soporta cadenas de mas de 255 caracteres.

La librería BarCodeLibrary.dll contiene solo 3 funciones:

• • LibraryVersion: Retorna una cadena con la versión de la librería.

  • SetConfiguration: Método para establecer el tamaño y el tipo de archivo de imagen a generar.

  • GenerateFile: Método responsable de generar la imagen del código de barras QR.

QRCodeLib.dll (recomendada)

• Genera códigos QR  funcionales con un mayor control de configuración.

• Soporta cadenas de mas de 255 caracteres.

La librería BarCodeLib.dll (versión 0.1b - www.validacfd.com ) contiene los métodos:

• QRCodeLibVer: Retorna una cadena con la versión de la librería.

• FastQRCode: Genera la imagen del código de barras QR con el texto a codificar.

• FullQRCode: Igual que el método anterior, pero con mayor control en la generación de la imagen del código QR.

Google API [Obsoleta]

• Genera códigos QR  a través de una llamada POST a una URL, por lo que  requiere conexión a internet

• Soporta cadenas de mas de 255 caracteres.

QR Server API [Reemplaza a la API de Google]

• Genera códigos QR  a través de una llamada POST a una URL, por lo que  requiere conexión a internet

• Soporta cadenas de mas de 255 caracteres.

• Para mas info, lea la documentación de QR Server en: goqr.me/api/doc/create-qr-code/

Métodos de FoxBarcodeQR

FoxBarcodeQR encapsula las funciones de las librerías BarCodeLibrary.dll, QRCodeLib.dll y la API de Google, en métodos propios de la clase para compatibilidad con las versiones anteriores y poder seleccionar la librería a utilizar .

Los métodos de la clase FoxBarcodeQR son: 

QRBarcodeImage() que utiliza la librería BarCodeLibrary.dll y que recibe los siguientes parámetros:

• •  tcText: Texto para codificar

  •  tcFile: Nombre del archivo de imagen que desea generar. Si no se especifica ninguno, se genera un nombre de archivo aleatorio en la carpeta de archivos temporales de Windows.

  •  tnSize: El tamaño de la imagen generada. Recibe un número entero entre 2 y 12

    • 2 = 66 x 66 (en píxeles)

    • 3 = 99 x 99

    • 4 = 132 x 132

    • 5 = 165 x 165

    • 6 = 198 x 198

    • 7 = 231 x 231

    • 8 = 264 x 264

    • 9 = 297 x 297

    • 10 = 330 x 330

    • 11 = 363 x 363

    • 12 = 396 x 396

  •  tnType: El tipo de archivo de imagen generado. Recibe un número entero entre 0 y 2.

    • 0 = BMP

    • 1 = JPG

    • 2 = PNG

A partir de la versión 2.0 de FoxBarcodeQR, los nuevos métodos añadidos utilizan la librería QRCodeLib.dll (versión 1.2-DEMO):

FullQRCodeImage() que recibe los mismos parámetros que QRBarcodeImage()

• •  tcText: Texto para codificar

  •  tcFile: Nombre del archivo de imagen que desea generar. Si no se especifica ninguno, se genera un nombre de archivo aleatorio en la carpeta de archivos temporales de Windows.

  •  tnSize: El ancho y alto en pixeles de la imagen generada

  • tnType: (solo por compatibilidad) La librería solo genera archivo de imagen tipo 0 = BMP

Para configurar las otras opciones se utilizan las siguientes propiedades:

• • lAutoConfigurate: .T. para seleccionar una versión de código QR más grande si la cantidad de datos lo requiere.

  • lAutoFit: Trabaja conjuntamente con lAutoConfigurate

  • nBackColor: Color del fondo del código QR

  • nBarColor: Color de las barras del código QR

  • nCorrectionLevel: Nivel de corrección  de errores :

    • 0 = Nivel L ( 7 % ) 

    • 1 = Nivel M  ( 15 % ) 

    • 2 = Nivel Q ( 25% ) 

    • 3= Nivel H ( 30% )  

  • nEncoding: Algoritmo de codificación:

    • 0 = Alfabético: Codifica caracteres alfanuméricos  (digitos 0-9;  mayúsculas A-Z;  otros nueve caracteres: Espacio $ % * + – . / : )

    • 1 = Byte = 1: Codifica valores binarios ( 8-bit data) 

    • 2 = Numérico: Codifica unicamente valores numéricos (digitos 0-9) 

    • 3 = Kanji: Codifica caracteres Kanji. Los caracteres Kanji en Código QR pueden tener valores 8140-9FFC y E040-EBBF 

    • 4 = Auto:  Selección automática del algoritmo de codificación. (Recomendado)

  • nMarginPixels: Margen en pixeles

  • nModuleWidth: Tamaño de los módulos en pixeles

  • nHeight: Alto de la imagen en pixeles

  • nWidth: Ancho de la imagen en pixeles

FastQRCodeImage() es igual que el método FullQRCodeImage() y solo se pasa el texto a codificar. El resto se configura automáticamente, sin ningún control del usuario. 

• •  tcText: Texto para codificar

  •  tcFile: Nombre del archivo de imagen que desea generar. Si no se especifica ninguno, se genera un nombre de archivo aleatorio en la carpeta de archivos temporales de Windows.

A partir de la versión 2.10 de FoxBarcodeQR se agregó un nuevo método que utiliza la API de Google [Obsoleta]:

GooQRCodeImage()  recibe los mismos parámetros que los métodos anteriores para uniformar la clase:

• •  tcText: Texto para codificar

  •  tcFile: Nombre del archivo de imagen que desea generar. Si no se especifica ninguno, se genera un nombre de archivo aleatorio en la carpeta de archivos temporales de Windows.

  •  tnSize: El ancho y alto en pixeles de la imagen generada

  • tnType: (solo por compatibilidad) La API solo genera archivo de imagen tipo 2 = PNG

Esta API nos permite ajustar algunas otras propiedades como:

• • nCorrectionLevel: Nivel de corrección  de errores :

    • 0 = Nivel L ( 7 % ) 

    • 1 = Nivel M  ( 15 % ) 

    • 2 = Nivel Q ( 25% ) 

    • 3= Nivel H ( 30% )  

  • nMarginPixels: Margen en columnas

A partir de la versión 2.25 de FoxBarcodeQR se agregó un nuevo método que utiliza la API de QR Server que reemplaza a la API de Google 

SvrQRCodeImage()  recibe los mismos parámetros que los métodos anteriores para uniformar la clase:

• •  tcText: Texto para codificar

  •  tcFile: Nombre del archivo de imagen que desea generar. Si no se especifica ninguno, se genera un nombre de archivo aleatorio en la carpeta de archivos temporales de Windows.

  •  tnSize: El ancho y alto en pixeles de la imagen generada

  • tnType: Tipo de la imagen generada:  [png, gif, jpeg, jpg, svg, eps]

Todos estos métodos retornan la ruta y el nombre del archivo de la imagen generada con el código QR.

Ejemplos

En el siguiente ejemplo, se crean dos imágenes de código QR, la primera con el método QRBarcodeImage() y la segunda con el método FullQRCodeImage():

A partir de ésta nueva versión 2.0 de FoxBarcodeQR se pueden codificar cadenas de caracteres mayores a 255 caracteres con la librería QRCodeLib.dll y con la API de QR Server. Ejemplo: