SDL2 for Pascal

SDL2-for-pascal

ملفات الوحدة لإنشاء تطبيقات Pascal / Delphi المجانية باستخدام مكتبة SDL2.

يعد مستودع SDL2-For-Pascal شوكة تم صيانتها في المجتمع لمستودع Pascal-SDL-2 Headers.

تثبيت

ما عليك سوى إضافة الوحدات إلى مسار تضمينك. يمكنك تحقيق ذلك من خلال:

• (FPC) باستخدام التوجيه {$UNITPATH XXX} في رمز المصدر الخاص بك ؛
• (FPC) باستخدام وسيطة سطر الأوامر -FuXXX إلى المترجم ؛
• مجرد نسخ ولصق الوحدات في نفس الدليل مثل رمز المصدر الرئيسي الخاص بك.

استخدم وحدة sdl2 لمكتبة SDL2 الرئيسية (يجب أن تكون هناك حاجة دائمًا). يتم توفير وحدات لمكتبات SDL2 الأخرى:

• sdl2_gfx
• sdl2_image
• sdl2_mixer
• sdl2_net
• sdl2_ttf

الوثائق

الوثائق الرسمية SDL2-For-Pascal

موارد أخرى

باسكال مجاني يلتقي SDL

PGD SDL2 منتدى

الأخطاء / المساهمات / تودوس

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

تودوس

• (باستمرار) تحديث الملفات حسب وظائف وأنواع SDL2 الجديدة الموجودة في إصدارات SDL2 الحديثة.
• (ATM باستمرار.) ترجمة الأسماء المستعارة الصحيح إلى التعدادات المكتوبة. انظر الجزء التعدادات على ورقة الغش للرجوع إليها.
• (باستمرار) تحسين التوافق Delphi (والأهم من ذلك ، لا تكسرها)
• (باستمرار) تكييف التعليقات مع تنسيق pasdoc. (انظر العدد رقم 22)

إرشادات نمط الكود

المبدأ الرئيسي هو البقاء ضيقًا قدر الإمكان في الأسماء في رؤوس C. تهدف هذه الإرشادات إلى الحصول على تناسق أفضل في هذا المشروع المجتمعي وتسهيل العثور على أجزاء رمز معينة في رؤوس C/Pascal تشملها. لا تتردد في مناقشة هذه الإرشادات أو تمديدها ، واستخدم تعقب القضية.

1. لا يتم تعديل أسماء C (الثوابت) ومعلمات الوظيفة أو "pascalified" على سبيل المثال: SDL_INIT_VIDEO لا تتغير إلى SDLInitVideo .

2. يتم الاحتفاظ بالأسماء المقابلة للكلمات الرئيسية المحجوزة ويتم إضافة السطح السفلي. على سبيل المثال: type في C Function SDL_HasEvent(Uint32 type) يتغير إلى type_ في وظيفة pascal SDL_HasEvent(type_: TSDL_EventType) .

3. استخدم أنواع البيانات C مثل cuint8 و cuint16 cuint32 cint8 و cint16 و cint32 و cfloat وما إلى ذلك إذا تم استخدام أنواع بيانات C الأصلية في الكود الأصلي. ملاحظة: بالنسبة لـ FPC ، تحتاج إلى إضافة وحدة ctypes لاستخدام أنواع بيانات C هذه. بالنسبة إلى دلفي ، لدينا حل مؤقت. (انظر العدد رقم 67)

مثال: استخدم cuint32 (إذا تم استخدام Uint32 في الكود الأصلي) بدلاً من UInt32 أو Cardinal أو LongWord أو DWord . الاستثناء: استبدال *char بواسطة PAnsiChar ! (انظر العدد رقم 26)

تلميح: استخدم TSDL_Bool لترجمة SDL_bool . لوظائف الماكرو استخدام Boolean . (انظر العدد رقم 30).

4. إذا اختفى معرف أو إعلان وظيفي ، فاحرص على deprecated . (انظر العدد رقم 34)

5. للراحة ، نشجع على إضافة مؤشرات واحدة ومزدوجة لأي نوع من أنواع SDL. (انظر العدد رقم 105)

6. إلقاء نظرة على ورقة غش الترجمة لدينا للرجوع إليها.

الإصدارات

تشير علامة الإصدار (انظر العلامات) إلى إصدار حزمة الترجمة هذه SDL2 لـ Pascal ، وليس SDL2 library .

v2.x (العمل قيد التقدم)

• تحديث sdlthreads.inc
• أضف إطار الاختبار (FPTEST)

v2.2 مستقر (02/01/2024)

• وحدة SDL2 محدثة مع إصدار 2.0.14 على الأقل من SDL2 library
• تم استبدال العديد من الأسماء المستعارة بالعدوى المكتوبة
• أضف مؤشرات واحدة ومزدوجة لجميع الأنواع (شكرًا لبرمجة الغضب)
• تحديث SDL_TTF.PAS إلى أحدث الإصدار 2.21.0
• استبدل أنواع البيانات بأنواع البيانات C (انظر PR #29)
• أضف بنية المجلد (انظر العلاقات العامة رقم 27)
• العديد من بوتوكس

الإصدار V2.1 التوافق (25/09/2021)

• يحتوي هذا الإصدار على جميع الالتزامات حتى تغيير هيكل مجلد المشروع (انظر PR #27). قارن بين التصنيف في العدد رقم 22.
• قد يؤدي نقل الوحدات إلى موقع جديد (1) إلى رفع صعوبات في ارتكاب تغييرات جديدة إذا بدأ الفرع قبل و (2) إجراء تحديثات لمسارات أبحاث المشروع اللازمة.
• تحديثات SDL2_Mixer و SDL2_IMAGE و SDL2_TTF وبعضها يتضمن الملفات
• تقديم أنواع نقطة التعويم
• bugfixes

v2.0

• أول إصدار رسمي من شوكة مجتمع PGD من Pascal-SDL-2 Headers
  • أحدث إصدار من GIT هو 1.72 ، في SDL2.PAS ، يصل إلى الإصدار 1.80 ؛ وبالتالي ، فإن البدء بـ V2.0 لهذا الشوكة هو تمييز شديد
• هذه حزمة احتياطية متوافقة ومستقرة للغاية Delphi
• بشكل فضفاض محدث مع الإصدار 2.0.4 من SDL2 library

رخصة

يمكنك ترخيص وحدات Pascal SDL2 إما باستخدام ترخيص MPL أو مع ترخيص ZLIB.