イメージスライダーによって構築されました

gradio_imageslider

2 つの画像を比較するための Gradio コンポーネント。

このコンポーネントはいくつかの方法で使用できます。

• ユーザーが単一の画像をアップロードすると、推論関数がそれと比較できる画像を生成する統合された入力/出力として (デモを参照)、
• 手動アップロード入力として、ユーザーが自分の 2 つの画像を比較できるようにします (画像は他の場所、たとえばモデルに渡すことができます)。
• 静的出力コンポーネントとして使用すると、ユーザーは推論関数によって生成された 2 つの画像を比較できます。

インストール

pip install gradio_imageslider

使用法

 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

初期化

名前	タイプ	デフォルト	説明
value	tuple [ str , str ] | tuple [ PIL . Image . Image , PIL . Image . Image ] | tuple [ numpy . ndarray , numpy . ndarray ] | None	None	PIL イメージ、numpy 配列、イメージ コンポーネントが取得するデフォルト値のパスまたは URL。呼び出し可能な場合、アプリが読み込まれるたびに関数が呼び出され、コンポーネントの初期値が設定されます。
position	int	0.5	スライダーの位置 (0 ～ 1)。
upload_count	int	1	コンポーネントにアップロードできる画像の数。 1 または 2。
height	int | None	None	表示される画像の高さ (ピクセル単位)。
width	int | None	None	表示される画像の幅 (ピクセル単位)。
type	"numpy" | "pil" | "filepath"	"numpy"	予測関数に渡される前に画像が変換される形式。 「numpy」は画像を形状 (高さ、幅、3) と 0 ～ 255 の値を持つ numpy 配列に変換します。「pil」は画像を PIL 画像オブジェクトに変換します。「filepath」は str パスを次の内容を含む一時ファイルに渡します。画像。
label	str | None	None	インターフェース内のコンポーネント名。
every	float | None	None	`value` が呼び出し可能な場合、クライアント接続が開いている間、関数を「毎」秒ごとに実行します。それ以外の場合は効果がありません。キューを有効にする必要があります。イベントには、このコンポーネントの .load_event 属性を介してアクセスできます (イベントをキャンセルするなど)。
show_label	bool | None	None	True の場合、ラベルが表示されます。
show_download_button	bool	True	True の場合、画像をダウンロードするボタンが表示されます。
container	bool	True	True の場合、コンポーネントがコンテナ内に配置され、境界線の周囲に追加のパディングが提供されます。
scale	int | None	None	行内の隣接するコンポーネントと比較した相対的な幅。たとえば、コンポーネント A のスケール = 2、コンポーネント B のスケール = 1 の場合、A の幅は B の 2 倍になります。整数である必要があります。
min_width	int	160	最小ピクセル幅。この値を満たすのに十分な画面スペースがない場合は折り返されます。特定のスケール値によってこのコンポーネントが min_width より狭くなる場合は、min_width パラメーターが最初に尊重されます。
interactive	bool | None	None	True の場合、ユーザーは画像をアップロードして編集できます。 False の場合、画像の表示にのみ使用できます。指定されていない場合は、コンポーネントが入力として使用されるか出力として使用されるかに基づいて推測されます。
visible	bool	True	False の場合、コンポーネントは非表示になります。
elem_id	str | None	None	HTML DOM でこのコンポーネントの ID として割り当てられるオプションの文字列。 CSS スタイルをターゲットにするために使用できます。
elem_classes	list [ str ] | str | None	None	HTML DOM でこのコンポーネントのクラスとして割り当てられる文字列のオプションのリスト。 CSS スタイルをターゲットにするために使用できます。
show_share_button	bool | None	None	True の場合、コンポーネントの隅に共有アイコンが表示され、ユーザーが出力を Hugging Face Spaces ディスカッションに共有できるようになります。 False の場合、アイコンは表示されません。 [なし] (デフォルトの動作) に設定すると、この Gradio アプリが Spaces で起動された場合にはアイコンが表示されますが、それ以外の場合は表示されません。
slider_color	str | None	None	スライダーセパレーターの色。

イベント

名前	説明
change	ユーザー入力 (ユーザーがテキストボックスに入力するなど) または関数の更新 (イベント トリガーの出力から画像が値を受け取るなど) によって ImageSlider の値が変更されるとトリガーされます。ユーザー入力によってのみトリガーされるリスナーについては、 .input()を参照してください。
upload	このリスナーは、ユーザーがファイルを ImageSlider にアップロードするとトリガーされます。

ユーザー機能

ユーザー予測関数への影響は、コンポーネントがイベントの入力として使用されるか出力として使用されるか (またはその両方) によって異なります。

• 入力として使用される場合、コンポーネントはユーザー関数の入力署名にのみ影響します。
• 出力として使用される場合、コンポーネントはユーザー関数の戻りシグネチャにのみ影響します。

以下のコード スニペットは、コンポーネントが入力と出力の両方として使用される場合に正確です。

• 出力として:要求された形式の画像のタプルが渡されます。
• 入力として: numpy 配列としての画像、PIL 画像、文字列/パス ファイルパス、または文字列 URL を返す必要があります。

 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