يُحوّل#

مقدمة#

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

لتعلم كيفية كتابة أوامر بايثون والأساليب والمعاملات، راجع VEXcode AIR Python API.

لأن كتل Switch تحتوي على كود بايثون، يجب أن تكون التهجئة وعلامات الترقيم والمسافات البادئة صحيحة لكي يعمل المشروع كما هو متوقع.

فيما يلي قائمة بجميع وحدات التبديل:

تبديل الكتل — إضافة كود بايثون إلى مشروع Blocks.

  • Stack — يوفر مساحة لكتابة أوامر بايثون التي يتم تشغيلها بالتسلسل مع كتل المكدس الأخرى.

  • C Block — يوفر مساحة لكتابة كود التحكم في بايثون، مثل if، while، أو for statement.

  • C Expandable — يوفر مساحة لكتابة كود التحكم في بايثون مع فروع متعددة، مثل if، elif، أو else.

  • Boolean — يوفر مساحة لكتابة كود بايثون الذي يُرجع True أو False.

  • Reporter — يوفر مساحة لكتابة كود بايثون الذي يُرجع قيمة.

  • Hat — يوفر مساحة لتعريف دالة بايثون.

كومة#

توفر كتلة Stack مساحة لكتابة أوامر بايثون التي يتم تشغيلها بالتسلسل مع كتل المكدس الأخرى.

كتلة مكدسة#
[] :: custom-switch

يمكن أن تحتوي كتلة Stack على سطر واحد أو عدة أسطر من كود بايثون.

عند بدء التشغيل، يستخدم كتلة المكدس للإقلاع والانتظار ثم الهبوط.#
عند البدء
[Take off, wait 1 second, then land.]
[drone.take_off(500)] :: custom-switch
انتظر [1] ثانية
هبوط ▶

المبنى ج#

توفر كتلة التعليمات البرمجية C مساحة لكتابة تعليمات التحكم في ، مثل if، while، وfor وتُنفَّذ الكتل البرمجية الموجودة داخل كتلة التعليمات البرمجية C كجزء من بنية التحكم في بايثون.

المبنى ج#
if [] :: custom-switch
fin

يتضمن كود التحكم بلغة بايثون الذي يمكن استخدامه في كتلة C ما يلي:

عند بدء التشغيل، يستخدم كتلة C للتحرك مع وحدة التحكم حتى يتم الضغط على الزر 7.#
عند البدء
[Move with the controller until button 7 is pressed.]
ارتفع إلى [500] [مم v] ▶
if [while not controller.button7.pressing():] :: custom-switch
تحرك باستخدام وحدة التحكم
fin
هبوط ▶

ج قابل للتوسيع#

توفر كتلة C Expandable مساحة لكتابة كود تحكم بايثون متعدد الفروع، مثل if، elif، أو elseويمكن إضافة فروع إضافية عن طريق تحديد سهم الزائد.

كتلة قابلة للتوسيع من النوع ج#
if [] :: custom-switch-expand
fin

يتضمن كود التحكم بلغة بايثون الذي يمكن استخدامه في كتلة C Expandable ما يلي:

عند بدء التشغيل، يستخدم كتلة قابلة للتوسيع من النوع C للتسلق لأعلى أو لأسفل أو التحليق.#
عند البدء
[Climb up or down with buttons 5 and 6.]
ارتفع إلى [500] [مم v] ▶
للأبد
if [if controller.button5.pressing():] :: custom-switch-expand
ارتفع [لأعلى v]
else [elif controller.button6.pressing():] :: custom-switch-expand
ارتفع [لأسفل v]
else [else:] :: custom-switch-expand
تحليق
fin
fin

منطقي#

توفر كتلة Boolean مساحة لكتابة كود بايثون الذي يُرجع True أو Falseويمكن وضعها داخل كتل ذات مدخلات سداسية.

كتلة منطقية#
<[] :: custom-switch>

يمكن أن تحتوي كتلة Boolean على شرط بايثون.

كتلة منطقية مع شرط بايثون#
<[controller.button7.pressing()] :: custom-switch>

يمكن أيضًا استخدام عوامل التشغيل المنطقية في كتلة Boolean:

كتلة منطقية مع عامل منطقي في بايثون#
<[controller.button5.pressing() and controller.button7.pressing()] :: custom-switch>

يمكن لكتلة Boolean استخدام عوامل المقارنة لمقارنة القيم:

  • أكبر من: >

  • أقل من: <

  • يساوي: ==

  • تتضمن عوامل المقارنة الأخرى <=، !=، و >=

كتلة منطقية مع عامل مقارنة بايثون#
<[drone.inertial.get_heading()> 100] :: custom-switch>
عند بدء التشغيل، يستخدم كتلة منطقية للتكرار حتى يتم الضغط على الزر 7.#
عند البدء
[Move with the controller until button 7 is pressed.]
ارتفع إلى [500] [مم v] ▶
كرر حتى <[controller.button7.pressing()] :: custom-switch>
تحرك باستخدام وحدة التحكم
fin
هبوط ▶

مراسل#

توفر كتلة Reporter مساحة لكتابة كود بايثون الذي يُرجع قيمة. ويمكن وضعها داخل كتل ذات مدخلات دائرية.

حجب المراسل#
([] :: custom-switch)

يمكن أن تحتوي كتلة Reporter على كود بايثون يقوم بإرجاع قيمة.

كتلة تقرير تحتوي على كود بايثون يُرجع قيمة#
([drone.get_altitude()] :: custom-switch)

يمكن استخدام عوامل التشغيل الرياضية في كتلة Reporter:

  • الجمع: +

  • الطرح: -

  • القسمة: /

  • الضرب: *

كتلة مراسلة مع إضافة بايثون#
([drone.get_altitude() + 45] :: custom-switch)
عند بدء التشغيل، يقوم البرنامج بطباعة ارتفاع الطائرة بدون طيار بعد صعودها لمدة 3 ثوانٍ.#
عند البدء
[Display the altitude after climbing for 3 seconds.]
ارتفع إلى [500] [مم v] ▶
ارتفع [لأعلى v]
انتظر [3] ثانية
اطبع ([drone.get_altitude()] :: custom-switch) على الشاشة ▶
هبوط ▶

قبعة#

توفر كتلة Hat مساحة لتعريف دالة بايثون. وتصبح الكتل المرفقة أسفل Hat هي جسم تلك الدالة.

قالب قبعة#
[] :: hat custom-switch

اكتب تعريف دالة بايثون في كتلة Hat. تُوضع المعاملات داخل الأقواس. إذا لم تستخدم الدالة معاملات، فاستخدم أقواسًا فارغة.

كتلة قبعة مع تعريف دالة بايثون#
[def function_name(parameter):] :: hat custom-switch
عند بدء التشغيل، يستخدم كتلة Hat لتعريف واستدعاء دالة.#
[def take_off_500():] :: hat custom-switch
[Define a custom function using a Hat block.]
ارتفع إلى [500] [مم v] ▶

عند البدء
[take_off_500()] :: custom-switch