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

📚 إضافة معامل إدخال إلى عنصر برمجة جديد

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

معامل الإدخال (Input Parameter): متغير يُضاف إلى تعريف عنصر البرمجة الجديد (My Block) ليسمح بإدخال قيم مختلفة عند استخدامه، مما يجعل الكتلة البرمجية قابلة للتكيف.

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

```markmap

البرمجة التركيبية

التنفيذ في فيكس كود في آر

عناصر برمجة جديدة (My Blocks)

#### استخدام العنصر الجديد "Petal"

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

###### 1. رؤية لبنة "تعريف Petal" في منطقة البرمجة

###### 2. تخزين العنصر الجديد "My Block Petal" في فئة "My blocks"

#### التعليقات

##### أداة لإضافة توضيحات

#### تعريف المقطع البرمجي للعنصر الجديد "Petal"

##### تحت لبنة "تعريف Petal"

###### المقطع البرمجي الذي ينشئ بتلة واحدة

####### اضبط القلم على اللون أحمر

####### اضبط القلم على العرض نحيف للغاية

####### نقل القلم أسفل

####### تكرار 3 مرات:

######## تحرك إلى الأمام 180 mm

######## انعطف يمين لمدة 30 درجة

####### انعطف يمين لمدة 90 درجة

####### تكرار 3 مرات:

######## تحرك إلى الأمام 180 mm

######## انعطف يمين لمدة 30 درجة

#### استخدام عنصر البرمجة الجديد لإنشاء المقاطع البرمجية

##### الهدف

###### إنشاء مقطع برمجي يتحرك فيه روبوت الواقع الافتراضي ويرسم البتلة

##### خطوات التنفيذ

###### 1. من فئة "عناصر برمجة جديدة (My blocks)"، اضغط على المقطع البرمجي "عنصر البرمجة الجديد Petal"

###### 2. أفلت المقطع بعد لبنة "عندما بدأت (when started)"

##### تشغيل المقطع

###### شغل المقطع البرمجي في "ملعب الفن قماش (Art Canvas)"

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

###### رسم شكل بتلة مكون من فصين متداخلين باللون الأحمر

#### تطوير العنصر الجديد "Petal"

##### المشكلة

###### حجم البتلة ثابت (طول الجانب = 180 ملم)

###### حجم الزهرة الناتجة ثابت

##### الحل

###### إضافة معامل إدخال رقمي (Input Parameter)

####### مكانه: في المقطع البرمجي لعنصر البرمجة الجديد "Petal"

####### الغرض: قبول قيم مختلفة لطول الجانب (side length)

####### الفائدة: إنشاء بتلات وزهور بأحجام مختلفة

##### خطوات إضافة المعامل

###### 1. تعديل عنصر البرمجة الجديد

####### اضغط على فئة "عناصر برمجة جديدة (My Blocks)".

####### اضغط زر الفأرة الأيمن على عنصر البرمجة الجديد "Petal".

####### اضغط على "تعديل (edit)".

###### 2. إضافة معامل الإدخال الرقمي

####### في نافذة التعديل، اضغط على "إضافة مدخلا رقم (add an input number)".

####### اضغط على الاسم الافتراضي "number" وغيرّه إلى "Petal side length".

####### اضغط على "موافق (OK)".

####### تطبيق المعاملات (Parameters)

######## عمل المعاملات كمتغيرات داخل عنصر البرمجة الجديد.

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

######## مثال: عنصر برمجة جديد لإنشاء مربع يحتوي على معامل إدخال رقمي لطول الجانب.

######### قيم إدخال مختلفة (مثل 200، 300، 600) للمعامل تنتج مربعات بأحجام مختلفة.

######### يتم استخدام نفس التعليمة البرمجية مع تغيير قيمة المعامل.

#### عناصر البرمجة الجديدة مع المعاملات

##### إضافة وتخصيص المعاملات

###### يمكن إضافة معامل واحد أو أكثر.

###### يمكن تخصيصها لتحديد:

####### شكل أو حجم الرسم.

####### اتجاه حركة روبوت الواقع الافتراضي.

####### المسافة التي يقطعها.

##### معالجة حالات المشكلات

###### تضمين العنصر الجديد في المقطع البرمجي الرئيس عدة مرات.

###### تمييز قيم الإدخال المعطاة للمعاملات في كل مرة.

##### مثال تطبيقي

###### عنصر "Petal" مع معامل إدخال هو طول جوانب شكل البتلة.

####### الاستخدام: لإنشاء أحجام مختلفة من الزهور أو الأوراق أو الفراشات.

#### إنشاء مقطع برمجي للزهور

##### الهدف

###### إنشاء مقطع برمجي يتحرك فيه روبوت الواقع الافتراضي ويرسم زهرة باستخدام عنصر البرمجة الجديد `Petal`

##### خطوات التنفيذ

###### 1. من فئة التحكم (Control)، أضف لبنة تكرار (repeat) ووضعها بعد لبنة "عندما بدأت (when started)".

###### 2. اضبط عدد مرات التكرار على 12.

###### 3. من فئة "عناصر برمجة جديدة (My blocks)"، أضف عنصر البرمجة الجديد `Petal` وأسقطه داخل لبنة التكرار 12 مرة.

###### 4. من فئة نظام الدفع (Drivetrain)، أضف لبنة انعطف (turn) ووضعها بعد عنصر البرمجة الجديد `Petal`.

###### 5. اضبط الانعطاف إلى 120 درجة.

#### نظام الدفع

##### أوامر التحكم الأساسية

###### تحرك إلى الأمام

###### تحرك إلى الأمام عدد 200 mm

###### انعطف يمين

###### انعطف يمين لمدة 90 درجة

###### انعطف لمواجهة 90 درجة

###### انعطف للدوران 90 درجة

###### أوقف القيادة

###### اضبط سرعة القيادة إلى 50 %

###### اضبط سرعة الانعطاف إلى 50 %

##### رسم الزهرة الكاملة

###### المقطع البرمجي الرئيس

####### عندما بدأت

####### تكرار 12 مرة:

######## استدعاء عنصر `Petal`

######## انعطف يمين لمدة 120 درجة

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

####### رسم زهرة مكونة من 12 بتلة باللون الأحمر في ملعب الفن قماش.

#### نافذة إنشاء/تعديل الكتلة

##### واجهة المستخدم

###### عنوان النافذة: "جعل كتلة" / "Make a Block"

###### معاينة الكتلة

####### تظهر اسم الكتلة ومعاملات الإدخال.

####### مؤشر رقمي (مثل 2، 3) فوق معامل الإدخال.

###### أزرار إضافة المدخلات

####### إضافة مدخلا رقم (Add an input number)

####### منطقية (Boolean)

####### إضافة تسمية (Add a label)

###### أزرار التنفيذ

####### موافق (OK)

####### إلغاء (Cancel)

##### أفضل ممارسة لتسمية المعاملات

###### يمكن كتابة اسم آخر لمعامل الإدخال.

###### من الجيد إعطاء اسم يصف فائدته (مثل: "طول جانب البتلة").

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

##### يظهر المعامل "Petal side length" كبنة عرض متغير في لبنة تعريف عنصر البرمجة الجديد "Petal".

##### خطوات وضع معامل الإدخال في المقطع البرمجي

###### 1. اضغط على لبنة معامل عرض المعامل "Petal side length" في لبنة تعريف (define)، وأفلتها على الموضع الأول الذي يوجد فيه الرقم 180.

###### 2. اضغط على لبنة معامل عرض المعامل "Petal side length" في لبنة تعريف (define)، وأفلتها على الموضع الثاني الذي يوجد فيه الرقم 180.

##### معلومة

###### يمكن إنشاء أكثر من مدخل رقمي إلى عنصر البرمجة الجديد باتباع نفس العملية وحسب الحاجة.

```

