gradio imageslider

gradio_imageslider

Eine Gradio-Komponente zum Vergleichen zweier Bilder.

Diese Komponente kann auf verschiedene Arten verwendet werden:

• als einheitliche Eingabe/Ausgabe , bei der Benutzer ein einzelnes Bild hochladen und eine Inferenzfunktion ein Bild generiert, mit dem es verglichen werden kann (siehe Demo),
• als manuelle Upload-Eingabe, die es Benutzern ermöglicht, zwei ihrer eigenen Bilder zu vergleichen (die dann an anderer Stelle weitergegeben werden können, z. B. an ein Modell),
• als statische Ausgabekomponente, die es Benutzern ermöglicht, zwei durch eine Inferenzfunktion generierte Bilder zu vergleichen.

Installation

pip install gradio_imageslider

Verwendung

 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

Initialisierung

Name	Typ	Standard	Beschreibung
value	tuple [ str , str ] | tuple [ PIL . Image . Image , PIL . Image . Image ] | tuple [ numpy . ndarray , numpy . ndarray ] | None	None	Ein PIL-Bild, ein Numpy-Array, ein Pfad oder eine URL für den Standardwert, den die Bildkomponente annehmen soll. Wenn sie aufrufbar ist, wird die Funktion immer dann aufgerufen, wenn die App geladen wird, um den Anfangswert der Komponente festzulegen.
position	int	0.5	Die Position des Schiebereglers, zwischen 0 und 1.
upload_count	int	1	Die Anzahl der Bilder, die in die Komponente hochgeladen werden können. 1 oder 2.
height	int | None	None	Höhe des angezeigten Bildes in Pixel.
width	int | None	None	Breite des angezeigten Bildes in Pixel.
type	"numpy" | "pil" | "filepath"	"numpy"	Das Format, in das das Bild konvertiert wird, bevor es an die Vorhersagefunktion übergeben wird. „numpy“ konvertiert das Bild in ein Numpy-Array mit Form (Höhe, Breite, 3) und Werten von 0 bis 255, „pil“ konvertiert das Bild in ein PIL-Bildobjekt, „filepath“ übergibt einen Str-Pfad zu einer temporären Datei, die Folgendes enthält das Bild.
label	str | None	None	Komponentenname in der Schnittstelle.
every	float | None	None	Wenn „value“ ein aufrufbarer Wert ist, führen Sie die Funktion alle Sekunden aus, während die Clientverbindung geöffnet ist. Hat ansonsten keine Auswirkung. Die Warteschlange muss aktiviert sein. Über das .load_event-Attribut dieser Komponente kann auf das Ereignis zugegriffen werden (z. B. um es abzubrechen).
show_label	bool | None	None	Wenn True, wird die Beschriftung angezeigt.
show_download_button	bool	True	Wenn True, wird eine Schaltfläche zum Herunterladen des Bildes angezeigt.
container	bool	True	Bei „True“ wird die Komponente in einem Container platziert, wodurch der Rand etwas zusätzlich aufgefüllt wird.
scale	int | None	None	relative Breite im Vergleich zu benachbarten Komponenten in einer Reihe. Wenn beispielsweise Komponente A den Maßstab = 2 und Komponente B den Maßstab = 1 hat, ist A doppelt so breit wie B. Sollte eine ganze Zahl sein.
min_width	int	160	Mindestpixelbreite, wird umbrochen, wenn nicht genügend Platz auf dem Bildschirm vorhanden ist, um diesen Wert zu erfüllen. Wenn ein bestimmter Skalierungswert dazu führt, dass diese Komponente schmaler als min_width ist, wird zuerst der Parameter min_width berücksichtigt.
interactive	bool | None	None	Wenn True, können Benutzer ein Bild hochladen und bearbeiten. Wenn False, kann es nur zum Anzeigen von Bildern verwendet werden. Wenn nicht angegeben, wird dies basierend darauf abgeleitet, ob die Komponente als Eingabe oder Ausgabe verwendet wird.
visible	bool	True	Bei False wird die Komponente ausgeblendet.
elem_id	str | None	None	Eine optionale Zeichenfolge, die als ID dieser Komponente im HTML-DOM zugewiesen wird. Kann für die Ausrichtung auf CSS-Stile verwendet werden.
elem_classes	list [ str ] | str | None	None	Eine optionale Liste von Zeichenfolgen, die als Klassen dieser Komponente im HTML-DOM zugewiesen sind. Kann für die Ausrichtung auf CSS-Stile verwendet werden.
show_share_button	bool | None	None	Wenn True, wird in der Ecke der Komponente ein Freigabesymbol angezeigt, mit dem Benutzer Ausgaben für Hugging Face Spaces Discussions teilen können. Bei „Falsch“ wird das Symbol nicht angezeigt. Bei der Einstellung „Keine“ (Standardverhalten) wird das Symbol angezeigt, wenn diese Gradio-App in Spaces gestartet wird, ansonsten jedoch nicht.
slider_color	str | None	None	Die Farbe des Schieber-Trennzeichens.

Veranstaltungen

Name	Beschreibung
change	Wird ausgelöst, wenn sich der Wert des ImageSlider ändert, entweder aufgrund einer Benutzereingabe (z. B. ein Benutzer gibt etwas in ein Textfeld ein) ODER aufgrund einer Funktionsaktualisierung (z. B. erhält ein Bild einen Wert von der Ausgabe eines Ereignisauslösers). Siehe .input() für einen Listener, der nur durch Benutzereingaben ausgelöst wird.
upload	Dieser Listener wird ausgelöst, wenn der Benutzer eine Datei in den ImageSlider hochlädt.

Benutzerfunktion

Die Auswirkungen auf die Vorhersagefunktion des Benutzers variieren je nachdem, ob die Komponente als Eingabe oder Ausgabe für ein Ereignis (oder beides) verwendet wird.

• Bei Verwendung als Eingabe wirkt sich die Komponente nur auf die Eingabesignatur der Benutzerfunktion aus.
• Bei Verwendung als Ausgabe wirkt sich die Komponente nur auf die Rückgabesignatur der Benutzerfunktion aus.

Der folgende Codeausschnitt ist in Fällen korrekt, in denen die Komponente sowohl als Eingabe als auch als Ausgabe verwendet wird.

• Als Ausgabe: Es wird ein Tupel von Bildern im angeforderten Format übergeben.
• Als Eingabe: Sollte ein Bild als Numpy-Array, ein PIL-Bild, einen String/Pfad-Dateipfad oder eine String-URL zurückgeben.

 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