معاملات بايثون - كتاب المهارات الرقمية - الصف 8 - الفصل 1 - المملكة العربية السعودية

📚 معاملات بايثون

المفاهيم الأساسية

معاملات بايثون (Parameters): قيم تُمرر للدالة داخل الأقواس وتُفصل بينها بفواصل.

تفصيل العملية عن معاملاتها: يتم باستخدام علامة النقطة (.)، مثل `drivetrain.drive_for`.

خريطة المفاهيم

```markmap

الوحدة الخامسة: برمجة الروبوت

الأدوات

VEXcode VR

#### واجهة بيئة VEXcode VR

##### فئات اللبنات البرمجية

###### المتغيرات (Variables)

####### مراقبة قيم المتغير

######## الغرض

######## الخطوات

######## النتيجة

####### مراقبة متغير العداد (Counter)

######## الغرض

######## الخطوات

######## النتيجة

####### وحدة تحكم العرض (Print Console)

######## الغرض

######## مثال من الصفحة

######## زر المسح (CLEAR)

###### التكرارات (Loops)

####### أنواع التكرارات

####### تكرار (repeat) مرات

######## الغرض

######## مثال: العمليات الحسابية في تكرارات

####### تكرار حتى (repeat until)

######## الغرض

######## كيفية الاستخدام مع العداد (Counter)

######## مثال 5: العد

######## مثال 6: رسم مربع

######### الهدف

######### المتغيرات المستخدمة

######### منطق البرنامج

######## التمييز بناءً على العداد (Counter)

######### الغرض

######### كيفية التنفيذ

######### مثال 7: رسم شكل ثماني

##### عرض الكود (Code Viewer)

###### الغرض

• رؤية المقطع البرمجي للمشروع بلغة بايثون.
• فهم طريقة ترجمة كل لبنة إلى نص برمجي.

###### مكونات النافذة

• المقطع البرمجي الافتراضي الخاص ببايثون.
• الدالة الرئيسية للمقطع البرمجي.
• المتغير الافتراضي الذي تم تعيينه على 0.
• الصف البرمجي لتشغيل روبوت الواقع الافتراضي.

###### قواعد مهمة

• يجب الإعلان عن المتغير داخل الدالة باستخدام `global`.

##### معاملات بايثون

###### الفرق عن اللبنات البرمجية

• في اللبنات: تغيير المعاملات عبر القوائم المنسدلة أو تغيير الأرقام.
• في بايثون: استخدام الفواصل للفصل بين المعاملات.

###### تركيب الأمر

• تفصيل العملية عن معاملاتها بعلامة النقطة (.).
• مثال: `drivetrain.drive_for(FORWARD, 200, MM)`

####### اسم العملية (Drivetrain)

####### المعاملات

######## الاتجاه (FORWARD)

######## المسافة (200)

######## الوحدة (MM)

###### مقارنة الأوامر واللبنات

####### drivetrain.drive_for(FORWARD, 200, MM) ↔ لبنة "تحرك إلى الأمام عدد 200 mm"

####### drivetrain.turn_for(RIGHT, 90, DEGREES) ↔ لبنة "انعطف يمين لمدة 90 درجة"

####### drivetrain.set_drive_velocity(50, PERCENT) ↔ لبنة "اضبط سرعة القيادة إلى 50 %"

####### for repeat_count in range(10): ↔ لبنة "تكرار 10"

####### wait(1, SECONDS) ↔ لبنة "الانتظار 1 ثانية"

```

نقاط مهمة

• في بيئة VEXcode VR، يمكن كتابة الأوامر بلغة بايثون بدلاً من استخدام اللبنات البرمجية المرئية.
• لكل لبنة برمجية مرئية أمر بايثون مكافئ لها.
• فهم تركيب أمر بايثون (مثل `drivetrain.drive_for(FORWARD, 200, MM)`) يساعد في قراءة الكود النصي وفهم دور كل جزء فيه.

معاملات بايثون

عند استخدام اللبنات البرمجية في بيئة فيكس كود في آر، يمكنك تغيير معاملاتها عن طريق اختيار أحد الخيارات المختلفة من القائمة المنسدلة أو تغيير الأرقام داخل المساحة الدائرية، ولكن في بايثون تستخدم الفواصل للفصل بين المعاملات المختلفة.

تفصيل العملية عن معاملاتها بعلامة النقطة (.).

يعرض الجدول التالي خمس لبنات أساسية وأوامر بايثون في بيئة فيكس كود في آر:

drivetrain.drive_for(FORWARD, 200, MM)

drivetrain.turn_for(RIGHT, 90, DEGREES)

drivetrain.set_drive_velocity(50, PERCENT)

for repeat_count in range(10):

wait(1, SECONDS)

وزارة التعليم Ministry of Education 2025 - 1447

358

