يُحوّل#

مقدمة #

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

لتعلم كيفية كتابة أوامر بايثون والأساليب والمعاملات، راجع VEX CTE 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
[Move the 6-Axis Arm to a standard position at the start of the project.]
[arm.move_to(120, 120, 75, False)] :: custom-switch

المبنى ج #

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

المبنى ج#

if [] :: custom-switch
fin

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

if
while
for

عند بدء التشغيل، يستخدم كتلة C للتحقق مما إذا كان بإمكان الذراع ذو المحاور الستة الوصول إلى موضع معين.#

عند البدء :: hat events
[Check if the 6-Axis Arm can move to a position.]
if [if not arm.can_arm_reach_to(0, 0, 0):] :: custom-switch
اطبع [The 6-Axis Arm can't move to this position.] على وحدة التحكم ◀ وانتقل للصف التالي
fin

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

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

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

if [] :: custom-switch-expand
fin

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

if
elif
else
while
for

عند بدء التشغيل، يستخدم كتلة قابلة للتوسيع من نوع C للتحقق مما إذا كان بإمكان الذراع ذو المحاور الستة الوصول إلى موضع معين.#

عند البدء
[Check if the 6-Axis Arm can or can't move to a position.]
if [if not arm.can_arm_reach_to(0, 0, 0):] :: custom-switch-expand
اطبع [The 6-Axis Arm can't move to this position.] على وحدة التحكم ◀ وانتقل للصف التالي
else [else:] :: custom-switch-expand
اطبع [The 6-Axis Arm can move to this position.] على وحدة التحكم ◀ وانتقل للصف التالي
fin

منطقي #

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

كتلة منطقية#

<[] :: custom-switch>

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

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

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

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

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

<[bumper_a.is_pressed() or bumper_b.is_pressed()] :: custom-switch>

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

أكبر من: >
أقل من: <
يساوي: ==
تتضمن عوامل المقارنة الأخرى <=، !=، و >=

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

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

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

عند البدء
[Check if the 6-Axis Arm can move to a position.]
إذا <ليس <[arm.can_arm_reach_to(0, 0, 0)] :: custom-switch>> إذن
اطبع [The 6-Axis Arm can't move to this position.] على وحدة التحكم ◀ وانتقل للصف التالي
fin

مراسل #

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

حجب المراسل#

([] :: custom-switch)

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

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

([arm.get_y()] :: custom-switch)

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

الجمع: +
الطرح: -
القسمة: /
الضرب: *

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

([arm.get_y() + 45] :: custom-switch)

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

عند البدء
[Display the current y-position while the 6-Axis Arm moves.]
حرك [ذراع v] إلى الموقع x:(-100) y:(200) z:(100) [مم v] ◀ ولا تنتظر
كرر حتى <[ذراع v] انتهى من الحركة؟>
اطبع ([arm.get_y()] :: custom-switch) على وحدة التحكم ◀ وانتقل للصف التالي
انتظر [0.25] ثانية
fin

قبعة #

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

قالب قبعة#

[] :: hat custom-switch

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

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

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

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

[def increment_y_100():] :: hat custom-switch
[Create a function to increment the 6-Axis Arm.]
أضف إلى موقع [ذراع v] بمقدار x:[0] y:[100] z:[0] [مم v] ▶

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

يُحوّل#

مقدمة#

كومة#

المبنى ج#

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

منطقي#

مراسل#

قبعة#