Texture: afegit suport per a fitxers .pal

fix: quedava un player_sprite_->setCurrentAnimation("dying") per canviar a player_sprite_->setCurrentAnimation("rolling")

CMakeLists.txt

@@ -1,88 +1,134 @@
-# CMakeLists.txt
+# CMakeLists.txt (Versión corregida y mejorada)
 
 cmake_minimum_required(VERSION 3.10)
-project(coffee_crisis_arcade_edition VERSION 0.01)
-
-# Establece las políticas
-cmake_policy(SET CMP0072 NEW)
-
-# Configuración de compilador para MinGW en Windows, si es necesario
-if(WIN32 AND NOT CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
-    set(CMAKE_CXX_COMPILER "g++")
-    set(CMAKE_C_COMPILER "gcc")
-endif()
+project(coffee_crisis_arcade_edition VERSION 2.00)
 
 # Establecer estándar de C++
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
 
-# Configuración global de flags de compilación
-set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")
-set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} -Os -ffunction-sections -fdata-sections")
+# --- 1. LISTA EXPLÍCITA DE FUENTES ---
+set(APP_SOURCES
+    # --- Archivos Principales del Sistema ---
+    source/main.cpp
+    source/director.cpp
+    source/section.cpp
+    source/screen.cpp
+    source/resource.cpp
+    source/asset.cpp
+    source/audio.cpp
+    source/input.cpp
+    source/options.cpp
+    source/lang.cpp
+    source/param.cpp
+    source/utils.cpp
+    source/global_events.cpp
+    source/global_inputs.cpp
+    
+    # --- UI (User Interface) ---
+    source/ui/service_menu.cpp
+    source/ui/menu_renderer.cpp
+    source/ui/ui_message.cpp
+    
+    # --- Lógica del Juego ---
+    source/balloon_formations.cpp
+    source/balloon_manager.cpp
+    source/balloon.cpp
+    source/bullet.cpp
+    source/enter_name.cpp
+    source/explosions.cpp
+    source/game_logo.cpp
+    source/item.cpp
+    source/manage_hiscore_table.cpp
+    source/player.cpp
+    source/scoreboard.cpp
+    
+    # --- Escenas ---
+    source/sections/credits.cpp
+    source/sections/game.cpp
+    source/sections/hiscore_table.cpp
+    source/sections/instructions.cpp
+    source/sections/intro.cpp
+    source/sections/logo.cpp
+    source/sections/title.cpp
+    
+    # --- Sprites y Gráficos ---
+    source/sprite.cpp
+    source/animated_sprite.cpp
+    source/moving_sprite.cpp
+    source/path_sprite.cpp
+    source/smart_sprite.cpp
+    source/background.cpp
+    source/tiled_bg.cpp
+    source/fade.cpp
+    source/texture.cpp
+    
+    # --- Otros ---
+    source/define_buttons.cpp
+    source/mouse.cpp
+    source/notifier.cpp
+    source/stage.cpp
+    source/tabe.cpp
+    source/text.cpp
+    source/writer.cpp
+)
 
-# Define el directorio de los archivos fuente
-set(DIR_SOURCES "${CMAKE_SOURCE_DIR}/source")
+# Fuentes de librerías de terceros
+set(EXTERNAL_SOURCES
+    source/external/jail_audio.cpp
+    source/external/jail_shader.cpp
+    source/external/json.hpp
+    source/external/gif.cpp 
+)
 
-# Cargar todos los archivos fuente en DIR_SOURCES
-file(GLOB SOURCES "${DIR_SOURCES}/*.cpp")
 
-# Verificar si se encontraron archivos fuente
-if(NOT SOURCES)
-    message(FATAL_ERROR "No se encontraron archivos fuente en ${DIR_SOURCES}. Verifica que el directorio existe y contiene archivos .cpp.")
-endif()
+# Configuración de SDL3
+find_package(SDL3 REQUIRED CONFIG REQUIRED COMPONENTS SDL3)
+message(STATUS "SDL3 encontrado: ${SDL3_INCLUDE_DIRS}")
 
-# Configuración de SDL2
-find_package(SDL2 REQUIRED)
-if(SDL2_FOUND)
-    message(STATUS "SDL2 encontrado: ${SDL2_INCLUDE_DIRS}")
-    include_directories(${SDL2_INCLUDE_DIRS})
-    link_directories(${SDL2_LIBDIR})
-else()
-    message(FATAL_ERROR "SDL2 no encontrado")
-endif()
+# --- 2. AÑADIR EJECUTABLE ---
+add_executable(${PROJECT_NAME} ${APP_SOURCES} ${EXTERNAL_SOURCES})
 
-# Incluye rutas de SDL2 obtenidas con pkg-config
-include_directories(/usr/local/include /usr/local/include/SDL2)
-link_directories(/usr/local/lib)
+# --- 3. DIRECTORIOS DE INCLUSIÓN ---
+target_include_directories(${PROJECT_NAME} PUBLIC
+    "${CMAKE_SOURCE_DIR}/source"
+    "${CMAKE_SOURCE_DIR}/source/external" 
+)
 
-# Definir las bibliotecas comunes
-set(LIBS SDL2)
+# Enlazar la librería SDL3
+target_link_libraries(${PROJECT_NAME} PRIVATE SDL3::SDL3)
 
-# Configuración común de salida de ejecutables en el directorio raíz
-set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR})
 
-# Añadir ejecutable principal
-add_executable(${PROJECT_NAME} ${SOURCES})
+# --- 4. CONFIGURACIÓN PLATAFORMAS Y COMPILADOR  ---
+# Configuración de flags de compilación
+target_compile_options(${PROJECT_NAME} PRIVATE -Wall)
+target_compile_options(${PROJECT_NAME} PRIVATE $<$<CONFIG:RELEASE>:-Os -ffunction-sections -fdata-sections>)
 
-# Añadir definiciones de compilación dependiendo del tipo de build
-target_compile_definitions(${PROJECT_NAME} PRIVATE $<$<CONFIG:DEBUG>:DEBUG VERBOSE>)
-
-# Enlazar bibliotecas
-target_link_libraries(${PROJECT_NAME} ${LIBS})
+# Definir _DEBUG en modo Debug
+target_compile_definitions(${PROJECT_NAME} PRIVATE $<$<CONFIG:DEBUG>:DEBUG>)
 
 # Configuración específica para cada plataforma
 if(WIN32)
     target_compile_definitions(${PROJECT_NAME} PRIVATE WINDOWS_BUILD)
-    target_link_libraries(${PROJECT_NAME} mingw32 opengl32 gdi32 winmm imm32 ole32 version)
+    target_link_libraries(${PROJECT_NAME} PRIVATE ws2_32 mingw32 opengl32)
 elseif(APPLE)
-    set(LIBS ${LIBS} "-framework OpenGL")
     target_compile_definitions(${PROJECT_NAME} PRIVATE MACOS_BUILD)
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-deprecated")
-    # Configurar compilación para Apple Silicon
+    target_compile_options(${PROJECT_NAME} PRIVATE -Wno-deprecated)
     set(CMAKE_OSX_ARCHITECTURES "arm64")
 elseif(UNIX AND NOT APPLE)
-    set(LIBS ${LIBS} GL)
     target_compile_definitions(${PROJECT_NAME} PRIVATE LINUX_BUILD)
-    target_link_libraries(${PROJECT_NAME} ${LIBS})
 endif()
 
-# Añadir OpenGL a las bibliotecas enlazadas
+# Configuración común para OpenGL
 if(NOT WIN32)
     find_package(OpenGL REQUIRED)
     if(OPENGL_FOUND)
         message(STATUS "OpenGL encontrado: ${OPENGL_LIBRARIES}")
-        target_link_libraries(${PROJECT_NAME} ${OPENGL_LIBRARIES})
+        target_link_libraries(${PROJECT_NAME} PRIVATE ${OPENGL_LIBRARIES})
     else()
         message(FATAL_ERROR "OpenGL no encontrado")
     endif()
 endif()
+
+# Especificar la ubicación del ejecutable
+set_target_properties(${PROJECT_NAME} PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR})

Makefile

