Pour chaque pixel de chaque bande d 'entrée, si le pixel correspondant dans "test" est différent de zéro, affichez le pixel correspondant dans la valeur. Sinon, affichez le pixel d'entrée.
Si, pour un pixel donné, le test ou la valeur sont masqués, 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 |
|---|---|---|
ceci : 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 s'agit peut-être pas d'une image matricielle. |
value | Image | Valeur de sortie à utiliser lorsque le test n'est pas nul. S'il s'agit d'une seule bande, elle est utilisée pour toutes les bandes de l'image d'entrée. |