SDL2 for Pascal

Sdl2-for-Pascal

Устройства для создания бесплатных приложений Pascal / Delphi с использованием библиотеки SDL2.

Репозиторий SDL2-для паскала представляет собой форк репозитория Pascal-SDL-2-заголовок, поддерживаемая сообществом.

Установка

Просто добавьте единицы в свой путь. Вы можете достичь этого:

• (FPC) с использованием директивы {$UNITPATH XXX} в вашем исходном коде;
• (FPC) с использованием аргумента командной строки -FuXXX для компилятора;
• Просто копируйте и вставьте подразделения в тот же каталог, что и ваш основной исходный код.

Используйте блок sdl2 для основной библиотеки SDL2 (всегда необходимо). Единицы для других библиотек SDL2 также предоставляются:

• sdl2_gfx
• sdl2_image
• sdl2_mixer
• sdl2_net
• sdl2_ttf

Документация

Официальная документация SDL2-для паскала

Дополнительные ресурсы

Бесплатный Паскаль встречает SDL

Форум PGD SDL2

Ошибки / взносы / todos

Если у вас есть какие -либо взносы или ошибки, не стесняйтесь бросить запрос на вытягивание или отправить патч. Пожалуйста, используйте трекер выпуска GitHub.

Тодос

• (Постоянно) Обновление файлов с помощью новых функций и типов SDL2, которые присутствуют в более поздних версиях SDL2.
• (Непрерывно атм.) Перевести целочисленные псевдонимы в типичные перечисления. См. Часть перечислена на шпаргалку для справки.
• (Постоянно) улучшить коэффициенту Delphi (и еще более важно, не сломайте его)
• (Постоянно) адаптировать комментарии к формату Pasdoc. (См. Выпуск № 22)

Рекомендации по стилю кода

Основной принцип - оставаться как можно более тесным на именах в заголовках C. Эти руководящие принципы направлены на то, чтобы иметь лучшую последовательность в этом проекте сообщества и облегчить поиск определенных частей кода в заголовках C/Pascal. Не стесняйтесь обсуждать или расширять эти руководящие принципы, используйте трекер выпуска.

1. Имена C определяет (константы) и параметры функции не должны быть изменены или «паскалифицирован» Ex: SDL_INIT_VIDEO не изменяются в SDLInitVideo .

2. Имена, соответствующие зарезервированным ключевым словам, сохраняются, и добавляется недостаток. Ex.: type функцию c SDL_HasEvent(Uint32 type) изменяется в type_ в pascal function 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
• Добавить структуру тестирования (FPT)

v2.2 стабильная (01.01.2024)

• Блок SDL2 актуальна, по крайней мере, версии 2.0.14 SDL2 library
• Многие псевдонимы были заменены на печатные переводы
• Добавить одиночные и двойные указатели для всех типов (спасибо Furious-программированию)
• Обновление SDL_TTF.PAS для последней версии 2.21.0
• Замените типы данных типами C (см. PR #29)
• Добавить структуру папки (см. PR #27)
• Многие ошибки

V2.1 Выпуск совместимости (25/09/2021)

• Этот релиз имеет все коммерции до изменения структуры папки проекта (см. PR #27). Сравните диуксацию в выпуске № 22.
• Перемещение единиц в новое местоположение может (1) поднять трудности при совершении новых изменений, если филиал был запущен ранее, и (2) сделать необходимые обновления пути исследований проекта.
• Обновления SDL2_MIXER, SDL2_IMAGE, SDL2_TTF, а некоторые включают файлы
• ввести типы точек плавания
• ошибки

v2.0

• Первый официальный релиз общественного сообщества PGD из заголовков Pascal-SDL-2
  • Его последняя версия GIT Tag составляет 1,72, в SDL2.PAS он даже подходит к версии 1.80; Следовательно, начиная с v2.0 для этой вилки - разумное различие
• Это очень совместимый с Delphi и стабильный запасной пакет
• Loosely в курсе версии 2.0.4 SDL2 library

Лицензия

Вы можете лицензировать единицы Pascal SDL2 либо с лицензией MPL, либо с лицензией ZLIB.