Callisto

كاليستو خفيفة الوزن وقوية؟ يدمج هذا البرمجة النصية Luajit في Delphi ، مما يتيح لك إضافة طبقة برمجة إلى تطبيقات Delphi بسهولة. سواء كنت تقوم ببناء برامج ديناميكية أو إضافة دعم وزارة الدفاع أو ببساطة تبحث عن طريقة لجعل تطبيقاتك أكثر مرونة وقابلة للتخصيص ، فإن Callisto يجعل هذا ممكنًا من خلال واجهات برمجة التطبيقات البسيطة المباشرة.

؟ جدول المحتويات

• مقدمة
• الميزات الرئيسية
• ؟ الاستخدامات المحتملة
• ابدء
• ؟ تثبيت
• ؟ أمثلة الاستخدام
• ميزات متقدمة
• نظرة عامة على API
• ؟ المساهمة
• رخصة

مقدمة

يقدم Callisto جسرًا؟ بين Delphi و Luajit ، يوفران حلاً نصفيًا قويًا لتوسيع قدرات مشاريع Delphi الخاصة بك. مع Callisto ، يمكن لمطوري Delphi الاستمتاع بجميع فوائد تضمين لغة سينمائية ديناميكية وسريعة ، وسهلة الاستخدام مثل Lua ، مع الاستفادة من Luajit للأداء العالي؟ ️.

تم تصميم هذه المكتبة لجعل دمج LUA في تطبيقات Delphi سلسة قدر الإمكان ، مع التركيز على قابلية الاستخدام ، والكفاءة ، وحد من منحنى التعلم؟ يتم تجميع جميع التبعيات مباشرة في القابل للتنفيذ ، مما يلغي الحاجة إلى DLL خارجية وجعل النشر أكثر بساطة وأكثر موثوقية ✅.

الميزات الرئيسية

• Bazing Fast Performance ⚡: مبني على Luajit ، يوفر Callisto سرعة استثنائية ، مما يجعله مناسبًا للتطبيقات المهمة للأداء.
• واجهات برمجة التطبيقات البسيطة : API سهلة الاستخدام لتسجيل إجراءات Delphi وتنفيذ البرامج النصية LUA.
• قابلية التشغيل البيني غير الملحومة : تمرير البيانات دون عناء بين بيئات Delphi و Lua.
• التصحيح التفاعلي ؟: استخدم dbg() في البرامج النصية LUA الخاصة بك لبدء تصحيح التصحيح التفاعلي.
• التسجيل الروتيني المخصص ➕: بسهولة إضافة إجراءات مخصصة في Delphi التي يمكن أن تتصل بها البرامج النصية Lua.
• الحد الأدنى من الإعداد : لا يتطلب سوى بضعة أسطر من التعليمات البرمجية للبدء.
• استيراد البرنامج النصي وتجميعه ؟: استخدم أمر import مخصص لدمج البرامج النصية ، وتجميعها في ملف واحد ، وقم بتخزينها اختياريًا كمورد EXE لتطبيق مستقل تمامًا.
• لا تبعيات خارجية ؟: يتم تجميع جميع التبعيات مباشرة في EXE ، لذلك لا توجد DLL خارجية للحفاظ عليها.
• دعم FFI ؟: بالإضافة إلى التسجيل الروتيني المخصص الذي توفره فئة Tcallisto ، يمكنك الاستفادة من واجهة الوظيفة الأجنبية القوية لـ Luajit (FFI). يتيح هذا البرامج النصية استدعاء الإجراءات التي تم تصديرها مباشرة من EXE الحالي أو أي DLL المحملة ، مما يتيح تكاملًا سلسًا مع مكتبات Delphi الحالية والوحدات الخارجية.

الاستخدامات المحتملة

• إضافة دعم تعديل : عزز تطبيقاتك من خلال السماح للمستخدمين بإنشاء تعديل.
• سير العمل الديناميكي : قم بإنشاء سير عمل مرن مع منطق الأعمال القابل للسيناريو.
• مرونة وقت التشغيل ⏱: إلغاء تحميل منطق البرامج النصية LUA لتعديل السلوك في وقت التشغيل.
• تطوير اللعبة ؟: بناء ألعاب أو محركات محاكاة مع طبقة نصية قوية.

ابدء

سيساعدك هذا القسم على رفع Callisto وتشغيله في بيئة Delphi الخاصة بك.

المتطلبات الأساسية

• Delphi 12 CE أو أعلى
• Windows 10 أو أعلى ؟
• تم اختباره على نظام التشغيل Windows 11 64 بت (24H2) ، Delphi 12.2 ✅

تثبيت

1. استنساخ أو تنزيل مستودع Callisto.

2. أضف ملفات مصدر Callisto إلى مشروع Delphi الخاص بك.

