Saltar al contenido principal

Binarizar un objeto de imagen (:binaryzation)

Declaración​

imagen = imagen:binaryzation({
    [white_background = fondo_blanco,]
    [csim_mode = modo_de_similitud,]
    [csim_algorithm = algoritmo_de_similitud_de_color,]
    {color\*, desviación\*},
    {color\*, desviación\*},
    ...
})
imagen = imagen:binaryzation("cx*-cox*,cx*-cox*...")

Parámetros​

  • fondo_blanco (compatible desde la versión 20250302)
    Booleano opcional: si se establece el fondo en blanco; predeterminado false, es decir, primer plano blanco y fondo negro.

  • modo_de_similitud (compatible desde la versión 20250302)
    Booleano opcional: si se usa el modo de similitud. Al activarlo, desviación* representa la similitud y no la diferencia de color; predeterminado false.

  • algoritmo_de_similitud_de_color (compatible desde la versión 20250302)
    Entero opcional: algoritmo de similitud de color; solo tiene efecto en el modo de similitud; predeterminado 0.

    Algoritmos de similitud de color
    0: algoritmo predeterminado de XXT, gradiente pronunciado; la diferencia reduce rápidamente la similitud
    1: algoritmo de Manhattan, gradiente suave
    2: algoritmo euclídeo, gradiente suave

  • color*, desviación*
    Enteros: lista blanca de valores de color; color* es el propio valor de color y desviación* es la diferencia máxima de color de color*.

  • cx*-cox*
    Texto: lista blanca de valores de color; cx* es la representación hexadecimal del valor y cox* es la diferencia máxima de color de cx* en hexadecimal.

Valor de retorno​

  • imagen
    Objeto de imagen; tras la binarización devuelve el propio objeto de imagen.

Descripción​

Binariza un objeto de imagen. Afecta al propio objeto. En cuanto al rendimiento, la operación no realiza copias de datos.

Ejemplo​

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 el modo de similitud
    csim_algorithm = 2,      -- Usar el algoritmo euclídeo
    white_background = true, -- Establecer el fondo en blanco
    {0x9D5D39, 90},          -- La similitud del color 0x9D5D39 es del 90 %
    {0xD3D3D2, 90},          -- La similitud del color 0xD3D3D2 es del 90 %
})