SDL2 for Pascal

SDL2-pour-Pascal

Fichiers unitaires pour créer des applications Pascal / Delphi gratuites à l'aide de la bibliothèque SDL2.

Le référentiel SDL2-FOR-PASCAL est une fourche entre communautaire du référentiel Pascal-SDL-2-Headers.

Installation

Ajoutez simplement les unités à votre chemin d'inclusion. Vous pouvez y parvenir par:

• (FPC) en utilisant la directive {$UNITPATH XXX} dans votre code source;
• (FPC) à l'aide de l'argument de ligne de commande -FuXXX au compilateur;
• Il suffit de copier et de coller les unités dans le même répertoire que votre code source principal.

Utilisez l'unité sdl2 pour la bibliothèque SDL2 principale (doit être toujours nécessaire). Des unités pour les autres bibliothèques SDL2 sont également fournies:

• sdl2_gfx
• sdl2_image
• sdl2_mixer
• sdl2_net
• sdl2_ttf

Documentation

Documentation officielle SDL2-pour-PASCAL

Des ressources supplémentaires

Pascal gratuit rencontre sdl

Forum PGD SDL2

Bogues / contributions / todos

Si vous avez des contributions ou des fidélises, n'hésitez pas à supprimer une demande de traction ou à envoyer un correctif. Veuillez utiliser le suivi du problème GitHub.

Todos

• (Constructionment) Mettre à jour les fichiers par de nouvelles fonctions et types SDL2 qui sont présents dans les versions SDL2 plus récentes.
• (ATM continue.) Traduire les alias entiers en énumations typées. Voir la pièce Enum sur la feuille de triche pour référence.
• (Continuellement) améliorer la compatibilité Delphi (et encore plus important, ne le cassez pas)
• (Continuellement) adapter les commentaires au format PASDOC. (Voir numéro 22)

Directives de style de code

Le principe principal est de rester aussi serré que possible aux noms des en-têtes C. Ces directives visent à avoir une meilleure cohérence dans ce projet communautaire et à faciliter la recherche de certaines pièces de code dans les en-têtes C / Pascal. N'hésitez pas à discuter ou à étendre ces directives, à utiliser le tracker du problème.

1. Les noms de C définissent (constantes) et les paramètres de fonction ne doivent pas être modifiés ou "Pascalifiés" EX: SDL_INIT_VIDEO ne se transforme pas en SDLInitVideo .

2. Les noms correspondant aux mots clés réservés sont conservés et un soulignement est ajouté. Ex.: type en C Fonction SDL_HasEvent(Uint32 type) Les changements en type_ dans la fonction Pascal SDL_HasEvent(type_: TSDL_EventType) .

3. Utilisez C Types de données comme cuint8 , cuint16 , cuint32 , cint8 , cint16 , cint32 , cfloat , etc. Si les types de données C natifs sont utilisés dans le code d'origine. Remarque: Pour FPC, vous devez ajouter les ctypes unitaires pour utiliser ces types de données C. Pour Delphi, nous avons une solution temporaire fournie. (Voir numéro 67)

Exemple: Utilisez cuint32 (si Uint32 est utilisé dans le code d'origine) au lieu de UInt32 , Cardinal , LongWord ou DWord . Exception: Remplacez *char par PAnsiChar ! (Voir numéro 26)

Astuce: utilisez TSDL_Bool pour traduire SDL_bool . Pour les fonctions macro, utilisez Boolean . (Voir numéro 30).

4. Si un identifiant ou une déclaration de fonction a disparu, marquez-les comme deprecated . (Voir le numéro 34)

5. Pour plus de commodité, nous encourageons à ajouter des pointeurs simples et doubles pour tout type SDL. (Voir numéro 105)

6. Jetez un œil à notre feuille de triche de traduction pour référence.

Versions

La version de version (voir Tags) fait référence à la version de ce package de traduction SDL2 pour Pascal, pas à la SDL2 library .

v2.x (travail en cours)

• mettre à jour sdlthreads.inc
• Ajouter le framework de test (FPTEST)

v2.2 stable (02/01/2024)

• L'unité SDL2 est à jour avec au moins la version 2.0.14 de la SDL2 library
• De nombreux alias ont été remplacés par des énumérations dactylographiées
• Ajouter des pointeurs simples et doubles pour tous les types (merci de la programmation furieuse)
• Mettre à jour sdl_ttf.pas à la dernière version 2.21.0
• Remplacez les types de données par C types de données (voir PR # 29)
• Ajouter la structure du dossier (voir PR # 27)
• de nombreux bugs

V2.1 Release de compatibilité (25/09/2021)

• Cette version a toutes les engagements jusqu'au changement de la structure du dossier du projet (voir PR # 27). Comparez la disucssion dans le numéro 22.
• Le déplacement des unités vers un nouvel emplacement peut (1) augmenter les difficultés à commettre de nouvelles modifications si la branche a été démarrée avant et (2) faire des mises à jour des pattes de recherche de projet nécessaires.
• Mises à jour de SDL2_MIXER, SDL2_IMAGE, SDL2_TTF et certains incluent des fichiers
• Introduire les types de points flottants
• bugfixes

v2.0

• Première libération officielle de la Fork Community Fork des Pascal-SDL-2-Headers
  • sa dernière version de version git est de 1,72, dans le sdl2.pas, il va même jusqu'à la version 1.80; Par conséquent commencer par v2.0 pour cette fourche est une distinction sensée
• Ceci est un package de secours très compatible et stable à Delphi
• Lacely est à jour avec la version 2.0.4 de la SDL2 library

Licence

Vous pouvez concéder aux unités Pascal SDL2 avec la licence MPL ou avec la licence ZLIB.