SDL2 for Pascal

SDL2-für-Pascal

Einheitsdateien zum Erstellen kostenloser Pascal / Delphi -Anwendungen mit der SDL2 -Bibliothek.

Das SDL2-für-Pascal-Repository ist eine von der Gemeinde gepflegte Gabel des Pascal-SDL-2-Header-Repositorys.

Installation

Fügen Sie einfach die Einheiten zu Ihrem Pfad hinzu. Sie können dies erreichen von:

• (FPC) Verwenden der {$UNITPATH XXX} -Grichtlinie in Ihrem Quellcode;
• (FPC) Verwenden des Befehlszeilenarguments -FuXXX -Befehls zum Compiler;
• Kopieren und Einfügen der Einheiten in das gleiche Verzeichnis wie Ihren Hauptquellcode.

Verwenden Sie die sdl2 -Einheit für die Hauptbibliothek SDL2 (sollte immer benötigt werden). Einheiten für die anderen SDL2 -Bibliotheken werden ebenfalls bereitgestellt:

• sdl2_gfx
• sdl2_image
• sdl2_mixer
• sdl2_net
• sdl2_ttf

Dokumentation

Offizielle SDL2-für-Pascal-Dokumentation

Weitere Ressourcen

Kostenloser Pascal trifft SDL

PGD SDL2 -Forum

Fehler / Beiträge / Todos

Wenn Sie Beiträge oder Bugfixes haben, können Sie eine Pull -Anfrage fallen oder einen Patch einsenden. Bitte verwenden Sie den GitHub -Ausgabe -Tracker.

Todos

• (Kontinuierlich) Aktualisieren Sie Dateien nach neuen SDL2 -Funktionen und -Typen, die in neueren SDL2 -Versionen vorhanden sind.
• (Ständig atm.) Übersetzen Sie ganzzahlige Aliase in typisierte Aufzüge. Siehe Teil Aufentsäumen auf dem Cheat -Blatt als Referenz.
• (Kontinuierlich) verbessern die Delphi-Kompatibilität (und noch wichtiger, brechen Sie es nicht)
• (Kontinuierlich) Anpassen Kommentare an das Pasdoc -Format. (Siehe Ausgabe Nr. 22)

Code -Stilrichtlinien

Das Hauptprinzip besteht darin, bei den Namen der C -Header so eng wie möglich zu bleiben. Diese Richtlinien zielen darauf ab, in diesem Community -Projekt eine bessere Konsistenz zu haben und es einfacher zu machen, bestimmte Code -Teile in den C -Headern/Pascal zu finden. Fühlen Sie sich frei, diese Richtlinien zu diskutieren oder zu erweitern, und verwenden Sie den Issue Tracker.

1. Namen von C -Definieren (Konstanten) und Funktionsparameter dürfen nicht geändert oder "pascalifiziert" ex: SDL_INIT_VIDEO ändert sich nicht in SDLInitVideo .

2. Namen, die reservierten Schlüsselwörtern entsprechen, werden aufbewahrt und ein Unterstrich wird hinzugefügt. EX.: type die C -Funktion SDL_HasEvent(Uint32 type) ein in type_ in pascal function SDL_HasEvent(type_: TSDL_EventType) .

3. Verwenden Sie C -Datentypen wie cuint8 , cuint16 , cuint32 , cint8 , cint16 , cint32 , cfloat usw., wenn native C -Datentypen im Originalcode verwendet werden. HINWEIS: Für FPC müssen Sie die Einheit ctypes hinzufügen, um diese C -Datentypen zu verwenden. Für Delphi haben wir eine vorübergehende Lösung. (Siehe Ausgabe Nr. 67)

Beispiel: Verwenden Sie cuint32 (wenn Uint32 im Originalcode verwendet wird) anstelle von UInt32 , Cardinal , LongWord oder DWord . Ausnahme: Ersetzen Sie *char von PAnsiChar ! (Siehe Ausgabe Nr. 26)

Hinweis: Verwenden Sie TSDL_Bool , um SDL_bool zu übersetzen. Für Makrofunktionen verwenden Sie Boolean . (Siehe Ausgabe Nr. 30).

4. Wenn eine Kennung oder eine Funktionserklärung verschwunden ist, markieren Sie sie als deprecated . (Siehe Ausgabe Nr. 34)

5. Wir ermutigen zur Einfachheit, einzelne und doppelte Zeiger für jeden SDL -Typ hinzuzufügen. (Siehe Ausgabe Nr. 105)

6. Schauen Sie sich unser Übersetzungs -Cheat -Blatt als Referenz an.

Versionen

Das Versions -Tag (siehe Tags) bezieht sich auf die Version dieses Übersetzungspakets SDL2 für Pascal, nicht auf die SDL2 library .

v2.x (in Arbeit)

• Aktualisieren Sie sdlthreads.inc
• Fügen Sie das Testframework hinzu (fptest)

v2.2 stabil (02.01.2024)

• Die SDL2-Einheit ist mit mindestens Version 2.0.14 der SDL2 library auf dem neuesten Stand
• Viele Aliase wurden durch typisierte Aufzüge ersetzt
• Fügen Sie einzelne und doppelte Zeiger für alle Typen hinzu (danke, dass es sich um eine Furious-Programmierung handelt)
• Aktualisieren Sie sdl_ttf.pas auf die neueste Version 2.21.0
• Datentypen durch C -Datentypen ersetzen (siehe PR #29)
• Ordnerstruktur hinzufügen (siehe PR #27)
• viele Bugfixes

V2.1 Kompatibilitätsveröffentlichung (25.09.2021)

• In dieser Version werden alle bis zur Änderung der Projektordnerstruktur (siehe PR #27) begangen. Vergleichen Sie die Discssion in Ausgabe Nr. 22.
• Wenn Sie die Einheiten an einen neuen Standort verschieben, kann (1) Schwierigkeiten bei der Bekämpfung neuer Änderungen aufwerfen, wenn die Zweigstelle vor gestartet wurde und (2) Aktualisierungen der Projektforschungspfade vornehmen.
• Updates von SDL2_MIXER, SDL2_IMAGE, SDL2_TTF und einigen enthalten Dateien
• Float Point -Typen einführen
• Bugfixes

v2.0

• Erste offizielle Veröffentlichung der PGD Community Fork der Pascal-SDL-2-Headers
  • Das neueste Version Git ist 1.72 in den SDL2.pas. Daher ist es eine sinnvolle Unterscheidung mit V2.0 für diese Gabel
• Dies ist ein stark delphi-kompatibles und stabiles Fallback-Paket
• Mit Version 2.0.4 der SDL2 library lose auf dem neuesten Stand

Lizenz

Sie können die Pascal SDL2 -Einheiten entweder mit der MPL -Lizenz oder mit der ZLIB -Lizenz lizenzieren.