Unit files for building Free Pascal / Delphi applications using the SDL2 library.
The SDL2-for-Pascal repository is a community-maintained fork of the Pascal-SDL-2-Headers repository.
Simply add the units to your include path. You can achieve this by:
- (FPC) using the
{$UNITPATH XXX}directive in your source code; - (FPC) using the
-FuXXXcommand-line argument to the compiler; - just copying & pasting the units into the same directory as your main source code.
Use the sdl2 unit for the main SDL2 library (should be always needed). Units for the other SDL2 libraries are also provided:
Official SDL2-for-Pascal Documentation
If you have any contributions or bugfixes, feel free to drop a pull request or send in a patch. Please use the GitHub issue tracker.
- (Continously) Update files by new SDL2 functions and types which are present in more recent SDL2 versions.
- (Continously atm.) Translate integer aliases into typed enums. See part Enums on the Cheat sheet for reference.
- (Continously) improve Delphi-compatibility (and even more important, DO NOT break it)
- (Continously) Adapt comments to PasDoc format. (See issue #22)
The main principle is to stay as tight as possible at the names in the C headers. These guidelines aim to have better consistency in this community project and make it easier to find certain code parts in the C headers/Pascal includes. Feel free to discuss or extend these guidelines, use the issue tracker.
-
Names of C defines (constants) and function parameters shall not be modified or "pascalified" Ex:
SDL_INIT_VIDEOdoes not change intoSDLInitVideo. -
Names corresponding to reserved key words are kept and an underscore is added. Ex.:
typein C functionSDL_HasEvent(Uint32 type)changes intotype_in Pascal functionSDL_HasEvent(type_: TSDL_EventType). -
Use C data types like
cuint8,cuint16,cuint32,cint8,cint16,cint32,cfloatand so on if native C data types are used in the original code. Note: For FPC you need to add the unitctypesto use these C data types. For Delphi we have a temporary solution provided. (see issue #67)
Example: Use cuint32 (if Uint32 is used in
the original code) instead of UInt32, Cardinal, LongWord or DWord.
Exception: Replace *char by PAnsiChar! (see issue #26)
Hint: Use TSDL_Bool to translate SDL_bool. For macro functions use Boolean. (see issue #30).
-
If an identifier or a function declaration is gone, mark them as
deprecated. (see issue #34) -
For convenience we encourage to add single and double pointers for any SDL type. (see issue #105)
-
Have a look at our Translation Cheat Sheet for reference.
The version tag (see tags) refers to the version of this translation package SDL2 for Pascal, not the SDL2 library.
- update sdlthreads.inc
- add testing framework (fptest)
- SDL2 unit is up-to-date with at least version 2.0.14 of the
SDL2 library - many aliases got replaced by typed enums
- add single and double pointers for all types (thanks furious-programming)
- update SDL_ttf.pas to latest version 2.21.0
- replace data types by c data types (see PR #29)
- add folder structure (see PR #27)
- many bugfixes
- This release has all commits until the change of the project folder structure (see PR #27). Compare the disucssion in issue #22.
- Moving the units to a new location may (1) raise difficulties in committing new changes if the branch was started before and (2) make updates of project research pathes necessary.
- updates of SDL2_Mixer, SDL2_Image, SDL2_TTF and some include files
- introduce float point types
- bugfixes
- first official release of the PGD community fork of the Pascal-SDL-2-Headers
- its latest version git tag is 1.72, in the sdl2.pas it goes even up to version 1.80; hence starting with v2.0 for this fork is a senseful distinction
- this ia a highly Delphi-compatible and stable fallback package
- loosely is up-to-date with version 2.0.4 of the
SDL2 library
You may license the Pascal SDL2 units either with the MPL license or with the zlib license.