معاملات بايثون عند استخدام اللبنات البرمجية في بيئة فيكس كود في آر، يمكنك تغيير معاملاتها عن طريق اختيار أحد الخيارات المختلفة من القائمة المنسدلة أو تغيير الأرقام داخل المساحة الدائرية، ولكن في بايثون تستخدم الفواصل للفصل بين المعاملات المختلفة. تفصيل العملية عن معاملاتها بعلامة النقطة (.). يعرض الجدول التالي خمس لبنات أساسية وأوامر بايثون في بيئة فيكس كود في آر: drivetrain.drive_for(FORWARD, 200, MM) drivetrain.turn_for(RIGHT, 90, DEGREES) drivetrain.set_drive_velocity(50, PERCENT) for repeat_count in range(10): wait(1, SECONDS) وزارة التعليم Ministry of Education 2025 - 1447 358 --- VISUAL CONTEXT --- **DIAGRAM**: شرح دالة drivetrain.drive_for Description: A diagram illustrating the components of the Python command `drivetrain.drive_for(FORWARD, 200, MM)`. It shows the full command text with arrows pointing to different parts, each labeled with its meaning. The command is `drivetrain.drive_for(FORWARD, 200, MM)`. An arrow points from 'drivetrain' to a box labeled 'Drivetrain اسم العملية.' (Drivetrain Operation Name). An arrow points from 'FORWARD' to a box labeled 'الاتجاه' (Direction). An arrow points from '200' to a box labeled 'المسافة' (Distance). An arrow points from 'MM' to a box labeled 'الوحدة' (Unit). Below the main command, a text box states 'تفصيل العملية عن معاملاتها بعلامة النقطة (.).' (Detailing the operation by its parameters with a dot (.).). Key Values: drivetrain, FORWARD, 200, MM Context: Explains the syntax and parameters of a Python function used in VEXcode VR for controlling a robot's movement, specifically how different parts of the function call correspond to specific parameters. **TABLE**: مقارنة بين أوامر بايثون ولبنات فيكس كود في آر Description: A two-column table comparing five basic Python commands with their equivalent VEXcode VR programming blocks. The left column is titled 'أوامر بايثون في بيئة فيكس كود في آر' (Python commands in VEXcode VR environment) and the right column is titled 'لبنات في بيئة فيكس كود في آر' (VEXcode VR blocks). Table Structure: Headers: أوامر بايثون في بيئة فيكس كود في آر | لبنات في بيئة فيكس كود في آر Rows: Row 1: drivetrain.drive_for(FORWARD, 200, MM) | تحرك إلى الأمام عدد 200 mm Row 2: drivetrain.turn_for(RIGHT, 90, DEGREES) | انعطف يمين لمدة 90 درجة Row 3: drivetrain.set_drive_velocity(50, PERCENT) | اضبط سرعة القيادة إلى 50 % Row 4: for repeat_count in range(10): | تكرار 10 Row 5: wait(1, SECONDS) | الانتظار 1 ثانية Data: The table provides a direct mapping between Python code snippets and their corresponding visual programming blocks in VEXcode VR. Context: Provides a direct mapping between Python code syntax and visual block programming in VEXcode VR, aiding in understanding how block-based commands translate to text-based code. **FIGURE**: Untitled Description: A blue VEXcode VR block representing a movement command. It contains the text 'تحرك إلى الأمام' (move forward), a numerical input field with the value '200', and a unit dropdown showing 'mm'. Key Values: FORWARD, 200, mm Context: Visual representation of the `drivetrain.drive_for(FORWARD, 200, MM)` Python command in a block-based programming environment. **FIGURE**: Untitled Description: A blue VEXcode VR block representing a turning command. It contains the text 'انعطف' (turn), a direction dropdown showing 'يمين' (right), the text 'لمدة' (for), a numerical input field with the value '90', and a unit dropdown showing 'درجة' (degrees). Key Values: RIGHT, 90, DEGREES Context: Visual representation of the `drivetrain.turn_for(RIGHT, 90, DEGREES)` Python command. **FIGURE**: Untitled Description: A blue VEXcode VR block representing a velocity setting command. It contains the text 'اضبط سرعة القيادة إلى' (set drive velocity to), a numerical input field with the value '50', and a '%' symbol. Key Values: 50, % Context: Visual representation of the `drivetrain.set_drive_velocity(50, PERCENT)` Python command. **FIGURE**: Untitled Description: An orange C-shaped VEXcode VR block representing a repetition loop. It contains the text 'تكرار' (repeat) and a numerical input field with the value '10'. Key Values: 10 Context: Visual representation of the `for repeat_count in range(10):` Python loop. **FIGURE**: Untitled Description: An orange VEXcode VR block representing a wait command. It contains the text 'الانتظار' (wait), a numerical input field with the value '1', and a unit dropdown showing 'ثانية' (seconds). Key Values: 1, SECONDS Context: Visual representation of the `wait(1, SECONDS)` Python command.