Dla każdego piksela w każdym paśmie „input” (dane wejściowe): jeśli odpowiedni piksel w „test” (dane testowe) jest różny od zera, wygeneruj odpowiedni piksel w „value” (wartość), w przeciwnym razie wygeneruj piksel wejściowy.
Jeśli w danym pikselu test lub wartość są zamaskowane, używana jest wartość wejściowa. Jeśli dane wejściowe są zamaskowane, nic się nie dzieje.
Pasma wyjściowe mają takie same nazwy jak pasma wejściowe. Typ danych wyjściowych każdego pasma jest większy z typów danych wejściowych i wartości. Obraz wyjściowy zachowuje metadane i ślad obrazu wejściowego.
| Wykorzystanie | Zwroty |
|---|---|
Image.where(test, value) | Obraz |
| Argument | Typ | Szczegóły |
|---|---|---|
to: input | Obraz | Obraz wejściowy. |
test | Obraz | Obraz testowy. Piksele tego obrazu określają, który z pikseli wejściowych zostanie zwrócony. Jeśli jest to pojedyncze pasmo, jest ono używane dla wszystkich pasm na obrazie wejściowym. Może to nie być obraz tablicowy. |
value | Obraz | Wartość wyjściowa do użycia, gdy test nie jest równy zero. Jeśli jest to pojedyncze pasmo, jest ono używane dla wszystkich pasm na obrazie wejściowym. |