Für jedes Pixel in jedem Band von „input“: Wenn das entsprechende Pixel in „test“ ungleich null ist, wird das entsprechende Pixel in „value“ ausgegeben. Andernfalls wird das Eingabepixel ausgegeben.
Wenn ein bestimmtes Pixel in „test“ oder „value“ maskiert ist, wird der Eingabewert verwendet. Wenn die Eingabe maskiert ist, geschieht nichts.
Die Ausgabebänder haben dieselben Namen wie die Eingabebänder. Der Ausgabetyp jedes Bands ist der größere der Eingabe- und Werttypen. Das Ausgabebild behält die Metadaten und den Footprint des Eingabebilds bei.
| Nutzung | Ausgabe |
|---|---|
Image.where(test, value) | Bild |
| Argument | Typ | Details |
|---|---|---|
Dieses: input | Bild | Das Eingabebild. |
test | Bild | Das Testbild. Die Pixel dieses Bilds bestimmen, welche der Eingabepixel zurückgegeben werden. Wenn es sich um ein einzelnes Band handelt, wird es für alle Bänder im Eingabebild verwendet. Dies darf kein Array-Bild sein. |
value | Bild | Der Ausgabewert, der verwendet werden soll, wenn „test“ nicht null ist. Wenn es sich um ein einzelnes Band handelt, wird es für alle Bänder im Eingabebild verwendet. |