QR
As ações QR leem códigos QR e códigos de barras em arquivos de imagem no host do robô usando OpenCV e Pyzbar.
Os valores de retorno viram variáveis de estado do robô (por exemplo
$qr_code,$barcode).
Índice
Ações
qr.read_barcode
Extrai valores de código de barras de um arquivo de imagem (simbologias não-QR via Pyzbar).
Com pré-processamento ativo, são aplicados realce de contraste e filtros morfológicos. A action pode repetir a decodificação em regiões recortadas quando nada for encontrado na imagem completa.
Parâmetros:
image_path - caminho do arquivo de imagem.
preprocess (opcional) - quando True, aplica o pipeline de pré-processamento de barras (padrão=True).
Retornar:
barcode - primeira string de código de barras decodificada quando houver resultados; lista vazia [] quando nenhum for detectado.
Exceções:
FileNotFoundException: quando a imagem não puder ser carregada.
InvalidImageExtension: em erros de processamento durante a leitura.
qr.read_qrcode
Extrai texto ou URLs codificados em QR codes a partir de um arquivo de imagem.
Com pré-processamento ativo, a imagem é convertida para escala de cinza e melhorada com CLAHE e filtro mediano antes da decodificação. A action também tenta decodificar em regiões quadradas quando nenhum código é encontrado na imagem inteira.
Parâmetros:
image_path - caminho do arquivo de imagem.
preprocess (opcional) - quando True, aplica CLAHE e filtro mediano antes da leitura (padrão=True).
Retornar:
qr_code - primeiro valor QR decodificado quando houver um ou mais códigos; lista vazia [] quando nenhum for detectado.
Exceções:
FileNotFoundException: quando a imagem não puder ser carregada.
InvalidImageExtension: em erros de processamento durante a leitura.