Binarizar um objeto de imagem (:binaryzation)

Declaração

imagem = imagem:binaryzation({
    [white_background = fundo_branco,]
    [csim_mode = modo_de_similaridade,]
    [csim_algorithm = algoritmo_de_similaridade_de_cor,]
    {cor*, desvio_de_cor*},
    {cor*, desvio_de_cor*},
    ...
})

imagem = imagem:binaryzation("cx*-cox*,cx*-cox*...")

Parâmetros

• fundo_branco (compatível a partir da versão 20250302)
  Booleano opcional; define o fundo como branco? O padrão é false, ou seja, primeiro plano branco e fundo preto

• modo_de_similaridade (compatível a partir da versão 20250302)
  Booleano opcional; usa o modo de similaridade? Quando ativado, desvio_de_cor* representa similaridade em vez de diferença de cor. O padrão é false

• algoritmo_de_similaridade_de_cor (compatível a partir da versão 20250302)
  Inteiro opcional; algoritmo de similaridade de cores, válido somente no modo de similaridade. O padrão é 0

  Algoritmo de similaridade de cores

  0 é o algoritmo padrão do XXT; o gradiente é acentuado e a similaridade diminui rapidamente com a diferença
  1 é o algoritmo de Manhattan; o gradiente é suave
  2 é o algoritmo euclidiano; o gradiente é suave

• cor*, desvio_de_cor*
  Inteiros; lista de permissões de valores de cor. cor* é o próprio valor da cor e desvio_de_cor* é a diferença máxima de cor de cor*

• cx*-cox*
  Texto; lista de permissões de valores de cor. cx* é a descrição hexadecimal do valor da cor e cox* é a descrição hexadecimal de sua diferença máxima de cx*

Valor retornado

• imagem
  Objeto de imagem; retorna o próprio objeto após a binarização

Descrição

Binariza o objeto de imagem.
A operação altera o próprio objeto.
Em termos de desempenho, essa operação não copia os dados.

Exemplo

local pic = screen.image(462, 242, 569, 272)
pic = pic:binaryzation({
    {0x9D5D39, 0x0F1F26},
    {0xD3D3D2, 0x2C2C2D},
})

local pic = screen.image(462, 242, 569, 272)
pic = pic:binaryzation("9D5D39-0F1F26,D3D3D2-2C2C2D")

local pic = screen.image(462, 242, 569, 272)
pic = pic:binaryzation({
    csim_mode = true,        -- usar o modo de similaridade
    csim_algorithm = 2,      -- usar o algoritmo euclidiano
    white_background = true, -- definir o fundo como branco
    {0x9D5D39, 90},          -- similaridade da cor 0x9D5D39 de 90%
    {0xD3D3D2, 90},          -- similaridade da cor 0xD3D3D2 de 90%
})