SDL2 for Pascal

Sdl2-para-Pascal

Archivos de unidad para construir aplicaciones Pascal / Delphi gratuitas utilizando la biblioteca SDL2.

El repositorio SDL2-para Pascal es una bifurcación mantenida por la comunidad del repositorio de cabeza de Pascal-SDL-2.

Instalación

Simplemente agregue las unidades a su ruta de inclusión. Puedes lograr esto por:

• (Fpc) usando la directiva {$UNITPATH XXX} en su código fuente;
• (Fpc) usando el argumento de línea de comandos -FuXXX al compilador;
• Simplemente copiar y pegar las unidades en el mismo directorio que su código fuente principal.

Use la unidad sdl2 para la biblioteca SDL2 principal (siempre debe ser necesaria). También se proporcionan unidades para las otras bibliotecas SDL2:

• sdl2_gfx
• sdl2_image
• sdl2_mixer
• sdl2_net
• sdl2_ttf

Documentación

Documentación oficial SDL2-para Pascal

Recursos adicionales

Free Pascal se encuentra con SDL

Foro PGD SDL2

Bugs / Contribucions / Todos

Si tiene alguna contribución o corrección de errores, no dude en soltar una solicitud de extracción o enviar un parche. Utilice el rastreador de problemas de GitHub.

Diádico

• (Continuamente) Actualice archivos mediante nuevas funciones y tipos de SDL2 que están presentes en versiones SDL2 más recientes.
• (Continuamente atm.) Traducir los alias enteros en enumeraciones escrita. Vea la parte en las enumines en la hoja de trucos como referencia.
• (Continuamente) mejorar la compatibilidad de Delphi (y aún más importante, no lo rompa)
• (Continuamente) adaptar los comentarios al formato PASDOC. (Ver número #22)

Pautas de estilo de código

El principio principal es mantenerse lo más apretado posible en los nombres de los encabezados C. Estas pautas tienen como objetivo tener una mejor consistencia en este proyecto comunitario y facilitar la búsqueda de ciertas piezas de código en los encabezados C/PASCAL incluye. Siéntase libre de discutir o extender estas pautas, use el rastreador de problemas.

1. Los nombres de C define (constantes) y los parámetros de función no se modificarán ni se modificarán o "Pascalificado" ex: SDL_INIT_VIDEO no cambia a SDLInitVideo .

2. Se mantienen los nombres correspondientes a las palabras clave reservadas y se agrega un bajo. Ej.: type en la función C SDL_HasEvent(Uint32 type) cambia en type_ en la función Pascal SDL_HasEvent(type_: TSDL_EventType) .

3. Use tipos de datos C como cuint8 , cuint16 , cuint32 , cint8 , cint16 , cint32 , cfloat , etc. si se utilizan tipos de datos n nativos en el código original. Nota: Para FPC, debe agregar la unidad ctypes para usar estos tipos de datos C. Para Delphi tenemos una solución temporal proporcionada. (Ver el tema #67)

Ejemplo: use cuint32 (si Uint32 se usa en el código original) en lugar de UInt32 , Cardinal , LongWord o DWord . Excepción: Reemplace *char por PAnsiChar ! (Ver número #26)

Sugerencia: use TSDL_Bool para traducir SDL_bool . Para funciones macro usa Boolean . (Ver número 30).

4. Si se ha ido un identificador o una declaración de función, marquelos como deprecated . (Ver el problema #34)

5. Por conveniencia, alentamos a agregar punteros individuales y dobles para cualquier tipo de SDL. (Ver el problema #105)

6. Eche un vistazo a nuestra hoja de trucos de traducción como referencia.

Versiones

La etiqueta de versión (ver etiquetas) se refiere a la versión de este paquete de traducción SDL2 para Pascal, no la SDL2 library .

v2.x (trabajo en progreso)

• actualizar sdlthreads.inc
• Agregar marco de prueba (FPTEST)

V2.2 Estable (01/02/2024)

• La unidad SDL2 está actualizada con al menos la versión 2.0.14 de la SDL2 library
• Muchos alias fueron reemplazados por enums escrita
• Agregue consejos individuales y dobles para todo tipo (gracias Furious Programming)
• Actualizar sdl_ttf.pas a la última versión 2.21.0
• Reemplace los tipos de datos por tipos de datos C (consulte PR #29)
• Agregar estructura de carpeta (ver PR #27)
• muchas correcciones de errores

V2.1 Release de compatibilidad (25/09/2021)

• Este lanzamiento tiene todas las compromisos hasta el cambio de la estructura de la carpeta del proyecto (ver PR #27). Compare la disución en el problema #22.
• Mover las unidades a una nueva ubicación puede (1) aumentar las dificultades para cometer nuevos cambios si la sucursal se inició antes y (2) hacer que las actualizaciones de las patas de investigación de proyectos sean necesarias.
• Actualizaciones de sdl2_mixer, sdl2_image, sdl2_ttf y algunos incluyen archivos
• introducir tipos de puntos flotantes
• corrige a los bug

v2.0

• Primer lanzamiento oficial de la bifurcación de la comunidad PGD de los Pascal-SDL-2-Headers
  • Su última versión de la etiqueta Git es 1.72, en el sdl2.pas se acerca a la versión 1.80; Por lo tanto, comenzar con v2.0 para este bifurcado es una distinción sensible
• Este es un paquete de ventaja altamente compatible y estable
• Loosely está actualizado con la versión 2.0.4 de la SDL2 library

Licencia

Puede licenciar las unidades Pascal SDL2 con la licencia MPL o con la licencia ZLIB.