針對「input」每個波段中的每個像素，如果「test」中對應的像素不為零，則輸出「value」中對應的像素，否則輸出輸入像素。
如果特定像素的測試或值遭到遮蓋，系統會使用輸入值。如果輸入內容已遮蓋，系統不會採取任何動作。
輸出頻帶的名稱與輸入頻帶相同。每個頻帶的輸出類型是輸入和值類型中較大的類型。輸出圖片會保留輸入圖片的中繼資料和足跡。
| 用量 | 傳回 |
|---|---|
Image.where(test, value) | 圖片 |
| 引數 | 類型 | 詳細資料 |
|---|---|---|
這個：input | 圖片 | 輸入圖片。 |
test | 圖片 | 測試圖片。這張圖片的像素會決定要傳回哪些輸入像素。如果是單一波段，則會用於輸入圖片中的所有波段。這可能不是陣列圖片。 |
value | 圖片 | 測試值不為零時要使用的輸出值。如果是單一波段，則會用於輸入圖片中的所有波段。 |