construit par imageslider

gradio_imageslider

Un composant Gradio pour comparer deux images.

Ce composant peut être utilisé de plusieurs manières :

• en tant qu'entrée/sortie unifiée où les utilisateurs téléchargeront une seule image et une fonction d'inférence générera une image à laquelle elle pourra être comparée (voir démo),
• comme entrée de téléchargement manuel permettant aux utilisateurs de comparer deux de leurs propres images (qui peuvent ensuite être transmises ailleurs, par exemple à un modèle),
• en tant que composant de sortie statique permettant aux utilisateurs de comparer deux images générées par une fonction d'inférence.

Installation

pip install gradio_imageslider

Usage

 import gradio as gr
from gradio_imageslider import ImageSlider
from PIL import ImageFilter


def fn ( im ):
    if not im or not im [ 0 ]:
        return im
    return ( im [ 0 ], im [ 0 ]. filter ( filter = ImageFilter . GaussianBlur ( radius = 10 )))


with gr . Blocks () as demo :
    with gr . Group ():
        img1 = ImageSlider ( label = "Blur image" , type = "pil" , slider_color = "pink" )
        img1 . upload ( fn , inputs = img1 , outputs = img1 )

if __name__ == "__main__" :
    demo . launch ()

ImageSlider

Initialisation

nom	taper	défaut	description
value	tuple [ str , str ] | tuple [ PIL . Image . Image , PIL . Image . Image ] | tuple [ numpy . ndarray , numpy . ndarray ] | None	None	Une image PIL, un tableau numpy, un chemin ou une URL pour la valeur par défaut que le composant Image va prendre. Si elle est appelable, la fonction sera appelée à chaque chargement de l'application pour définir la valeur initiale du composant.
position	int	0.5	La position du curseur, entre 0 et 1.
upload_count	int	1	Le nombre d'images pouvant être téléchargées sur le composant. 1 ou 2.
height	int | None	None	Hauteur de l'image affichée en pixels.
width	int | None	None	Largeur de l'image affichée en pixels.
type	"numpy" | "pil" | "filepath"	"numpy"	Le format dans lequel l'image est convertie avant d'être transmise à la fonction de prédiction. "numpy" convertit l'image en un tableau numpy avec une forme (hauteur, largeur, 3) et des valeurs de 0 à 255, "pil" convertit l'image en un objet image PIL, "filepath" transmet un chemin str vers un fichier temporaire contenant l'image.
label	str | None	None	nom du composant dans l'interface.
every	float | None	None	Si `value` est appelable, exécutez la fonction 'toutes les' secondes pendant que la connexion client est ouverte. N'a aucun effet autrement. La file d'attente doit être activée. L'événement est accessible (par exemple pour l'annuler) via l'attribut .load_event de ce composant.
show_label	bool | None	None	si vrai, affichera l’étiquette.
show_download_button	bool	True	Si vrai, affichera le bouton pour télécharger l’image.
container	bool	True	Si True, placera le composant dans un conteneur – fournissant un remplissage supplémentaire autour de la bordure.
scale	int | None	None	largeur relative par rapport aux composants adjacents dans une rangée. Par exemple, si le composant A a une échelle = 2 et que le composant B a une échelle = 1, A sera deux fois plus large que B. Il doit s'agir d'un nombre entier.
min_width	int	160	largeur de pixel minimale, s'enroulera si l'espace d'écran n'est pas suffisant pour satisfaire cette valeur. Si une certaine valeur d'échelle fait que ce composant est plus étroit que min_width, le paramètre min_width sera respecté en premier.
interactive	bool | None	None	si True, permettra aux utilisateurs de télécharger et de modifier une image ; si False, ne peut être utilisé que pour afficher des images. S’il n’est pas fourni, cela est déduit selon que le composant est utilisé comme entrée ou comme sortie.
visible	bool	True	Si False, le composant sera masqué.
elem_id	str | None	None	Une chaîne facultative attribuée comme identifiant de ce composant dans le DOM HTML. Peut être utilisé pour cibler les styles CSS.
elem_classes	list [ str ] | str | None	None	Une liste facultative de chaînes affectées comme classes de ce composant dans le DOM HTML. Peut être utilisé pour cibler les styles CSS.
show_share_button	bool | None	None	Si True, affichera une icône de partage dans le coin du composant qui permet à l’utilisateur de partager les résultats des discussions Hugging Face Spaces. Si False, l’icône n’apparaît pas. Si elle est définie sur Aucun (comportement par défaut), l'icône apparaît si cette application Gradio est lancée sur Spaces, mais pas autrement.
slider_color	str | None	None	La couleur du séparateur de curseur.

Événements

nom	description
change	Déclenché lorsque la valeur de ImageSlider change soit en raison d'une entrée de l'utilisateur (par exemple, un utilisateur tape dans une zone de texte) OU en raison d'une mise à jour de fonction (par exemple, une image reçoit une valeur de la sortie d'un déclencheur d'événement). Voir .input() pour un écouteur qui n'est déclenché que par l'entrée de l'utilisateur.
upload	Cet écouteur est déclenché lorsque l'utilisateur télécharge un fichier dans ImageSlider.

Fonction utilisateur

L'impact sur la fonction de prévision des utilisateurs varie selon que le composant est utilisé comme entrée ou comme sortie pour un événement (ou les deux).

• Lorsqu'il est utilisé comme entrée, le composant n'impacte que la signature d'entrée de la fonction utilisateur.
• Lorsqu'il est utilisé en sortie, le composant n'impacte que la signature de retour de la fonction utilisateur.

L'extrait de code ci-dessous est précis dans les cas où le composant est utilisé à la fois comme entrée et comme sortie.

• En sortie : est transmis, un tuple d'images au format demandé.
• En entrée : doit renvoyer une image sous forme de tableau numpy, une image PIL, un chemin de fichier chaîne/chemin ou une URL de chaîne.

 def predict (
    value : tuple [ str , str ]
   | tuple [ PIL . Image . Image , PIL . Image . Image ]
   | tuple [ numpy . ndarray , numpy . ndarray ]
   | None
) -> tuple [ str , str ]
   | tuple [ PIL . Image . Image , PIL . Image . Image ]
   | tuple [ numpy . ndarray , numpy . ndarray ]
   | None :
    return value