BarcodePicker

BarcodePicker lee códigos de barras/QR a partir de fotogramas de la cámara en vivo, filtrando por formato. Es una clase abstracta: el consumidor implementa onBarcode(BarcodeFormat format, String code). Sigue el patrón de los pickers (ver Picker) — devuelve el payload leído vía getAnswer().

🔴 · Paquete: dev.crossfly.ui.picker · Extiende: Picker implements GdxCamera.Listener (abstracta) · Hardware: cámara

ℹ️ Este BarcodePicker es la lectura por cámara y sigue existiendo. No confundir con la antigua utilidad de generación de barcode (util/barcode), que fue eliminada en la modernización.

Cuándo usar

• Escanear códigos de barras (productos, entradas) o códigos QR.

Cuándo NO usar

• Tomar foto/grabar vídeo → usa PhotoPicker.

Apariencia

Vista previa de la cámara a pantalla completa (fondo negro), título arriba, un crosshair rojo central de mira y una “X” blanca de cerrar en la esquina inferior derecha.

Ejemplo completo (copiar, pegar y ejecutar)

BarcodePicker es abstracto: instáncialo con un cuerpo que implemente onBarcode. Como es un overlay de cámara, dispáralo desde un Button. El ejemplo reutiliza el uso básico (formatos 1D, cierra en la 1ª lectura) y escribe el payload en un Label. BarcodeFormat proviene de com.google.zxing.

package com.exemplo;

import com.google.zxing.BarcodeFormat;

import dev.crossfly.ui.*;
import dev.crossfly.ui.layout.*;
import dev.crossfly.ui.picker.*;

/** Pantalla principal ejecutable. Apunta el launcher (classname) y corre: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      Label saida = new Label("Nenhum código lido");
      add(LAY_AUTO, saida);

      Button escanear = new Button("Escanear código")
         .onAction(c ->
         {
            BarcodePicker scanner = new BarcodePicker("Aponte para o código", BarcodePicker.formats1D)
            {
               protected void onBarcode(BarcodeFormat format, String code)
               {
                  onUI(() -> saida.setText(format + ": " + code)); // vuelve al paint thread
                  hide(); // cierra tras la 1ª lectura (no se cierra solo)
               }
            };
            scanner.show(answer -> {});
         });
      add(LAY_AUTO, escanear);
   }
}

Los fragmentos siguientes muestran solo el núcleo (lo que va dentro de onShow()). Para ejecutarlos, colócalos en el esqueleto MainWindow de arriba.

Uso básico

BarcodePicker scanner = new BarcodePicker("Aponte para o código", BarcodePicker.formats1D)
{
   protected void onBarcode(BarcodeFormat format, String code)
   {
      Debug.log(format + ": " + code);
      hide(); // cierra tras la 1ª lectura
   }
};
scanner.show(answer -> campoCodigo.setText((String) answer));

Constructores

Propiedades y personalización

Callbacks y eventos

getAnswer() devuelve el último payload decodificado, o null si se canceló.

Estados

• No hay hide() automático al detectar — quien decide cerrar es tu onBarcode (llamando a hide()). Sin eso, el scanner sigue leyendo (útil para lectura continua).
• Los códigos repetidos consecutivos (mismo lastCode) se ignoran.
• onAppPause/onAppResume gestionan la cámara; onRemove detiene el hilo de decodificación.

Aceptar solo QR y cerrar en la primera lectura

BarcodePicker scanner = new BarcodePicker("Leia o QR", BarcodePicker.formats2D)
{
   protected void onBarcode(BarcodeFormat format, String code)
   {
      onUI(() -> campoCodigo.setText(code)); // actualización de UI en la paint thread
      hide();
   }
};
scanner.show(answer -> Debug.log("Lido: " + answer));

Buenas prácticas

• Llama a hide() en onBarcode para lectura única; omítelo para lectura continua.
• La decodificación se ejecuta en un hilo de fondo — envuelve las actualizaciones de UI en onUI(...).

Errores comunes

• Olvidar hide() cuando querías lectura única — el scanner sigue activo.
• Actualizar la UI directamente en onBarcode — respeta la paint thread con onUI(...).

Ver también

• Guía del área: ui/ · Recetas: cookbook/
• Base del patrón: Picker
• Componentes relacionados: PhotoPicker