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 อย่างเป็นทางการ

ทรัพยากรเพิ่มเติม

ฟรี Pascal พบกับ SDL

ฟอรัม PGD SDL2

บั๊ก / ผลงาน / todos

หากคุณมีส่วนร่วมหรือแก้ไขข้อผิดพลาดอย่าลังเลที่จะส่งคำขอดึงหรือส่งในแพตช์ โปรดใช้ตัวติดตามปัญหา GitHub

โทดอส

• (ต่อเนื่อง) อัปเดตไฟล์โดยฟังก์ชั่นและประเภท SDL2 ใหม่ที่มีอยู่ในเวอร์ชัน SDL2 ล่าสุด
• (ATM อย่างต่อเนื่อง) แปลนามแฝงจำนวนเต็มเป็น enum ที่พิมพ์ ดูส่วนหนึ่งในแผ่นโกงเพื่ออ้างอิง
• (ต่อเนื่อง) ปรับปรุงความเข้ากันได้ของ Delphi (และที่สำคัญกว่านั้นอย่าทำลายมัน)
• (ต่อเนื่อง) ปรับความคิดเห็นเป็นรูปแบบ pasdoc (ดูปัญหา #22)

แนวทางรูปแบบรหัส

หลักการหลักคือการอยู่ให้แน่นที่สุดเท่าที่จะทำได้ในชื่อในส่วนหัว C แนวทางเหล่านี้มีจุดมุ่งหมายที่จะมีความสอดคล้องที่ดีขึ้นในโครงการชุมชนนี้และทำให้ง่ายต่อการค้นหาชิ้นส่วนรหัสบางส่วนในส่วนหัว C/Pascal รวมถึง อย่าลังเลที่จะหารือหรือขยายแนวทางเหล่านี้ใช้ตัวติดตามปัญหา

1. ชื่อของ C กำหนด (ค่าคงที่) และพารามิเตอร์ฟังก์ชันจะไม่ได้รับการแก้ไขหรือ "pascalified" เช่น: SDL_INIT_VIDEO ไม่เปลี่ยนเป็น SDLInitVideo

2. ชื่อที่สอดคล้องกับคำสำคัญที่สงวนไว้จะถูกเก็บไว้และเพิ่มขีดเส้นใต้ ตัวอย่าง: type ในฟังก์ชัน c SDL_HasEvent(Uint32 type) เปลี่ยนเป็น type_ ในฟังก์ชัน pascal SDL_HasEvent(type_: TSDL_EventType)

3. ใช้ชนิดข้อมูล C เช่น cuint8 , cuint16 , cuint32 , cint8 , cint16 , cint32 , cfloat และอื่น ๆ หากใช้ชนิดข้อมูล C ดั้งเดิมในรหัสดั้งเดิม หมายเหตุ: สำหรับ FPC คุณต้องเพิ่มหน่วย ctypes เพื่อใช้ชนิดข้อมูล C เหล่านี้ สำหรับ Delphi เรามีวิธีแก้ปัญหาชั่วคราว (ดูปัญหา #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
• นามแฝงจำนวนมากถูกแทนที่ด้วย enums ที่พิมพ์
• เพิ่มพอยน์เตอร์เดี่ยวและคู่สำหรับทุกประเภท (ขอบคุณโปรแกรม Furious)
• อัปเดต sdl_ttf.pas เป็นเวอร์ชันล่าสุด 2.21.0
• แทนที่ประเภทข้อมูลตามประเภทข้อมูล C (ดู PR #29)
• เพิ่มโครงสร้างโฟลเดอร์ (ดู PR #27)
• แก้ไขข้อผิดพลาดมากมาย

V2.1 การเปิดตัวความเข้ากันได้ (25/09/2021)

• รุ่นนี้มีการกระทำทั้งหมดจนกว่าจะเปลี่ยนโครงสร้างโฟลเดอร์โครงการ (ดู PR #27) เปรียบเทียบ disucssion ในปัญหา #22
• การย้ายหน่วยไปยังตำแหน่งใหม่อาจ (1) เพิ่มความยากลำบากในการเปลี่ยนแปลงการเปลี่ยนแปลงใหม่หากสาขาเริ่มต้นก่อนและ (2) ทำการปรับปรุงเส้นทางการวิจัยโครงการที่จำเป็น
• การอัปเดต SDL2_MIXER, SDL2_IMAGE, SDL2_TTF และบางไฟล์รวมถึงไฟล์
• แนะนำประเภทจุดลอยตัว
• ข้อผิดพลาด

v2.0

• การเปิดตัวอย่างเป็นทางการครั้งแรกของ PGD Community Fork ของ Pascal-SDL-2-Headers
  • GIT Tag เวอร์ชันล่าสุดคือ 1.72 ใน SDL2.pas มันไปได้ถึงเวอร์ชัน 1.80; ดังนั้นการเริ่มต้นด้วย v2.0 สำหรับส้อมนี้จึงเป็นความแตกต่างอย่างสม่ำเสมอ
• นี่เป็นแพ็คเกจทางเลือกที่เข้ากันได้และมีความเสถียรและมีเสถียรภาพสูง
• เป็นข้อมูลล่าสุดเกี่ยวกับเวอร์ชัน 2.0.4 ของ SDL2 library

ใบอนุญาต

คุณสามารถอนุญาตให้ใช้หน่วย Pascal SDL2 ไม่ว่าจะด้วยใบอนุญาต MPL หรือด้วยใบอนุญาต ZLIB