تثبيت المكتبة القياسية باي جايم (pygame) - كتاب المهارات الرقمية - الصف 9 - الفصل 1 - المملكة العربية السعودية

📚 بدء استخدام نموذج بايثون برمجي

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

نموذج pygame: نموذج برمجي (مكتبة قياسية) لإنشاء أشكال هندسية على الشاشة.

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

```markmap

المكتبات والنماذج البرمجية في بايثون

مفهوم النموذج البرمجي

تعريف

• حزمة ملفات تحتوي مقاطع برمجية
• امتدادها .py
• يتم استيرادها لتنفيذ وظائف

مصادر النماذج

المكتبة القياسية (Standard library)

#### تعريف

• تُثبَّت تلقائياً مع بايثون
• جزء أساسي من اللغة
• تحتوي على أكثر من 200 نموذج برمجي

#### طرق الاستيراد

##### 1. استيراد الكل

• الأمر: `from module_name import *`

##### 2. استيراد دوال من نموذج برمجي

• الأمر: `from module_name import function_a, function_b, function_c`

##### 3. استيراد النماذج البرمجية

• الأمر: `import module_name`

##### أمثلة على نماذجها

###### math

• الهدف: الوصول إلى دوال وثوابت رياضية شائعة
• طريقة الاستيراد: `import math`
• أمثلة على استخدامه:

- الدوال الأكبتان (التقريب)

- `math.ceil(x)`: تقريب الرقم `x` إلى أقرب عدد صحيح أكبر (السقف).

- مثال: `math.ceil(10.1657)` ← 11

- `math.floor(x)`: تقريب الرقم `x` إلى أقرب عدد صحيح أصغر (الأرضية).

- مثال: `math.floor(10.1657)` ← 10

- مثال مع الأرقام السالبة: `math.floor(-10.1657)` ← -11

###### tkinter

• الهدف: إنشاء واجهات رسومية (GUI).
• طريقة الاستيراد: `from tkinter import *` (حالة نموذجية لاستيراد الكل بسبب كثرة الدوال المستخدمة).
• خطوات إنشاء نافذة أساسية:

1. `window = Tk()`: إنشاء كائن النافذة.

2. `window.title("عنوان")`: تحديد عنوان النافذة.

3. `window.geometry("عرضxارتفاع")`: تحديد حجم النافذة.

4. `window.mainloop()`: إبقاء النافذة مفتوحة.

###### time

• الهدف: توفير دوال للعمل مع الأوقات.
• طريقة الاستيراد: `import time`
• أمثلة على استخدامه:

- معرفة الوقت بالساعة والدقيقة (تنسيق 24 ساعة) واليوم من الأسبوع وما إذا كان صباحًا أم مساءً.

- الأمر: `print(time.strftime("%H:%M"), time.strftime("%A %p"))`

- مثال على المخرجات: `10:49 Wednesday AM`

###### datetime

• الهدف: التعامل مع التواريخ والوقت بكثرة في البرامج المختلفة.
• طريقة الاستيراد: `import datetime`
• أمثلة على استخدامه:

- معرفة تاريخ اليوم.

- الأمر: `print(datetime.date.today())`

- مثال على المخرجات: `2023-11-15`

- يمكن استخراج السنة والشهر واليوم من التاريخ.

- استخدام سمة (Attribute) الدالة:

- الصيغة العامة: `module_name.function_name().attribute_name`

- مثال لاستخراج اليوم: `datetime.date.today().day`

- مثال لاستخراج الشهر: `datetime.date.today().month`

- مثال لاستخراج السنة: `datetime.date.today().year`

- حساب الأيام المتبقية لحدث (مثال: يوم التأسيس):

1. استيراد `date` من `datetime`.

2. الحصول على تاريخ اليوم: `today = date.today()`.

3. تحديد تاريخ الحدث: `foundationDay = date(today.year, 2, 22)`.

4. التحقق إذا مضى الحدث هذا العام باستخدام `date.replace()`:

- `if foundationDay < today: foundationDay = foundationDay.replace(year=today.year + 1)`

5. حساب الفرق بالأيام: `time_to_foundationDay = foundationDay - today`.

6. طباعة النتيجة: `print("Days left:", time_to_foundationDay.days)`.

###### pygame

• الهدف: استخدام النموذج لإنشاء أشكال هندسية على الشاشة.
• خطوات التثبيت في PyCharm:

1. الضغط على Packages (الحزم).

2. كتابة باي جايم (pygame) في شريط البحث.

3. اختيار pygame والضغط على Install (تثبيت).

4. ظهور رسالة تؤكد اكتمال التثبيت.

مميزات إنشاء المقطع البرمجي الخاص

• يلائم احتياجاتك الحقيقية
• التحكم الكامل والقدرة على التصحيح والتغيير الفوري
• أكثر موثوقية (معلومات التوثيق في النماذج الخارجية قد تكون غير كافية أو غير صحيحة)
• تجنب مشكلة توقف التحديثات إذا توقف المطور الأصلي
• تجنب التكلفة العالية أو القيود على ترخيص النماذج الخارجية

مدير حزم بايثون (PIP)

دوره

• تثبيت حزم غير متوفرة في المكتبة القياسية

فهرس حزمة بايثون (PyPI)

• مستودع برامج خاص ببايثون
• موقع افتراضي للبحث عن الحزم
• يستضيف الحزم التي يساهم بها المجتمع

طريقة التثبيت

• الأمر: `install`
• مثال: تثبيت حزمة `pygame` (مكتبة مفتوحة المصدر لإنشاء تطبيقات الوسائط المتعددة والألعاب)

الحزمة

• تحتوي على جميع الملفات المطلوبة في النموذج البرمجي

```

