مكعبات#

يشرح مرجع واجهة برمجة تطبيقات VEX CTE Blocks ما يفعله كل كتلة VEXcode، وكيف تغير مدخلاتها سلوك الذراع ذي المحاور الستة، وكيف يمكن استخدام الكتلة في مشروع.

استخدم هذا المرجع عندما تريد فهم كتلة قبل إضافتها إلى مشروع، أو التحقق مما تُبلغه الكتلة، أو مقارنة الكتل المتشابهة في فئة معينة.

تُستخدم الكتل في مشاريع VEXcode Blocks. أما مشاريع بايثون فتستخدم قسم واجهة برمجة التطبيقات النصية بدلاً من ذلك.

كيفية قراءة إدخال الكتلة#

تتضمن معظم إدخالات الكتل الأجزاء التالية:

وصف الكتلة - يشرح ما تفعله الكتلة ومتى تكون مفيدة.
صورة الكتلة - توضح شكل الكتلة في VEXcode.
المعلمات - تسرد المدخلات الموجودة على الكتلة وتشرح كيف يؤثر كل مدخل على الذراع أو المشروع ذي المحاور الستة.
قيمة الإرجاع - توضح ما الذي يبلغه كتلة Boolean أو Reporter.
مثال - يوضح إحدى الطرق التي يمكن بها استخدام الكتلة في مشروع ما.

أنواع الكتل الشائعة#

تؤدي الأشكال المختلفة للكتل وظائف مختلفة في المشروع.

نوع الكتلة	ماذا يعني ذلك؟
كومة	كتلة تقوم بتنفيذ إجراء. تتصل الكتل المكدسة فوق وتحت الكتل الأخرى في المكدس.
قبعة	كتلة تبدأ سلسلة من الكتل عندما يحدث شيء ما، مثل بدء المشروع أو وقوع حدث ما.
منطقي	كتلة تُبلغ عن صواب أو خطأ. تُستخدم الكتل المنطقية غالبًا داخل الشروط، مثل كتل إذا كان ثم أو انتظر حتى.
مراسل	كتلة تُبلغ عن قيمة، مثل رقم أو نص. تُستخدم كتل الإبلاغ غالبًا داخل كتل أخرى.
المبنى ج	كتلة تلتف حول كتل أخرى وتتحكم في وقت أو كيفية تشغيلها، مثل كتل التكرار أو كتل إذا ثم.

مثال على إدخال كتلة#

حرك الذراع إلى الوضع المطلوب#

تقوم كتلة تحريك الذراع إلى الموضع بتحريك الذراع ذي المحاور الستة إلى إحداثيات x و y و z المحددة.

حرك [ذراع v] إلى الموقع x:[120] y:[0] z:[100] [مم v] ▶

المعلمة	وصف
x	الإحداثي السيني لموقع الهدف.
y	إحداثي y لموقع الهدف.
z	إحداثيات z لموقع الهدف.
وحدة	يحدد وحدة الإحداثيات: مم — مليمترات بوصات
سهم متوسع	افتراضيًا، هذه كتلة انتظار، لذا سينتهي ذراع الحركة سداسي المحاور من الحركة قبل تشغيل الكتلة التالية. لبدء حركة ذراع الحركة سداسي المحاور وتشغيل الكتلة التالية فورًا، وسّع الكتلة لتشمل بدون انتظار.

مثال

عند البدء
[Move the 6-Axis Arm to standard position at start of project.]
حرك [ذراع v] إلى الموقع x:(120) y:(120) z:(75) [مم v] ▶