@@ -29,16 +29,15 @@ ifeq ($(OS),Windows_NT)
     SOURCES         := source/*.cpp
     CXXFLAGS        := -std=c++20 -Wall -Os -ffunction-sections -fdata-sections -Wl,--gc-sections -static-libstdc++ -Wl,-subsystem,windows
     CXXFLAGS_DEBUG  := -std=c++20 -Wall -g
-    LDFLAGS         := -lmingw32 -lws2_32 -lSDL2main -lSDL2 -lopengl32
+    LDFLAGS         := -lmingw32 -lws2_32 -lSDL3 -lopengl32
     RM              := del /Q
     MKDIR           := mkdir
 else
     FixPath         = $1
-    SOURCES         := $(shell find $(DIR_SOURCES) -name '*.cpp')
     SOURCES         := source/*.cpp
     CXXFLAGS        := -std=c++20 -Wall -Os -ffunction-sections -fdata-sections
     CXXFLAGS_DEBUG  := -std=c++20 -Wall -g
-    LDFLAGS         := -lSDL2
+    LDFLAGS         := -lSDL3
     RMFILE          := rm -f
 	RMDIR			:= rm -rdf
     MKDIR           := mkdir -p
@@ -128,16 +127,24 @@ macos_release:
 	ln -s /Applications "$(RELEASE_FOLDER)"/Applications
 
 # Compila la versión para procesadores Intel
-	$(CXX) $(SOURCES) -D MACOS_BUNDLE $(CXXFLAGS) $(LDFLAGS) -o "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS/$(TARGET_NAME)" -rpath @executable_path/../Frameworks/ -target x86_64-apple-macos10.12
+ifdef ENABLE_MACOS_X86_64
+	$(CXX) $(SOURCES) -D MACOS_BUNDLE $(CXXFLAGS) $(LDFLAGS) -o "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS/$(TARGET_NAME)" -rpath @executable_path/../Frameworks/ -target x86_64-apple-macos10.15
+
+# Firma la aplicación
+	codesign --deep --force --sign - --timestamp=none "$(RELEASE_FOLDER)/$(APP_NAME).app"
 
 # Empaqueta el .dmg de la versión Intel
 	hdiutil create tmp.dmg -ov -volname "$(APP_NAME)" -fs HFS+ -srcfolder "$(RELEASE_FOLDER)" 
 	hdiutil convert tmp.dmg -format UDZO -o "$(MACOS_INTEL_RELEASE)"
 	$(RMFILE) tmp.dmg
+endif
 
 # Compila la versión para procesadores Apple Silicon
 	$(CXX) $(SOURCES) -D MACOS_BUNDLE -D SDL_DISABLE_IMMINTRIN_H $(CXXFLAGS) $(LDFLAGS) -o "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS/$(TARGET_NAME)" -rpath @executable_path/../Frameworks/ -target arm64-apple-macos11
 
+# Firma la aplicación
+	codesign --deep --force --sign - --timestamp=none "$(RELEASE_FOLDER)/$(APP_NAME).app"
+
 # Empaqueta el .dmg de la versión Apple Silicon
 	hdiutil create tmp.dmg -ov -volname "$(APP_NAME)" -fs HFS+ -srcfolder "$(RELEASE_FOLDER)" 
 	hdiutil convert tmp.dmg -format UDZO -o "$(MACOS_APPLE_SILICON_RELEASE)"

README.md

@@ -1,6 +1,8 @@
 # Coffee Crisis Arcade Edition
 
-**¡La batalla definitiva pel cafè està ací!**
+<img src="https://php.sustancia.synology.me/images/ccae/coffee_crisis_arcade_edition_cover_web.png" width="300" align="left" style="margin-right: 20px; margin-bottom: 10px;" alt="Coffee Crisis Cover">
+
+## ¡La batalla definitiva pel cafè està ací!
 
 Coffee Crisis Arcade Edition és una versió ampliada i millorada del aclamat Coffee Crisis. Aquesta versió porta l'acció cooperativa al següent nivell, amb:
 
@@ -10,9 +12,9 @@ Coffee Crisis Arcade Edition és una versió ampliada i millorada del aclamat Co
 
 Defensa el teu cafè contra les bambolles gegants en aquest trepidant joc d'arcade! 🍵
 
-<p align="center">
-    <img src="https://php.sustancia.synology.me/images/ccae/ccae_title.png" alt="Títol" width="60%" />
-</p>
+<br clear="left">
+
+
 
 ## Controls
 
@@ -40,15 +42,12 @@ El joc està optimitzat per a ser jugat amb un mando de jocs, encara que un dels
 | **F3**      | Alterna entre mode de pantalla completa i finestra |
 | **F4**      | Activa o desactiva el filtre de pantalla           |
 | **F5**      | Activa o desactiva el mode d'escalat sencer        |
-| **F6**      | Activa o desactiva l'àudio                         |
-| **F7**      | Activa o desactiva el dispar automàtic             |
-| **F8**      | Canvia l'idioma del joc (Provoca el reinici)       |
+| **F6**      | Activa o desactiva el sincronisme vertical         |
+| **F7**      | Activa o desactiva l'àudio                         |
+| **F8**      | Activa o desactiva el dispar automàtic             |
+| **F9**      | Canvia l'idioma del joc (Provoca el reinici)       |
 | **F10**     | Reinicia el joc                                    |
 
-<p align="center">
-    <img src="https://php.sustancia.synology.me/images/ccae/ccae2.png" alt="Joc" width="50%" />
-</p>
-
 ## Com instal·lar i jugar
 
 1. Descarrega el joc des de [l'apartat de llançaments](https://gitea.sustancia.synology.me/JailDesigner/coffee_crisis_arcade_edition/releases).

data/config/param_320x240.txt

@@ -1,55 +1,77 @@
-## GAME
-game.item_size           20 # Tamaño de los items del juego
-game.coffee_machine_w    28 # Ancho de la máquina de café
-game.coffee_machine_h    37 # Alto de la máquina de café
-game.width              320 # Ancho de la resolucion nativa del juego
-game.height             240 # Alto de la resolucion nativa del juego
-game.play_area.rect.x     0 # Rectangulo con la posición de la zona de juego
-game.play_area.rect.y     0 # Rectangulo con la posición de la zona de juego
-game.play_area.rect.w   320 # Rectangulo con la posición de la zona de juego
-game.play_area.rect.h   200 # Rectangulo con la posición de la zona de juego
-game.enter_name_seconds  60 # Duración en segundos para introducir el nombre al finalizar la partida
+## --- GAME ---
+game.item_size               20   # Tamaño de los items del juego (en píxeles)
+game.width                  320   # Ancho de la resolución nativa del juego (en píxeles)
+game.height                 240   # Alto de la resolución nativa del juego (en píxeles)
+game.play_area.rect.x         0   # Posición X de la zona jugable
+game.play_area.rect.y         0   # Posición Y de la zona jugable
+game.play_area.rect.w       320   # Ancho de la zona jugable
+game.play_area.rect.h       200   # Alto de la zona jugable
+game.name_entry_idle_time    10   # Segundos para introducir el nombre al finalizar la partida si no se pulsa nada
+game.name_entry_total_time   60   # Segundos totales para introducir el nombre al finalizar la partida
 
-## FADE
-fade.num_squares_width    160
-fade.num_squares_height   120
-fade.random_squares_delay   1
-fade.random_squares_mult  500
-fade.post_duration         80
-fade.venetian_size         12
+## --- FADE ---
+fade.color                 1F2B30   # Color hexadecimal para el efecto de fundido
+fade.num_squares_width        160   # Número de cuadrados en el eje X para el fundido
+fade.num_squares_height       120   # Número de cuadrados en el eje Y para el fundido
+fade.random_squares_delay       1   # Delay entre aparición de cuadrados aleatorios (frames)
+fade.random_squares_mult      500   # Multiplicador para la velocidad de aparición aleatoria
+fade.post_duration             80   # Duración tras el fundido (frames)
+fade.venetian_size             12   # Tamaño de las bandas para el efecto veneciano (en píxeles)
 
-## SCOREBOARD
-scoreboard.x   0
-scoreboard.y 200
-scoreboard.w 320
-scoreboard.h  40
+## --- SCOREBOARD ---
+scoreboard.rect.x                     0   # Posición X del marcador
+scoreboard.rect.y                   216   # Posición Y del marcador
+scoreboard.rect.w                   320   # Ancho del marcador
+scoreboard.rect.h                    40   # Alto del marcador
+scoreboard.separator_autocolor     true   # ¿El separador usa color automático?
+scoreboard.separator_color       0D1A2B   # Color del separador (hexadecimal)
+scoreboard.easy_color            4B692F   # Color para la dificultad fácil
+scoreboard.normal_color          2E3F47   # Color para la dificultad normal
+scoreboard.hard_color            76428A   # Color para la dificultad difícil
+scoreboard.text_autocolor          true   # ¿El texto usa color automático?
+scoreboard.text_color1           FFFFFF   # Color principal del texto del marcador
+scoreboard.text_color2           FFFFFF   # Color secundario del texto del marcador
+scoreboard.skip_countdown_value       8   # Valor para saltar la cuenta atrás (segundos)
 
-## TITLE
-title.press_start_position     170
-title.title_duration           800
-title.arcade_edition_position  123
-title.title_c_c_position        80
+## --- TITLE ---
+title.press_start_position     170   # Posición Y del texto "Press Start"
+title.title_duration           800   # Duración de la pantalla de título (frames)
+title.arcade_edition_position  123   # Posición Y del subtítulo "Arcade Edition"
+title.title_c_c_position        80   # Posición Y del título principal
 
-## BACKGROUND
-background.attenuate_color.r 255
-background.attenuate_color.g 255
-background.attenuate_color.b 255
-background.attenuate_alpha     0
+## --- BACKGROUND ---
+background.attenuate_color  FFFFFF00   # Color de atenuación del fondo (RGBA hexadecimal)
 
-## BALLOONS
-balloon_1.vel  2.75f
-balloon_1.grav 0.09f
-balloon_2.vel  3.70f
-balloon_2.grav 0.10f
-balloon_3.vel  4.70f
-balloon_3.grav 0.10f
-balloon_4.vel  5.45f
-balloon_4.grav 0.10f
+## --- BALLOONS ---
+balloon_1.vel   2.75f   # Velocidad inicial del globo 1
+balloon_1.grav  0.09f   # Gravedad aplicada al globo 1
+balloon_2.vel   3.70f   # Velocidad inicial del globo 2
+balloon_2.grav  0.10f   # Gravedad aplicada al globo 2
+balloon_3.vel   4.70f   # Velocidad inicial del globo 3
+balloon_3.grav  0.10f   # Gravedad aplicada al globo 3
+balloon_4.vel   5.45f   # Velocidad inicial del globo 4
+balloon_4.grav  0.10f   # Gravedad aplicada al globo 4
 
-## NOTIFICATION
-notification.pos_v     TOP
-notification.pos_h    LEFT
-notification.sound   false
-notification.color.r    48
-notification.color.g    48
-notification.color.b    48
+## --- NOTIFICATION ---
+notification.pos_v     TOP   # Posición vertical de la notificación (TOP/BOTTOM)
+notification.pos_h    LEFT   # Posición horizontal de la notificación (LEFT/RIGHT)
+notification.sound   false   # ¿La notificación reproduce sonido?
+notification.color  303030   # Color de fondo de la notificación (hexadecimal)
+
+## --- SERVICE MENU ---
+service_menu.title_color       99FF62   # Color del título del menú de servicio
+service_menu.text_color        FFFFFF   # Color del texto del menú de servicio  
+service_menu.selected_color    FFDC44   # Color de la opción seleccionada en el menú de servicio
+service_menu.bg_color        003000F5   # Color de fondo del menú de servicio (RGBA hexadecimal)
+service_menu.drop_shadow        false   # ¿El menú de servicio tiene sombra?
+
+## --- INTRO ---
+intro.bg_color    543149   # Color de fondo de la intro
+intro.card_color  CBDBFC   # Color de las tarjetas en la intro
+
+## --- DEBUG ---
+debug.color  00FFFF   # Color para elementos de depuración
+
+## --- RESOURCE ---
+resource.color  CDD1CD   # Color de recurso 1
+resource.color  17E97A   # Color de recurso 2

data/config/param_320x256.txt

@@ -1,55 +1,77 @@
-## GAME
-game.item_size           20 # Tamaño de los items del juego
-game.coffee_machine_w    28 # Ancho de la máquina de café
-game.coffee_machine_h    37 # Alto de la máquina de café
-game.width              320 # Ancho de la resolucion nativa del juego
-game.height             256 # Alto de la resolucion nativa del juego
-game.play_area.rect.x     0 # Rectangulo con la posición de la zona de juego
-game.play_area.rect.y     0 # Rectangulo con la posición de la zona de juego
-game.play_area.rect.w   320 # Rectangulo con la posición de la zona de juego
-game.play_area.rect.h   216 # Rectangulo con la posición de la zona de juego
-game.enter_name_seconds  60 # Duración en segundos para introducir el nombre al finalizar la partida
+## --- GAME ---
+game.item_size               20   # Tamaño de los items del juego (en píxeles)
+game.width                  320   # Ancho de la resolución nativa del juego (en píxeles)
+game.height                 256   # Alto de la resolución nativa del juego (en píxeles)
+game.play_area.rect.x         0   # Posición X de la zona jugable
+game.play_area.rect.y         0   # Posición Y de la zona jugable
+game.play_area.rect.w       320   # Ancho de la zona jugable
+game.play_area.rect.h       216   # Alto de la zona jugable
+game.name_entry_idle_time    10   # Segundos para introducir el nombre al finalizar la partida si no se pulsa nada
+game.name_entry_total_time   60   # Segundos totales para introducir el nombre al finalizar la partida
 
-## FADE
-fade.num_squares_width    160
-fade.num_squares_height   128
-fade.random_squares_delay   1
-fade.random_squares_mult  500
-fade.post_duration         80
-fade.venetian_size         12
+## --- FADE ---
+fade.color                 1F2B30   # Color hexadecimal para el efecto de fundido
+fade.num_squares_width        160   # Número de cuadrados en el eje X para el fundido
+fade.num_squares_height       128   # Número de cuadrados en el eje Y para el fundido
+fade.random_squares_delay       1   # Delay entre aparición de cuadrados aleatorios (frames)
+fade.random_squares_mult      500   # Multiplicador para la velocidad de aparición aleatoria
+fade.post_duration             80   # Duración tras el fundido (frames)
+fade.venetian_size             12   # Tamaño de las bandas para el efecto veneciano (en píxeles)
 
-## SCOREBOARD
-scoreboard.x   0
-scoreboard.y 216
-scoreboard.w 320
-scoreboard.h  40
+## --- SCOREBOARD ---
+scoreboard.rect.x                     0   # Posición X del marcador
+scoreboard.rect.y                   216   # Posición Y del marcador
+scoreboard.rect.w                   320   # Ancho del marcador
+scoreboard.rect.h                    40   # Alto del marcador
+scoreboard.separator_autocolor     true   # ¿El separador usa color automático?
+scoreboard.separator_color       0D1A2B   # Color del separador (hexadecimal)
+scoreboard.easy_color            4B692F   # Color para la dificultad fácil
+scoreboard.normal_color          2E3F47   # Color para la dificultad normal
+scoreboard.hard_color            76428A   # Color para la dificultad difícil
+scoreboard.text_autocolor          true   # ¿El texto usa color automático?
+scoreboard.text_color1           FFFFFF   # Color principal del texto del marcador
+scoreboard.text_color2           FFFFFF   # Color secundario del texto del marcador
+scoreboard.skip_countdown_value       8   # Valor para saltar la cuenta atrás (segundos)
 
-## TITLE
-title.press_start_position     180
-title.title_duration           800
-title.arcade_edition_position  123
-title.title_c_c_position        80
+## --- TITLE ---
+title.press_start_position     180   # Posición Y del texto "Press Start"
+title.title_duration           800   # Duración de la pantalla de título (frames)
+title.arcade_edition_position  123   # Posición Y del subtítulo "Arcade Edition"
+title.title_c_c_position        80   # Posición Y del título principal
 
-## BACKGROUND
-background.attenuate_color.r 255
-background.attenuate_color.g 255
-background.attenuate_color.b 255
-background.attenuate_alpha     0
+## --- BACKGROUND ---
+background.attenuate_color  FFFFFF00   # Color de atenuación del fondo (RGBA hexadecimal)
 
-## BALLOONS
-balloon_1.vel  2.75f
-balloon_1.grav 0.09f
-balloon_2.vel  3.70f
-balloon_2.grav 0.10f
-balloon_3.vel  4.70f
-balloon_3.grav 0.10f
-balloon_4.vel  5.45f
-balloon_4.grav 0.10f
+## --- BALLOONS ---
+balloon_1.vel   2.75f   # Velocidad inicial del globo 1
+balloon_1.grav  0.09f   # Gravedad aplicada al globo 1
+balloon_2.vel   3.70f   # Velocidad inicial del globo 2
+balloon_2.grav  0.10f   # Gravedad aplicada al globo 2
+balloon_3.vel   4.70f   # Velocidad inicial del globo 3
+balloon_3.grav  0.10f   # Gravedad aplicada al globo 3
+balloon_4.vel   5.45f   # Velocidad inicial del globo 4
+balloon_4.grav  0.10f   # Gravedad aplicada al globo 4
 
-## NOTIFICATION
-notification.pos_v     TOP
-notification.pos_h    LEFT
-notification.sound   false
-notification.color.r    48
-notification.color.g    48
-notification.color.b    48
+## --- NOTIFICATION ---
+notification.pos_v     TOP   # Posición vertical de la notificación (TOP/BOTTOM)
+notification.pos_h    LEFT   # Posición horizontal de la notificación (LEFT/RIGHT)
+notification.sound   false   # ¿La notificación reproduce sonido?
+notification.color  303030   # Color de fondo de la notificación (hexadecimal)
+
+## --- SERVICE MENU ---
+service_menu.title_color       99FF62   # Color del título del menú de servicio
+service_menu.text_color        FFFFFF   # Color del texto del menú de servicio
+service_menu.selected_color    FFDC44   # Color de la opción seleccionada en el menú de servicio
+service_menu.bg_color        000F00F5   # Color de fondo del menú de servicio (RGBA hexadecimal)
+service_menu.drop_shadow        false   # ¿El menú de servicio tiene sombra?
+
+## --- INTRO ---
+intro.bg_color    543149   # Color de fondo de la intro
+intro.card_color  CBDBFC   # Color de las tarjetas en la intro
+
+## --- DEBUG ---
+debug.color  00FFFF   # Color para elementos de depuración
+
+## --- RESOURCE ---
+resource.color  CDD1CD   # Color de recurso 1
+resource.color  17E97A   # Color de recurso 2

data/font/aseprite.txt

@@ -0,0 +1,194 @@
+# box width
+8
+# box height
+8
+# 32 espacio ( )
+3
+# 33 !
+1
+# 34 "
+3
+# 35 #
+3
+# 36 $
+4
+# 37 %
+5
+# 38 &
+5
+# 39 '
+2
+# 40 (
+2
+# 41 )
+2
+# 42 *
+5
+# 43 +
+5
+# 44 ,
+3
+# 45 -
+3
+# 46 .
+1
+# 47 /
+4
+# 48 0
+4
+# 49 1
+2
+# 50 2
+4
+# 51 3
+4
+# 52 4
+4
+# 53 5
+4
+# 54 6
+4
+# 55 7
+4
+# 56 8
+4
+# 57 9
+4
+# 58 :
+1
+# 59 ;
+1
+# 60 <
+3
+# 61 =
+4
+# 62 >
+4
+# 63 ?
+4
+# 64 @
+7
+# 65 A
+4
+# 66 B
+4
+# 67 C
+4
+# 68 D
+4
+# 69 E
+4
+# 70 F
+4
+# 71 G
+4
+# 72 H
+4
+# 73 I
+2
+# 74 J
+2
+# 75 K
+4
+# 76 L
+4
+# 77 M
+5
+# 78 N
+4
+# 79 O
+5
+# 80 P
+4
+# 81 Q
+5
+# 82 R
+4
+# 83 S
+4
+# 84 T
+5
+# 85 U
+4
+# 86 V
+5
+# 87 W
+7
+# 88 X
+5
+# 89 Y
+5
+# 90 Z
+4
+# 91 [
+2
+# 92 \
+3
+# 93 ]
+2
+# 94 ^
+5
+# 95 _
+5
+# 96 `
+3
+# 97 a
+4
+# 98 b
+4
+# 99 c
+4
+# 100 d
+4
+# 101 e
+4
+# 102 f
+2
+# 103 g
+4
+# 104 h
+4
+# 105 i
+1
+# 106 j
+2
+# 107 k
+4
+# 108 l
+1
+# 109 m
+7
+# 110 n
+4
+# 111 o
+4
+# 112 p
+4
+# 113 q
+4
+# 114 r
+3
+# 115 s
+3
+# 116 t
+2
+# 117 u
+4
+# 118 v
+4
+# 119 w
+5
+# 120 x
+5
+# 121 y
+4
+# 122 z
+4
+# 123 {
+3
+# 124 |
+3
+# 125 }
+3
+# 126 ~
+5

data/gfx/bullet/bullet.ani

@@ -0,0 +1,44 @@
+frame_width=12
+frame_height=12
+
+[animation]
+name=normal_up
+speed=5
+loop=0
+frames=0,1,2
+[/animation]
+
+[animation]
+name=normal_left
+speed=5
+loop=0
+frames=3,4,5,5,4,3
+[/animation]
+
+[animation]
+name=normal_right
+speed=5
+loop=0
+frames=6,7,8,8,7,6
+[/animation]
+
+[animation]
+name=powered_up
+speed=5
+loop=0
+frames=9,10,11,11,10,9
+[/animation]
+
+[animation]
+name=powered_left
+speed=5
+loop=0
+frames=12,13,14,14,13,12
+[/animation]
+
+[animation]
+name=powered_right
+speed=5
+loop=0
+frames=15,16,17,17,26,15
+[/animation]

data/gfx/item/item_clock.ani

@@ -3,7 +3,7 @@ frame_height=20
 
 [animation]
 name=default
-speed=10
+speed=8
 loop=0
-frames=0,1
+frames=0,0,1
 [/animation]

data/gfx/item/item_coffee.ani

@@ -3,7 +3,7 @@ frame_height=20
 
 [animation]
 name=default
-speed=10
+speed=8
 loop=0
-frames=0,1
+frames=0,0,1
 [/animation]

data/gfx/item/item_coffee_machine.ani

@@ -1,9 +1,9 @@
-frame_width=28
-frame_height=37
+frame_width=32
+frame_height=39
 
 [animation]
 name=default
-speed=10
+speed=6
 loop=0
-frames=0,1,2,3
+frames=0,1,2,3,4,5,6,7,8
 [/animation]

data/gfx/item/item_debian.ani

@@ -3,7 +3,7 @@ frame_height=20
 
 [animation]
 name=default
-speed=10
+speed=8
 loop=0
-frames=0,1
+frames=0,0,1
 [/animation]

data/gfx/item/item_points1_disk.ani

@@ -3,7 +3,7 @@ frame_height=20
 
 [animation]
 name=default
-speed=10
+speed=8
 loop=0
-frames=0,1
+frames=0,0,1
 [/animation]

data/gfx/item/item_points2_gavina.ani

@@ -3,7 +3,7 @@ frame_height=20
 
 [animation]
 name=default
-speed=10
+speed=8
 loop=0
-frames=0,1
+frames=0,0,1
 [/animation]

data/gfx/item/item_points3_pacmar.ani

@@ -3,7 +3,7 @@ frame_height=20
 
 [animation]
 name=default
-speed=10
+speed=8
 loop=0
-frames=0,1
+frames=0,0,1
 [/animation]

data/gfx/player/player.ani

@@ -1,5 +1,5 @@
-frame_width=30
-frame_height=30
+frame_width=32
+frame_height=32
 
 [animation]
 name=walk
@@ -16,78 +16,106 @@ frames=4,5,6,7
 [/animation]
 
 [animation]
-name=walk-sideshoot
+name=walk-fire-side
 speed=5
 loop=0
 frames=8,9,10,11
 [/animation]
 
 [animation]
-name=walk-sideshoot-cooldown
+name=walk-recoil-side
 speed=5
 loop=0
 frames=12,13,14,15
 [/animation]
 
 [animation]
-name=stand-sideshoot
+name=walk-cool-side
 speed=5
 loop=0
 frames=16,17,18,19
 [/animation]
 
 [animation]
-name=stand-sideshoot-cooldown
+name=stand-fire-side
 speed=5
 loop=0
-frames=15
+frames=20
 [/animation]
 
 [animation]
-name=walk-centershoot
+name=stand-recoil-side
 speed=5
 loop=0
-frames=20,21,22,23
+frames=21
 [/animation]
 
 [animation]
-name=walk-centershoot-cooldown
+name=stand-cool-side
 speed=5
 loop=0
-frames=24,25,26,27
+frames=22 
 [/animation]
 
 [animation]
-name=stand-centershoot
+name=walk-fire-center
 speed=5
 loop=0
-frames=28,29,30,31
+frames=23,24,25,26
 [/animation]
 
 [animation]
-name=stand-centershoot-cooldown
+name=walk-recoil-center
 speed=5
 loop=0
-frames=27
+frames=27,28,29,30
 [/animation]
 
 [animation]
-name=dying
+name=walk-cool-center
+speed=5
+loop=0
+frames=31,32,33,34
+[/animation]
+
+[animation]
+name=stand-fire-center
+speed=5
+loop=0
+frames=35
+[/animation]
+
+[animation]
+name=stand-recoil-center
+speed=5
+loop=0
+frames=36
+[/animation]
+
+[animation]
+name=stand-cool-center
+speed=5
+loop=0
+frames=37
+[/animation]
+
+[animation]
+name=rolling
 speed=10
 loop=0
-frames=32,33,34,35
-[/animation]
-
-[animation]
-name=dead
-speed=3
-loop=0
-frames=44,45,46,47,48,49,50
+frames=38,39,40,41
 [/animation]
 
 [animation]
 name=celebration
 speed=10
 loop=-1
-frames=36,36,36,36,36,36,37,38,39,40,40,40,40,40,40,39,39,39,40,40,40,39,39,39,38,37,36,36,36
+frames=42,42,42,42,42,42,43,44,45,46,46,46,46,46,46,45,45,45,46,46,46,45,45,45,44,43,42,42,42
+[/animation]
+
+[animation]
+name=dead
+speed=5
+loop=0
+frames=47,48,49,50,51,52,53
 [/animation]

data/gfx/player/player1_coffee1.pal

@@ -0,0 +1,67 @@
+JASC-PAL
+0100
+64
+0 0 0 0
+136 66 83 255
+150 66 83 255
+186 97 86 255
+217 148 85 255
+230 157 90 255
+242 166 94 255
+189 189 189 255
+224 224 224 255
+243 108 96 255
+117 117 117 255
+238 238 238 255
+255 255 235 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+61 156 112 255
+79 163 112 255
+93 222 112 255
+125 242 92 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+50 64 143 255
+54 70 156 255
+59 75 168 255
+63 81 181 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+78 52 46 255
+93 64 55 255
+109 76 65 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+239 224 5 255
+232 247 8 255
+245 247 215 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+102 50 63 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255

data/gfx/player/player1_coffee2.pal

@@ -0,0 +1,67 @@
+JASC-PAL
+0100
+64
+0 0 0 0
+136 66 83 255
+150 66 83 255
+186 97 86 255
+217 148 85 255
+230 157 90 255
+242 166 94 255
+189 189 189 255
+224 224 224 255
+243 108 96 255
+117 117 117 255
+238 238 238 255
+255 255 235 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+214 164 26 255
+227 174 27 255
+239 183 29 255
+252 193 30 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+50 64 143 255
+54 70 156 255
+59 75 168 255
+63 81 181 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+78 52 46 255
+93 64 55 255
+109 76 65 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+239 224 5 255
+232 247 8 255
+245 247 215 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+102 50 63 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255

data/gfx/player/player1_invencible.pal

@@ -0,0 +1,67 @@
+JASC-PAL
+0100
+64
+0 0 0 0
+204 204 204 255
+204 204 204 255
+255 255 255 255
+204 204 204 255
+255 255 255 255
+255 255 255 255
+189 189 189 255
+224 224 224 255
+255 255 255 255
+204 204 204 255
+255 255 255 255
+255 255 235 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+204 204 204 255
+204 204 204 255
+255 255 255 255
+255 255 255 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+204 204 204 255
+204 204 204 255
+255 255 255 255
+255 255 255 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+204 204 204 255
+204 204 204 255
+255 255 255 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+204 204 204 255
+255 255 255 255
+255 255 255 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+170 170 170 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255

data/gfx/player/player2_coffee1.pal

@@ -0,0 +1,67 @@
+JASC-PAL
+0100
+64
+0 0 0 0
+19 18 18 255
+35 35 35 255
+54 48 47 255
+212 148 85 255
+232 148 85 255
+242 166 94 255
+234 234 234 255
+199 199 199 255
+243 108 96 255
+196 20 17 255
+221 25 29 255
+222 222 222 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+46 139 87 255
+60 179 113 255
+72 209 129 255
+85 239 141 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+26 35 126 255
+29 38 138 255
+32 41 150 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+78 52 46 255
+93 64 55 255
+109 76 65 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+250 8 219 255
+250 86 229 255
+250 202 244 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+102 50 63 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255

data/gfx/player/player2_coffee2.pal

@@ -0,0 +1,67 @@
+JASC-PAL
+0100
+64
+0 0 0 0
+19 18 18 255
+35 35 35 255
+54 48 47 255
+212 148 85 255
+232 148 85 255
+242 166 94 255
+234 234 234 255
+199 199 199 255
+243 108 96 255
+196 20 17 255
+221 25 29 255
+222 222 222 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+224 133 0 255
+250 125 0 255
+250 162 0 255
+250 133 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+26 35 126 255
+29 38 138 255
+32 41 150 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+78 52 46 255
+93 64 55 255
+109 76 65 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+250 8 219 255
+250 86 229 255
+250 202 244 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+102 50 63 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255

data/gfx/player/player2_invencible.pal

@@ -0,0 +1,67 @@
+JASC-PAL
+0100
+64
+0 0 0 0
+204 204 204 255
+204 204 204 255
+255 255 255 255
+204 204 204 255
+255 255 255 255
+255 255 255 255
+189 189 189 255
+224 224 224 255
+255 255 255 255
+204 204 204 255
+255 255 255 255
+255 255 235 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+204 204 204 255
+204 204 204 255
+255 255 255 255
+255 255 255 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+204 204 204 255
+204 204 204 255
+255 255 255 255
+255 255 255 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+204 204 204 255
+204 204 204 255
+255 255 255 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+204 204 204 255
+255 255 255 255
+255 255 255 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+170 170 170 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255
+0 0 0 255

data/lang/ba_BA.json

@@ -0,0 +1,112 @@
+{
+    "[CREDITS] PROGRAMMED_AND_DESIGNED_BY": "PROGRAMAT I DISSENYAT PER",
+    "[CREDITS] PIXELART_DRAWN_BY": "GRAFICS DIBUIXATS PER",
+    "[CREDITS] MUSIC_COMPOSED_BY": "MUSICA COMPOSADA PER",
+    "[CREDITS] SOUND_EFFECTS": "EFECTES DE SO",
+
+    "[DEFINE_BUTTONS] FIRE_LEFT": "Disparar cap a l'esquerra",
+    "[DEFINE_BUTTONS] FIRE_UP": "Disparar cap amunt",
+    "[DEFINE_BUTTONS] FIRE_RIGHT": "Disparar cap a la dreta",
+    "[DEFINE_BUTTONS] START": "Start",
+    "[DEFINE_BUTTONS] SERVICE_MENU": "Menu de servei",
+    "[DEFINE_BUTTONS] PLAYER": "Jugador",
+    "[DEFINE_BUTTONS] KEYBOARD": "Teclat",
+
+    "[GAME_TEXT] 1": "Felicitats!!",
+    "[GAME_TEXT] 2": " fases mes!",
+    "[GAME_TEXT] 3": "Ultima fase!",
+    "[GAME_TEXT] 4": "SuperPoder!",
+    "[GAME_TEXT] 5": "+1 Colp",
+    "[GAME_TEXT] 6": "Temps!",
+    "[GAME_TEXT] 7": "Endavant!",
+    "[GAME_TEXT] 8": "1.000.000 de punts!",
+    
+    "[HIGHSCORE_TABLE] CAPTION": "Millors puntuacions",
+    
+    "[INSTRUCTIONS] 01": "Objectiu",
+    "[INSTRUCTIONS] 02": "HAS D'EXPLOTAR",
+    "[INSTRUCTIONS] 03": "TANTS GLOBUS COM PUGUES",
+    "[INSTRUCTIONS] 04": "LA DIFICULTAT AUGMENTA",
+    "[INSTRUCTIONS] 05": "A MESURA QUE VAS PUNTUANT",
+    "[INSTRUCTIONS] 06": "Objectes",
+    "[INSTRUCTIONS] 07": "1.000 PUNTS",
+    "[INSTRUCTIONS] 08": "2.500 PUNTS",
+    "[INSTRUCTIONS] 09": "5.000 PUNTS",
+    "[INSTRUCTIONS] 10": "PARA EL TEMPS",
+    "[INSTRUCTIONS] 11": "VIDA EXTRA",
+    
+    "[INTRO] 1": "Un dia qualsevol de l'any 2000",
+    "[INTRO] 2": "Tot esta tranquil a la UPV",
+    "[INTRO] 3": "Fins que un desaprensiu...",
+    "[INTRO] 4": "HEY! ME ANE A FERME UN CORTAET...",
+    "[INTRO] 5": "UAAAAAAAAAAAAA!!!",
+    "[INTRO] 6": "Espera un moment...",
+    "[INTRO] 7": "Si resulta que no tinc solt!",
+    "[INTRO] 8": "VAJA BIRRIA DE MAQUINA !!!",
+    "[INTRO] 9": "blop... blop... blop...",
+    
+    "[NOTIFICATIONS] 01": "Torna a polsar per eixir",
+    "[NOTIFICATIONS] 02": "Torna a polsar per apagar el sistema",
+    "[NOTIFICATIONS] 03": "Torna a polsar per reiniciar",
+    "[NOTIFICATIONS] 04": "Torna a polsar per canviar el idioma a",
+    "[NOTIFICATIONS] 05": "Idioma canviat a",
+    "[NOTIFICATIONS] 06": "activat",
+    "[NOTIFICATIONS] 07": "desactivat",
+    "[NOTIFICATIONS] 08": "Dispar automatic",
+    "[NOTIFICATIONS] 09": "Tamany de la finestra",
+    "[NOTIFICATIONS] 10": "Mode finestra",
+    "[NOTIFICATIONS] 11": "Mode pantalla completa",
+    "[NOTIFICATIONS] 12": "Mode d'escalat sencer",
+    "[NOTIFICATIONS] 13": "Filtre",
+    "[NOTIFICATIONS] 14": "Sincronisme vertical",
+    "[NOTIFICATIONS] 15": "Reiniciar",
+
+    "[RESOURCE] LOADING": "Carregant",
+
+    "[SERVICE_MENU] TITLE": "Menu de servei",
+    "[SERVICE_MENU] RESET": "Reiniciar",
+    "[SERVICE_MENU] QUIT": "Eixir del joc",
+    "[SERVICE_MENU] SHUTDOWN": "Apagar el sistema",
+    "[SERVICE_MENU] FULLSCREEN": "Pantalla completa",
+    "[SERVICE_MENU] WINDOW_SIZE": "Tamany de la finestra",
+    "[SERVICE_MENU] SHADERS": "Filtre",
+    "[SERVICE_MENU] VSYNC": "Sincronisme vertical",
+    "[SERVICE_MENU] INTEGER_SCALE": "Escalat sencer",
+    "[SERVICE_MENU] MAIN_VOLUME": "Volumen general",
+    "[SERVICE_MENU] MUSIC_VOLUME": "Volumen de la musica",
+    "[SERVICE_MENU] SFX_VOLUME": "Volumen dels sons",
+    "[SERVICE_MENU] AUTOFIRE": "Dispar automatic",
+    "[SERVICE_MENU] LANGUAGE": "Idioma",
+    "[SERVICE_MENU] LANG_ES": "Castella",
+    "[SERVICE_MENU] LANG_EN": "Angles",
+    "[SERVICE_MENU] LANG_BA": "Balooncia",
+    "[SERVICE_MENU] VIDEO": "Video",
+    "[SERVICE_MENU] AUDIO": "Audio",
+    "[SERVICE_MENU] SETTINGS": "Configuracio",
+    "[SERVICE_MENU] SYSTEM": "Sistema",
+    "[SERVICE_MENU] ON": "Activat",
+    "[SERVICE_MENU] OFF": "Desactivat",
+    "[SERVICE_MENU] DIFFICULTY": "Dificultat",
+    "[SERVICE_MENU] EASY": "Facil",
+    "[SERVICE_MENU] NORMAL": "Normal",
+    "[SERVICE_MENU] HARD": "Dificil",
+    "[SERVICE_MENU] NEED_RESTART_MESSAGE": "Reiniciar per aplicar canvis",
+    "[SERVICE_MENU] ENABLE_SHUTDOWN": "Permetre apagar el sistema",
+    
+    "[SCOREBOARD] 1": "Jugador 1",
+    "[SCOREBOARD] 2": "Jugador 2",
+    "[SCOREBOARD] 3": "Multiplicador",
+    "[SCOREBOARD] 4": "Max. puntuacio",
+    "[SCOREBOARD] 5": "Fase",
+    "[SCOREBOARD] 6": "Mode demostracio",
+    "[SCOREBOARD] 7": "Game Over",
+    "[SCOREBOARD] 8": "Pulsa START",
+    "[SCOREBOARD] 9": "per jugar",
+    "[SCOREBOARD] 10": "Continuar?",
+    "[SCOREBOARD] 11": "Posa el nom",
+    "[SCOREBOARD] 12": "Per favor",
+    "[SCOREBOARD] 13": "espere",
+    "[SCOREBOARD] 14": "Puntuacio",
+
+    "[TITLE] PRESS_BUTTON_TO_PLAY": "PULSA PER JUGAR"
+}

data/lang/ba_BA.txt

@@ -1,407 +0,0 @@
-## 0 - MENU DEL TITULO
-JUGAR
-
-## 1 - MENU DEL TITULO
-OPCIONS
-
-## 2 - MENU DEL TITULO
-INSTRUCCIONS
-
-## 3 - MENU DEL TITULO
-EIXIR
-
-## 4 - MENU DE OPCIONES
-FINESTRA
-
-## 5 - MENU DE OPCIONES
-PANTALLA COMPLETA
-
-## 6 - MENU DE OPCIONES
-PANTALLA COMPLETA FALSA
-
-## 7 - MENU DE OPCIONES
-TAMANY DE FINESTRA
-
-## 8 - MENU DE OPCIONES
-IDIOMA
-
-## 9 - MENU DE OPCIONES
-[ ACEPTAR ]
-
-## 10 - MENU DE OPCIONES
-[ CANCELAR ]
-
-## 11 - INSTRUCCIONES
-Objectiu
-
-## 12 - INSTRUCCIONES
-HAS D'EXPLOTAR
-
-## 13 - INSTRUCCIONES
-TANTS GLOBUS COM PUGUES
-
-## 14 - INSTRUCCIONES
-LA DIFICULTAT AUGMENTA
-
-## 15 - INSTRUCCIONES
-A MESURA QUE VAS PUNTUANT
-
-## 16 - INSTRUCCIONES
-Objectes
-
-## 17 - INSTRUCCIONES
-1.000 PUNTS
-
-## 18 - INSTRUCCIONES
-2.500 PUNTS
-
-## 19 - INSTRUCCIONES
-5.000 PUNTS
-
-## 20 - INSTRUCCIONES
-PARA EL TEMPS
-
-## 21 - INSTRUCCIONES
-VIDA EXTRA
-
-## 22 - INSTRUCCIONES
-PREM UNA TECLA PER A TORNAR
-
-## 23 - TITULO
-PULSA PER JUGAR
-
-## 24 - MENU SELECCION DE IDIOMA
-ESPA{OL (ESPANYOL)
-
-## 25 - MENU SELECCION DE IDIOMA
-BALOONCIA
-
-## 26 - MENU SELECCION DE IDIOMA
-ENGLISH (ANGLES)
-
-## 27 - INTRO
-Un dia qualsevol de l'any 2000
-
-## 28 - INTRO
-Tot esta tranquil a la UPV
-
-## 29 - INTRO
-Fins que un desaprensiu...
-
-## 30 - INTRO
-HEY! ME ANE A FERME UN CORTAET...
-
-## 31 - INTRO
-UAAAAAAAAAAAAA!!!
-
-## 32 - INTRO
-Espera un moment...
-
-## 33 - INTRO
-Si resulta que no tinc solt!
-
-## 34 - INTRO
-VAJA BIRRIA DE MAQUINA !!!
-
-## 35 - INTRO
-blop... blop... blop...
-
-## 36 - TEXTOS DEL JUEGO
-Temps detes: 
-
-## 37 - TEXTOS DEL JUEGO
-D E M O
-
-## 38 - TEXTOS DEL JUEGO
- fases mes!
-
-## 39 - MENU SELECCION DE JUGADOR
-Selecciona personatge
-
-## 40 - MENU SELECCION DE JUGADOR
-Enrere
-
-## 41 - MENU DE PAUSA
-Menu de pausa
-
-## 42 - TABLA DE RECORDS
-Millors puntuacions
-
-## 43 - PANTALLA DE GAME OVER
-FI DEL JOC
-
-## 44 - PANTALLA DE GAME OVER
-ELS TEUS PUNTS: 
-
-## 45 - PANTALLA DE GAME OVER
-CONTINUAR?
-
-## 46 - MENU DE PAUSA
-CONTINUAR
-
-## 47 - MENU DE PAUSA
-EIXIR DEL JOC
-
-## 48 - MENU GAME OVER
-SI
-
-## 49 - MENU GAME OVER
-NO
-
-## 50 - TEXTO DE COMPLETAR EL JUEGO
-Felicitats!!
-
-## 51 - MENU DEL TITULO
-1 JUGADOR
-
-## 52 - MENU DEL TITULO
-2 JUGADORS
-
-## 53 MARCADOR
-Jugador 1
-
-## 54 MARCADOR
-Jugador 2
-
-## 55 MARCADOR
-Multiplicador
-
-## 56 MARCADOR
-Max. puntuacio
-
-## 57 MARCADOR
-Fase 
-
-## 58 - MENU DE OPCIONES
-MODE DE VISUALITZACIO
-
-## 59 - MENU DE OPCIONES
-DIFICULTAT
-
-## 60 - MENU DE OPCIONES
-FILTRE
-
-## 61 - MENU DE OPCIONES
-SINC. VERTICAL
-
-## 62 - MENU DE OPCIONES
-CONTROLS DEL JUGADOR 1
-
-## 63 - MENU DE OPCIONES
-CONTROLS DEL JUGADOR 2
-
-## 64 - MENU DE OPCIONES
-(FORA DE LINEA)
-
-## 65 - 
--
-
-## 66 - MENU DE OPCIONES
-FACIL
-
-## 67 - MENU DE OPCIONES
-NORMAL
-
-## 68 - MENU DE OPCIONES
-DIFICIL
-
-## 69 - MENU DE OPCIONES
-Teclat
-
-## 70 - MENU DE OPCIONES
-MANDO
-
-## 71 - MENU DE OPCIONES
-LINEAL
-
-## 72 - MENU DE OPCIONES
-NEAREST
-
-## 73 - MENU DE OPCIONES
-ACTIVADA
-
-## 74 - MENU DE OPCIONES
-DESACTIVADA
-
-## 75 - JUEGO
-Endavant!
-
-## 76 - JUEGO
-1.000.000 de punts!
-
-## 77 - PANTALLA DE GAME OVER
-PUNTS J1: 
-
-## 78 - PANTALLA DE GAME OVER
-PUNTS J2: 
-
-## 79 - TEXTOS DEL JUEGO
-Ultima fase!
-
-## 80 - NOTIFICACIONES
-Fallo al conectar a
-
-## 81 - NOTIFICACIONES
-No s'ha pogut obtenir
-
-## 82 - NOTIFICACIONES
-la puntuacio online
-
-## 83 - NOTIFICACIONES
-No ha especificat
-
-## 84 - NOTIFICACIONES
-cap jailerID
-
-## 85 - NOTIFICACIONES
-ha iniciat la sesio
-
-## 86 - NOTIFICACIONES
-Punts enviats: 
-
-## 87 - NOTIFICACIONES
-No s'ha pogut
-
-## 88 - NOTIFICACIONES
-enviar la puntuacio
-
-## 89 - ENTER ID
-CONFIGURACIO EN LINEA
-
-## 90 - ENTER ID
-INTRODUEIX UN JAILER_ID
-
-## 91 - ENTER ID
-DEIXA BUIT PER A
-
-## 92 - ENTER ID
-MODE FORA DE LINEA
-
-## 93 - MENU OPCIONES
-TAULER DE PUNTS
-
-## 94 - NOTIFICACIONES
-Torna a polsar per eixir
-
-## 95 - DEFINE BUTTONS
-Disparar cap a l'esquerra
-
-## 96 - DEFINE BUTTONS
-Disparar cap amunt
-
-## 97 - DEFINE BUTTONS
-Disparar cap a la dreta
-
-## 98 - DEFINE BUTTONS
-Start
-
-## 99 - DEFINE BUTTONS
-Servei
-
-## 100 - DEFINE BUTTONS
-Jugador 
-
-## 101 - MARCADOR
-Mode demostracio
-
-## 102 - MARCADOR
-Game Over
-
-## 103 - MARCADOR
-Pulsa START
-
-## 104 - MARCADOR
-per jugar
-
-## 105 - MARCADOR
-Continuar?
-
-## 106 - MARCADOR
-Posa el nom
-
-## 107 - AJUDA
-Intercanviar mandos
-
-## 108 - AJUDA
-Configuracio
-
-## 109 - AJUDA
-Alternar el audio
-
-## 110 - AJUDA
-Filtres
-
-## 111 - AJUDA
-Reiniciar
-
-## 112 - AJUDA
-Pausar
-
-## 113 - AJUDA
-Eixir
-
-## 114 - MARCADOR
-Per favor
-
-## 115 - MARCADOR
-espere
-
-## 116 - NOTIFICACIONES
-Torna a polsar per apagar el sistema
-
-## 117 - GAME TEXT
-SuperPoder!
-
-## 118 - GAME TEXT
-+1 Colp
-
-## 119 - GAME TEXT
-Temps!
-
-## 120 - SCOREBOARD
-Puntuacio
-
-## 121 - CREDITS
-PROGRAMAT I DISSENYAT PER
-
-## 122 - CREDITS
-GRAFICS DIBUIXATS PER
-
-## 123 - CREDITS
-MUSICA COMPOSADA PER
-
-## 124 - CREDITS
-EFECTES DE SO
-
-## 125 - NOTIFICACIONES
-Torna a polsar per reiniciar
-
-## 126 - NOTIFICACIONES
-Torna a polsar per canviar el idioma a
-
-## 127 - NOTIFICACIONES
-Idioma canviat a
-
-## 128 - VARIOS
-activat
-
-## 129 - VARIOS
-desactivat
-
-## 130 - VARIOS
-Dispar automatic
-
-## 131 - VARIOS
-Zoom de finestra
-
-## 132 - VARIOS
-Mode finestra
-
-## 133 - VARIOS
-Mode pantalla completa
-
-## 134 - VARIOS
-Mode d'escalat sencer
-
-## 135 - VARIOS
-Filtre

data/lang/en_UK.json

@@ -0,0 +1,112 @@
+{
+    "[CREDITS] PROGRAMMED_AND_DESIGNED_BY": "PROGRAMMED AND DESIGNED BY",
+    "[CREDITS] PIXELART_DRAWN_BY"         : "PIXELART DRAWN BY",
+    "[CREDITS] MUSIC_COMPOSED_BY"         : "MUSIC COMPOSED BY",
+    "[CREDITS] SOUND_EFFECTS"             : "SOUND EFFECTS",
+
+    "[DEFINE_BUTTONS] FIRE_LEFT"   : "Fire left",
+    "[DEFINE_BUTTONS] FIRE_UP"     : "Fire up",
+    "[DEFINE_BUTTONS] FIRE_RIGHT"  : "Fire right",
+    "[DEFINE_BUTTONS] START"       : "Start",
+    "[DEFINE_BUTTONS] SERVICE_MENU": "Service menu",
+    "[DEFINE_BUTTONS] PLAYER"      : "Player",
+    "[DEFINE_BUTTONS] KEYBOARD"    : "Keyboard",
+
+    "[GAME_TEXT] 1": "Congratulations!!",
+    "[GAME_TEXT] 2": " stages left!",
+    "[GAME_TEXT] 3": "Last stage!",
+    "[GAME_TEXT] 4": "PowerUp",
+    "[GAME_TEXT] 5": "+1 Hit",
+    "[GAME_TEXT] 6": "Stop!",
+    "[GAME_TEXT] 7": "Get Ready!",
+    "[GAME_TEXT] 8": "1.000.000 points!",
+
+    "[HIGHSCORE_TABLE] CAPTION": "Best scores",
+    
+    "[INSTRUCTIONS] 01": "OBJECTIVE",
+    "[INSTRUCTIONS] 02": "YOU HAVE TO POP AS MANY",
+    "[INSTRUCTIONS] 03": "BALLOONS AS YOU CAN",
+    "[INSTRUCTIONS] 04": "DIFFICULTY WILL BE INCREASED",
+    "[INSTRUCTIONS] 05": "AS YOU SCORE POINTS",
+    "[INSTRUCTIONS] 06": "ITEMS",
+    "[INSTRUCTIONS] 07": "1.000 POINTS",
+    "[INSTRUCTIONS] 08": "2.500 POINTS",
+    "[INSTRUCTIONS] 09": "5.000 POINTS",
+    "[INSTRUCTIONS] 10": "TIME STOPPER",
+    "[INSTRUCTIONS] 11": "EXTRA HIT",
+    
+    "[INTRO] 1": "Any day of the year 2000",
+    "[INTRO] 2": "Everything is quiet at the UPV",
+    "[INTRO] 3": "Until a bastard arrives...",
+    "[INTRO] 4": "YO! GONNA TAKE A CAFELITO...",
+    "[INTRO] 5": "AAAAAAAARGHHHH!!!",
+    "[INTRO] 6": "Wait a moment...",
+    "[INTRO] 7": "I don't have any loose!",
+    "[INTRO] 8": "FUCKING MACHINE!",
+    "[INTRO] 9": "Blop... blop... blop...",
+    
+    "[NOTIFICATIONS] 01": "Press again to quit",
+    "[NOTIFICATIONS] 02": "Press again to shutdown system",
+    "[NOTIFICATIONS] 03": "Press again to reset",
+    "[NOTIFICATIONS] 04": "Press again to change language to",
+    "[NOTIFICATIONS] 05": "Language set to",
+    "[NOTIFICATIONS] 06": "on",
+    "[NOTIFICATIONS] 07": "off",
+    "[NOTIFICATIONS] 08": "Autofire",
+    "[NOTIFICATIONS] 09": "Window zoom",
+    "[NOTIFICATIONS] 10": "Window mode",
+    "[NOTIFICATIONS] 11": "Fullscreen mode",
+    "[NOTIFICATIONS] 12": "Integer scale",
+    "[NOTIFICATIONS] 13": "Filter",
+    "[NOTIFICATIONS] 14": "Vertical Sync",
+    "[NOTIFICATIONS] 15": "Reset",
+
+    "[RESOURCE] LOADING": "Loading",
+
+    "[SERVICE_MENU] TITLE": "Service Menu",
+    "[SERVICE_MENU] RESET": "Reset",
+    "[SERVICE_MENU] QUIT": "Quit Game",
+    "[SERVICE_MENU] SHUTDOWN": "Shutdown System",
+    "[SERVICE_MENU] FULLSCREEN": "Fullscreen",
+    "[SERVICE_MENU] WINDOW_SIZE": "Window Size",
+    "[SERVICE_MENU] SHADERS": "Shaders",
+    "[SERVICE_MENU] VSYNC": "V-Sync",
+    "[SERVICE_MENU] INTEGER_SCALE": "Integer Scale",
+    "[SERVICE_MENU] MAIN_VOLUME": "Main Volume",
+    "[SERVICE_MENU] MUSIC_VOLUME": "Music Volume",
+    "[SERVICE_MENU] SFX_VOLUME": "Sound Volume",
+    "[SERVICE_MENU] AUTOFIRE": "Autofire",
+    "[SERVICE_MENU] LANGUAGE": "Language",
+    "[SERVICE_MENU] LANG_ES": "Spanish",
+    "[SERVICE_MENU] LANG_EN": "English",
+    "[SERVICE_MENU] LANG_BA": "Balooncia",
+    "[SERVICE_MENU] VIDEO": "Video",
+    "[SERVICE_MENU] AUDIO": "Audio",
+    "[SERVICE_MENU] SETTINGS": "Settings",
+    "[SERVICE_MENU] SYSTEM": "System",
+    "[SERVICE_MENU] ON": "On",
+    "[SERVICE_MENU] OFF": "Off",
+    "[SERVICE_MENU] DIFFICULTY": "Difficulty",
+    "[SERVICE_MENU] EASY": "Easy",
+    "[SERVICE_MENU] NORMAL": "Normal",
+    "[SERVICE_MENU] HARD": "Hard",
+    "[SERVICE_MENU] NEED_RESTART_MESSAGE": "Restart to apply changes",
+    "[SERVICE_MENU] ENABLE_SHUTDOWN": "Enable shutdown",
+    
+    "[SCOREBOARD] 1": "Player 1",
+    "[SCOREBOARD] 2": "Player 2",
+    "[SCOREBOARD] 3": "Multiplier",
+    "[SCOREBOARD] 4": "High Score",
+    "[SCOREBOARD] 5": "Stage",
+    "[SCOREBOARD] 6": "Demo mode",
+    "[SCOREBOARD] 7": "Game Over",
+    "[SCOREBOARD] 8": "Press START",
+    "[SCOREBOARD] 9": "to play",
+    "[SCOREBOARD] 10": "Continue?",
+    "[SCOREBOARD] 11": "Enter name",
+    "[SCOREBOARD] 12": "Please",
+    "[SCOREBOARD] 13": "wait",
+    "[SCOREBOARD] 14": "Score",
+
+    "[TITLE] PRESS_BUTTON_TO_PLAY": "PRESS START BUTTON TO PLAY"
+}

data/lang/en_UK.txt

@@ -1,407 +0,0 @@
-## 0 - MENU DEL TITULO
-PLAY
-
-## 1 - MENU DEL TITULO
-OPTIONS
-
-## 2 - MENU DEL TITULO
-HOW TO PLAY
-
-## 3 - MENU DEL TITULO
-QUIT
-
-## 4 - MENU DE OPCIONES
-WINDOW
-
-## 5 - MENU DE OPCIONES
-FULLSCREEN
-
-## 6 - MENU DE OPCIONES
-FAKE FULLSCREEN
-
-## 7 - MENU DE OPCIONES
-WINDOW SIZE
-
-## 8 - MENU DE OPCIONES
-LANGUAGE
-
-## 9 - MENU DE OPCIONES
-[ ACCEPT ]
-
-## 10 - MENU DE OPCIONES
-[ CANCEL ]
-
-## 11 - INSTRUCCIONES
-OBJECTIVE
-
-## 12 - INSTRUCCIONES
-YOU HAVE TO POP AS MANY
-
-## 13 - INSTRUCCIONES
-BALLOONS AS YOU CAN
-
-## 14 - INSTRUCCIONES
-DIFFICULTY WILL BE INCREASED
-
-## 15 - INSTRUCCIONES
-AS YOU SCORE POINTS
-
-## 16 - INSTRUCCIONES
-ITEMS
-
-## 17 - INSTRUCCIONES
-1.000 POINTS
-
-## 18 - INSTRUCCIONES
-2.500 POINTS
-
-## 19 - INSTRUCCIONES
-5.000 POINTS
-
-## 20 - INSTRUCCIONES
-TIME STOPPER
-
-## 21 - INSTRUCCIONES
-EXTRA HIT
-
-## 22 - INSTRUCCIONES
-PRESS ANY KEY TO RETURN
-
-## 23 - TITULO
-PRESS START BUTTON TO PLAY
-
-## 24 - MENU SELECCION DE IDIOMA
-ESPA{OL (SPANISH)
-
-## 25 - MENU SELECCION DE IDIOMA
-BALOONCIA (VALENCIAN)
-
-## 26 - MENU SELECCION DE IDIOMA
-ENGLISH
-
-## 27 - INTRO
-Any day of the year 2000
-
-## 28 - INTRO
-Everything is quiet at the UPV
-
-## 29 - INTRO
-Until a bastard arrives...
-
-## 30 - INTRO
-  YO! GONNA TAKE A CAFELITO...  
-
-## 31 - INTRO
-AAAAAAAARGHHHH!!!
-
-## 32 - INTRO
-Wait a moment...
-
-## 33 - INTRO
-  I don't have any loose!  
-
-## 34 - INTRO
-FUCKING MACHINE!
-
-## 35 - INTRO
-Blop... blop... blop...
-
-## 36 - TEXTOS DEL JUEGO
-Time stopped: 
-
-## 37 - TEXTOS DEL JUEGO
-D E M O
-
-## 38 - TEXTOS DEL JUEGO
- stages left!
-
-## 39 - MENU SELECCION DE JUGADOR
-Select Player
-
-## 40 - MENU SELECCION DE JUGADOR
-Back
-
-## 41 - MENU DE PAUSA
-Pause Menu
-
-## 42 - TABLA DE RECORDS
-Best scores
-
-## 43 - PANTALLA DE GAME OVER
-GAME OVER
-
-## 44 - PANTALLA DE GAME OVER
-YOUR SCORE: 
-
-## 45 - PANTALLA DE GAME OVER
-CONTINUE?
-
-## 46 - MENU DE PAUSA
-CONTINUE
-
-## 47 - MENU DE PAUSA
-LEAVE GAME
-
-## 48 - MENU GAME OVER
-YES
-
-## 49 - MENU GAME OVER
-NO
-
-## 50 - TEXTO DE COMPLETAR EL JUEGO
-Congratulations!!
-
-## 51 - MENU DEL TITULO
-1 PLAYER
-
-## 52 - MENU DEL TITULO
-2 PLAYERS
-
-## 53 - MARCADOR
-Player 1
-
-## 54 - MARCADOR
-Player 2
-
-## 55 - MARCADOR
-Multiplier
-
-## 56 - MARCADOR
-High Score
-
-## 57 - MARCADOR
-Stage 
-
-## 58 - MENU DE OPCIONES
-DISPLAY MODE
-
-## 59 - MENU DE OPCIONES
-DIFFICULTY
-
-## 60 - MENU DE OPCIONES
-FILTER
-
-## 61 - MENU DE OPCIONES
-VSYNC
-
-## 62 - MENU DE OPCIONES
-PLAYER 1 CONTROLS
-
-## 63 - MENU DE OPCIONES
-PLAYER 2 CONTROLS
-
-## 64 - MENU DE OPCIONES
-(OFFLINE MODE)
-
-## 65 - 
--
-
-## 66 - MENU DE OPCIONES
-EASY
-
-## 67 - MENU DE OPCIONES
-NORMAL
-
-## 68 - MENU DE OPCIONES
-HARD
-
-## 69 - MENU DE OPCIONES
-Keyboard
-
-## 70 - MENU DE OPCIONES
-GAME CONTROLLER
-
-## 71 - MENU DE OPCIONES
-LINEAL
-
-## 72 - MENU DE OPCIONES
-NEAREST
-
-## 73 - MENU DE OPCIONES
-ON
-
-## 74 - MENU DE OPCIONES
-OFF
-
-## 75 - JUEGO
-Get Ready!
-
-## 76 - JUEGO
-1.000.000 points!
-
-## 77 - PANTALLA DE GAME OVER
-PLAYER1 SCORE: 
-
-## 78 - PANTALLA DE GAME OVER
-PLAYER2 SCORE: 
-
-## 79 - TEXTOS DEL JUEGO
-Last stage!
-
-## 80 - NOTIFICACIONES
-Failed connecting to
-
-## 81 - NOTIFICACIONES
-Can't get
-
-## 82 - NOTIFICACIONES
-online scores
-
-## 83 - NOTIFICACIONES
-No JailerID
-
-## 84 - NOTIFICACIONES
-name was set
-
-## 85 - NOTIFICACIONES
-is logged in
-
-## 86 - NOTIFICACIONES
-Score submitted
-
-## 87 - NOTIFICACIONES
-Failed to send
-
-## 88 - NOTIFICACIONES
-score to online server
-
-## 89 - ENTER ID
-ONLINE CONFIGURATION
-
-## 90 - ENTER ID
-PLEASE ENTER AN ID
-
-## 91 - ENTER ID
-LEAVE BLANK FOR
-
-## 92 - ENTER ID
-OFFLINE MODE
-
-## 93 - MENU OPCIONES
-HISCORE TABLE
-
-## 94 - NOTIFICACIONES
-Press again to quit
-
-## 95 - DEFINE BUTTONS
-Fire left
-
-## 96 - DEFINE BUTTONS
-Fire up
-
-## 97 - DEFINE BUTTONS
-Fire right
-
-## 98 - DEFINE BUTTONS
-Start
-
-## 99 - DEFINE BUTTONS
-Service
-
-## 100 - DEFINE BUTTONS
-Player
-
-## 101 - MARCADOR
-Demo mode
-
-## 102 - MARCADOR
-Game Over
-
-## 103 - MARCADOR
-Press START
-
-## 104 - MARCADOR
-to play
-
-## 105 - MARCADOR
-Continue?
-
-## 106 - MARCADOR
-Enter name
-
-## 107 - AJUDA
-Swap Controllers
-
-## 108 - AJUDA
-Configuration
-
-## 109 - AJUDA
-Toggle audio
-
-## 110 - AJUDA
-Shaders
-
-## 111 - AJUDA
-Reset
-
-## 112 - AJUDA
-Pause
-
-## 113 - AJUDA
-Exit
-
-## 114 - MARCADOR
-Please
-
-## 115 - MARCADOR
-wait
-
-## 116 - NOTIFICACIONES
-Press again to shutdown system
-
-## 117 - GAME TEXT
-PowerUp
-
-## 118 - GAME TEXT
-+1 Hit
-
-## 119 - GAME TEXT
-Stop!
-
-## 120 - SCOREBOARD
-Score
-
-## 121 - CREDITS
-PROGRAMMED AND DESIGNED BY
-
-## 122 - CREDITS
-PIXELART DRAWN BY
-
-## 123 - CREDITS
-MUSIC COMPOSED BY
-
-## 124 - CREDITS
-SOUND EFFECTS
-
-## 125 - NOTIFICACIONES
-Press again to reset
-
-## 126 - NOTIFICACIONES
-Press again to change languaje to
-
-## 127 - NOTIFICACIONES
-Language set to
-
-## 128 - VARIOS
-on
-
-## 129 - VARIOS
-off
-
-## 130 - VARIOS
-Autofire
-
-## 131 - VARIOS
-Window zoom
-
-## 132 - VARIOS
-Window mode
-
-## 133 - VARIOS
-Fullscreen mode
-
-## 134 - VARIOS
-Integer scale
-
-## 135 - VARIOS
-Filter

data/lang/es_ES.json

@@ -0,0 +1,112 @@
+{
+    "[CREDITS] PROGRAMMED_AND_DESIGNED_BY": "PROGRAMADO Y DISENADO POR",
+    "[CREDITS] PIXELART_DRAWN_BY": "GRAFICOS DIBUJADOS POR",
+    "[CREDITS] MUSIC_COMPOSED_BY": "MUSICA COMPUESTA POR",
+    "[CREDITS] SOUND_EFFECTS": "EFECTOS DE SONIDO",
+
+    "[DEFINE_BUTTONS] FIRE_LEFT": "Disparar a la izquierda",
+    "[DEFINE_BUTTONS] FIRE_UP": "Disparar hacia arriba",
+    "[DEFINE_BUTTONS] FIRE_RIGHT": "Disparar hacia la derecha",
+    "[DEFINE_BUTTONS] START": "Start",
+    "[DEFINE_BUTTONS] SERVICE_MENU": "Menu de servicio",
+    "[DEFINE_BUTTONS] PLAYER": "Jugador",
+    "[DEFINE_BUTTONS] KEYBOARD": "Teclado",
+
+    "[GAME_TEXT] 1": "Felicidades!!",
+    "[GAME_TEXT] 2": " fases mas!",
+    "[GAME_TEXT] 3": "Ultima fase!",
+    "[GAME_TEXT] 4": "Potenciador",
+    "[GAME_TEXT] 5": "+1 Golpe",
+    "[GAME_TEXT] 6": "Tiempo!",
+    "[GAME_TEXT] 7": "Adelante!",
+    "[GAME_TEXT] 8": "1.000.000 de puntos!",
+    
+    "[HIGHSCORE_TABLE] CAPTION": "Mejores puntuaciones",
+    
+    "[INSTRUCTIONS] 01": "OBJETIVO",
+    "[INSTRUCTIONS] 02": "TIENES QUE EXPLOTAR",
+    "[INSTRUCTIONS] 03": "TANTOS GLOBOS COMO PUEDAS",
+    "[INSTRUCTIONS] 04": "LA DIFICULTAD SE INCREMENTA",
+    "[INSTRUCTIONS] 05": "A MEDIDA QUE VAS PUNTUANDO",
+    "[INSTRUCTIONS] 06": "OBJETOS",
+    "[INSTRUCTIONS] 07": "1.000 PUNTOS",
+    "[INSTRUCTIONS] 08": "2.500 PUNTOS",
+    "[INSTRUCTIONS] 09": "5.000 PUNTOS",
+    "[INSTRUCTIONS] 10": "DETIENE EL TIEMPO",
+    "[INSTRUCTIONS] 11": "VIDA EXTRA",
+    
+    "[INTRO] 1": "Un dia cualquiera del ano 2000",
+    "[INTRO] 2": "Todo esta tranquilo en la UPV",
+    "[INTRO] 3": "Hasta que un desaprensivo...",
+    "[INTRO] 4": "HEY! VOY A SACARME UN TALLADET...",
+    "[INTRO] 5": "UAAAAAAAAAAAAA!!!",
+    "[INTRO] 6": "Espera un momento...",
+    "[INTRO] 7": "Si no llevo suelto encima!",
+    "[INTRO] 8": "MIERDA DE MAQUINA!",
+    "[INTRO] 9": "Blop... blop... blop...",
+    
+    "[NOTIFICATIONS] 01": "Pulsa otra vez para salir",
+    "[NOTIFICATIONS] 02": "Pulsa otra vez para apagar el sistema",
+    "[NOTIFICATIONS] 03": "Vuelve a pulsar para reiniciar",
+    "[NOTIFICATIONS] 04": "Vuelve a pulsar para cambiar el idioma a",
+    "[NOTIFICATIONS] 05": "Idioma cambiado a",
+    "[NOTIFICATIONS] 06": "activado",
+    "[NOTIFICATIONS] 07": "desactivado",
+    "[NOTIFICATIONS] 08": "Disparo automatico",
+    "[NOTIFICATIONS] 09": "Zoom de ventana",
+    "[NOTIFICATIONS] 10": "Modo ventana",
+    "[NOTIFICATIONS] 11": "Modo pantalla completa",
+    "[NOTIFICATIONS] 12": "Modo de escalado entero",
+    "[NOTIFICATIONS] 13": "Filtro",
+    "[NOTIFICATIONS] 14": "Sincronismo vertical",
+    "[NOTIFICATIONS] 15": "Reiniciar",
+
+    "[RESOURCE] LOADING": "Cargando",
+
+    "[SERVICE_MENU] TITLE": "Menu de servicio",
+    "[SERVICE_MENU] RESET": "Reiniciar",
+    "[SERVICE_MENU] QUIT": "Salir del juego",
+    "[SERVICE_MENU] SHUTDOWN": "Apagar el sistema",
+    "[SERVICE_MENU] FULLSCREEN": "Pantalla completa",
+    "[SERVICE_MENU] WINDOW_SIZE": "Zoom de ventana",
+    "[SERVICE_MENU] SHADERS": "Filtro",
+    "[SERVICE_MENU] VSYNC": "Sincronismo vertical",
+    "[SERVICE_MENU] INTEGER_SCALE": "Escalado entero",
+    "[SERVICE_MENU] MAIN_VOLUME": "Volumen general",
+    "[SERVICE_MENU] MUSIC_VOLUME": "Volumen de la musica",
+    "[SERVICE_MENU] SFX_VOLUME": "Volumen de los efectos",
+    "[SERVICE_MENU] AUTOFIRE": "Disparo automatico",
+    "[SERVICE_MENU] LANGUAGE": "Idioma",
+    "[SERVICE_MENU] LANG_ES": "Castellano",
+    "[SERVICE_MENU] LANG_EN": "Ingles",
+    "[SERVICE_MENU] LANG_BA": "Balooncia",
+    "[SERVICE_MENU] VIDEO": "Video",
+    "[SERVICE_MENU] AUDIO": "Audio",
+    "[SERVICE_MENU] SETTINGS": "Configuracion",
+    "[SERVICE_MENU] SYSTEM": "Sistema",
+    "[SERVICE_MENU] ON": "Activado",
+    "[SERVICE_MENU] OFF": "Desactivado",
+    "[SERVICE_MENU] DIFFICULTY": "Dificultad",
+    "[SERVICE_MENU] EASY": "Facil",
+    "[SERVICE_MENU] NORMAL": "Normal",
+    "[SERVICE_MENU] HARD": "Dificil",
+    "[SERVICE_MENU] NEED_RESTART_MESSAGE": "Reiniciar para aplicar cambios",
+    "[SERVICE_MENU] ENABLE_SHUTDOWN": "Permitir apagar el sistema",
+
+    "[SCOREBOARD] 1": "Jugador 1",
+    "[SCOREBOARD] 2": "Jugador 2",
+    "[SCOREBOARD] 3": "Multiplicador",
+    "[SCOREBOARD] 4": "Max. puntuacion",
+    "[SCOREBOARD] 5": "Fase",
+    "[SCOREBOARD] 6": "Modo demostracion",
+    "[SCOREBOARD] 7": "Game Over",
+    "[SCOREBOARD] 8": "Pulsa START",
+    "[SCOREBOARD] 9": "para jugar",
+    "[SCOREBOARD] 10": "Continuar?",
+    "[SCOREBOARD] 11": "Pon tu nombre",
+    "[SCOREBOARD] 12": "Por favor",
+    "[SCOREBOARD] 13": "espere",
+    "[SCOREBOARD] 14": "Puntuacion",
+
+    "[TITLE] PRESS_BUTTON_TO_PLAY": "PULSA UN BOTON PARA JUGAR"
+}

data/lang/es_ES.txt

@@ -1,407 +0,0 @@
-## 0 - MENU DEL TITULO
-JUGAR
-
-## 1 - MENU DEL TITULO
-OPCIONES
-
-## 2 - MENU DEL TITULO
-INSTRUCCIONES
-
-## 3 - MENU DEL TITULO
-SALIR
-
-## 4 - MENU DE OPCIONES
-VENTANA
-
-## 5 - MENU DE OPCIONES
-PANTALLA COMPLETA
-
-## 6 - MENU DE OPCIONES
-PANTALLA COMPLETA FALSA
-
-## 7 - MENU DE OPCIONES
-TAMA{O DE VENTANA
-
-## 8 - MENU DE OPCIONES
-IDIOMA
-
-## 9 - MENU DE OPCIONES
-[ ACEPTAR ]
-
-## 10 - MENU DE OPCIONES
-[ CANCELAR ]
-
-## 11 - INSTRUCCIONES
-OBJETIVO
-
-## 12 - INSTRUCCIONES
-TIENES QUE EXPLOTAR
-
-## 13 - INSTRUCCIONES
-TANTOS GLOBOS COMO PUEDAS
-
-## 14 - INSTRUCCIONES
-LA DIFICULTAD SE INCREMENTA
-
-## 15 - INSTRUCCIONES
-A MEDIDA QUE VAS PUNTUANDO
-
-## 16 - INSTRUCCIONES
-OBJETOS
-
-## 17 - INSTRUCCIONES
-1.000 PUNTOS
-
-## 18 - INSTRUCCIONES
-2.500 PUNTOS
-
-## 19 - INSTRUCCIONES
-5.000 PUNTOS
-
-## 20 - INSTRUCCIONES
-DETIENE EL TIEMPO
-
-## 21 - INSTRUCCIONES
-VIDA EXTRA
-
-## 22 - INSTRUCCIONES
-PULSA UNA TECLA PARA VOLVER
-
-## 23 - TITULO
-PULSA UN BOTON PARA JUGAR
-
-## 24 - MENU SELECCION DE IDIOMA
-ESPA{OL
-
-## 25 - MENU SELECCION DE IDIOMA
-BALOONCIA (VALENCIANO)
-
-## 26 - MENU SELECCION DE IDIOMA
-ENGLISH (INGLES)
-
-## 27 - INTRO
-Un dia cualquiera del a{o 2000
-
-## 28 - INTRO
-Todo esta tranquilo en la UPV
-
-## 29 - INTRO
-Hasta que un desaprensivo...
-
-## 30 - INTRO
-HEY! VOY A SACARME UN TALLADET...
-
-## 31 - INTRO
-UAAAAAAAAAAAAA!!!
-
-## 32 - INTRO
-Espera un momento...
-
-## 33 - INTRO
-Si no llevo suelto encima!
-
-## 34 - INTRO
-MIERDA DE MAQUINA!
-
-## 35 - INTRO
-Blop... blop... blop...
-
-## 36 - TEXTOS DEL JUEGO
-Tiempo: 
-
-## 37 - TEXTOS DEL JUEGO
-D E M O
-
-## 38 - TEXTOS DEL JUEGO
- fases mas!
-
-## 39 - MENU SELECCION DE JUGADOR
-Selecciona jugador
-
-## 40 - MENU SELECCION DE JUGADOR
-Volver
-
-## 41 - MENU DE PAUSA
-Menu de pausa
-
-## 42 - TABLA DE RECORDS
-Mejores puntuaciones
-
-## 43 - PANTALLA DE GAME OVER
-FIN DE JUEGO
-
-## 44 - PANTALLA DE GAME OVER
-TU PUNTUACION: 
-
-## 45 - PANTALLA DE GAME OVER
-CONTINUAR?
-
-## 46 - MENU DE PAUSA
-CONTINUAR
-
-## 47 - MENU DE PAUSA
-SALIR DEL JUEGO
-
-## 48 - MENU GAME OVER
-SI
-
-## 49 - MENU GAME OVER
-NO
-
-## 50 - TEXTO DE COMPLETAR EL JUEGO
-Felicidades!!
-
-## 51 - MENU DEL TITULO
-1 JUGADOR
-
-## 52 - MENU DEL TITULO
-2 JUGADORES
-
-## 53 - MARCADOR
-Jugador 1
-
-## 54 - MARCADOR
-Jugador 2
-
-## 55 - MARCADOR
-Multiplicador
-
-## 56 - MARCADOR
-Max. puntuacion
-
-## 57 - MARCADOR
-Fase 
-
-## 58 - MENU DE OPCIONES
-MODO DE VISUALIZACION
-
-## 59 - MENU DE OPCIONES
-DIFICULTAD
-
-## 60 - MENU DE OPCIONES
-FILTRO
-
-## 61 - MENU DE OPCIONES
-SINC. VERTICAL
-
-## 62 - MENU DE OPCIONES
-CONTROLES DEL JUGADOR 1
-
-## 63 - MENU DE OPCIONES
-CONTROLES DEL JUGADOR 2
-
-## 64 - MENU DE OPCIONES
-(MODO OFFLINE)
-
-## 65 - 
--
-
-## 66 - MENU DE OPCIONES
-FACIL
-
-## 67 - MENU DE OPCIONES
-NORMAL
-
-## 68 - MENU DE OPCIONES
-DIFICIL
-
-## 69 - MENU DE OPCIONES
-Teclado
-
-## 70 - MENU DE OPCIONES
-MANDO
-
-## 71 - MENU DE OPCIONES
-LINEAL
-
-## 72 - MENU DE OPCIONES
-NEAREST
-
-## 73 - MENU DE OPCIONES
-ACTIVADA
-
-## 74 - MENU DE OPCIONES
-DESACTIVADA
-
-## 75 - JUEGO
-Adelante!
-
-## 76 - JUEGO
-1.000.000 de puntos!
-
-## 77 - PANTALLA DE GAME OVER
-PUNTUACION J1: 
-
-## 78 - PANTALLA DE GAME OVER
-PUNTUACION J2: 
-
-## 79 - TEXTOS DEL JUEGO
-Ultima fase!
-
-## 80 - NOTIFICACIONES
-Fallo al conectar a 
-
-## 81 - NOTIFICACIONES
-No se ha podido obtener
-
-## 82 - NOTIFICACIONES
-la puntuacion online
-
-## 83 - NOTIFICACIONES
-No se ha especificado
-
-## 84 - NOTIFICACIONES
-ningun jailerID
-
-## 85 - NOTIFICACIONES
-ha iniciado la sesion
-
-## 86 - NOTIFICACIONES
-Puntos enviados: 
-
-## 87 - NOTIFICACIONES
-No se ha podido
-
-## 88 - NOTIFICACIONES
-enviar la puntuacion
-
-## 89 - ENTER ID
-CONFIGURACION ONLNE
-
-## 90 - ENTER ID
-INTRODUCE UN JAILER_ID
-
-## 91 - ENTER ID
-DEJA EN BLANCO PARA
-
-## 92 - ENTER ID
-MODO SIN CONEXION
-
-## 93 - MENU OPCIONES
-TABLA DE PUNTUACIONES
-
-## 94 - NOTIFICACIONES
-Pulsa otra vez para salir
-
-## 95 - DEFINE BUTTONS
-Disparar a la izquierda
-
-## 96 - DEFINE BUTTONS
-Disparar hacia arriba
-
-## 97 - DEFINE BUTTONS
-Disparar hacia la derecha
-
-## 98 - DEFINE BUTTONS
-Start
-
-## 99 - DEFINE BUTTONS
-Servicio
-
-## 100 - DEFINE BUTTONS
-Jugador 
-
-## 101 - MARCADOR
-Mode demostracion
-
-## 102 - MARCADOR
-Game Over
-
-## 103 - MARCADOR
-Pulsa START
-
-## 104 - MARCADOR
-para jugar
-
-## 105 - MARCADOR
-Continuar?
-
-## 106 - MARCADOR
-Pon tu nombre
-
-## 107 - AJUDA
-Intercambiar mandos
-
-## 108 - AJUDA
-Configuracion
-
-## 109 - AJUDA
-Alternar el audio
-
-## 110 - AJUDA
-Filtros
-
-## 111 - AJUDA
-Reiniciar
-
-## 112 - AJUDA
-Pausar
-
-## 113 - AJUDA
-Salir
-
-## 114 - MARCADOR
-Por favor
-
-## 115 - MARCADOR
-espere
-
-## 94 - NOTIFICACIONES
-Pulsa otra vez para apagar el sistema
-
-## 117 - GAME TEXT
-Potenciador
-
-## 118 - GAME TEXT
-+1 Golpe
-
-## 119 - GAME TEXT
-Tiempo!
-
-## 120 - SCOREBOARD
-Puntuacion
-
-## 121 - CREDITS
-PROGRAMADO Y DISE{ADO POR
-
-## 122 - CREDITS
-GRAFICOS DIBUJADOS POR
-
-## 123 - CREDITS
-MUSICA COMPUESTA POR
-
-## 124 - CREDITS
-EFECTOS DE SONIDO
-
-## 125 - NOTIFICACIONES
-Vuelve a pulsar para reiniciar
-
-## 126 - NOTIFICACIONES
-Vuelve a pulsar para cambiar el idioma a
-
-## 127 - NOTIFICACIONES
-Idioma cambiado a
-
-## 128 - VARIOS
-activado
-
-## 129 - VARIOS
-desactivado
-
-## 130 - VARIOS
-Disparo automático
-
-## 131 - VARIOS
-Zoom de ventana
-
-## 132 - VARIOS
-Modo ventana
-
-## 133 - VARIOS
-Modo pantalla completa
-
-## 134 - VARIOS
-Modo de escalado entero
-
-## 135 - VARIOS
-Filtro

release/Info.plist

@@ -5,9 +5,9 @@
 	<key>CFBundleDevelopmentRegion</key>
 	<string>es</string>
 	<key>CFBundleDisplayName</key>
-	<string>coffee_crisis arcade edition</string>
+	<string>coffee_crisis_arcade_edition</string>
 	<key>CFBundleExecutable</key>
-	<string>coffee_crisis</string>
+	<string>coffee_crisis_arcade_edition</string>
 	<key>CFBundleIconFile</key>
 	<string>icon</string>
 	<key>CFBundleIconName</key>
@@ -29,7 +29,7 @@
 	<key>CSResourcesFileMapped</key>
 	<true/>
 	<key>LSMinimumSystemVersion</key>
-	<string>10.12</string>
+	<string>10.15</string>
 	<key>NSHighResolutionCapable</key>
 	<true/>
 	<key>NSHumanReadableCopyright</key>

release/SDL2.framework/Headers

@@ -1 +0,0 @@
-Versions/Current/Headers

release/SDL2.framework/Headers

@@ -0,0 +1 @@
+Versions/Current/Headers

release/SDL2.framework/Resources

@@ -1 +0,0 @@
-Versions/Current/Resources

release/SDL2.framework/Resources

@@ -0,0 +1 @@
+Versions/Current/Resources

release/SDL2.framework/SDL2

@@ -1 +0,0 @@
-Versions/Current/SDL2

release/SDL2.framework/SDL2

@@ -0,0 +1 @@
+Versions/Current/SDL2

release/SDL2.framework/Versions/A/Headers/SDL.h

@@ -1,6 +1,6 @@
 /*
   Simple DirectMedia Layer
-  Copyright (C) 1997-2023 Sam Lantinga <slouken@libsdl.org>
+  Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
 
   This software is provided 'as-is', without any express or implied
   warranty.  In no event will the authors be held liable for any damages
@@ -25,7 +25,6 @@
  *  Main include header for the SDL library
  */
 
