Pour chaque pixel de chaque bande de "input", si le pixel correspondant dans "test" est différent de zéro, affiche le pixel correspondant dans "value". Sinon, affiche le pixel d'entrée.
Si, pour un pixel donné, "test" ou "value" est masqué, la valeur d'entrée est utilisée. Si l'entrée est masquée, rien n'est fait.
Les bandes de sortie portent les mêmes noms que les bandes d'entrée. Le type de sortie de chaque bande est le plus grand des types d'entrée et de valeur. L'image de sortie conserve les métadonnées et l'empreinte de l'image d'entrée.
| Utilisation | Renvoie |
|---|---|
Image.where(test, value) | Image |
| Argument | Type | Détails |
|---|---|---|
this: input | Image | Image d'entrée. |
test | Image | Image de test. Les pixels de cette image déterminent lesquels des pixels d'entrée sont renvoyés. S'il s'agit d'une seule bande, elle est utilisée pour toutes les bandes de l'image d'entrée. Il ne peut pas s'agir d'une image de tableau. |
value | Image | Valeur de sortie à utiliser lorsque le test est différent de zéro. S'il s'agit d'une seule bande, elle est utilisée pour toutes les bandes de l'image d'entrée. |