نقاط مهمة

• بعد إضافة معامل الإدخال "Petal side length"، يجب وضعه مكان القيم الثابتة (180 mm) في المقطع البرمجي للعنصر الجديد.
• يتم استخدام المعامل مرتين في مقطع "Petal" (مرة داخل كل حلقة تكرار)، لذا يجب وضعه في كلا الموضعين.
• العملية تتم بسحب وإفلات لبنة المعامل من منطقة التعريف إلى المكان المطلوب في الكود.

يظهر المعامل Petal side length كبنة عرض متغير في لبنة تعريف عنصر البرمجة الجديد Petal.

عليك وضع معامل الإدخال Petal side length في مكان الرقم الثابت 180 mm في المقطع البرمجي لعنصر البرمجة الجديد، ونظرًا لاستخدام طول الجانب مرتين في هذا المقطع البرمجي، ستضع لبنة معامل عرض المتغير في كلا الموضعين. المعامل في لبنة تعريف (define).

لوضع معامل إدخال في عنصر البرمجة الجديد:

اضغط على لبنة معامل عرض المعامل Petal side length في لبنة تعريف (define)، 1 وأفلتها على الموضع الأول الذي يوجد فيه الرقم 180. 2

اضغط على لبنة معامل عرض المعامل Petal side length في لبنة تعريف (define)، 3 وأفلتها على الموضع الثاني الذي يوجد فيه الرقم 180. 4

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

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

