SDL2 for Pascal

SDL2-FOR-PASCAL

File unit untuk membangun aplikasi Pascal / Delphi gratis menggunakan pustaka SDL2.

Repositori SDL2-untuk-Pascal adalah garpu yang dipelihara komunitas dari repositori Pascal-SDL-2-Headers.

Instalasi

Cukup tambahkan unit ke jalur termasuk Anda. Anda dapat mencapai ini dengan:

• (FPC) menggunakan arahan {$UNITPATH XXX} dalam kode sumber Anda;
• (FPC) menggunakan argumen baris perintah -FuXXX ke kompiler;
• Hanya menyalin & menempelkan unit ke direktori yang sama dengan kode sumber utama Anda.

Gunakan unit sdl2 untuk perpustakaan SDL2 utama (harus selalu diperlukan). Unit untuk pustaka SDL2 lainnya juga disediakan:

• sdl2_gfx
• sdl2_image
• sdl2_mixer
• sdl2_net
• sdl2_ttf

Dokumentasi

Dokumentasi resmi SDL2-untuk-Pascal

Sumber daya lebih lanjut

Pascal gratis bertemu SDL

Forum PGD SDL2

Bug / Kontribusi / Todo

Jika Anda memiliki kontribusi atau perbaikan bug, jangan ragu untuk menjatuhkan permintaan tarik atau mengirimkan tambalan. Harap gunakan pelacak masalah GitHub.

Todos

• (Terus menerus) Perbarui file oleh fungsi dan jenis SDL2 baru yang ada dalam versi SDL2 yang lebih baru.
• (Terus -menerus atm.) Terjemahkan alias integer ke dalam enum yang diketik. Lihat bagian enum pada lembar cheat untuk referensi.
• (Terus menerus) meningkatkan kompatibilitas Delphi (dan bahkan lebih penting, jangan hancurkan)
• (Terus menerus) beradaptasi dengan format PASDOC. (Lihat Edisi #22)

Pedoman Gaya Kode

Prinsip utamanya adalah tetap sekencang mungkin pada nama -nama di header C. Pedoman ini bertujuan untuk memiliki konsistensi yang lebih baik dalam proyek komunitas ini dan memudahkan untuk menemukan bagian kode tertentu dalam come/pascal C. Jangan ragu untuk mendiskusikan atau memperluas pedoman ini, gunakan pelacak masalah.

1. Nama C Defines (konstanta) dan parameter fungsi tidak boleh dimodifikasi atau "dipasahkan" EX: SDL_INIT_VIDEO tidak berubah menjadi SDLInitVideo .

2. Nama yang sesuai dengan kata -kata kunci yang dipesan disimpan dan garis bawah ditambahkan. Ex.: type in c fungsi SDL_HasEvent(Uint32 type) berubah menjadi type_ dalam fungsi pascal SDL_HasEvent(type_: TSDL_EventType) .

3. Gunakan tipe data C seperti cuint8 , cuint16 , cuint32 , cint8 , cint16 , cint32 , cfloat dan sebagainya jika tipe data C asli digunakan dalam kode asli. Catatan: Untuk FPC Anda perlu menambahkan unit ctypes untuk menggunakan tipe data C ini. Untuk Delphi kami memiliki solusi sementara yang disediakan. (Lihat Edisi #67)

Contoh: Gunakan cuint32 (jika Uint32 digunakan dalam kode asli) sebagai ganti UInt32 , Cardinal , LongWord atau DWord . Pengecualian: Ganti *char oleh PAnsiChar ! (Lihat Edisi #26)

Petunjuk: Gunakan TSDL_Bool untuk menerjemahkan SDL_bool . Untuk fungsi makro, gunakan Boolean . (Lihat masalah #30).

4. Jika pengidentifikasi atau deklarasi fungsi hilang, tandai mereka sebagai deprecated . (Lihat masalah #34)

5. Untuk kenyamanan kami mendorong untuk menambahkan pointer tunggal dan ganda untuk jenis SDL apa pun. (Lihat Edisi #105)

6. Lihat lembar cheat terjemahan kami untuk referensi.

Versi

Tag versi (lihat tag) mengacu pada versi paket terjemahan ini SDL2 untuk Pascal, bukan SDL2 library .

v2.x (bekerja sedang berlangsung)

• Perbarui sdlthreads.inc
• Tambahkan Kerangka Pengujian (Fptest)

v2.2 stabil (02/01/2024)

• Unit SDL2 mutakhir dengan setidaknya versi 2.0.14 dari SDL2 library
• banyak alias digantikan oleh enum yang diketik
• Tambahkan pointer tunggal dan ganda untuk semua jenis (terima kasih pemrograman geram)
• Perbarui sdl_ttf.pas ke versi terbaru 2.21.0
• Ganti tipe data oleh tipe data C (lihat PR #29)
• Tambahkan Struktur Folder (lihat PR #27)
• banyak perbaikan bug

V2.1 Rilis Kompatibilitas (25/09/2021)

• Rilis ini memiliki semua komit sampai perubahan struktur folder proyek (lihat PR #27). Bandingkan disuksi dalam edisi #22.
• Memindahkan unit ke lokasi baru dapat (1) meningkatkan kesulitan dalam melakukan perubahan baru jika cabang dimulai sebelum dan (2) membuat pembaruan jalur penelitian proyek yang diperlukan.
• Pembaruan SDL2_MIXER, SDL2_IMAGE, SDL2_TTF dan beberapa termasuk file
• memperkenalkan jenis titik float
• perbaikan bug

v2.0

• Rilis resmi pertama dari PGD Community Fork dari Pascal-SDL-2-Headers
  • Tag GIT versi terbarunya adalah 1,72, di SDL2.pas itu bahkan hingga versi 1.80; karenanya dimulai dengan v2.0 untuk garpu ini adalah perbedaan yang sensefis
• Ini adalah paket fallback yang sangat kompatibel dan stabil Delphi
• secara longgar mutakhir dengan versi 2.0.4 dari SDL2 library

Lisensi

Anda dapat melisensikan unit Pascal SDL2 baik dengan lisensi MPL atau dengan lisensi Zlib.