Para cada pixel em cada banda de "entrada", se o pixel correspondente em "teste" for diferente de zero, a saída será o pixel correspondente no valor. Caso contrário, a saída será o pixel de entrada.
Se, em um determinado pixel, o teste ou o valor estiverem mascarados, o valor de entrada será usado. Se a entrada estiver mascarada, nada será feito.
As bandas de saída têm os mesmos nomes das bandas de entrada. O tipo de saída de cada banda é o maior dos tipos de entrada e valor. A imagem de saída mantém os metadados e a área de cobertura da imagem de entrada.
| Uso | Retorna |
|---|---|
Image.where(test, value) | Imagem |
| Argumento | Tipo | Detalhes |
|---|---|---|
this: input | Imagem | A imagem de entrada. |
test | Imagem | A imagem de teste. Os pixels dessa imagem determinam quais dos pixels de entrada são retornados. Se for uma única banda, ela será usada para todas as bandas na imagem de entrada. Essa não pode ser uma imagem de matriz. |
value | Imagem | O valor de saída a ser usado quando o teste não for zero. Se for uma única banda, ela será usada para todas as bandas na imagem de entrada. |