صفحة 386 - كتاب المهارات الرقمية - الصف 9 - الفصل 1 - المملكة العربية السعودية

📚 إضافة تعليقات نصية في البرامج

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

التعليقات (Comments): لبنات نصية تضاف إلى المقطع البرمجي لجعله مفهومًا من خلال وصف اللبنات. لا تؤثر على تنفيذ الكود، بل تساعد على صيانته أو تطويره في المستقبل.

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

```markmap

مستشعرات المسافة

لبنات التحكم (Control Blocks)

لبنة إلى الأبد (Forever)

• تكرار اللبنات الموجودة بداخلها إلى الأبد

لبنة إذا ثم آخر (If-Then-Else)

• تنفيذ أمر بناءً على شرط

#### مثال تطبيقي: التوقف قبل الاصطدام

• الشرط: إذا (المسافة الأمامية < 50 مم)
• الإجراء: أوقف القيادة
• البديل (آخر): تحرك إلى الأمام
• النتيجة: يتوقف الروبوت لتجنب الاصطدام عندما تقل المسافة عن 50 مم

#### مثال تطبيقي: تناسب السرعة مع المسافة

• الشرط: إذا (المسافة الأمامية < 6 مم)
• الإجراء: أوقف القيادة
• البديل (آخر): تحرك للأمام بسرعة 50%
• النتيجة: يبطئ الروبوت لتجنب الاصطدام عندما تقل المسافة عن 6 مم

#### مثال تطبيقي: تجنب عائق متبوع بقرار الانعطاف

• الخطوات:

1. ينعطف الروبوت 90 درجة لليسار ويقيس المسافة (يخزنها في `Distance_to_left`).

2. ينعطف 180 درجة لليمين ويقيس المسافة (يخزنها في `Distance_to_right`).

3. يقارن بين قيمتي المسافة (`Distance_to_left` و `Distance_to_right`).

4. يقرر الانعطاف في الاتجاه الذي تكون فيه المسافة أكبر (أطول مسافة خالية).

• عناصر برمجة جديدة: المتغيرات، نظام الدفع، مغناطيس، العرض، الأحداث، التحكم، الاستشعار، العمليات.

عناصر برمجة جديدة

Turn 90 left or right

• يستخدم لجعل الروبوت يتحرك بشكل مستمر
• مثال: إذا كانت المسافة من الجدار الأيسر أقل من المسافة من الجدار الأيمن، ينعطف الروبوت إلى اليمين.

إنشاء عنصر

تعليق

#### الغرض

• جعل المقطع البرمجي مفهوماً
• المساعدة في صيانة أو تطوير الكود في المستقبل

#### طريقة الإضافة في فيكس كود في آر

من فئة التعليقات (Comments)، اسحب لبنة تعليق (comment).

ضعها قبل أمر اللبنة التي تريد شرحها.

اضغط على اللبنة واكتب النص التوضيحي (مثال: "يتحرك الروبوت إلى الأمام مسافة 200 ملليمتر.").

#### معلومة عامة

• في جميع لغات البرمجة، توجد رموز خاصة تسبق التعليقات.
• تخبر هذه الرموز المحول (Compiler) بتجاهل النص الذي يليها.

تطبيق

العلاقة بين السرعة والكبح

• كلما زادت سرعة الروبوت، تأخر في التوقف

بيانات المحاكاة (Simulation View)

• مثال: المسافة: 21 مم
• موقع الروبوت: X: 0 مم، Y: -270 مم
• حالة المستشعرات:

- العين الأمامية: Object: True

- العين السفلية: Object: False

- مستشعر الاصطدام: Left: False, Right: False

• مثال آخر: المسافة: 45 مم
• موقع الروبوت: X: 0 مم، Y: -294 مم
• حالة المستشعرات:

- العين الأمامية: Object: True

- العين السفلية: Object: False

- مستشعر الاصطدام: Left: False, Right: False

```

نقاط مهمة

• التعليقات هي نصوص توضيحية داخل الكود ولا تؤثر على تنفيذه.
• لإضافة تعليق في بيئة فيكس كود في آر، استخدم لبنة تعليق (comment) من فئة التعليقات (Comments).
• المحول (Compiler) يتجاهل النص الموجود داخل التعليقات بسبب رموز خاصة.

إضافة تعليقات نصية في البرامج

التعليقات هي لبنات نصية تضاف إلى المقطع البرمجي لجعله مفهومًا وذلك من خلال وصف اللبنات، كما لا تؤثر التعليقات على المقطع البرمجي، بل تساعد على صيانته أو تطويره في المستقبل.

لإضافة تعليقات في أحد المقاطع البرمجية في بيئة فيكس كود في آر، عليك استخدام لبنة تعليق (comment) الموجودة في فئة (Comments).

لإضافة تعليق:

< من فئة التعليقات (Comments)، اسحب لبنة لتعليق (comment)، وضعها قبل أمر اللبنة. اضغط على لبنة تعليق (comment)، ثم اكتب "يتحرك الروبوت إلى الأمام مسافة 200 ملليمتر.".

أنشئ المقطع البرمجي الآتي الذي يتحرك الروبوت فيه إلى الأمام وأضف تعليقات إليه.

معلومة

في جميع لغات البرمجة توجد رموز تسبق التعليقات أو يمكن تضمينها، وتخبر هذه الرموز المحول (Compiler) الذي يحول لغة البرمجة إلى لغة يفهمها الحاسب بأن يتجاهل النص الذي يليها.

إضافة تعليقات نصية في البرامج التعليقات هي لبنات نصية تضاف إلى المقطع البرمجي لجعله مفهومًا وذلك من خلال وصف اللبنات، كما لا تؤثر التعليقات على المقطع البرمجي، بل تساعد على صيانته أو تطويره في المستقبل. لإضافة تعليقات في أحد المقاطع البرمجية في بيئة فيكس كود في آر، عليك استخدام لبنة تعليق (comment) الموجودة في فئة (Comments). لإضافة تعليق: < من فئة التعليقات (Comments)، اسحب لبنة لتعليق (comment)، وضعها قبل أمر اللبنة. اضغط على لبنة تعليق (comment)، ثم اكتب "يتحرك الروبوت إلى الأمام مسافة 200 ملليمتر.". أنشئ المقطع البرمجي الآتي الذي يتحرك الروبوت فيه إلى الأمام وأضف تعليقات إليه. معلومة في جميع لغات البرمجة توجد رموز تسبق التعليقات أو يمكن تضمينها، وتخبر هذه الرموز المحول (Compiler) الذي يحول لغة البرمجة إلى لغة يفهمها الحاسب بأن يتجاهل النص الذي يليها. --- VISUAL CONTEXT --- **DIAGRAM**: Programming blocks for adding comments Description: A visual representation of programming blocks used to add comments in a Scratch-like environment. It shows a sequence of actions: 1. A 'Comments' block is dragged. 2. A 'Comment' block is placed. 3. A 'Move forward' block is shown. 4. A number input field is present. 5. The 'Move forward' block with a value of 200mm is displayed. Data: Illustrates the process of adding a comment block and a movement block in a visual programming interface. Key Values: 200 mm Context: Demonstrates how to use comment blocks and movement blocks in a visual programming language to create a simple robot movement with a comment.