לכל פיקסל בכל פס של input, אם הפיקסל התואם ב-test שונה מאפס, הפלט יהיה הפיקסל התואם ב-value, אחרת הפלט יהיה פיקסל הקלט.
אם בפיקסל מסוים, אחד מהערכים test או value מוסתר, נעשה שימוש בערך הקלט. אם הקלט מוסתר, לא מתבצעת פעולה.
לפסי הפלט יש את אותם שמות כמו לפסי הקלט. טיפוס הפלט של כל פס הוא הגדול מבין טיפוסי הקלט והערך. תמונת הפלט שומרת על המטא-נתונים ועל טביעת הרגל של תמונת הקלט.
| שימוש | החזרות |
|---|---|
Image.where(test, value) | תמונה |
| ארגומנט | סוג | פרטים |
|---|---|---|
זה: input | תמונה | תמונת הקלט. |
test | תמונה | תמונה לבדיקה. הפיקסלים של התמונה הזו קובעים אילו מהפיקסלים של הקלט יוחזרו. אם מדובר בפס יחיד, הוא ישמש את כל הפסים בתמונת הקלט. יכול להיות שזו לא תמונה של מערך. |
value | תמונה | ערך הפלט שבו יש להשתמש אם המבחן לא שווה לאפס. אם מדובר בפס יחיד, הוא ישמש את כל הפסים בתמונת הקלט. |