class Blob -- كائن Blob

كائن الكتلة هو attrtuple يُعيده Image.find_blobs(). تمثل كل كتلة منطقة متصلة من البكسلات التي طابقت واحدة أو أكثر من عتبات اللون الممررة إلى find_blobs(). يجمع الكائن معًا مربع إحاطة الكتلة، ومركز الثقل، وعدد البكسلات، والمحيط، والاتجاه، ومقاييس كثافة المساحة، ومجموعة العتبات التي تطابقت معها، والمستطيل المُدوَّر ذو المساحة الدنيا، ومدرجات الإسقاط التكرارية الاختيارية على المحورين X/Y.

يمكن الوصول إلى الحقول عبر اسم السمة (blob.x) أو عبر الفهرس (blob[0]). لا يملك الكائن مُنشئًا عامًا.

class image.blob

يرجى استدعاء Image.find_blobs() لإنشاء هذا الكائن.

مربع الإحاطة ومركز الثقل

x

إحداثي x للركن العلوي الأيسر لمربع الإحاطة، بالبكسل. عدد صحيح. الفهرس [0].

y

إحداثي y للركن العلوي الأيسر لمربع الإحاطة، بالبكسل. عدد صحيح. الفهرس [1].

w

عرض مربع الإحاطة، بالبكسل. عدد صحيح. الفهرس [2].

h

ارتفاع مربع الإحاطة، بالبكسل. عدد صحيح. الفهرس [3].

cx

إحداثي x لمركز الثقل (متوسط بكسلات الكتلة)، مقرّب إلى عدد صحيح. عدد صحيح. الفهرس [4].

cy

إحداثي y لمركز الثقل (متوسط بكسلات الكتلة)، مقرّب إلى عدد صحيح. عدد صحيح. الفهرس [5].

cxf

إحداثي x لمركز الثقل كعدد عشري دون البكسل. الفهرس [16].

cyf

إحداثي y لمركز الثقل كعدد عشري دون البكسل. الفهرس [17].

rect

رباعية (x, y, w, h) لمربع الإحاطة. مناسبة لتمريرها مباشرة إلى طرق الرسم/الاقتصاص مثل Image.draw_rectangle() أو Image.crop(). الفهرس [22].

واصفات الشكل

pixels

عدد البكسلات التي تتكون منها هذه الكتلة. عدد صحيح. الفهرس [6].

area

مساحة مربع الإحاطة المحاذي للمحاور (w * h). عدد صحيح. الفهرس [19].

density

pixels / area -- نسبة مربع الإحاطة الذي تملؤه الكتلة. عدد عشري في المدى 0.0 -- 1.0. المستطيل المصمت يقترب من 1.0؛ والخط القطري الرفيع يقترب من 0.0. الفهرس [20].

perimeter

عدد البكسلات على المحيط الخارجي للكتلة. عدد صحيح. الفهرس [10].

roundness

نسبة المحور الأصغر إلى المحور الأكبر للكتلة، محسوبة من عزومها من الرتبة الثانية. عدد عشري في المدى 0.0 -- 1.0؛ 1.0 دائرة مثالية، و0.0 خط. الفهرس [11].

elongation

1.0 - roundness -- قيمة في المدى 0.0 -- 1.0 حيث 0.0 دائرة مثالية و1.0 خط. الفهرس [18].

compactness

(pixels * 4 * pi) / (perimeter * perimeter). تملك الدائرة أصغر محيط لمساحة معطاة، لذا فإن هذا المقياس يساوي 1.0 للدائرة المثالية وينخفض كلما أصبحت الكتلة أكثر عدم انتظام أو استطالة. عدد عشري. الفهرس [21].

rotation

اتجاه الكتلة بالراديان، مشتق من عزومها من الرتبة الثانية. عدد عشري في المدى 0 إلى pi (المحور متماثل لذا يكون الاتجاه غامضًا بعد pi). أكثر دقة للكتل المستطيلة -- بالنسبة للكتل شبه المستديرة تصبح القيمة مشوشة. الفهرس [7].

بيانات وصفية للعتبة / الدمج

code

خريطة بت بطول 32 بت مع بت واحد مضبوط لكل عتبة لون (كما تُمرَّر إلى Image.find_blobs()) طابقتها هذه الكتلة. مع عتبة واحدة، يكون code == 1. ومع الكتل متعددة الألوان المدموجة (merge=True) قد يُضبط أكثر من بت واحد. الفهرس [8].

count

عدد الكتل المصدرية المدموجة في هذه الكتلة. 1 عندما يكون merge=False؛ ويمكن أن يكون أكبر عندما يكون merge=True. الفهرس [9].

الزوايا

corners

رباعية من رُباعيات (x, y) الصحيحة للزوايا الأربع القصوى للكتلة، مرتبة في اتجاه عقارب الساعة بدءًا من الركن العلوي الأيسر. هذه هي الزوايا المشتقة من المحيط (النقاط على حدود الكتلة الأبعد عن مركز الثقل على طول أربعة أقطار). الفهرس [14].

min_corners

رباعية من رُباعيات (x, y) الصحيحة للزوايا الأربع لمستطيل الإحاطة المُدوَّر ذي المساحة الدنيا للكتلة. مدمجة مع rotation تمنحك أضيق احتواء حول الكتلة. الفهرس [15].

مدرجات الإسقاط التكرارية

x_hist_bins

قائمة من العدّات الصحيحة لمدرج إسقاط الكتلة التكراري على المحور X (الأعمدة). تُعبَّأ فقط عند استدعاء find_blobs(...) مع x_hist_bins_max > 0؛ وإلا فتكون فارغة. الفهرس [12].

y_hist_bins

قائمة من العدّات الصحيحة لمدرج إسقاط الكتلة التكراري على المحور Y (الصفوف). تُعبَّأ فقط عند استدعاء find_blobs(...) مع y_hist_bins_max > 0؛ وإلا فتكون فارغة. الفهرس [13].