يُحوّل

مقدمة

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

لتعلم كيفية كتابة أوامر بايثون والأساليب والمعاملات، راجع VEX GO 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 على سطر واحد أو عدة أسطر من كود بايثون.

عند بدء التشغيل، يستخدم كتلة Stack للتحرك للأمام، ثم الانتظار، ثم التوقف.

عند البدء :: hat events
[Build Used: Super Code Base 2.0]
[Drive forward, then stop.]
[drivetrain.drive(FORWARD)] :: custom-switch
انتظر [2] ثانية
إيقاف القيادة

المبنى ج

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

المبنى ج

if [] :: custom-switch
fin

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

• if

• while

• for

عند بدء التشغيل، يستخدم كتلة C للتحرك للأمام عند الضغط على مصد LED.

عند البدء :: hat events
[Build Used: Super Code Base 2.0]
[Drive forward whenever the LED Bumper is pressed.]
للأبد
if [if bumper.is_pressed():] :: custom-switch
تشغيل [للأمام v] لمسافة [200] [مم v] ▶
fin
fin

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

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

كتلة قابلة للتوسيع من النوع ج

if [] :: custom-switch-expand
fin

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

• if

• elif

• else

• while

• for

عند بدء التشغيل، يستخدم البرنامج كتلة C قابلة للتوسيع للتوقف عند اكتشاف جسم ما، والاستمرار في العمل في غير ذلك.

عند البدء
[Build Used: Super Code Base 2.0]
[Drive forward if there is not an object in the way.]
للأبد
if [if eye.is_object_detected():] :: custom-switch-expand
إيقاف القيادة
else [else:] :: custom-switch-expand
تشغيل [للأمام v] لمسافة [200] [مم v] ▶
fin
fin

منطقي

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

كتلة منطقية

<[] :: custom-switch>

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

كتلة منطقية مع شرط بايثون

<[bumper.is_pressed()] :: custom-switch>

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

• and

• or

• not

كتلة منطقية مع عامل منطقي في بايثون

<[bumper.is_pressed() or eye.is_object_detected()] :: custom-switch>

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

• أكبر من: >

• أقل من: <

• يساوي: ==

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

كتلة منطقية مع عامل مقارنة بايثون

<[drivetrain.get_heading()> 100] :: custom-switch>

عند بدء التشغيل، يستخدم كتلة منطقية للتحرك للأمام كلما تم الضغط على مصد LED.

عند البدء :: hat events
[Build Used: Super Code Base 2.0]
[Drive forward whenever the LED Bumper is pressed.]
للأبد
إذا <[bumper.is_pressed()] :: custom-switch> إذن
تشغيل [للأمام v] لمسافة [200] [مم v] ▶
fin
fin

مراسل

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

حجب المراسل

([] :: custom-switch)

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

كتلة تقرير تحتوي على كود بايثون يُرجع قيمة

([drivetrain.get_rotation()] :: custom-switch)

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

• الجمع: +

• الطرح: -

• القسمة: /

• الضرب: *

كتلة مراسلة مع إضافة بايثون

([drivetrain.get_heading() + 45] :: custom-switch)

عند بدء التشغيل، يقوم البرنامج بطباعة دوران مجموعة نقل الحركة أثناء دوران الروبوت.

عند البدء :: hat events
[Build Used: Code Base 2.0]
[Display the rotation while turning.]
استدر [يمين v] بمقدار [450] درجة ◀ ولا تنتظر
للأبد
امسح جميع الصفوف
اطبع ([drivetrain.get_rotation()] :: custom-switch) ▶
انتظر [0.1] ثانية
fin

قبعة

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

قالب قبعة

[] :: hat custom-switch

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

كتلة قبعة مع تعريف دالة بايثون

[def function_name(parameter):] :: hat custom-switch

عند بدء التشغيل، يستخدم كتلة Hat لتعريف واستدعاء دالة.

[def drive_400():] :: hat custom-switch
[Build Used: Code Base 2.0]
[Create a function to drive the robot forward.]
تشغيل [للأمام v] لمسافة (400) [مم v] ▶

عند البدء :: hat events
[drive_400()] :: custom-switch