يظهر المعامل Petal side length كبنة عرض متغير في لبنة تعريف عنصر البرمجة الجديد Petal. عليك وضع معامل الإدخال Petal side length في مكان الرقم الثابت 180 mm في المقطع البرمجي لعنصر البرمجة الجديد، ونظرًا لاستخدام طول الجانب مرتين في هذا المقطع البرمجي، ستضع لبنة معامل عرض المتغير في كلا الموضعين. المعامل في لبنة تعريف (define). لوضع معامل إدخال في عنصر البرمجة الجديد: اضغط على لبنة معامل عرض المعامل Petal side length في لبنة تعريف (define)، 1 وأفلتها على الموضع الأول الذي يوجد فيه الرقم 180. 2 اضغط على لبنة معامل عرض المعامل Petal side length في لبنة تعريف (define)، 3 وأفلتها على الموضع الثاني الذي يوجد فيه الرقم 180. 4 --- SECTION: معلومة --- يمكنك إنشاء أكثر من مدخل رقمي إلى عنصر البرمجة الجديد باتباع نفس العملية وحسب الحاجة. وزارة التعليم Ministry of Education 2025 - 1447 383 --- VISUAL CONTEXT --- **DIAGRAM**: Untitled Description: A diagram illustrating a programming block structure. It starts with a 'تعريف Petal side length' (Define Petal side length) block. This is followed by three sequential blocks: 'اضبط القلم على اللون أحمر' (Set pen color to red), 'اضبط القلم على العرض نحيف للغاية' (Set pen width to very thin), and 'نقل القلم أسفل' (Pen down). Below these, there is a 'تكرار 3' (Repeat 3) loop block. Inside this loop, there are two blocks: 'تحرك إلى الأمام عدد 180 mm' (Move forward 180 mm) and 'انعطف يمين لمدة 30 درجة' (Turn right for 30 degrees). After this loop, there is an 'انعطف يمين لمدة 90 درجة' (Turn right for 90 degrees) block. This is followed by another 'تكرار 3' (Repeat 3) loop. Inside this second loop, there are again two blocks: 'تحرك إلى الأمام عدد 180 mm' (Move forward 180 mm) and 'انعطف يمين لمدة 30 درجة' (Turn right for 30 degrees). Key Values: Petal side length, 180 mm, 30 درجة, 90 درجة, تكرار 3 Context: This diagram serves as a visual example of a programming sequence, demonstrating how different blocks are nested and executed. **DIAGRAM**: Untitled Description: A diagram illustrating a programming block structure with four numbered pointers indicating specific locations. The diagram shows a 'تعريف Petal' (Define Petal) block at the top, which contains a 'Petal side length' block (Pointer 1). Below this, there are blocks for setting pen color, width, and pen down. A 'تكرار 3' (Repeat 3) loop follows. Inside this loop, there is a 'تحرك إلى الأمام عدد' (Move forward number) block, which has a 'Petal side length' block (Pointer 2) nested within it, followed by an 'انعطف يمين لمدة 30 درجة' (Turn right for 30 degrees) block. After this loop, there is an 'انعطف يمين لمدة 90 درجة' (Turn right for 90 degrees) block. This is followed by another 'تكرار 3' (Repeat 3) loop. Inside this second loop, there is a 'تحرك إلى الأمام عدد' (Move forward number) block, which has a 'Petal side length' block (Pointer 4) nested within it, followed by an 'انعطف يمين لمدة 30 درجة' (Turn right for 30 degrees) block. Pointer 3 is shown as a 'Petal side length' block that is meant to be dragged and dropped. Key Values: Petal side length, 30 درجة, 90 درجة, تكرار 3 Context: This diagram is used in conjunction with the instructions to show where the 'Petal side length' variable block should be placed within the programming structure.