Unduh Callisto - Unduh Kode Sumber Callisto

Callisto

Kode sumber Delphi

1.0.0

Unduh

PLUS

Callisto ringan dan kuat? Itu mengintegrasikan skrip Luajit ke dalam Delphi, memungkinkan Anda untuk dengan mudah menambahkan lapisan skrip ke aplikasi Delphi Anda. Apakah Anda sedang membangun perangkat lunak yang dinamis, menambahkan dukungan mod, atau hanya mencari cara untuk membuat aplikasi Anda lebih fleksibel dan dapat disesuaikan, Callisto memungkinkan ini melalui API sederhana dan langsung.

? Daftar isi

Perkenalan
Fitur utama
? Penggunaan potensial
Memulai
? Instalasi
? Contoh penggunaan
Fitur canggih
Tinjauan API
? Berkontribusi
Lisensi

Perkenalan

Callisto menawarkan jembatan? Antara Delphi dan Luajit, memberikan solusi skrip yang kuat untuk memperluas kemampuan proyek Delphi Anda. Dengan Callisto, pengembang Delphi dapat menikmati semua manfaat dari menanamkan bahasa skrip yang dinamis, cepat ⚡, dan mudah digunakan seperti Lua, sambil memanfaatkan Luajit untuk kinerja tinggi? ️.

Perpustakaan ini dirancang untuk membuat mengintegrasikan LUA ke dalam aplikasi Delphi semulus mungkin, dengan fokus pada kegunaan, efisiensi, dan kurva pembelajaran minimal? Semua dependensi dikompilasi langsung ke dalam yang dapat dieksekusi, menghilangkan kebutuhan akan DLL eksternal dan membuat penyebaran lebih sederhana dan lebih dapat diandalkan ✅.

Fitur utama

Performa cepat Blazing ⚡: Dibangun di atas Luajit, Callisto memberikan kecepatan yang luar biasa, membuatnya cocok untuk aplikasi kinerja-kritis.
API Sederhana : API yang mudah digunakan untuk mendaftarkan rutinitas Delphi dan menjalankan skrip LUA.
Interoperabilitas yang mulus : dengan mudah meneruskan data antara lingkungan Delphi dan Lua.
Debugging Interaktif ?: Gunakan dbg() dalam skrip LUA Anda untuk memulai debugging interaktif.
Pendaftaran Rutin Kustom ➕: Mudah menambahkan rutinitas khusus di Delphi yang dapat dihubungi oleh skrip LUA.
Pengaturan Minimal : Hanya membutuhkan beberapa baris kode untuk memulai.
Script Importing and Bundling ?: Gunakan perintah import khusus untuk menggabungkan skrip, menyusunnya menjadi satu file, dan secara opsional menyimpannya sebagai sumber daya EXE untuk aplikasi yang sepenuhnya mandiri.
Tidak ada dependensi eksternal ?: Semua dependensi dikompilasi langsung ke EXE, jadi tidak ada DLL eksternal untuk dipertahankan.
Dukungan FFI ?: Selain pendaftaran rutin khusus yang disediakan oleh kelas Tcallisto, Anda dapat memanfaatkan antarmuka fungsi asing Luajit yang kuat (FFI). Ini memungkinkan skrip untuk memanggil rutinitas yang diekspor langsung dari EXE saat ini atau DLL yang dimuat, memungkinkan integrasi tanpa batas dengan perpustakaan Delphi yang ada dan modul eksternal.

Penggunaan potensial

Tambahkan Dukungan Modding : Tingkatkan aplikasi Anda dengan memungkinkan pengguna membuat mod.
Alur kerja dinamis : Buat alur kerja yang fleksibel dengan logika bisnis yang dapat ditulis.
Runtime Fleksibilitas ⏱️: Logika Offload ke skrip LUA untuk memodifikasi perilaku saat runtime.
Pengembangan Game ?: Bangun game atau mesin simulasi dengan lapisan skrip yang kuat.

Memulai

Bagian ini akan membantu Anda mendapatkan Callisto dan berjalan di lingkungan Delphi Anda.

Prasyarat

Delphi 12 CE atau lebih tinggi
Windows 10 atau lebih tinggi ?
Diuji pada Windows 11 64-bit (24H2), Delphi 12.2 ✅

Instalasi

Klon atau unduh repositori Callisto.
Tambahkan file sumber Callisto ke proyek Delphi Anda.
? Unduh versi terbaru Callisto.
Ekstrak isinya ke direktori proyek Anda.
➕ Tambahkan folder Callisto src ke jalur perpustakaan Anda di Delphi.
Dalam proyek Anda, sertakan Callisto dalam klausa uses .
? Lihat Folder examples untuk instruksi penggunaan terperinci dan demonstrasi pustaka PSFML beraksi.

Itu saja! Anda sekarang harus dapat memulai skrip dengan Lua di proyek Delphi Anda.

Contoh penggunaan

Berikut adalah beberapa contoh sederhana untuk menunjukkan cara mengintegrasikan Callisto ke dalam proyek Delphi Anda:

Memuat dan menjalankan skrip LUA?

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

Mendaftarkan rutinitas Delphi untuk digunakan di LUA?

 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 ;

Memanggil Lua Fungsi dari Delphi?

 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 ;

Fitur canggih

Callisto juga mendukung fitur canggih seperti:

Debugging Interaktif ?: Tambahkan dbg() dalam kode LUA untuk memulai debugging, berguna untuk mengidentifikasi masalah selama runtime.
Impor skrip : Gunakan import untuk menggabungkan berbagai file skrip ke dalam satu unit kompilasi tunggal, yang berguna untuk menyimpan dan memuat skrip yang dikompilasi sebagai sumber daya.
Kompilasi Bytecode ?: Kompilasi skrip LUA ke bytecode menggunakan CompileToStream() , memungkinkan pengemasan dan distribusi yang efisien.

Tinjauan API

Callisto API telah dirancang untuk menjadi kuat dan mudah digunakan. Di bawah ini adalah referensi cepat untuk kelas dan metode utama:

Tcallisto?

Buat/Hancurkan : Kelola siklus hidup instance Lua.
LoadStream/LoadString/LoadFile ?: Muat skrip LUA dari berbagai sumber.
Berlari ▶ ️ : Jalankan skrip yang dimuat.
PANGGILAN ?: Panggil fungsi LUA dari Delphi.
RegisterRoutine ➕: Register rutin Delphi untuk dapat dipanggil dari LUA.

Icallistocontext

PushValue/GetValue : Tekan nilai ke atau mendapatkan nilai dari tumpukan LUA.
ClearStack/PopStack ? ️: Kelola status tumpukan secara efektif.
SettableFieldValue/GettableFieldValue ?: Akses dan memanipulasi tabel LUA.

Media

Podcast Deep Dive

Jelajahi diskusi mendalam tentang Callisto, fitur-fiturnya, dan kasus penggunaannya.

Callisto-lua-scripting-for-delph.mp4

Berkontribusi

Kontribusi untuk Callisto sangat dianjurkan. Jangan ragu untuk mengirimkan masalah, menyarankan fitur baru, atau membuat permintaan tarik untuk memperluas kemampuan dan ketahanan mesin skrip.

Lisensi

Callisto didistribusikan di bawah? Lisensi BSD-3-Clause , memungkinkan redistribusi dan penggunaan dalam bentuk sumber dan biner, dengan atau tanpa modifikasi, dalam kondisi tertentu. Lihat file lisensi untuk lebih jelasnya.