مكعبات

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

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

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

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

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

• وصف الكتلة - يشرح ما تفعله الكتلة ومتى تكون مفيدة.

• صورة الكتلة - توضح شكل الكتلة في VEXcode V5.

• المعلمات - تسرد المدخلات الموجودة في الكتلة وتشرح كيف يؤثر كل مدخل على الروبوت أو المشروع.

• قيمة الإرجاع - توضح ما الذي يبلغه كتلة Boolean أو Reporter.

• مثال - يوضح إحدى الطرق التي يمكن بها استخدام الكتلة في مشروع ما.

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

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

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

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

استدر لـ

تقوم كتلة turn for بتدوير الروبوت يمينًا أو يسارًا بزاوية محددة. ويكون الدوران نسبيًا لموقع الروبوت الحالي. سينتظر البرنامج حتى ينتهي الروبوت من الدوران قبل تنفيذ الكتلة التالية في المكدس.

استدر [يمين v] بمقدار [90] درجة ▶

حدود	وصف
اتجاه	اتجاه دوران الروبوت: يسار أو يمين.
زاوية	عدد الدرجات التي يدور بها الروبوت. يمكن أن يكون هذا عددًا صحيحًا أو عددًا عشريًا.
ولا تنتظر	حدد السهم ( ▶ ) لتوسيع الكتلة لتقول ولا تنتظر، حتى يتم تشغيل الكتلة التالية في المكدس على الفور.

مثال

عند البدء
[Turn left, then turn around to the right.]
استدر [يسار v] بمقدار [90] درجة ▶
استدر [يمين v] بمقدار [180] درجة ▶