نقاط مهمة

• قبل استخدام مكتبة `pygame` في PyCharm، يجب تثبيتها أولاً.
• يمكن أن يكون للمكتبة القياسية والنموذج البرمجي نفس الاسم (مثل `pygame`).
• خطوات تثبيت `pygame` في PyCharm هي: فتح Packages، ثم البحث عن `pygame`، ثم اختياره والضغط على Install.

بدء استخدام نموذج بايثون برمجي

سترى الآن كيف يمكنك استخدام نموذج pygame لإنشاء أشكال هندسية على الشاشة. قبل استخدام المكتبة القياسية pygame في باي تشارم (PyCharm)، يجب عليك تثبيت المكتبة القياسية pygame.

تثبيت المكتبة القياسية باي جايم (pygame)

في نافذة PyCharm (باي تشارم)، اضغط على Packages (الحزم).

اكتب (باي جايم) في شريط البحث.

اختر pygame (باي جايم)، واضغط على Install (تثبيت).

ستظهر رسالة تخبرك بأن التثبيت قد اكتمل.

في بعض الأحيان يمكن أن يكون للمكتبة القياسية والنموذج البرمجي نفس الاسم.

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

164

بدء استخدام نموذج بايثون برمجي سترى الآن كيف يمكنك استخدام نموذج pygame لإنشاء أشكال هندسية على الشاشة. قبل استخدام المكتبة القياسية pygame في باي تشارم (PyCharm)، يجب عليك تثبيت المكتبة القياسية pygame. --- SECTION: تثبيت المكتبة القياسية باي جايم (pygame) --- تثبيت المكتبة القياسية باي جايم (pygame) في نافذة PyCharm (باي تشارم)، اضغط على Packages (الحزم). اكتب (باي جايم) في شريط البحث. اختر pygame (باي جايم)، واضغط على Install (تثبيت). ستظهر رسالة تخبرك بأن التثبيت قد اكتمل. في بعض الأحيان يمكن أن يكون للمكتبة القياسية والنموذج البرمجي نفس الاسم. وزارة التعليم Ministry of Education 2025 - 1447 164 --- VISUAL CONTEXT --- **DIAGRAM**: Untitled Description: Screenshot of the PyCharm IDE. The 'Python Packages' section is visible on the left, with a search bar showing 'pygame' entered. Below the search bar, 'pygame' is listed as an installed package (155 found). A section labeled 'pygame' is highlighted in the main window, showing details like build status, version, license, and a description of pygame as a free and open-source cross-platform library. A numbered step '1' points to the 'Packages' section, '2' points to the search bar, and '3' points to the listed 'pygame' package. Context: Illustrates the process of searching for and identifying the pygame package within the PyCharm IDE. **DIAGRAM**: Untitled Description: Screenshot of the PyCharm IDE, continuing from the previous view. The 'pygame' package details are shown in the main window. A button labeled 'Install' is visible on the right side of the package details section, indicated by the number '4'. Below the package details, a notification box with an information icon states 'Packages installed successfully' and 'Installed packages: 'pygame'', indicated by the number '5'. Context: Shows the final step of installing pygame and the confirmation message indicating successful installation.