3. ؟ قم بتنزيل أحدث إصدار من Callisto.

4. استخراج محتويات دليل المشروع الخاص بك.

5. ➕ أضف مجلد Callisto src إلى مسار مكتبتك في دلفي.

6. في مشروعك ، قم بتضمين Callisto في شرط uses .

7. ؟ ارجع إلى مجلد examples للحصول على تعليمات الاستخدام التفصيلية وعروض مكتبة PSFML أثناء العمل.

هذا كل شيء! يجب أن تكون قادرًا الآن على بدء البرمجة النصية مع Lua في مشاريع Delphi الخاصة بك.

أمثلة الاستخدام

فيما يلي بعض الأمثلة البسيطة لإظهار كيفية دمج Callisto في مشروع Delphi الخاص بك:

تحميل وتشغيل البرامج النصية لوا؟

 var
  LCallisto: TCallisto;
begin
  LCallisto := TCallisto.Create();
  LCallisto.LoadString( ' print("Hello from Lua!") ' );
  LCallisto.Free();
end ;

تسجيل روتين دلفي لاستخدامه في لوا؟

 class procedure TMyClass.DelphiRoutine ( const ALua: ICallistoContext);
begin
  // Example routine that pushes a string result onto Lua stack
  ACallisto.PushValue( ' Hello from Delphi! ' );
end ;

var
  LCallisto: TCallisto;
begin
  LCallisto := Callisto.Create();
  LCallisto.RegisterRoutine( ' DelphiRoutine ' , TMyClass.MyDelphiRoutine);
  LCallisto.LoadString( ' DelphiRoutine() ' );
  LCallisto.Free();
end ;

استدعاء وظائف لوا من دلفي؟

 var
  LCallisto: TCallisto;
  LResult: TCallistoValue;
begin
  LCallisto := TCallisto.Create();
  LCallisto.LoadString( ' function greet() return "Hello from Lua!" end ' );
  LResult := LCallisto.Call( ' greet ' , []);
  ShowMessage(LResult.AsString);  
  LCallisto.Free();
end ;

ميزات متقدمة

يدعم Callisto أيضًا ميزات متقدمة مثل:

• تصحيح التصحيح التفاعلي ؟: إضافة dbg() في رمز LUA لبدء تصحيح الأخطاء ، مفيدة لتحديد المشكلات أثناء وقت التشغيل.
• استيراد البرنامج النصي : استخدم import لتجميع ملفات البرنامج النصي المختلفة في وحدة تجميع واحدة ، وهو أمر مفيد لحفظ البرامج النصية المترجمة وتحميلها كموارد.
• تجميع Bytecode ؟: ترجمة البرامج النصية LUA إلى Bytecode باستخدام CompileToStream() ، مما يسمح بالتغليف والتوزيع الفعال.

نظرة عامة على API

تم تصميم API Callisto لتكون قوية وسهلة الاستخدام. فيما يلي إشارة سريعة إلى فئات وأساليب المفاتيح:

tcallisto؟

• إنشاء/تدمير : إدارة دورة حياة مثيل LUA.
• LoadStream/LoadString/Loadfile ؟: تحميل البرامج النصية Lua من مصادر مختلفة.
• يجري ▶ : تنفيذ البرنامج النصي المحمّل.
• اتصل ؟: استدعاء وظيفة لوا من دلفي.
• registerRoutine ➕: سجل روتين Delphi ليكون قابلاً للاتصال من Lua.

icallistocontext

• PushValue/getValue : دفع القيم إلى أو الحصول على قيم من مكدس LUA.
• Clearstack/popstack ؟ ️: إدارة حالات المكدس بشكل فعال.
• SettableFieldValue/GetTableFieldValue ؟: Access والتلاعب جداول Lua.

وسائط

البودكاست الغوص العميق

استكشف المناقشة المتعمقة حول Callisto وميزاته وحالات الاستخدام.

Callisto-lua-scripting-for delph.mp4

المساهمة

يتم تشجيع المساهمات إلى Callisto بشدة. لا تتردد في تقديم المشكلات ، أو اقتراح ميزات جديدة ، أو إنشاء طلبات سحب لتوسيع إمكانيات وقوة محرك البرمجة النصية.

رخصة

يتم توزيع Callisto تحت؟ ترخيص BSD-3-CASE ، مما يسمح بإعادة التوزيع والاستخدام في كل من النماذج المصدر والثنائية ، مع أو بدون تعديل ، في ظل ظروف محددة. انظر ملف الترخيص لمزيد من التفاصيل.

يدعم

• مشاكل
• المناقشات
• لوجيت
• تعلم دلفي

---

نأمل أن يساعد Callisto في جعل مشاريع Delphi أكثر ديناميكية ومرونة. ترميز سعيد! ؟

مصنوع من ❤ في دلفي