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

📚 المعاملات (Parameters)

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

المعاملات (Parameters): متغيرات داخل عنصر البرمجة الجديد (My Block) تستخدم معامل إدخال واحد أو أكثر بدلاً من القيم الثابتة في وحدات البرامج (Module Programs).

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

```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)

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

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

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

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

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

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

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

```

نقاط مهمة

• إضافة معاملات الإدخال (Input Parameters) لوحدات البرامج (Module Programs) هي طريقة للاستفادة من ميزة البرمجة التركيبية.
• الهدف من المعاملات هو إنشاء وحدات برامج قابلة للتأقلم على أكثر من مشكلة، بدلاً من استخدام قيم ثابتة.
• مثال تطبيقي: عنصر برمجة جديد لرسم مربع، إذا احتوى على معامل إدخال رقمي لطول الجانب، يمكن استخدامه لرسم مربعات بأحجام مختلفة (مثل 200، 300، 600) باستخدام نفس الكود.

المعاملات (Parameters)

للاستفادة من ميزة البرمجة التركيبية، عليك إضافة معاملات الإدخال (Input Parameters) في وحدات البرامج (Module Programs). تعمل المعاملات (Parameters) كمتغيرات داخل عنصر البرمجة الجديد باستخدام معامل إدخال واحد أو أكثر بدلاً من القيم الثابتة في وحدات البرامج. يمكنك إنشاء وحدات قابلة للتأقلم على أكثر من مشكلة.

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

قيم الإدخال: 200، 300، 600 المعامل: طول الجانب وحدة البرنامج: مربع

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

المعاملات (Parameters) للاستفادة من ميزة البرمجة التركيبية، عليك إضافة معاملات الإدخال (Input Parameters) في وحدات البرامج (Module Programs). تعمل المعاملات (Parameters) كمتغيرات داخل عنصر البرمجة الجديد باستخدام معامل إدخال واحد أو أكثر بدلاً من القيم الثابتة في وحدات البرامج. يمكنك إنشاء وحدات قابلة للتأقلم على أكثر من مشكلة. على سبيل المثال، إذا أنشأت عنصر برمجة جديدة الذي ينشئ مربعًا ويحتوي على معامل إدخال رقمي (numeric input parameter) طول جانب المربع، فستتمكن من إنشاء مربعات مختلفة الحجم، باستخدام نفس التعليمة البرمجية وإعطاء قيم إدخال مختلفة لهذا المعامل. قيم الإدخال: 200، 300، 600 المعامل: طول الجانب وحدة البرنامج: مربع وزارة التعليم Ministry of Education 2025 - 1447 376 --- VISUAL CONTEXT --- **DIAGRAM**: Untitled Description: A set of three blue rounded rectangular boxes, stacked vertically, illustrating input parameters for a program. The top box contains 'قيم الإدخال: 200، 300، 600' (Input Values: 200, 300, 600). The middle box contains 'المعامل: طول الجانب' (Parameter: Side Length). The bottom box contains 'وحدة البرنامج: مربع' (Program Unit: Square). Key Values: Input Values: 200, 300, 600, Parameter: Side Length, Program Unit: Square Context: Illustrates the concept of defining input parameters for a program to control its output, specifically for drawing squares of different sizes. **DIAGRAM**: 200 Description: A small green square outline, labeled with 'جانب' (side) below it. An arrow points from the number '200' down to the square, indicating that 200 is the input parameter for its side length. This square is the smallest of the three conceptual squares. Key Values: side length: 200 units (conceptual) Context: Illustrates the output (a small square) when the program receives an input parameter of 200 for the side length. **DIAGRAM**: 300 Description: A medium-sized green square outline, larger than the '200' square, labeled with 'جانب' (side) below it. An arrow points from the number '300' down to the square, indicating that 300 is the input parameter for its side length. Key Values: side length: 300 units (conceptual) Context: Illustrates the output (a medium square) when the program receives an input parameter of 300 for the side length. **DIAGRAM**: 600 Description: A large green square outline, significantly larger than the '300' square, labeled with 'جانب' (side) below it. An arrow points from the number '600' down to the square, indicating that 600 is the input parameter for its side length. This square is the largest of the three conceptual squares. Key Values: side length: 600 units (conceptual) Context: Illustrates the output (a large square) when the program receives an input parameter of 600 for the side length. **IMAGE**: Untitled Description: A 3D rendering of a VEX robot on a white grid-patterned floor. The robot is dark grey and orange, positioned slightly to the right of the center. It has drawn two green square outlines on the grid. The inner square is smaller, and the outer square is larger, sharing a common corner with the inner square. The robot is positioned at the bottom-right corner of the inner square, facing right. The grid extends to the edges of the image, with 'VEX' logos visible on vertical panels along the left and top edges of the simulated environment. The perspective is slightly from above and to the right. Context: Visually demonstrates the VEX robot executing a program to draw squares of different sizes, reinforcing the concept of using parameters to control output, as described in the text. The two squares drawn illustrate two different parameter inputs.