-
 #ifndef SDL_h_
 #define SDL_h_
 
@@ -70,6 +69,8 @@
 extern "C" {
 #endif
 
+/* WIKI CATEGORY: Init */
+
 /* As of version 0.5, SDL is loaded dynamically into the application */
 
 /**
@@ -130,7 +131,7 @@ extern "C" {
  * call SDL_Quit() to force shutdown). If a subsystem is already loaded then
  * this call will increase the ref-count and return.
  *
- * \param flags subsystem initialization flags
+ * \param flags subsystem initialization flags.
  * \returns 0 on success or a negative error code on failure; call
  *          SDL_GetError() for more information.
  *

release/SDL2.framework/Versions/A/Headers/SDL_assert.h

@@ -1,6 +1,6 @@
 /*
   Simple DirectMedia Layer
-  Copyright (C) 1997-2023 Sam Lantinga <slouken@libsdl.org>
+  Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
 
   This software is provided 'as-is', without any express or implied
   warranty.  In no event will the authors be held liable for any damages
@@ -61,6 +61,8 @@ assert can have unique static variables associated with it.
     #define SDL_TriggerBreakpoint() __asm__ __volatile__ ( "brk #22\n\t" )
 #elif defined(__APPLE__) && defined(__arm__)
     #define SDL_TriggerBreakpoint() __asm__ __volatile__ ( "bkpt #22\n\t" )
+#elif defined(_WIN32) && ((defined(__GNUC__) || defined(__clang__)) && (defined(__arm64__) || defined(__aarch64__)) )
+    #define SDL_TriggerBreakpoint() __asm__ __volatile__ ( "brk #0xF000\n\t" )
 #elif defined(__386__) && defined(__WATCOMC__)
     #define SDL_TriggerBreakpoint() { _asm { int 0x03 } }
 #elif defined(HAVE_SIGNAL_H) && !defined(__WATCOMC__)
@@ -191,8 +193,8 @@ extern DECLSPEC SDL_AssertState SDLCALL SDL_ReportAssertion(SDL_AssertData *,
  * A callback that fires when an SDL assertion fails.
  *
  * \param data a pointer to the SDL_AssertData structure corresponding to the
- *             current assertion
- * \param userdata what was passed as `userdata` to SDL_SetAssertionHandler()
+ *             current assertion.
+ * \param userdata what was passed as `userdata` to SDL_SetAssertionHandler().
  * \returns an SDL_AssertState value indicating how to handle the failure.
  */
 typedef SDL_AssertState (SDLCALL *SDL_AssertionHandler)(
@@ -212,8 +214,8 @@ typedef SDL_AssertState (SDLCALL *SDL_AssertionHandler)(
  * This callback is NOT reset to SDL's internal handler upon SDL_Quit()!
  *
  * \param handler the SDL_AssertionHandler function to call when an assertion
- *                fails or NULL for the default handler
- * \param userdata a pointer that is passed to `handler`
+ *                fails or NULL for the default handler.
+ * \param userdata a pointer that is passed to `handler`.
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -254,7 +256,7 @@ extern DECLSPEC SDL_AssertionHandler SDLCALL SDL_GetDefaultAssertionHandler(void
  * data, it is safe to pass a NULL pointer to this function to ignore it.
  *
  * \param puserdata pointer which is filled with the "userdata" pointer that
- *                  was passed to SDL_SetAssertionHandler()
+ *                  was passed to SDL_SetAssertionHandler().
  * \returns the SDL_AssertionHandler that is called when an assert triggers.
  *
  * \since This function is available since SDL 2.0.2.

release/SDL2.framework/Versions/A/Headers/SDL_atomic.h

@@ -1,6 +1,6 @@
 /*
   Simple DirectMedia Layer
-  Copyright (C) 1997-2023 Sam Lantinga <slouken@libsdl.org>
+  Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
 
   This software is provided 'as-is', without any express or implied
   warranty.  In no event will the authors be held liable for any damages
@@ -20,38 +20,29 @@
 */
 
 /**
- * \file SDL_atomic.h
+ * # CategoryAtomic
  *
  * Atomic operations.
  *
- * IMPORTANT:
- * If you are not an expert in concurrent lockless programming, you should
- * only be using the atomic lock and reference counting functions in this
- * file.  In all other cases you should be protecting your data structures
- * with full mutexes.
+ * IMPORTANT: If you are not an expert in concurrent lockless programming, you
+ * should not be using any functions in this file. You should be protecting
+ * your data structures with full mutexes instead.
  *
- * The list of "safe" functions to use are:
- *  SDL_AtomicLock()
- *  SDL_AtomicUnlock()
- *  SDL_AtomicIncRef()
- *  SDL_AtomicDecRef()
+ * ***Seriously, here be dragons!***
  *
- * Seriously, here be dragons!
- * ^^^^^^^^^^^^^^^^^^^^^^^^^^^
- *
- * You can find out a little more about lockless programming and the
- * subtle issues that can arise here:
- * http://msdn.microsoft.com/en-us/library/ee418650%28v=vs.85%29.aspx
+ * You can find out a little more about lockless programming and the subtle
+ * issues that can arise here:
+ * https://learn.microsoft.com/en-us/windows/win32/dxtecharts/lockless-programming
  *
  * There's also lots of good information here:
- * http://www.1024cores.net/home/lock-free-algorithms
- * http://preshing.com/
  *
- * These operations may or may not actually be implemented using
- * processor specific atomic operations. When possible they are
- * implemented as true processor specific atomic operations. When that
- * is not possible the are implemented using locks that *do* use the
- * available atomic operations.
+ * - https://www.1024cores.net/home/lock-free-algorithms
+ * - https://preshing.com/
+ *
+ * These operations may or may not actually be implemented using processor
+ * specific atomic operations. When possible they are implemented as true
+ * processor specific atomic operations. When that is not possible the are
+ * implemented using locks that *do* use the available atomic operations.
  *
  * All of the atomic operations that modify memory are full memory barriers.
  */
@@ -94,7 +85,7 @@ typedef int SDL_SpinLock;
  * ***Please note that spinlocks are dangerous if you don't know what you're
  * doing. Please be careful using any sort of spinlock!***
  *
- * \param lock a pointer to a lock variable
+ * \param lock a pointer to a lock variable.
  * \returns SDL_TRUE if the lock succeeded, SDL_FALSE if the lock is already
  *          held.
  *
@@ -111,7 +102,7 @@ extern DECLSPEC SDL_bool SDLCALL SDL_AtomicTryLock(SDL_SpinLock *lock);
  * ***Please note that spinlocks are dangerous if you don't know what you're
  * doing. Please be careful using any sort of spinlock!***
  *
- * \param lock a pointer to a lock variable
+ * \param lock a pointer to a lock variable.
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -128,7 +119,7 @@ extern DECLSPEC void SDLCALL SDL_AtomicLock(SDL_SpinLock *lock);
  * ***Please note that spinlocks are dangerous if you don't know what you're
  * doing. Please be careful using any sort of spinlock!***
  *
- * \param lock a pointer to a lock variable
+ * \param lock a pointer to a lock variable.
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -209,7 +200,7 @@ typedef void (*SDL_KernelMemoryBarrierFunc)();
 #if defined(__ARM_ARCH_7__) || defined(__ARM_ARCH_7A__) || defined(__ARM_ARCH_7EM__) || defined(__ARM_ARCH_7R__) || defined(__ARM_ARCH_7M__) || defined(__ARM_ARCH_7S__) || defined(__ARM_ARCH_8A__)
 #define SDL_MemoryBarrierRelease()   __asm__ __volatile__ ("dmb ish" : : : "memory")
 #define SDL_MemoryBarrierAcquire()   __asm__ __volatile__ ("dmb ish" : : : "memory")
-#elif defined(__ARM_ARCH_6__) || defined(__ARM_ARCH_6J__) || defined(__ARM_ARCH_6K__) || defined(__ARM_ARCH_6T2__) || defined(__ARM_ARCH_6Z__) || defined(__ARM_ARCH_6ZK__) || defined(__ARM_ARCH_5TE__)
+#elif defined(__ARM_ARCH_6__) || defined(__ARM_ARCH_6J__) || defined(__ARM_ARCH_6K__) || defined(__ARM_ARCH_6T2__) || defined(__ARM_ARCH_6Z__) || defined(__ARM_ARCH_6ZK__)
 #ifdef __thumb__
 /* The mcr instruction isn't available in thumb mode, use real functions */
 #define SDL_MEMORY_BARRIER_USES_FUNCTION
@@ -257,10 +248,13 @@ typedef void (*SDL_KernelMemoryBarrierFunc)();
 
 
 /**
- * \brief A type representing an atomic integer value.  It is a struct
- *        so people don't accidentally use numeric operations on it.
+ * A type representing an atomic integer value.
+ *
+ * It is a struct so people don't accidentally use numeric operations on it.
  */
-typedef struct { int value; } SDL_atomic_t;
+typedef struct SDL_atomic_t {
+    int value;
+} SDL_atomic_t;
 
 /**
  * Set an atomic variable to a new value if it is currently an old value.
@@ -268,9 +262,9 @@ typedef struct { int value; } SDL_atomic_t;
  * ***Note: If you don't know what this function is for, you shouldn't use
  * it!***
  *
- * \param a a pointer to an SDL_atomic_t variable to be modified
- * \param oldval the old value
- * \param newval the new value
+ * \param a a pointer to an SDL_atomic_t variable to be modified.
+ * \param oldval the old value.
+ * \param newval the new value.
  * \returns SDL_TRUE if the atomic variable was set, SDL_FALSE otherwise.
  *
  * \since This function is available since SDL 2.0.0.
@@ -289,8 +283,8 @@ extern DECLSPEC SDL_bool SDLCALL SDL_AtomicCAS(SDL_atomic_t *a, int oldval, int
  * ***Note: If you don't know what this function is for, you shouldn't use
  * it!***
  *
- * \param a a pointer to an SDL_atomic_t variable to be modified
- * \param v the desired value
+ * \param a a pointer to an SDL_atomic_t variable to be modified.
+ * \param v the desired value.
  * \returns the previous value of the atomic variable.
  *
  * \since This function is available since SDL 2.0.2.
@@ -305,7 +299,7 @@ extern DECLSPEC int SDLCALL SDL_AtomicSet(SDL_atomic_t *a, int v);
  * ***Note: If you don't know what this function is for, you shouldn't use
  * it!***
  *
- * \param a a pointer to an SDL_atomic_t variable
+ * \param a a pointer to an SDL_atomic_t variable.
  * \returns the current value of an atomic variable.
  *
  * \since This function is available since SDL 2.0.2.
@@ -322,8 +316,8 @@ extern DECLSPEC int SDLCALL SDL_AtomicGet(SDL_atomic_t *a);
  * ***Note: If you don't know what this function is for, you shouldn't use
  * it!***
  *
- * \param a a pointer to an SDL_atomic_t variable to be modified
- * \param v the desired value to add
+ * \param a a pointer to an SDL_atomic_t variable to be modified.
+ * \param v the desired value to add.
  * \returns the previous value of the atomic variable.
  *
  * \since This function is available since SDL 2.0.2.
@@ -356,9 +350,9 @@ extern DECLSPEC int SDLCALL SDL_AtomicAdd(SDL_atomic_t *a, int v);
  * ***Note: If you don't know what this function is for, you shouldn't use
  * it!***
  *
- * \param a a pointer to a pointer
- * \param oldval the old pointer value
- * \param newval the new pointer value
+ * \param a a pointer to a pointer.
+ * \param oldval the old pointer value.
+ * \param newval the new pointer value.
  * \returns SDL_TRUE if the pointer was set, SDL_FALSE otherwise.
  *
  * \since This function is available since SDL 2.0.0.
@@ -375,8 +369,8 @@ extern DECLSPEC SDL_bool SDLCALL SDL_AtomicCASPtr(void **a, void *oldval, void *
  * ***Note: If you don't know what this function is for, you shouldn't use
  * it!***
  *
- * \param a a pointer to a pointer
- * \param v the desired pointer value
+ * \param a a pointer to a pointer.
+ * \param v the desired pointer value.
  * \returns the previous value of the pointer.
  *
  * \since This function is available since SDL 2.0.2.
@@ -392,7 +386,7 @@ extern DECLSPEC void* SDLCALL SDL_AtomicSetPtr(void **a, void* v);
  * ***Note: If you don't know what this function is for, you shouldn't use
  * it!***
  *
- * \param a a pointer to a pointer
+ * \param a a pointer to a pointer.
  * \returns the current value of a pointer.
  *
  * \since This function is available since SDL 2.0.2.

release/SDL2.framework/Versions/A/Headers/SDL_audio.h

@@ -1,6 +1,6 @@
 /*
   Simple DirectMedia Layer
-  Copyright (C) 1997-2023 Sam Lantinga <slouken@libsdl.org>
+  Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
 
   This software is provided 'as-is', without any express or implied
   warranty.  In no event will the authors be held liable for any damages
@@ -22,9 +22,9 @@
 /* !!! FIXME: several functions in here need Doxygen comments. */
 
 /**
- *  \file SDL_audio.h
+ * # CategoryAudio
  *
- *  Access to the raw audio mixing buffer for the SDL library.
+ * Access to the raw audio mixing buffer for the SDL library.
  */
 
 #ifndef SDL_audio_h_
@@ -44,24 +44,24 @@ extern "C" {
 #endif
 
 /**
- *  \brief Audio format flags.
+ * Audio format flags.
  *
- *  These are what the 16 bits in SDL_AudioFormat currently mean...
- *  (Unspecified bits are always zero).
+ * These are what the 16 bits in SDL_AudioFormat currently mean...
+ * (Unspecified bits are always zero).
  *
- *  \verbatim
-    ++-----------------------sample is signed if set
-    ||
-    ||       ++-----------sample is bigendian if set
-    ||       ||
-    ||       ||          ++---sample is float if set
-    ||       ||          ||
-    ||       ||          || +---sample bit size---+
-    ||       ||          || |                     |
-    15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00
-    \endverbatim
+ * ```
+ * ++-----------------------sample is signed if set
+ * ||
+ * ||       ++-----------sample is bigendian if set
+ * ||       ||
+ * ||       ||          ++---sample is float if set
+ * ||       ||          ||
+ * ||       ||          || +---sample bit size---+
+ * ||       ||          || |                     |
+ * 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00
+ * ```
  *
- *  There are macros in SDL 2.0 and later to query these bits.
+ * There are macros in SDL 2.0 and later to query these bits.
  */
 typedef Uint16 SDL_AudioFormat;
 
@@ -149,33 +149,30 @@ typedef Uint16 SDL_AudioFormat;
 /* @} *//* Audio flags */
 
 /**
- *  This function is called when the audio device needs more data.
+ * This function is called when the audio device needs more data.
  *
- *  \param userdata An application-specific parameter saved in
- *                  the SDL_AudioSpec structure
- *  \param stream A pointer to the audio data buffer.
- *  \param len    The length of that buffer in bytes.
- *
- *  Once the callback returns, the buffer will no longer be valid.
- *  Stereo samples are stored in a LRLRLR ordering.
- *
- *  You can choose to avoid callbacks and use SDL_QueueAudio() instead, if
- *  you like. Just open your audio device with a NULL callback.
+ * \param userdata An application-specific parameter saved in the
+ *                 SDL_AudioSpec structure.
+ * \param stream A pointer to the audio data buffer.
+ * \param len Length of **stream** in bytes.
  */
 typedef void (SDLCALL * SDL_AudioCallback) (void *userdata, Uint8 * stream,
                                             int len);
 
 /**
- *  The calculated values in this structure are calculated by SDL_OpenAudio().
+ * The calculated values in this structure are calculated by SDL_OpenAudio().
  *
- *  For multi-channel audio, the default SDL channel mapping is:
- *  2:  FL  FR                          (stereo)
- *  3:  FL  FR LFE                      (2.1 surround)
- *  4:  FL  FR  BL  BR                  (quad)
- *  5:  FL  FR LFE  BL  BR              (4.1 surround)
- *  6:  FL  FR  FC LFE  SL  SR          (5.1 surround - last two can also be BL BR)
- *  7:  FL  FR  FC LFE  BC  SL  SR      (6.1 surround)
- *  8:  FL  FR  FC LFE  BL  BR  SL  SR  (7.1 surround)
+ * For multi-channel audio, the default SDL channel mapping is:
+ *
+ * ```
+ * 2:  FL  FR                          (stereo)
+ * 3:  FL  FR LFE                      (2.1 surround)
+ * 4:  FL  FR  BL  BR                  (quad)
+ * 5:  FL  FR LFE  BL  BR              (4.1 surround)
+ * 6:  FL  FR  FC LFE  SL  SR          (5.1 surround - last two can also be BL BR)
+ * 7:  FL  FR  FC LFE  BC  SL  SR      (6.1 surround)
+ * 8:  FL  FR  FC LFE  BL  BR  SL  SR  (7.1 surround)
+ * ```
  */
 typedef struct SDL_AudioSpec
 {
@@ -196,11 +193,11 @@ typedef void (SDLCALL * SDL_AudioFilter) (struct SDL_AudioCVT * cvt,
                                           SDL_AudioFormat format);
 
 /**
- *  \brief Upper limit of filters in SDL_AudioCVT
+ * Upper limit of filters in SDL_AudioCVT
  *
- *  The maximum number of SDL_AudioFilter functions in SDL_AudioCVT is
- *  currently limited to 9. The SDL_AudioCVT.filters array has 10 pointers,
- *  one of which is the terminating NULL pointer.
+ * The maximum number of SDL_AudioFilter functions in SDL_AudioCVT is
+ * currently limited to 9. The SDL_AudioCVT.filters array has 10 pointers, one
+ * of which is the terminating NULL pointer.
  */
 #define SDL_AUDIOCVT_MAX_FILTERS 9
 
@@ -287,7 +284,7 @@ extern DECLSPEC int SDLCALL SDL_GetNumAudioDrivers(void);
  * meant to be proper names.
  *
  * \param index the index of the audio driver; the value ranges from 0 to
- *              SDL_GetNumAudioDrivers() - 1
+ *              SDL_GetNumAudioDrivers() - 1.
  * \returns the name of the audio driver at the requested index, or NULL if an
  *          invalid index was specified.
  *
@@ -314,7 +311,7 @@ extern DECLSPEC const char *SDLCALL SDL_GetAudioDriver(int index);
  * specific need to designate the audio driver you want to use. You should
  * normally use SDL_Init() or SDL_InitSubSystem().
  *
- * \param driver_name the name of the desired audio driver
+ * \param driver_name the name of the desired audio driver.
  * \returns 0 on success or a negative error code on failure; call
  *          SDL_GetError() for more information.
  *
@@ -408,13 +405,13 @@ extern DECLSPEC int SDLCALL SDL_OpenAudio(SDL_AudioSpec * desired,
                                           SDL_AudioSpec * obtained);
 
 /**
- *  SDL Audio Device IDs.
+ * SDL Audio Device IDs.
  *
- *  A successful call to SDL_OpenAudio() is always device id 1, and legacy
- *  SDL audio APIs assume you want this device ID. SDL_OpenAudioDevice() calls
- *  always returns devices >= 2 on success. The legacy calls are good both
- *  for backwards compatibility and when you don't care about multiple,
- *  specific, or capture devices.
+ * A successful call to SDL_OpenAudio() is always device id 1, and legacy SDL
+ * audio APIs assume you want this device ID. SDL_OpenAudioDevice() calls
+ * always returns devices >= 2 on success. The legacy calls are good both for
+ * backwards compatibility and when you don't care about multiple, specific,
+ * or capture devices.
  */
 typedef Uint32 SDL_AudioDeviceID;
 
@@ -452,7 +449,7 @@ typedef Uint32 SDL_AudioDeviceID;
  * ```
  *
  * \param iscapture zero to request playback devices, non-zero to request
- *                  recording devices
+ *                  recording devices.
  * \returns the number of available devices exposed by the current driver or
  *          -1 if an explicit list of devices can't be determined. A return
  *          value of -1 does not necessarily mean an error condition.
@@ -478,7 +475,7 @@ extern DECLSPEC int SDLCALL SDL_GetNumAudioDevices(int iscapture);
  * invalid next time any of several other SDL functions are called.
  *
  * \param index the index of the audio device; valid values range from 0 to
- *              SDL_GetNumAudioDevices() - 1
+ *              SDL_GetNumAudioDevices() - 1.
  * \param iscapture non-zero to query the list of recording devices, zero to
  *                  query the list of output devices.
  * \returns the name of the audio device at the requested index, or NULL on
@@ -504,11 +501,11 @@ extern DECLSPEC const char *SDLCALL SDL_GetAudioDeviceName(int index,
  * count.
  *
  * \param index the index of the audio device; valid values range from 0 to
- *              SDL_GetNumAudioDevices() - 1
+ *              SDL_GetNumAudioDevices() - 1.
  * \param iscapture non-zero to query the list of recording devices, zero to
  *                  query the list of output devices.
  * \param spec The SDL_AudioSpec to be initialized by this function.
- * \returns 0 on success, nonzero on error
+ * \returns 0 on success, nonzero on error.
  *
  * \since This function is available since SDL 2.0.16.
  *
@@ -542,7 +539,7 @@ extern DECLSPEC int SDLCALL SDL_GetAudioDeviceSpec(int index,
  * \param spec The SDL_AudioSpec to be initialized by this function.
  * \param iscapture non-zero to query the default recording device, zero to
  *                  query the default output device.
- * \returns 0 on success, nonzero on error
+ * \returns 0 on success, nonzero on error.
  *
  * \since This function is available since SDL 2.24.0.
  *
@@ -594,7 +591,7 @@ extern DECLSPEC int SDLCALL SDL_GetDefaultAudioInfo(char **name,
  *   frames_ (with stereo output, two samples--left and right--would make a
  *   single sample frame). This number should be a power of two, and may be
  *   adjusted by the audio driver to a value more suitable for the hardware.
- *   Good values seem to range between 512 and 8096 inclusive, depending on
+ *   Good values seem to range between 512 and 4096 inclusive, depending on
  *   the application and CPU speed. Smaller values reduce latency, but can
  *   lead to underflow if the application is doing heavy processing and cannot
  *   fill the audio buffer in time. Note that the number of sample frames is
@@ -645,12 +642,12 @@ extern DECLSPEC int SDLCALL SDL_GetDefaultAudioInfo(char **name,
  *               driver-specific name as appropriate. NULL requests the most
  *               reasonable default device.
  * \param iscapture non-zero to specify a device should be opened for
- *                  recording, not playback
+ *                  recording, not playback.
  * \param desired an SDL_AudioSpec structure representing the desired output
- *                format; see SDL_OpenAudio() for more information
+ *                format; see SDL_OpenAudio() for more information.
  * \param obtained an SDL_AudioSpec structure filled in with the actual output
- *                 format; see SDL_OpenAudio() for more information
- * \param allowed_changes 0, or one or more flags OR'd together
+ *                 format; see SDL_OpenAudio() for more information.
+ * \param allowed_changes 0, or one or more flags OR'd together.
  * \returns a valid device ID that is > 0 on success or 0 on failure; call
  *          SDL_GetError() for more information.
  *
@@ -712,7 +709,7 @@ extern DECLSPEC SDL_AudioStatus SDLCALL SDL_GetAudioStatus(void);
  * Use this function to get the current audio state of an audio device.
  *
  * \param dev the ID of an audio device previously opened with
- *            SDL_OpenAudioDevice()
+ *            SDL_OpenAudioDevice().
  * \returns the SDL_AudioStatus of the specified audio device.
  *
  * \since This function is available since SDL 2.0.0.
@@ -745,7 +742,7 @@ extern DECLSPEC SDL_AudioStatus SDLCALL SDL_GetAudioDeviceStatus(SDL_AudioDevice
  *
  * ...and is only useful if you used the legacy SDL_OpenAudio() function.
  *
- * \param pause_on non-zero to pause, 0 to unpause
+ * \param pause_on non-zero to pause, 0 to unpause.
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -775,8 +772,8 @@ extern DECLSPEC void SDLCALL SDL_PauseAudio(int pause_on);
  * callback, you shouldn't pause the audio device, as it will lead to dropouts
  * in the audio playback. Instead, you should use SDL_LockAudioDevice().
  *
- * \param dev a device opened by SDL_OpenAudioDevice()
- * \param pause_on non-zero to pause, 0 to unpause
+ * \param dev a device opened by SDL_OpenAudioDevice().
+ * \param pause_on non-zero to pause, 0 to unpause.
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -841,14 +838,14 @@ extern DECLSPEC void SDLCALL SDL_PauseAudioDevice(SDL_AudioDeviceID dev,
  * SDL_LoadWAV("sample.wav", &spec, &buf, &len);
  * ```
  *
- * \param src The data source for the WAVE data
- * \param freesrc If non-zero, SDL will _always_ free the data source
+ * \param src The data source for the WAVE data.
+ * \param freesrc If non-zero, SDL will _always_ free the data source.
  * \param spec An SDL_AudioSpec that will be filled in with the wave file's
- *             format details
+ *             format details.
  * \param audio_buf A pointer filled with the audio data, allocated by the
  *                  function.
  * \param audio_len A pointer filled with the length of the audio data buffer
- *                  in bytes
+ *                  in bytes.
  * \returns This function, if successfully called, returns `spec`, which will
  *          be filled with the audio data format of the wave source data.
  *          `audio_buf` will be filled with a pointer to an allocated buffer
@@ -874,8 +871,9 @@ extern DECLSPEC SDL_AudioSpec *SDLCALL SDL_LoadWAV_RW(SDL_RWops * src,
                                                       Uint32 * audio_len);
 
 /**
- *  Loads a WAV from a file.
- *  Compatibility convenience function.
+ * Loads a WAV from a file.
+ *
+ * Compatibility convenience function.
  */
 #define SDL_LoadWAV(file, spec, audio_buf, audio_len) \
     SDL_LoadWAV_RW(SDL_RWFromFile(file, "rb"),1, spec,audio_buf,audio_len)
@@ -888,7 +886,7 @@ extern DECLSPEC SDL_AudioSpec *SDLCALL SDL_LoadWAV_RW(SDL_RWops * src,
  * this function with a NULL pointer.
  *
  * \param audio_buf a pointer to the buffer created by SDL_LoadWAV() or
- *                  SDL_LoadWAV_RW()
+ *                  SDL_LoadWAV_RW().
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -912,15 +910,16 @@ extern DECLSPEC void SDLCALL SDL_FreeWAV(Uint8 * audio_buf);
  * and then can call SDL_ConvertAudio() to complete the conversion.
  *
  * \param cvt an SDL_AudioCVT structure filled in with audio conversion
- *            information
+ *            information.
  * \param src_format the source format of the audio data; for more info see
- *                   SDL_AudioFormat
- * \param src_channels the number of channels in the source
- * \param src_rate the frequency (sample-frames-per-second) of the source
+ *                   SDL_AudioFormat.
+ * \param src_channels the number of channels in the source.
+ * \param src_rate the frequency (sample-frames-per-second) of the source.
  * \param dst_format the destination format of the audio data; for more info
- *                   see SDL_AudioFormat
- * \param dst_channels the number of channels in the destination
- * \param dst_rate the frequency (sample-frames-per-second) of the destination
+ *                   see SDL_AudioFormat.
+ * \param dst_channels the number of channels in the destination.
+ * \param dst_rate the frequency (sample-frames-per-second) of the
+ *                 destination.
  * \returns 1 if the audio filter is prepared, 0 if no conversion is needed,
  *          or a negative error code on failure; call SDL_GetError() for more
  *          information.
@@ -991,12 +990,12 @@ typedef struct _SDL_AudioStream SDL_AudioStream;
 /**
  * Create a new audio stream.
  *
- * \param src_format The format of the source audio
- * \param src_channels The number of channels of the source audio
- * \param src_rate The sampling rate of the source audio
- * \param dst_format The format of the desired audio output
- * \param dst_channels The number of channels of the desired audio output
- * \param dst_rate The sampling rate of the desired audio output
+ * \param src_format The format of the source audio.
+ * \param src_channels The number of channels of the source audio.
+ * \param src_rate The sampling rate of the source audio.
+ * \param dst_format The format of the desired audio output.
+ * \param dst_channels The number of channels of the desired audio output.
+ * \param dst_rate The sampling rate of the desired audio output.
  * \returns 0 on success, or -1 on error.
  *
  * \since This function is available since SDL 2.0.7.
@@ -1018,9 +1017,9 @@ extern DECLSPEC SDL_AudioStream * SDLCALL SDL_NewAudioStream(const SDL_AudioForm
 /**
  * Add data to be converted/resampled to the stream.
  *
- * \param stream The stream the audio data is being added to
- * \param buf A pointer to the audio data to add
- * \param len The number of bytes to write to the stream
+ * \param stream The stream the audio data is being added to.
+ * \param buf A pointer to the audio data to add.
+ * \param len The number of bytes to write to the stream.
  * \returns 0 on success, or -1 on error.
  *
  * \since This function is available since SDL 2.0.7.
@@ -1037,10 +1036,10 @@ extern DECLSPEC int SDLCALL SDL_AudioStreamPut(SDL_AudioStream *stream, const vo
 /**
  * Get converted/resampled data from the stream
  *
- * \param stream The stream the audio is being requested from
- * \param buf A buffer to fill with audio data
- * \param len The maximum number of bytes to fill
- * \returns the number of bytes read from the stream, or -1 on error
+ * \param stream The stream the audio is being requested from.
+ * \param buf A buffer to fill with audio data.
+ * \param len The maximum number of bytes to fill.
+ * \returns the number of bytes read from the stream, or -1 on error.
  *
  * \since This function is available since SDL 2.0.7.
  *
@@ -1118,6 +1117,9 @@ extern DECLSPEC void SDLCALL SDL_AudioStreamClear(SDL_AudioStream *stream);
  */
 extern DECLSPEC void SDLCALL SDL_FreeAudioStream(SDL_AudioStream *stream);
 
+/**
+ * Maximum volume allowed in calls to SDL_MixAudio and SDL_MixAudioFormat.
+ */
 #define SDL_MIX_MAXVOLUME 128
 
 /**
@@ -1132,11 +1134,11 @@ extern DECLSPEC void SDLCALL SDL_FreeAudioStream(SDL_AudioStream *stream);
  * ...where `format` is the obtained format of the audio device from the
  * legacy SDL_OpenAudio() function.
  *
- * \param dst the destination for the mixed audio
- * \param src the source audio buffer to be mixed
- * \param len the length of the audio buffer in bytes
+ * \param dst the destination for the mixed audio.
+ * \param src the source audio buffer to be mixed.
+ * \param len the length of the audio buffer in bytes.
  * \param volume ranges from 0 - 128, and should be set to SDL_MIX_MAXVOLUME
- *               for full audio volume
+ *               for full audio volume.
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -1165,13 +1167,13 @@ extern DECLSPEC void SDLCALL SDL_MixAudio(Uint8 * dst, const Uint8 * src,
  * SDL_MixAudioFormat() is really only needed when you're mixing a single
  * audio stream with a volume adjustment.
  *
- * \param dst the destination for the mixed audio
- * \param src the source audio buffer to be mixed
+ * \param dst the destination for the mixed audio.
+ * \param src the source audio buffer to be mixed.
  * \param format the SDL_AudioFormat structure representing the desired audio
- *               format
- * \param len the length of the audio buffer in bytes
+ *               format.
+ * \param len the length of the audio buffer in bytes.
  * \param volume ranges from 0 - 128, and should be set to SDL_MIX_MAXVOLUME
- *               for full audio volume
+ *               for full audio volume.
  *
  * \since This function is available since SDL 2.0.0.
  */
@@ -1215,9 +1217,9 @@ extern DECLSPEC void SDLCALL SDL_MixAudioFormat(Uint8 * dst,
  * from planar audio formats into a non-planar one (see SDL_AudioFormat)
  * before queuing audio.
  *
- * \param dev the device ID to which we will queue audio
- * \param data the data to queue to the device for later playback
- * \param len the number of bytes (not samples!) to which `data` points
+ * \param dev the device ID to which we will queue audio.
+ * \param data the data to queue to the device for later playback.
+ * \param len the number of bytes (not samples!) to which `data` points.
  * \returns 0 on success or a negative error code on failure; call
  *          SDL_GetError() for more information.
  *
@@ -1263,9 +1265,9 @@ extern DECLSPEC int SDLCALL SDL_QueueAudio(SDL_AudioDeviceID dev, const void *da
  * You should not call SDL_LockAudio() on the device before dequeueing; SDL
  * handles locking internally for this function.
  *
- * \param dev the device ID from which we will dequeue audio
- * \param data a pointer into where audio data should be copied
- * \param len the number of bytes (not samples!) to which (data) points
+ * \param dev the device ID from which we will dequeue audio.
+ * \param data a pointer into where audio data should be copied.
+ * \param len the number of bytes (not samples!) to which (data) points.
  * \returns the number of bytes dequeued, which could be less than requested;
  *          call SDL_GetError() for more information.
  *
@@ -1299,7 +1301,7 @@ extern DECLSPEC Uint32 SDLCALL SDL_DequeueAudio(SDL_AudioDeviceID dev, void *dat
  * You should not call SDL_LockAudio() on the device before querying; SDL
  * handles locking internally for this function.
  *
- * \param dev the device ID of which we will query queued audio size
+ * \param dev the device ID of which we will query queued audio size.
  * \returns the number of bytes (not samples!) of queued audio.
  *
  * \since This function is available since SDL 2.0.4.
@@ -1334,7 +1336,7 @@ extern DECLSPEC Uint32 SDLCALL SDL_GetQueuedAudioSize(SDL_AudioDeviceID dev);
  *
  * This function always succeeds and thus returns void.
  *
- * \param dev the device ID of which to clear the audio queue
+ * \param dev the device ID of which to clear the audio queue.
  *
  * \since This function is available since SDL 2.0.4.
  *
@@ -1406,7 +1408,7 @@ extern DECLSPEC void SDLCALL SDL_LockAudio(void);
  * at once, not only will you block the audio callback, you'll block the other
  * thread.
  *
- * \param dev the ID of the device to be locked
+ * \param dev the ID of the device to be locked.
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -1439,7 +1441,7 @@ extern DECLSPEC void SDLCALL SDL_UnlockAudio(void);
  *
  * This function should be paired with a previous SDL_LockAudioDevice() call.
  *
- * \param dev the ID of the device to be unlocked
+ * \param dev the ID of the device to be unlocked.
  *
  * \since This function is available since SDL 2.0.0.
  *
@@ -1481,7 +1483,7 @@ extern DECLSPEC void SDLCALL SDL_CloseAudio(void);
  * The device ID is invalid as soon as the device is closed, and is eligible
  * for reuse in a new SDL_OpenAudioDevice() call immediately.
  *
- * \param dev an audio device previously opened with SDL_OpenAudioDevice()
+ * \param dev an audio device previously opened with SDL_OpenAudioDevice().
  *
  * \since This function is available since SDL 2.0.0.
  *