对于“input”中每个波段的每个像素，如果“test”中对应的像素不为零，则输出相应像素的值，否则输出输入像素。
如果给定像素的测试或值被遮盖，则使用输入值。如果输入被遮盖，则不执行任何操作。
输出波段与输入波段具有相同的名称。每个频段的输出类型是输入类型和值类型中较大的类型。输出图片会保留输入图片的元数据和覆盖区。
| 用法 | 返回 |
|---|---|
Image.where(test, value) | 图片 |
| 参数 | 类型 | 详细信息 |
|---|---|---|
此：input | 图片 | 输入图片。 |
test | 图片 | 测试图片。此图片的像素决定了返回哪些输入像素。如果这是单波段，则会用于输入图片中的所有波段。这可能不是数组图片。 |
value | 图片 | 在测试结果不为零时使用的输出值。如果这是单波段，则会用于输入图片中的所有波段。 |