ee.Image.sampleRectangle

يستخرج هذا المشغّل منطقة مستطيلة من وحدات البكسل من صورة إلى مصفوفة ND لكل نطاق. يتم عرض المصفوفات في عنصر يحتفظ بالخصائص نفسها الخاصة بالصورة وشكل هندسي مطابق للشكل الهندسي المستخدَم لأخذ عينات من الصورة (أو بصمة الصورة إذا لم يتم تحديدها). يتم أخذ عيّنات من كل نطاق في إسقاط الإدخال الخاص به، وإذا لم يتم تحديد أي شكل هندسي، يتم أخذ العيّنات باستخدام مساحة التغطية. بالنسبة إلى النطاقات العددية، يكون صفيف الإخراج ثنائي الأبعاد. بالنسبة إلى نطاقات المصفوفة، تكون مصفوفة الإخراج (2+N)D حيث N هو عدد الأبعاد في النطاق الأصلي. في حال أخذ عيّنات من نطاقات مصفوفات، يجب أن تحتوي جميع المصفوفات على العدد نفسه من العناصر. إذا كان الجزء الذي تم أخذ عيّنات منه من النطاق محجوبًا بالكامل وتم تحديد قيمة تلقائية للمصفوفة، يتم استخدام قيمة المصفوفة التلقائية بدلاً من أخذ عيّنات من الصورة.

الاستخدام	المرتجعات
Image.sampleRectangle(region, properties, defaultValue, defaultArrayValue)	الميزة

الوسيطة	النوع	التفاصيل
هذا: image	صورة	الصورة المطلوب أخذ عيّنة منها
region	Geometry, default: null	المنطقة التي يتم استخدام مربع الإحاطة المتوقّع الخاص بها لأخذ عيّنة من الصورة يتم ضبطها تلقائيًا على مساحة التغطية في كل نطاق.
properties	قائمة، القيمة التلقائية: فارغة	السمات التي سيتم نسخها من الصورة النموذجية يتم ضبطها تلقائيًا على جميع الخصائص غير التابعة للنظام.
defaultValue	العدد العائم، القيمة التلقائية: null	قيمة تلقائية تُستخدَم عندما يتم إخفاء بكسل تم أخذ عيّنة منه أو عندما يكون خارج نطاق البصمة الطيفية.
defaultArrayValue	مصفوفة، القيمة التلقائية: null	قيمة تلقائية تُستخدَم عندما يتم إخفاء بكسل مصفوفة تم أخذ عينات منها أو عندما يكون خارج نطاق تغطية نطاق ترددي.