SDL2 for Pascal

Sdl2-for-pascal

Arquivos da unidade para criar aplicativos Pascal / Delphi gratuitos usando a biblioteca SDL2.

O repositório SDL2-For-Pascal é um garfo mantido na comunidade do repositório Pascal-SDL-2-Headers.

Instalação

Basta adicionar as unidades ao seu caminho de incluir. Você pode conseguir isso:

• (FPC) usando a diretiva {$UNITPATH XXX} em seu código -fonte;
• (FPC) usando o argumento da linha de comando -FuXXX para o compilador;
• Apenas copiando e colando as unidades no mesmo diretório do seu código -fonte principal.

Use a unidade sdl2 para a biblioteca SDL2 principal (sempre deve ser necessária). Também são fornecidas unidades para as outras bibliotecas SDL2:

• sdl2_gfx
• sdl2_image
• sdl2_mixer
• sdl2_net
• sdl2_ttf

Documentação

Documentação Oficial SDL2-For-Pascal

Outros recursos

Pascal grátis encontra SDL

Fórum PGD SDL2

Bugs / Contribuições / Todos

Se você tiver contribuições ou bugs, sinta -se à vontade para soltar uma solicitação de tração ou enviar um patch. Por favor, use o rastreador de problemas do github.

Todos

• (Continuamente) Atualize os arquivos por novas funções e tipos SDL2 que estão presentes nas versões mais recentes do SDL2.
• (ATM continuamente atm.) Traduza aliases inteiros em enumes digitadas. Consulte a parte enumes na folha de dicas para referência.
• (Continuamente) melhorar a compatibilidade com Delphi (e ainda mais importante, não a quebre)
• (Continuamente) adapte os comentários ao formato PASDOC. (Veja a edição nº 22)

Diretrizes de estilo de código

O princípio principal é permanecer o mais apertado possível nos nomes dos cabeçalhos C. Essas diretrizes visam ter melhor consistência neste projeto da comunidade e facilitar a localização de determinadas peças de código nos cabeçalhos C/Pascal. Sinta -se à vontade para discutir ou estender essas diretrizes, use o rastreador de problemas.

1. Os nomes de c define (constantes) e os parâmetros de função não devem ser modificados ou "Pascalified" Ex: SDL_INIT_VIDEO não muda para SDLInitVideo .

2. Os nomes correspondentes a palavras -chave reservados são mantidos e um sublinhado é adicionado. Ex.: type na função c SDL_HasEvent(Uint32 type) muda para type_ na função Pascal SDL_HasEvent(type_: TSDL_EventType) .

3. Use tipos de dados C como cuint8 , cuint16 , cuint32 , cint8 , cint16 , cint32 , cfloat E assim por diante se os tipos de dados n nativos C forem usados no código original. Nota: Para o FPC, você precisa adicionar os ctypes da unidade para usar esses tipos de dados C. Para Delphi, temos uma solução temporária fornecida. (Veja a edição #67)

Exemplo: use cuint32 (se Uint32 for usado no código original) em vez de UInt32 , Cardinal , LongWord ou DWord . Exceção: Substitua *char por PAnsiChar ! (Veja a edição #26)

Dica: use TSDL_Bool para traduzir SDL_bool . Para funções macro, use Boolean . (Veja a edição nº 30).

4. Se um identificador ou uma declaração de função for desaparecido, marque -o como deprecated . (Veja a edição #34)

5. Por conveniência, incentivamos a adicionar ponteiros únicos e duplos para qualquer tipo SDL. (Veja a edição nº 105)

6. Dê uma olhada na nossa folha de dicas de tradução para referência.

Versões

A tag de versão (consulte Tags) refere -se à versão deste pacote de tradução SDL2 para Pascal, não a SDL2 library .

v2.x (trabalho em andamento)

• Atualize sdlthreads.inc
• Adicionar estrutura de teste (FPTEST)

v2.2 estável (02/01/2024)

• A unidade SDL2 está atualizada com pelo menos a versão 2.0.14 da SDL2 library
• Muitos aliases foram substituídos por enumes digitados
• Adicione ponteiros únicos e duplos para todos os tipos (graças à programação furiosa)
• Atualize sdl_ttf.pas para a versão mais recente 2.21.0
• Substitua os tipos de dados por C Tipos de dados (consulte PR #29)
• Adicionar estrutura de pasta (consulte PR #27)
• muitas correções

V2.1 Liberação de compatibilidade (25/09/2021)

• Esta versão tem tudo se compromete até a alteração da estrutura da pasta do projeto (consulte o PR #27). Compare a distribuição na edição nº 22.
• Mover as unidades para um novo local pode (1) aumentar as dificuldades em cometer novas alterações se a filial foi iniciada antes e (2) fazer atualizações dos caminhos de pesquisa do projeto necessários.
• Atualizações de sdl2_mixer, sdl2_image, sdl2_ttf e algumas incluem arquivos
• Introduzir tipos de ponto de flutuação
• Bugfixes

v2.0

• Primeiro lançamento oficial do PGD Community Fork of the Pascal-SDL-2-Headers
  • Sua versão mais recente GIT TAG é 1.72, no SDL2.PAS, ele leva até a versão 1.80; Portanto, começar com a v2.0 para este garfo é uma distinção sensual
• Este é um pacote de fallback altamente compatível com Delphi e estável
• Loosely está atualizado com a versão 2.0.4 da SDL2 library

Licença

Você pode licenciar as unidades Pascal SDL2 com a licença MPL ou com a licença ZLIB.