Aller au contenu principal

Binariser un objet image (:binaryzation)

Déclaration​

image = image:binaryzation({
    [white_background = white_background,]
    [csim_mode = similarity_mode,]
    [csim_algorithm = color_similarity_algorithm,]
    {color*, tolerance*},
    {color*, tolerance*},
    ...
})
image = image:binaryzation("cx*-cox*,cx*-cox*...")

Paramètres​

  • white_background (à partir de 20250302) Booléen facultatif : indique si l’arrière-plan doit devenir blanc. Par défaut false, soit premier plan blanc et arrière-plan noir

  • similarity_mode (à partir de 20250302) Booléen facultatif : active le mode de similarité. Dans ce mode, tolerance* représente la similarité et non la différence de couleur. Par défaut false

  • color_similarity_algorithm (à partir de 20250302) Entier facultatif : algorithme de similarité des couleurs, actif uniquement en mode de similarité, par défaut 0

    Algorithmes de similarité des couleurs
    0 algorithme par défaut de XXT, gradient abrupt, la similarité diminue rapidement avec la différence
    1 algorithme de Manhattan, gradient régulier
    2 algorithme euclidien, gradient régulier

  • color*, tolerance* Entiers : liste blanche de couleurs ; color* est la couleur elle-même et tolerance* est la différence maximale de color*

  • cx*-cox* Chaînes : liste blanche de couleurs ; cx* est la représentation hexadécimale de la couleur et cox* est la différence maximale de cx* en hexadécimal

Valeur de retour​

  • image Objet image : retourne l’objet image lui-même après binarisation

Description​

Binarise un objet image Modifie l’objet lui-même Cette opération ne copie pas de données

Exemples​

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,        -- utiliser le mode de similarité
    csim_algorithm = 2,      -- utiliser l’algorithme euclidien
    white_background = true, -- définir l’arrière-plan en blanc
    {0x9D5D39, 90},          -- similarité de 90 % pour la couleur 0x9D5D39
    {0xD3D3D2, 90},          -- similarité de 90 % pour la couleur 0xD3D3D2
})