بالنسبة إلى كل بكسل في كل نطاق من "الإدخال"، إذا كان البكسل المقابل في "الاختبار" غير صفري، يتم عرض البكسل المقابل في القيمة، وإلا يتم عرض بكسل الإدخال.
إذا تم إخفاء الاختبار أو القيمة عند بكسل معيّن، يتم استخدام قيمة الإدخال. إذا كان الإدخال مخفيًا، لن يتم تنفيذ أي إجراء.
تحمل النطاقات الناتجة الأسماء نفسها المستخدَمة في النطاقات المدخلة. نوع الإخراج لكل نطاق هو الأكبر بين نوعَي الإدخال والقيمة. تحتفظ الصورة الناتجة بالبيانات الوصفية والبصمة الرقمية للصورة المُدخلة.
| الاستخدام | المرتجعات |
|---|---|
Image.where(test, value) | صورة |
| الوسيطة | النوع | التفاصيل |
|---|---|---|
هذا: input | صورة | الصورة المدخَلة |
test | صورة | صورة الاختبار تحدّد وحدات البكسل في هذه الصورة وحدات البكسل التي سيتم عرضها من وحدات البكسل المُدخَلة. إذا كانت هذه حزمة واحدة، يتم استخدامها لجميع الحِزم في الصورة المُدخَلة. قد لا تكون هذه الصورة عبارة عن مجموعة صور. |
value | صورة | قيمة الإخراج التي سيتم استخدامها عندما لا يكون الاختبار صفرًا إذا كانت هذه حزمة واحدة، يتم استخدامها لجميع الحِزم في الصورة المُدخَلة. |