tweak(ship-3d): descans prop de P-PRESS / Y-PLAY, més mida, pitch +14° lift

resolveBodyPair afegeix early-out per a parells on a.radius<=0 o b.radius<=0.
Honra el comentari de bullet.cpp:30 ("radius=0 → sin colisión física,
cinemática pura") que abans no s'aplicava: amb bala radius=0 + enemic
radius=ENEMY_RADIUS, SUM_R era enemic radius i el body-body disparava
si la bala (a 700 px/s) penetrava el cos l'enemic entre frames.

Símptomes corregits:
- Pentagon: la bala "rebotava espectacularment" en lloc d'impactar.
- Quadrat: rebut un impulse double del cantó de la física que es
  sumava (o cancel·lava, segons l'angle) al manual, fent l'efecte
  inconsistent.

Ara la gameplay collision (Physics::checkCollision amb entity radius,
que ja és més generós) és l'única que tracta el parell bala-enemic.

A més: IMPACT_MOMENTUM_FACTOR 2.0 → 3.0 per compensar la pèrdua del
rebot físic i donar més empenta:
  - Pentagon (m=5) Δv = 210 px/s
  - Quadrat  (m=8) Δv = 131 px/s
  - Molinillo (m=4) Δv = 262 px/s

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.clang-format

@@ -1,6 +1,7 @@
 BasedOnStyle: Google
 IndentWidth: 4
-IndentAccessModifiers: true
+NamespaceIndentation: All
+IndentAccessModifiers: false
 ColumnLimit: 0  # Sin límite de longitud de línea
 BreakBeforeBraces: Attach  # Llaves en la misma línea
 AllowShortIfStatementsOnASingleLine: true

.clang-tidy

@@ -1,104 +1,112 @@
 Checks:
-  # Estrategia: Habilitar checks uno por uno, aplicar fix, compilar, commit
-  # ✅ Check 1: readability-uppercase-literal-suffix (1.0f → 1.0F)
-  # ✅ Check 2: readability-math-missing-parentheses (claridad en ops matemáticas)
-  # ✅ Check 3: readability-identifier-naming (DESHABILITADO temporalmente - cascada de cambios)
-  # ✅ Check 4: readability-const-return-type (código ya cumple)
-  # ✅ Check 5: readability-else-after-return (código ya cumple)
-  # ✅ Check 6: readability-simplify-boolean-expr (código ya cumple)
-  # ✅ Check 7: readability-* (225 fixes aplicados)
   - readability-*
-  - -readability-identifier-naming              # Excluido (cascada de cambios)
-  - -readability-identifier-length              # Excluido (nombres cortos son OK)
-  - -readability-magic-numbers                  # Excluido (muchos falsos positivos)
-  - -readability-convert-member-functions-to-static  # Excluido (rompe encapsulación)
-  - -readability-use-anyofallof                 # Excluido (C++20 ranges - no todos los compiladores)
-  - -readability-function-cognitive-complexity  # Excluido (complejidad ciclomática aceptable)
-  - -clang-analyzer-security.insecureAPI.rand   # Excluido (rand() es suficiente para juegos)
-  # ✅ Check 8: modernize-* (215 fixes aplicados)
   - modernize-*
-  - -modernize-use-trailing-return-type         # Excluido (estilo controversial)
-  - -modernize-avoid-c-arrays                   # Excluido (arrays C son OK en algunos contextos)
-  # ✅ Check 9: performance-* (91 fixes aplicados)
   - performance-*
-  - -performance-enum-size                      # Excluido (tamaño de enum no crítico)
-  # ✅ Check 10: bugprone-* (0 fixes - todos eran falsos positivos)
   - bugprone-*
-  - -bugprone-easily-swappable-parameters       # Excluido (muchos falsos positivos)
-  - -bugprone-narrowing-conversions             # Excluido (conversiones intencionales)
-  - -bugprone-integer-division                  # Excluido (divisiones enteras OK en contexto)
-  - -bugprone-branch-clone                      # Excluido (fall-through en switch es intencional)
-  - -bugprone-switch-missing-default-case       # Excluido (no todos los switches necesitan default)
-  - -bugprone-implicit-widening-of-multiplication-result  # Excluido (valores pequeños, sin overflow)
-  - -bugprone-exception-escape                  # Excluido (excepciones en main terminan el programa - OK)
-  # ✅ Check 11: llvm-include-order (validar orden de includes - 0 errores)
-  - llvm-include-order
-  # ⏸️  Check 12: misc-include-cleaner (DESHABILITADO temporalmente - requiere refactorización masiva de includes)
-  - -misc-include-cleaner
+  - -readability-identifier-length
+  - -readability-magic-numbers
+  - -bugprone-integer-division
+  - -bugprone-easily-swappable-parameters
+  - -bugprone-narrowing-conversions
+  - -modernize-avoid-c-arrays
+  # performance-noexcept-move-constructor crashea clang-tidy (LLVM 19.1)
+  # con recursión infinita en ExceptionSpecAnalyzer::analyzeRecord cuando
+  # analiza ciertas instanciaciones de std::set. No es un falso positivo
+  # sobre nuestro código: el check ni siquiera llega a evaluar el patrón.
+  - -performance-noexcept-move-constructor
 
 WarningsAsErrors: '*'
-# No usar HeaderFilterRegex - usamos .clang-tidy local en source/core/audio/ para excluir
+# Headers nostres (excloem source/external/ que conté dependències de tercers no editables)
+HeaderFilterRegex: 'source/(core|game|utils)/'
 FormatStyle: file
 
 CheckOptions:
-  # Variables locales en snake_case
-  - { key: readability-identifier-naming.VariableCase, value: lower_case }
+  # bugprone-empty-catch: aceptar catches vacíos marcados con @INTENTIONAL en un comentario
+  - { key: bugprone-empty-catch.IgnoreCatchWithKeywords, value: '@INTENTIONAL' }
 
-  # Miembros privados en snake_case con sufijo _
+  # =====================================================================
+  # CONSTANTES → UPPER_CASE (compile-time y runtime, en cualquier scope)
+  # =====================================================================
+  # Todo lo que sea const o constexpr se identifica visualmente en UPPER_CASE,
+  # sin importar si es global, local, miembro o static.
+
+  # constexpr en cualquier scope (globales y locales)
+  - { key: readability-identifier-naming.ConstexprVariableCase, value: UPPER_CASE }
+
+  # Constantes globales (const no-constexpr)
+  - { key: readability-identifier-naming.GlobalConstantCase, value: UPPER_CASE }
+
+  # Constantes locales (const en función)
+  - { key: readability-identifier-naming.LocalConstantCase, value: UPPER_CASE }
+
+  # Static const a nivel de archivo/namespace
+  - { key: readability-identifier-naming.StaticConstantCase, value: UPPER_CASE }
+
+  # Miembros static const/constexpr de clase (p.ej. static constexpr int MAX = 100;)
+  - { key: readability-identifier-naming.ClassConstantCase, value: UPPER_CASE }
+
+  # Miembros const no-static de clase (p.ej. const int limit;)
+  - { key: readability-identifier-naming.ConstantMemberCase, value: UPPER_CASE }
+
+  # Valores de enums
+  - { key: readability-identifier-naming.EnumConstantCase, value: UPPER_CASE }
+
+  # NOTA: Los parámetros const NO se tratan como constantes aquí.
+  # Un parámetro sigue siendo un parámetro aunque sea const → hereda ParameterCase.
+
+  # =====================================================================
+  # VARIABLES NO-CONST
+  # =====================================================================
+
+  # Variables locales
+  - { key: readability-identifier-naming.VariableCase, value: lower_case }
+  - { key: readability-identifier-naming.LocalVariableCase, value: lower_case }
+
+  # Parámetros de función
+  - { key: readability-identifier-naming.ParameterCase, value: lower_case }
+
+  # Variables estáticas no-const (static locales, static file-scope,
+  # y static members no-const de clase como el instance_ de un Singleton).
+  # Sufijo _ para marcar que tienen storage estático.
+  - { key: readability-identifier-naming.StaticVariableCase, value: lower_case }
+  - { key: readability-identifier-naming.StaticVariableSuffix, value: _ }
+
+  # =====================================================================
+  # MIEMBROS DE CLASE NO-CONST
+  # =====================================================================
+  # Privados: snake_case con sufijo _
   - { key: readability-identifier-naming.PrivateMemberCase, value: lower_case }
   - { key: readability-identifier-naming.PrivateMemberSuffix, value: _ }
 
-  # Miembros protegidos en snake_case con sufijo _
+  # Protegidos: snake_case con sufijo _
   - { key: readability-identifier-naming.ProtectedMemberCase, value: lower_case }
   - { key: readability-identifier-naming.ProtectedMemberSuffix, value: _ }
 
-  # Miembros públicos en snake_case (sin sufijo)
+  # Públicos: snake_case sin sufijo
   - { key: readability-identifier-naming.PublicMemberCase, value: lower_case }
 
-  # Namespaces en CamelCase
-  - { key: readability-identifier-naming.NamespaceCase, value: CamelCase }
-
-  # Variables estáticas privadas como miembros privados
-  - { key: readability-identifier-naming.StaticVariableCase, value: lower_case }
-  - { key: readability-identifier-naming.StaticVariableSuffix, value: _ }
-  
-  # Constantes estáticas sin sufijo
-  - { key: readability-identifier-naming.StaticConstantCase, value: UPPER_CASE }
-
-  # Constantes globales en UPPER_CASE
-  - { key: readability-identifier-naming.GlobalConstantCase, value: UPPER_CASE }
-
-  # Variables constexpr globales en UPPER_CASE
-  - { key: readability-identifier-naming.ConstexprVariableCase, value: UPPER_CASE }
-
-  # Constantes locales en UPPER_CASE
-  - { key: readability-identifier-naming.LocalConstantCase, value: UPPER_CASE }
-
-  # Constexpr miembros en UPPER_CASE (sin sufijo)
-  - { key: readability-identifier-naming.ConstexprMemberCase, value: UPPER_CASE }
-
-  # Constexpr miembros privados/protegidos con sufijo _
-  - { key: readability-identifier-naming.ConstexprMethodCase, value: UPPER_CASE }
-
-  # Clases, structs y enums en CamelCase
+  # =====================================================================
+  # TIPOS
+  # =====================================================================
   - { key: readability-identifier-naming.ClassCase, value: CamelCase }
   - { key: readability-identifier-naming.StructCase, value: CamelCase }
   - { key: readability-identifier-naming.EnumCase, value: CamelCase }
+  - { key: readability-identifier-naming.UnionCase, value: CamelCase }
+  - { key: readability-identifier-naming.TypeAliasCase, value: CamelCase }
+  - { key: readability-identifier-naming.TypedefCase, value: CamelCase }
+  - { key: readability-identifier-naming.TemplateParameterCase, value: CamelCase }
 
-  # Valores de enums en UPPER_CASE
-  - { key: readability-identifier-naming.EnumConstantCase, value: UPPER_CASE }
+  # Namespaces
+  - { key: readability-identifier-naming.NamespaceCase, value: CamelCase }
 
-  # Métodos en camelBack (sin sufijos)
+  # =====================================================================
+  # FUNCIONES Y MÉTODOS (incluyendo constexpr)
+  # =====================================================================
+  # Un método/función constexpr es un invocable, no una constante → camelBack.
+  - { key: readability-identifier-naming.FunctionCase, value: camelBack }
+  - { key: readability-identifier-naming.ConstexprFunctionCase, value: camelBack }
   - { key: readability-identifier-naming.MethodCase, value: camelBack }
   - { key: readability-identifier-naming.PrivateMethodCase, value: camelBack }
   - { key: readability-identifier-naming.ProtectedMethodCase, value: camelBack }
   - { key: readability-identifier-naming.PublicMethodCase, value: camelBack }
-
-  # Funciones en camelBack
-  - { key: readability-identifier-naming.FunctionCase, value: camelBack }
-
-  # Parámetros en lower_case
-  - { key: readability-identifier-naming.ParameterCase, value: lower_case }
-
-  # misc-include-cleaner: Ignorar SDL (genera falsos positivos)
-  - { key: misc-include-cleaner.IgnoreHeaders, value: 'SDL3/.*' }
+  - { key: readability-identifier-naming.ConstexprMethodCase, value: camelBack }

.claude/settings.local.json

@@ -1,19 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(dir \"C:\\mingw\\gitea\\orni_attack\\release\\dll\")",
-      "Bash(make:*)",
-      "Bash(echo:*)",
-      "Bash(objdump:*)",
-      "Bash(unzip:*)",
-      "Bash(\"/Volumes/diskito/diskito.app/Contents/MacOS/diskito\")",
-      "Bash(pkill:*)",
-      "Bash(hdiutil detach:*)",
-      "Bash(cat:*)",
-      "Bash(hdiutil mount:*)",
-      "Bash(open \"/Volumes/Orni Attack/Orni Attack.app\")"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}

.githooks/pre-commit

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# Pre-commit hook: aplica clang-format als fitxers C++ staged abans del commit.
+# - Només toca fitxers staged dins source/ (exclou source/external/ i source/legacy/).
+# - Avorta el commit si hi ha canvis NO staged en aquests fitxers (per no incloure'ls sense voler).
+
+set -euo pipefail
+
+if ! command -v clang-format >/dev/null 2>&1; then
+    echo "pre-commit: clang-format no trobat — saltant format check" >&2
+    exit 0
+fi
+
+mapfile -t STAGED < <(git diff --cached --name-only --diff-filter=ACMR \
+    | grep -E '^source/.*\.(cpp|hpp|h)$' \
+    | grep -vE '^source/(external|legacy)/' || true)
+
+if [ ${#STAGED[@]} -eq 0 ]; then
+    exit 0
+fi
+
+UNSTAGED_DIRTY=()
+for f in "${STAGED[@]}"; do
+    if ! git diff --quiet -- "$f"; then
+        UNSTAGED_DIRTY+=("$f")
+    fi
+done
+
+if [ ${#UNSTAGED_DIRTY[@]} -gt 0 ]; then
+    echo "pre-commit: aquests fitxers tenen canvis NO staged i estan al commit." >&2
+    echo "            Fes 'git add' o 'git stash' abans de continuar:" >&2
+    printf '  %s\n' "${UNSTAGED_DIRTY[@]}" >&2
+    exit 1
+fi
+
+clang-format -i "${STAGED[@]}"
+git add -- "${STAGED[@]}"
+
+# --- clang-tidy només sobre els fitxers staged ---
+if ! command -v clang-tidy >/dev/null 2>&1; then
+    echo "pre-commit: clang-tidy no trobat — saltant tidy" >&2
+    exit 0
+fi
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+BUILD_DIR="$REPO_ROOT/build"
+
+if [ ! -f "$BUILD_DIR/compile_commands.json" ]; then
+    echo "pre-commit: generant compile_commands.json (build dir buit)..." >&2
+    cmake -S "$REPO_ROOT" -B "$BUILD_DIR" >/dev/null
+fi
+
+echo "pre-commit: clang-tidy sobre ${#STAGED[@]} fitxer(s)..." >&2
+if ! clang-tidy -p "$BUILD_DIR" --quiet "${STAGED[@]}"; then
+    echo "pre-commit: clang-tidy ha trobat errors — commit avortat" >&2
+    exit 1
+fi
+
+# --- cppcheck només sobre els .cpp staged ---
+if ! command -v cppcheck >/dev/null 2>&1; then
+    echo "pre-commit: cppcheck no trobat — saltant cppcheck" >&2
+    exit 0
+fi
+
+CPP_STAGED=()
+for f in "${STAGED[@]}"; do
+    [[ "$f" == *.cpp ]] && CPP_STAGED+=("$f")
+done
+
+if [ ${#CPP_STAGED[@]} -eq 0 ]; then
+    exit 0
+fi
+
+echo "pre-commit: cppcheck sobre ${#CPP_STAGED[@]} fitxer(s)..." >&2
+# Nota: el path d'inclusió ha d'anar en relatiu. Amb path absolut, cppcheck
+# falla a parsejar "enum class X : std::uint8_t" (no resol <cstdint> bé) i
+# emet un syntaxError fals. Els hooks de git s'executen sempre des de la
+# rel del repo, així que "source" relatiu és prou.
+if ! cppcheck \
+        --enable=warning,style,performance,portability \
+        --std=c++20 \
+        --language=c++ \
+        --inline-suppr \
+        --suppress=missingIncludeSystem \
+        --suppress=toomanyconfigs \
+        --suppress='*:*source/external/*' \
+        --suppress='*:*source/legacy/*' \
+        --suppress=normalCheckLevelMaxBranches \
+        --suppress=useStlAlgorithm \
+        -D_DEBUG \
+        -DLINUX_BUILD \
+        --quiet \
+        --error-exitcode=1 \
+        -I source \
+        "${CPP_STAGED[@]}"; then
+    echo "pre-commit: cppcheck ha trobat errors — commit avortat" >&2
+    exit 1
+fi

.gitignore

@@ -24,9 +24,11 @@ tools/pack_resources/pack_resources.exe
 *.zip
 *.tar.gz
 *.dmg
+dist/
 
 # Generated resources
 resources.pack
+release/windows/*.res
 
 # Compiled Object files
 *.o
@@ -100,3 +102,7 @@ ehthumbs_vista.db
 *.bak
 *.swp
 *.swo
+
+.cache/
+.claude/lint-reports/
+lint-reports/

CMakeLists.txt

@@ -1,122 +1,236 @@
-# CMakeLists.txt
+cmake_minimum_required(VERSION 3.16)
+project(orni VERSION 0.7.2 LANGUAGES CXX)
 
-cmake_minimum_required(VERSION 3.10)
-project(orni VERSION 0.7.2)
-
-# Info del proyecto
+# Info del projecte (font de veritat per a project.h)
 set(PROJECT_LONG_NAME "Orni Attack")
-set(PROJECT_COPYRIGHT_ORIGINAL "© 1999 Visente i Sergi")
-set(PROJECT_COPYRIGHT_PORT "© 2025 JailDesigner")
-set(PROJECT_COPYRIGHT "${PROJECT_COPYRIGHT_ORIGINAL}, ${PROJECT_COPYRIGHT_PORT}")
+set(PROJECT_COPYRIGHT "© 2026 JailDesigner")
 
-# Establecer estándar de C++
-set(CMAKE_CXX_STANDARD 20)
-set(CMAKE_CXX_STANDARD_REQUIRED True)
-
-# Exportar comandos de compilación para herramientas de análisis
-set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
-
-# --- GENERACIÓN DE VERSIÓN AUTOMÁTICA ---
-find_package(Git QUIET)
-if(GIT_FOUND)
-    execute_process(
-        COMMAND ${GIT_EXECUTABLE} rev-parse --short=7 HEAD
-        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
-        OUTPUT_VARIABLE GIT_HASH
-        OUTPUT_STRIP_TRAILING_WHITESPACE
-        ERROR_QUIET
-    )
-else()
-    set(GIT_HASH "unknown")
+if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
+    set(CMAKE_BUILD_TYPE Debug CACHE STRING "" FORCE)
+endif()
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+
+# --- GENERACIÓ DEL project.h AMB GIT HASH ---
+# Si GIT_HASH ve passat des de fora (Makefile), l'usem; si no, el resolem amb git.
+if(NOT DEFINED GIT_HASH OR GIT_HASH STREQUAL "")
+    find_package(Git QUIET)
+    if(GIT_FOUND)
+        execute_process(
+            COMMAND ${GIT_EXECUTABLE} rev-parse --short=7 HEAD
+            WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+            OUTPUT_VARIABLE GIT_HASH
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+    endif()
+    if(NOT DEFINED GIT_HASH OR GIT_HASH STREQUAL "")
+        set(GIT_HASH "unknown")
+    endif()
 endif()
 
-# Configurar archivo de versión
 configure_file(${CMAKE_SOURCE_DIR}/source/project.h.in ${CMAKE_BINARY_DIR}/project.h @ONLY)
 
-# --- LISTA DE FUENTES (AUTO-DESCUBRIMIENTO) ---
-# Buscar automáticamente todos los archivos .cpp en core/, game/ y main.cpp
-file(GLOB_RECURSE CORE_SOURCES "${CMAKE_SOURCE_DIR}/source/core/*.cpp")
-file(GLOB_RECURSE GAME_SOURCES "${CMAKE_SOURCE_DIR}/source/game/*.cpp")
+# --- LLISTA DE FONTS (AUTO-DESCOBRIMENT) ---
+# Cerquem tots els .cpp dins core/ i game/, més main.cpp. Exclou legacy/.
+file(GLOB_RECURSE CORE_SOURCES CONFIGURE_DEPENDS "${CMAKE_SOURCE_DIR}/source/core/*.cpp")
+file(GLOB_RECURSE GAME_SOURCES CONFIGURE_DEPENDS "${CMAKE_SOURCE_DIR}/source/game/*.cpp")
+file(GLOB_RECURSE EXTERNAL_SOURCES CONFIGURE_DEPENDS "${CMAKE_SOURCE_DIR}/source/external/*.cpp")
+
 set(APP_SOURCES
     ${CORE_SOURCES}
     ${GAME_SOURCES}
+    ${EXTERNAL_SOURCES}
     source/main.cpp
 )
-
-# Excluir archivos legacy (código Pascal de referencia)
 list(FILTER APP_SOURCES EXCLUDE REGEX ".*/legacy/.*")
 
-# Log de archivos encontrados (útil para debug)
 list(LENGTH APP_SOURCES APP_SOURCES_COUNT)
-message(STATUS "Archivos .cpp encontrados: ${APP_SOURCES_COUNT}")
+message(STATUS "Fonts .cpp trobades: ${APP_SOURCES_COUNT}")
 
-# Configuración de SDL3
+# --- SDL3 ---
 find_package(SDL3 REQUIRED CONFIG REQUIRED COMPONENTS SDL3)
-message(STATUS "SDL3 encontrado: ${SDL3_INCLUDE_DIRS}")
 
-# --- AÑADIR EJECUTABLE ---
 add_executable(${PROJECT_NAME} ${APP_SOURCES})
 
-# --- DIRECTORIOS DE INCLUSIÓN ---
-target_include_directories(${PROJECT_NAME} PUBLIC
+target_include_directories(${PROJECT_NAME} PRIVATE
     "${CMAKE_SOURCE_DIR}/source"
     "${CMAKE_BINARY_DIR}"
 )
 
-# Enlazar las librerías SDL3
 target_link_libraries(${PROJECT_NAME} PRIVATE SDL3::SDL3)
 
-# --- 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>:-O2 -ffunction-sections -fdata-sections>)
+# Silencia warnings de codi de tercers (mateixa filosofia que el
+# .clang-tidy a source/external/). Només afecta aquests TUs concrets;
+# la resta del codi continua compilant amb -Wall -Wextra -Wpedantic.
+if(EXTERNAL_SOURCES)
+    set_source_files_properties(
+        ${EXTERNAL_SOURCES}
+        PROPERTIES COMPILE_OPTIONS "-Wno-missing-field-initializers;-Wno-deprecated-declarations"
+    )
+endif()
 
-# Definir _DEBUG en modo Debug y RELEASE_BUILD en modo Release
-target_compile_definitions(${PROJECT_NAME} PRIVATE $<$<CONFIG:DEBUG>:_DEBUG>)
-target_compile_definitions(${PROJECT_NAME} PRIVATE $<$<CONFIG:RELEASE>:RELEASE_BUILD>)
+target_compile_options(${PROJECT_NAME} PRIVATE -Wall -Wextra -Wpedantic)
+target_compile_options(${PROJECT_NAME} PRIVATE
+    $<$<CONFIG:Release>:-O2 -ffunction-sections -fdata-sections>
+)
+
+target_compile_definitions(${PROJECT_NAME} PRIVATE
+    $<$<CONFIG:Debug>:_DEBUG>
+    $<$<CONFIG:Release>:RELEASE_BUILD>
+)
 
-# Definir MACOS_BUNDLE si es un bundle de macOS
 if(APPLE AND MACOSX_BUNDLE)
     target_compile_definitions(${PROJECT_NAME} PRIVATE MACOS_BUNDLE)
 endif()
 
-# Configuración específica para cada plataforma
 if(WIN32)
     target_compile_definitions(${PROJECT_NAME} PRIVATE WINDOWS_BUILD)
     target_link_libraries(${PROJECT_NAME} PRIVATE mingw32)
-    # Static linking for libgcc and libstdc++ (avoid DLL dependencies for distribution)
     target_link_options(${PROJECT_NAME} PRIVATE
         -static-libgcc
         -static-libstdc++
         -static
     )
-    # Añadir icono en Windows (se configurará desde el Makefile con windres)
 elseif(APPLE)
     target_compile_definitions(${PROJECT_NAME} PRIVATE MACOS_BUILD)
     target_compile_options(${PROJECT_NAME} PRIVATE -Wno-deprecated)
-    set(CMAKE_OSX_ARCHITECTURES "arm64")
 elseif(UNIX AND NOT APPLE)
     target_compile_definitions(${PROJECT_NAME} PRIVATE LINUX_BUILD)
 endif()
 
-# Especificar la ubicación del ejecutable
-set_target_properties(${PROJECT_NAME} PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR})
+# --- EINA STANDALONE: pack_resources ---
+# Executable auxiliar que empaqueta `data/` a `build/resources.pack`.
+# EXCLUDE_FROM_ALL: només es compila quan algun target en depèn (ho fa
+# `resource_pack`). Build manual: `cmake --build build --target pack_resources`.
+add_executable(pack_resources EXCLUDE_FROM_ALL
+    tools/pack_resources/pack_resources.cpp
+    source/core/resources/resource_pack.cpp
+)
+target_include_directories(pack_resources PRIVATE "${CMAKE_SOURCE_DIR}/source")
+target_compile_options(pack_resources PRIVATE -Wall -Wextra -Wpedantic)
 
-# --- STATIC ANALYSIS TARGETS ---
-# Buscar herramientas de análisis estático
-find_program(CLANG_FORMAT_EXE NAMES clang-format)
+# --- REGENERACIÓ AUTOMÀTICA DE build/resources.pack ---
+# A cada build re-empaquetem data/ si algun fitxer dins ha canviat. Evita
+# debugar amb un pack obsolet. CONFIGURE_DEPENDS força CMake a re-globbar
+# a la pròxima invocació (recull fitxers nous afegits a data/).
+file(GLOB_RECURSE DATA_FILES CONFIGURE_DEPENDS "${CMAKE_SOURCE_DIR}/data/*")
+set(RESOURCE_PACK "${CMAKE_BINARY_DIR}/resources.pack")
+
+add_custom_command(
+    OUTPUT ${RESOURCE_PACK}
+    COMMAND $<TARGET_FILE:pack_resources>
+        "${CMAKE_SOURCE_DIR}/data"
+        "${RESOURCE_PACK}"
+    DEPENDS pack_resources ${DATA_FILES}
+    WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
+    COMMENT "Empaquetant data/ → build/resources.pack"
+    VERBATIM
+)
+add_custom_target(resource_pack ALL DEPENDS ${RESOURCE_PACK})
+add_dependencies(${PROJECT_NAME} resource_pack)
+
+# --- COMPILACIÓ DE SHADERS GLSL → SPIR-V (headers C++ embedits) ---
+# Compila els shaders .glsl a SPIR-V i els converteix en headers C++ embedits
+# (source/core/rendering/gpu/spv/*.h). Aquests headers es commiteen al repo:
+# en macOS no cal glslc (els headers ja existeixen). En Linux/Windows glslc
+# és obligatori per regenerar els headers en cada canvi del GLSL.
+#
+# Per a macOS hi ha a més els headers MSL escrits a mà a source/core/rendering/gpu/msl/.
+set(SHADERS_DIR  "${CMAKE_SOURCE_DIR}/shaders")
+set(HEADERS_DIR  "${CMAKE_SOURCE_DIR}/source/core/rendering/gpu/spv")
+set(ALL_SHADER_HEADERS
+    "${HEADERS_DIR}/line_vert_spv.h"
+    "${HEADERS_DIR}/line_frag_spv.h"
+    "${HEADERS_DIR}/postfx_vert_spv.h"
+    "${HEADERS_DIR}/postfx_frag_spv.h"
+    "${HEADERS_DIR}/bloom_frag_spv.h"
+)
+set(ALL_SHADER_SOURCES
+    "${SHADERS_DIR}/line.vert.glsl"
+    "${SHADERS_DIR}/line.frag.glsl"
+    "${SHADERS_DIR}/postfx.vert.glsl"
+    "${SHADERS_DIR}/postfx.frag.glsl"
+    "${SHADERS_DIR}/bloom.frag.glsl"
+)
+find_program(GLSLC_EXE NAMES glslc HINTS ${Vulkan_GLSLC_EXECUTABLE})
+if(GLSLC_EXE)
+    add_custom_command(
+        OUTPUT  ${ALL_SHADER_HEADERS}
+        COMMAND ${CMAKE_COMMAND}
+                -D GLSLC=${GLSLC_EXE}
+                -D SHADERS_DIR=${SHADERS_DIR}
+                -D HEADERS_DIR=${HEADERS_DIR}
+                -P ${CMAKE_SOURCE_DIR}/tools/shaders/compile_spirv.cmake
+        DEPENDS ${ALL_SHADER_SOURCES} ${CMAKE_SOURCE_DIR}/tools/shaders/compile_spirv.cmake
+        COMMENT "Compilant shaders GLSL → headers SPIR-V embedits"
+        VERBATIM
+    )
+    add_custom_target(shaders DEPENDS ${ALL_SHADER_HEADERS})
+    add_dependencies(${PROJECT_NAME} shaders)
+    message(STATUS "Shaders: glslc trobat (${GLSLC_EXE}); headers SPV es regeneraran si canvia el GLSL")
+elseif(APPLE)
+    message(STATUS "Shaders: glslc no trobat en macOS — s'usaran els headers SPV ja commiteats")
+else()
+    message(FATAL_ERROR "glslc no trobat: instal·la 'shaderc' o 'vulkan-sdk' per compilar shaders SPIR-V (obligatori a Linux/Windows)")
+endif()
+
+# --- STATIC ANALYSIS / FORMAT TARGETS ---
 find_program(CLANG_TIDY_EXE NAMES clang-tidy)
+find_program(CLANG_FORMAT_EXE NAMES clang-format)
+find_program(CPPCHECK_EXE NAMES cppcheck)
 
-# Recopilar todos los archivos fuente para formateo
 file(GLOB_RECURSE ALL_SOURCE_FILES
     "${CMAKE_SOURCE_DIR}/source/*.cpp"
     "${CMAKE_SOURCE_DIR}/source/*.hpp"
+    "${CMAKE_SOURCE_DIR}/source/*.h"
 )
-# Excluir directorios con checks deshabilitados
-list(FILTER ALL_SOURCE_FILES EXCLUDE REGEX ".*/audio/.*")
+list(FILTER ALL_SOURCE_FILES EXCLUDE REGEX ".*/external/.*")
 list(FILTER ALL_SOURCE_FILES EXCLUDE REGEX ".*/legacy/.*")
 
-# Targets de clang-format
+set(CPPCHECK_SOURCES ${ALL_SOURCE_FILES})
+list(FILTER CPPCHECK_SOURCES INCLUDE REGEX ".*\\.cpp$")
+
+if(CLANG_TIDY_EXE)
+    # En macOS, obtenir la ruta del SDK perquè clang-tidy trobe els headers del sistema.
+    set(CLANG_TIDY_EXTRA_ARGS "")
+    if(APPLE)
+        execute_process(
+            COMMAND xcrun --show-sdk-path
+            OUTPUT_VARIABLE MACOS_SDK_PATH
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+        )
+        if(MACOS_SDK_PATH)
+            set(CLANG_TIDY_EXTRA_ARGS "--extra-arg=-isysroot${MACOS_SDK_PATH}")
+            message(STATUS "clang-tidy usarà SDK de macOS: ${MACOS_SDK_PATH}")
+        endif()
+    endif()
+
+    add_custom_target(tidy
+        COMMAND ${CLANG_TIDY_EXE}
+            -p ${CMAKE_BINARY_DIR}
+            ${CLANG_TIDY_EXTRA_ARGS}
+            ${ALL_SOURCE_FILES}
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMENT "Running clang-tidy..."
+    )
+
+    add_custom_target(tidy-fix
+        COMMAND ${CLANG_TIDY_EXE}
+            -p ${CMAKE_BINARY_DIR}
+            ${CLANG_TIDY_EXTRA_ARGS}
+            --fix
+            ${ALL_SOURCE_FILES}
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMENT "Running clang-tidy with fixes..."
+    )
+else()
+    message(STATUS "clang-tidy no trobat - targets 'tidy' i 'tidy-fix' no disponibles")
+endif()
+
 if(CLANG_FORMAT_EXE)
     add_custom_target(format
         COMMAND ${CLANG_FORMAT_EXE}
@@ -135,45 +249,30 @@ if(CLANG_FORMAT_EXE)
         COMMENT "Checking clang-format..."
     )
 else()
-    message(STATUS "clang-format no encontrado - targets 'format' y 'format-check' no disponibles")
+    message(STATUS "clang-format no trobat - targets 'format' i 'format-check' no disponibles")
 endif()
 
-# Targets de clang-tidy
-if(CLANG_TIDY_EXE)
-    # En macOS, obtener la ruta del SDK para que clang-tidy encuentre los headers del sistema
-    set(CLANG_TIDY_EXTRA_ARGS "")
-    if(APPLE)
-        execute_process(
-            COMMAND xcrun --show-sdk-path
-            OUTPUT_VARIABLE MACOS_SDK_PATH
-            OUTPUT_STRIP_TRAILING_WHITESPACE
-        )
-        if(MACOS_SDK_PATH)
-            set(CLANG_TIDY_EXTRA_ARGS "--extra-arg=-isysroot${MACOS_SDK_PATH}")
-            message(STATUS "clang-tidy usará SDK de macOS: ${MACOS_SDK_PATH}")
-        endif()
-    endif()
-
-    add_custom_target(tidy
-        COMMAND ${CLANG_TIDY_EXE}
-            -p ${CMAKE_BINARY_DIR}
-            ${CLANG_TIDY_EXTRA_ARGS}
-            --fix
-            --fix-errors
-            ${ALL_SOURCE_FILES}
+if(CPPCHECK_EXE)
+    add_custom_target(cppcheck
+        COMMAND ${CPPCHECK_EXE}
+            --enable=warning,style,performance,portability
+            --std=c++20
+            --language=c++
+            --inline-suppr
+            --suppress=missingIncludeSystem
+            --suppress=toomanyconfigs
+            --suppress=*:*source/external/*
+            --suppress=*:*source/legacy/*
+            --suppress=normalCheckLevelMaxBranches
+            --suppress=useStlAlgorithm
+            -D_DEBUG
+            -DLINUX_BUILD
+            --quiet
+            -I ${CMAKE_SOURCE_DIR}/source
+            ${CPPCHECK_SOURCES}
         WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
-        COMMENT "Running clang-tidy with auto-fix..."
-    )
-
-    add_custom_target(tidy-check
-        COMMAND ${CLANG_TIDY_EXE}
-            -p ${CMAKE_BINARY_DIR}
-            ${CLANG_TIDY_EXTRA_ARGS}
-            --warnings-as-errors='*'
-            ${ALL_SOURCE_FILES}
-        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
-        COMMENT "Checking clang-tidy..."
+        COMMENT "Running cppcheck..."
     )
 else()
-    message(STATUS "clang-tidy no encontrado - targets 'tidy' y 'tidy-check' no disponibles")
+    message(STATUS "cppcheck no trobat - target 'cppcheck' no disponible")
 endif()

Makefile

@@ -1,380 +1,340 @@
-# ==============================================================================
-# DIRECTORIES
-# ==============================================================================
-DIR_ROOT       := $(dir $(abspath $(MAKEFILE_LIST)))
-DIR_SOURCES    := $(addprefix $(DIR_ROOT), source/)
-DIR_BIN        := $(DIR_ROOT)
+PROJECT  := orni
+BUILDDIR := build
 
-# ==============================================================================
-# TARGET NAMES
-# ==============================================================================
+# Detecció de plataforma. En Windows CMake defaulteja a "NMake Makefiles"
+# (que requereix Visual Studio); forcem MinGW Makefiles per usar el g++ de
+# MinGW. nproc tampoc existeix en cmd.exe → fem servir NUMBER_OF_PROCESSORS.
 ifeq ($(OS),Windows_NT)
-    TARGET_NAME    := $(shell powershell -Command "(Select-String -Path 'CMakeLists.txt' -Pattern 'project\s*\x28(\w+)').Matches.Groups[1].Value")
-    LONG_NAME      := $(shell powershell -Command "(Select-String -Path 'CMakeLists.txt' -Pattern 'PROJECT_LONG_NAME\s+\x22(.+?)\x22').Matches.Groups[1].Value")
+    ifneq ($(MSYSTEM),)
+        NULDEV := /dev/null
+    else
+        NULDEV := NUL
+    endif
+    JOBS      ?= $(NUMBER_OF_PROCESSORS)
+    HAS_NINJA := $(shell ninja --version 2>$(NULDEV))
+    ifneq ($(HAS_NINJA),)
+        CMAKE_GEN := -G "Ninja"
+    else
+        CMAKE_GEN := -G "MinGW Makefiles"
+    endif
 else
-    TARGET_NAME    := $(shell awk '/^project/ {gsub(/[)(]/, " "); print $$2}' CMakeLists.txt)
-    LONG_NAME      := $(shell grep 'PROJECT_LONG_NAME' CMakeLists.txt | sed 's/.*"\(.*\)".*/\1/')
+    NULDEV    := /dev/null
+    JOBS      ?= $(shell nproc 2>/dev/null || echo 4)
+    HAS_NINJA := $(shell ninja --version 2>/dev/null)
+    ifneq ($(HAS_NINJA),)
+        CMAKE_GEN := -G "Ninja"
+    else
+        CMAKE_GEN :=
+    endif
 endif
 
-TARGET_FILE    := $(DIR_BIN)$(TARGET_NAME)
-RELEASE_FOLDER := $(TARGET_NAME)_release
-RELEASE_FILE   := $(RELEASE_FOLDER)/$(TARGET_NAME)
-
-# ==============================================================================
-# VERSION
-# ==============================================================================
+# VERSION (única font de veritat: CMakeLists.txt project(...) VERSION ...).
+# Lazy (=): només es calcula quan s'invoca un target que la usa.
 ifeq ($(OS),Windows_NT)
-    VERSION := v$(shell powershell -Command "(Select-String -Path 'CMakeLists.txt' -Pattern 'project.*VERSION\s+([0-9.]+)').Matches.Groups[1].Value")
+    VERSION = v$(shell powershell -Command "(Select-String -Path 'CMakeLists.txt' -Pattern 'project.*VERSION\s+([0-9.]+)').Matches.Groups[1].Value")
 else
-    VERSION := v$(shell grep "^project" CMakeLists.txt | tr -cd 0-9.)
+    VERSION = v$(shell grep '^project' CMakeLists.txt | sed -E 's/.*VERSION[[:space:]]+([0-9.]+).*/\1/')
 endif
 
-# Release file names (depend on VERSION, so must come after)
-ifeq ($(OS),Windows_NT)
-    RAW_VERSION := $(shell powershell -Command "\"$(VERSION)\" -replace '^v', ''")
-else
-    RAW_VERSION := $(shell echo $(VERSION) | sed 's/^v//')
+# GIT_HASH calculat al host i passat a CMake (evita problemes si CMake corre en
+# entorns sense accés a git).
+GIT_HASH := $(shell git rev-parse --short=7 HEAD 2>$(NULDEV))
+ifeq ($(GIT_HASH),)
+    GIT_HASH := unknown
 endif
-WINDOWS_RELEASE := $(TARGET_NAME)-$(VERSION)-windows-x64.zip
-MACOS_ARM_RELEASE := $(TARGET_NAME)-$(VERSION)-macos-arm64.dmg
-MACOS_INTEL_RELEASE := $(TARGET_NAME)-$(VERSION)-macos-x64.dmg
-LINUX_RELEASE := $(TARGET_NAME)-$(VERSION)-linux-x64.tar.gz
-RPI_RELEASE := $(TARGET_NAME)-$(VERSION)-rpi-arm64.tar.gz
-APP_NAME := $(LONG_NAME)
+
+CMAKE_DEFS := -DGIT_HASH=$(GIT_HASH)
 
 # ==============================================================================
-# SOURCE FILES
+# RELEASE — variables d'empaquetat per distribució
 # ==============================================================================
-# Note: Source files are now auto-discovered by CMake using GLOB_RECURSE
-# No need to maintain this list manually anymore!
+APP_NAME       := Orni Attack
+DIST_DIR       := dist
+RELEASE_FOLDER := $(DIST_DIR)/_tmp
+TARGET_FILE    := $(BUILDDIR)/$(PROJECT)
+RELEASE_FILE   := $(RELEASE_FOLDER)/$(PROJECT)
 
-# ==============================================================================
-# PLATFORM-SPECIFIC UTILITIES
-# ==============================================================================
-# Use Unix commands always (MinGW Make uses bash even on Windows)
-RMFILE          := rm -f
-RMDIR           := rm -rf
-MKDIR           := mkdir -p
+# Noms dels artefactes finals (amb VERSION i PROJECT)
+WINDOWS_RELEASE             := $(DIST_DIR)/$(PROJECT)-$(VERSION)-win32-x64.zip
+MACOS_APPLE_SILICON_RELEASE := $(DIST_DIR)/$(PROJECT)-$(VERSION)-macos-apple-silicon.dmg
+LINUX_RELEASE               := $(DIST_DIR)/$(PROJECT)-$(VERSION)-linux.tar.gz
 
+# Variables específiques de Windows (PowerShell). El subst escapa apòstrofs.
 ifeq ($(OS),Windows_NT)
-    # Windows-specific: Force cmd.exe shell for PowerShell commands
-    SHELL := cmd.exe
+    WIN_TARGET_FILE     := $(BUILDDIR)/$(APP_NAME)
+    WIN_RELEASE_FILE    := $(RELEASE_FOLDER)/$(APP_NAME)
+    WIN_RELEASE_FILE_PS := $(subst ','',$(WIN_RELEASE_FILE))
+    UNAME_S             :=
 else
-    # Unix-specific
-    UNAME_S         := $(shell uname -s)
+    WIN_TARGET_FILE     := $(TARGET_FILE)
+    WIN_RELEASE_FILE    := $(RELEASE_FILE)
+    WIN_RELEASE_FILE_PS := $(WIN_RELEASE_FILE)
+    UNAME_S             := $(shell uname -s)
+endif
+
+# Helpers cross-platform.
+ifeq ($(OS),Windows_NT)
+    RMFILE := del /Q
+    RMDIR  := rmdir /S /Q
+    MKDIR  := mkdir
+else
+    RMFILE := rm -f
+    RMDIR  := rm -rdf
+    MKDIR  := mkdir -p
+endif
+
+.PHONY: all debug release _windows-release _macos-release _linux-release \
+        run run-debug clean rebuild show-version pack \
+        format format-check tidy tidy-fix cppcheck hooks-install help
+
+# ==============================================================================
+# COMPILACIÓ
+# ==============================================================================
+#   make           → Release (binari d'ús normal)
+#   make debug     → Debug
+#   make release   → Release + empaquetat per a distribució (zip/dmg/tar.gz segons SO)
+# ==============================================================================
+
+all:
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) -j$(JOBS)
+
+debug:
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Debug $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) -j$(JOBS)
+
+run: all
+	@./$(BUILDDIR)/$(PROJECT)
+
+run-debug: debug
+	@./$(BUILDDIR)/$(PROJECT)
+
+# Release + empaquetat: detecta el SO i delega al sub-target corresponent.
+release:
+ifeq ($(OS),Windows_NT)
+	@"$(MAKE)" _windows-release
+else
+ifeq ($(UNAME_S),Darwin)
+	@$(MAKE) _macos-release
+else
+	@$(MAKE) _linux-release
+endif
 endif
 
 # ==============================================================================
-# PACKING TOOL
+# RELEASE — Linux (.tar.gz)
 # ==============================================================================
-PACK_TOOL := tools/pack_resources/pack_resources
+_linux-release:
+	@echo "Creando release para Linux - Version: $(VERSION)"
 
-# ==============================================================================
-# DEFAULT GOAL
-# ==============================================================================
-.DEFAULT_GOAL := all
+# Compila Release (genera resources.pack i binari)
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) -j$(JOBS)
 
-.PHONY: pack_tool resources.pack
-
-pack_tool:
-	@make -C tools/pack_resources
-
-resources.pack: pack_tool
-	@echo "Creating resources.pack..."
-	@./$(PACK_TOOL) data resources.pack
-
-# ==============================================================================
-# TARGETS
-# ==============================================================================
-.PHONY: all clean debug help backup
-
-# ==============================================================================
-# BUILD TARGETS (delegate to CMake)
-# ==============================================================================
-
-# Default target: build with CMake + resources
-all: resources.pack $(TARGET_FILE)
-
-$(TARGET_FILE):
-	@cmake -B build -DCMAKE_BUILD_TYPE=Release
-	@cmake --build build
-	@echo "Build successful: $(TARGET_FILE)"
-
-# Debug build
-debug: resources.pack
-	@cmake -B build -DCMAKE_BUILD_TYPE=Debug
-	@cmake --build build
-	@echo "Debug build successful: $(TARGET_FILE)"
-
-# ==============================================================================
-# RELEASE PACKAGING TARGETS
-# ==============================================================================
-
-# macOS Release (Apple Silicon)
-.PHONY: macos_release
-macos_release: pack_tool resources.pack
-	@echo "Creating macOS release - Version: $(VERSION)"
-
-	# Check/install create-dmg
-	@command -v create-dmg >/dev/null || (echo "Installing create-dmg..." && brew install create-dmg)
-
-	# Clean previous releases
+# Recrea la carpeta temporal
+	@$(MKDIR) "$(DIST_DIR)" 2>/dev/null || true
 	@$(RMDIR) "$(RELEASE_FOLDER)" 2>/dev/null || true
-	@$(RMDIR) Frameworks 2>/dev/null || true
-	@$(RMFILE) "$(MACOS_ARM_RELEASE)" 2>/dev/null || true
+	$(MKDIR) "$(RELEASE_FOLDER)"
 
-	# Create .app structure
-	@$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks"
-	@$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS"
-	@$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources"
-	@$(MKDIR) Frameworks
+# Còpia de fitxers
+	cp $(BUILDDIR)/resources.pack "$(RELEASE_FOLDER)"
+	cp README.md "$(RELEASE_FOLDER)"
+	@[ -f LICENSE ] && cp LICENSE "$(RELEASE_FOLDER)" || true
+	cp "$(TARGET_FILE)" "$(RELEASE_FILE)"
+	strip -s -R .comment -R .gnu.version "$(RELEASE_FILE)" --strip-unneeded
 
-	# Copy resources.pack to Resources
-	@cp resources.pack "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources/"
-	@ditto release/frameworks/SDL3.xcframework/macos-arm64_x86_64/SDL3.framework "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks/SDL3.framework"
-	@ditto release/frameworks/SDL3.xcframework/macos-arm64_x86_64/SDL3.framework Frameworks/SDL3.framework
+# Empaqueta a .tar.gz
+	$(RMFILE) "$(LINUX_RELEASE)"
+	tar -czvf "$(LINUX_RELEASE)" -C "$(RELEASE_FOLDER)" .
+	@echo "Release creado: $(LINUX_RELEASE)"
 
-	# Recreate framework symlinks (may be broken)
-	@cd Frameworks/SDL3.framework && rm -f SDL3 Headers Resources && \
-		ln -s Versions/Current/SDL3 SDL3 && \
-		ln -s Versions/Current/Headers Headers && \
-		ln -s Versions/Current/Resources Resources
-	@cd Frameworks/SDL3.framework/Versions && rm -f Current && ln -s A Current
-	@cd "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks/SDL3.framework" && rm -f SDL3 Headers Resources && \
-		ln -s Versions/Current/SDL3 SDL3 && \
-		ln -s Versions/Current/Headers Headers && \
-		ln -s Versions/Current/Resources Resources
-	@cd "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks/SDL3.framework/Versions" && rm -f Current && ln -s A Current
+# Neteja la carpeta temporal
+	$(RMDIR) "$(RELEASE_FOLDER)"
 
-	@cp release/icon.icns "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources/"
-	@cp release/Info.plist "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/"
-	@cp LICENSE "$(RELEASE_FOLDER)/" 2>/dev/null || echo "Warning: LICENSE not found"
-	@cp README.md "$(RELEASE_FOLDER)/" 2>/dev/null || echo "Warning: README.md not found"
-
-	# Update Info.plist version and names
-	@echo "Updating Info.plist with version $(RAW_VERSION) and names..."
-	@sed -i '' '/<key>CFBundleShortVersionString<\/key>/{n;s|<string>.*</string>|<string>$(RAW_VERSION)</string>|;}' \
-		"$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"
-	@sed -i '' '/<key>CFBundleVersion<\/key>/{n;s|<string>.*</string>|<string>$(RAW_VERSION)</string>|;}' \
-		"$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"
-	@sed -i '' '/<key>CFBundleExecutable<\/key>/{n;s|<string>.*</string>|<string>$(TARGET_NAME)</string>|;}' \
-		"$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"
-	@sed -i '' '/<key>CFBundleName<\/key>/{n;s|<string>.*</string>|<string>$(APP_NAME)</string>|;}' \
-		"$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"
-	@sed -i '' '/<key>CFBundleDisplayName<\/key>/{n;s|<string>.*</string>|<string>$(APP_NAME)</string>|;}' \
-		"$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"
-
-	# Compile for Apple Silicon using CMake
-	@cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_OSX_ARCHITECTURES=arm64
-	@cmake --build build
-	@cp $(TARGET_FILE) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS/$(TARGET_NAME)"
-
-	# Code sign
-	@codesign --deep --force --sign - --timestamp=none "$(RELEASE_FOLDER)/$(APP_NAME).app" || echo "Warning: Code signing failed"
-
-	# Create DMG
-	@echo "Creating DMG for Apple Silicon..."
-	@create-dmg \
-		--volname "$(APP_NAME)" \
-		--window-pos 200 120 \
-		--window-size 720 300 \
-		--icon-size 96 \
-		--text-size 12 \
-		--icon "$(APP_NAME).app" 278 102 \
-		--icon "LICENSE" 441 102 \
-		--icon "README.md" 604 102 \
-		--app-drop-link 115 102 \
-		--hide-extension "$(APP_NAME).app" \
-		"$(MACOS_ARM_RELEASE)" \
-		"$(RELEASE_FOLDER)" || true
-	@echo "✓ macOS release created: $(MACOS_ARM_RELEASE)"
-
-	# Cleanup
-	@$(RMDIR) Frameworks
-	@$(RMDIR) "$(RELEASE_FOLDER)"
-
-# Linux Release
-.PHONY: linux_release
-linux_release: pack_tool resources.pack
-	@echo "Creating Linux release - Version: $(VERSION)"
-	@echo "Note: SDL3 must be installed on the target system (libsdl3-dev)"
-
-	# Clean previous
-	@$(RMDIR) "$(RELEASE_FOLDER)"
-	@$(RMFILE) "$(LINUX_RELEASE)"
-
-	# Create folder
-	@$(MKDIR) "$(RELEASE_FOLDER)"
-
-	# Copy resources
-	@cp resources.pack "$(RELEASE_FOLDER)/"
-	@cp LICENSE "$(RELEASE_FOLDER)/" 2>/dev/null || echo "Warning: LICENSE not found"
-	@cp README.md "$(RELEASE_FOLDER)/" 2>/dev/null || echo "Warning: README.md not found"
-
-	# Compile with CMake
-	@cmake -B build -DCMAKE_BUILD_TYPE=Release
-	@cmake --build build
-	@cp $(TARGET_FILE) "$(RELEASE_FILE)"
-	@strip -s -R .comment -R .gnu.version "$(RELEASE_FILE)" --strip-unneeded || strip "$(RELEASE_FILE)"
-
-	# Package
-	@tar -czf "$(LINUX_RELEASE)" -C "$(RELEASE_FOLDER)" .
-	@echo "✓ Linux release created: $(LINUX_RELEASE)"
-
-	# Cleanup
-	@$(RMDIR) "$(RELEASE_FOLDER)"
-
-# Windows Release (requires MinGW on Windows or cross-compiler on Linux)
-.PHONY: windows_release
-windows_release: pack_tool resources.pack
+# ==============================================================================
+# RELEASE — Windows (.zip)
+# ==============================================================================
+_windows-release:
 	@echo off
-	@echo Creating Windows release - Version: $(VERSION)
-	@powershell if (Test-Path "$(RELEASE_FOLDER)") {Remove-Item "$(RELEASE_FOLDER)" -Recurse -Force}
-	@powershell if (Test-Path "$(WINDOWS_RELEASE)") {Remove-Item "$(WINDOWS_RELEASE)"}
-	@powershell if (-not (Test-Path "$(RELEASE_FOLDER)")) {New-Item "$(RELEASE_FOLDER)" -ItemType Directory}
-	@powershell Copy-Item -Path "resources.pack" -Destination "$(RELEASE_FOLDER)"
-	@powershell Copy-Item "release\dll\SDL3.dll" -Destination "$(RELEASE_FOLDER)"
-	@powershell Copy-Item "release\dll\libwinpthread-1.dll" -Destination "$(RELEASE_FOLDER)"
-	@powershell if (Test-Path "LICENSE") {Copy-Item "LICENSE" -Destination "$(RELEASE_FOLDER)"}
-	@powershell if (Test-Path "README.md") {Copy-Item "README.md" -Destination "$(RELEASE_FOLDER)"}
-	@windres release/$(TARGET_NAME).rc -O coff -o release/$(TARGET_NAME).res 2>nul || echo Warning: windres failed
-	@cmake -B build -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release
-	@cmake --build build
-	@powershell if (Test-Path "$(TARGET_FILE).exe") {Copy-Item "$(TARGET_FILE).exe" -Destination "$(RELEASE_FILE).exe"} else {Copy-Item "$(TARGET_FILE)" -Destination "$(RELEASE_FILE).exe"}
-	@strip "$(RELEASE_FILE).exe" 2>nul || echo Warning: strip not available
-	@powershell Compress-Archive -Path "$(RELEASE_FOLDER)\*" -DestinationPath "$(WINDOWS_RELEASE)" -Force
-	@echo Release created: $(WINDOWS_RELEASE)
-	@powershell if (Test-Path "$(RELEASE_FOLDER)") {Remove-Item "$(RELEASE_FOLDER)" -Recurse -Force}
+	@echo Creando release para Windows - Version: $(VERSION)
 
-# Raspberry Pi Release (cross-compilation from Linux/macOS)
-.PHONY: rpi_release
-rpi_release:
-	@echo "Creating Raspberry Pi ARM64 release - Version: $(VERSION)"
-	@echo "Note: Requires aarch64-linux-gnu-g++ cross-compiler"
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) -j$(JOBS)
 
-	# Check for cross-compiler
-	@command -v aarch64-linux-gnu-g++ >/dev/null || (echo "Error: aarch64-linux-gnu-g++ not found" && exit 1)
+	@powershell -Command "if (-not (Test-Path '$(DIST_DIR)')) {New-Item '$(DIST_DIR)' -ItemType Directory}"
+	@powershell -Command "if (Test-Path '$(RELEASE_FOLDER)') {Remove-Item '$(RELEASE_FOLDER)' -Recurse -Force}"
+	@powershell -Command "if (-not (Test-Path '$(RELEASE_FOLDER)')) {New-Item '$(RELEASE_FOLDER)' -ItemType Directory}"
 
-	# Clean previous
-	@$(RMDIR) "$(RELEASE_FOLDER)"
-	@$(RMFILE) "$(RPI_RELEASE)"
+	@powershell -Command "Copy-Item -Path '$(BUILDDIR)/resources.pack' -Destination '$(RELEASE_FOLDER)'"
+	@powershell -Command "if (Test-Path 'LICENSE') { Copy-Item 'LICENSE' -Destination '$(RELEASE_FOLDER)' }"
+	@powershell -Command "Copy-Item 'README.md' -Destination '$(RELEASE_FOLDER)'"
+	@powershell -Command "if (Test-Path 'release\windows\dll') { Copy-Item 'release\windows\dll\*.dll' -Destination '$(RELEASE_FOLDER)' }"
+	@powershell -Command "Copy-Item -Path '$(TARGET_FILE).exe' -Destination '$(WIN_RELEASE_FILE_PS).exe'"
+	strip -s -R .comment -R .gnu.version "$(WIN_RELEASE_FILE).exe" --strip-unneeded
 
-	# Create folder
-	@$(MKDIR) "$(RELEASE_FOLDER)"
+	@powershell -Command "if (Test-Path '$(WINDOWS_RELEASE)') {Remove-Item '$(WINDOWS_RELEASE)'}"
+	@powershell -Command "Compress-Archive -Path '$(RELEASE_FOLDER)/*' -DestinationPath '$(WINDOWS_RELEASE)'"
+	@echo Release creado: $(WINDOWS_RELEASE)
 
-	# Copy resources
-	@cp resources.pack "$(RELEASE_FOLDER)/"
-	@cp LICENSE "$(RELEASE_FOLDER)/" 2>/dev/null || echo "Warning: LICENSE not found"
-	@cp README.md "$(RELEASE_FOLDER)/" 2>/dev/null || echo "Warning: README.md not found"
+	@powershell -Command "if (Test-Path '$(RELEASE_FOLDER)') {Remove-Item '$(RELEASE_FOLDER)' -Recurse -Force}"
 
-	# Note: Cross-compilation with CMake is complex, would need toolchain file
-	@echo "Warning: RPI cross-compilation requires manual setup with CMake toolchain file"
-	@echo "Falling back to direct g++ compilation..."
-	@aarch64-linux-gnu-g++ -std=c++20 -Wall -O2 -DLINUX_BUILD -DRPI_BUILD \
-		-Isource -Ibuild \
-		$$(find source/core source/game -name "*.cpp") source/main.cpp \
-		-lSDL3 -o "$(RELEASE_FILE)" || echo "Error: Compilation failed"
-	@aarch64-linux-gnu-strip -s -R .comment -R .gnu.version "$(RELEASE_FILE)" --strip-unneeded || true
+# ==============================================================================
+# RELEASE — macOS (.dmg per Apple Silicon)
+# ==============================================================================
+_macos-release:
+	@echo "Creando release para macOS - Version: $(VERSION)"
 
-	# Package
-	@tar -czf "$(RPI_RELEASE)" -C "$(RELEASE_FOLDER)" .
-	@echo "✓ Raspberry Pi release created: $(RPI_RELEASE)"
+# Verificar/instal·lar create-dmg si cal
+	@which create-dmg > /dev/null || (echo "Instalando create-dmg..." && brew install create-dmg)
 
-	# Cleanup
-	@$(RMDIR) "$(RELEASE_FOLDER)"
+# Compila la versió Apple Silicon
+	@cmake -S . -B $(BUILDDIR)/arm $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release \
+		-DCMAKE_OSX_ARCHITECTURES=arm64 -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0 \
+		-DMACOS_BUNDLE=ON $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR)/arm -j$(JOBS)
 
-# Windows Cross-compilation (from Linux/macOS)
-.PHONY: windows_cross
-windows_cross:
-	@echo "Cross-compiling for Windows from $(UNAME_S) - Version: $(VERSION)"
+# Neteja artefactes anteriors
+	@$(MKDIR) "$(DIST_DIR)" 2>/dev/null || true
+	$(RMDIR) "$(RELEASE_FOLDER)" 2>/dev/null || true
+	$(RMFILE) "$(DIST_DIR)"/rw.* 2>/dev/null || true
+	$(RMFILE) "$(MACOS_APPLE_SILICON_RELEASE)"
 
-	# Check for cross-compiler
-	@command -v x86_64-w64-mingw32-g++ >/dev/null || (echo "Error: x86_64-w64-mingw32-g++ not found" && exit 1)
+# Crea l'estructura del bundle .app
+	$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks"
+	$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS"
+	$(MKDIR) "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources"
 
-	# Clean previous
-	@$(RMDIR) "$(RELEASE_FOLDER)"
-	@$(RMFILE) "$(WINDOWS_RELEASE)"
+# Còpia de recursos i metadades del bundle
+	cp $(BUILDDIR)/arm/resources.pack "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources"
+	cp -R release/macos/frameworks/SDL3.xcframework/macos-arm64_x86_64/SDL3.framework "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks"
+	cp release/icons/icon.icns "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Resources"
+	cp release/macos/Info.plist "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents"
+	@[ -f LICENSE ] && cp LICENSE "$(RELEASE_FOLDER)" || true
+	cp README.md "$(RELEASE_FOLDER)"
 
-	# Create folder
-	@$(MKDIR) "$(RELEASE_FOLDER)"
+# Recreate framework symlinks (Versions/Current i top-level)
+	@cd "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks/SDL3.framework" && \
+		rm -f SDL3 Headers Resources && \
+		ln -s Versions/Current/SDL3 SDL3 && \
+		ln -s Versions/Current/Headers Headers && \
+		ln -s Versions/Current/Resources Resources
+	@cd "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Frameworks/SDL3.framework/Versions" && \
+		rm -f Current && ln -s A Current
 
-	# Copy resources
-	@cp resources.pack "$(RELEASE_FOLDER)/"
-	@cp release/dll/SDL3.dll release/dll/libwinpthread-1.dll "$(RELEASE_FOLDER)/"
-	@cp LICENSE "$(RELEASE_FOLDER)/" 2>/dev/null || echo "Warning: LICENSE not found"
-	@cp README.md "$(RELEASE_FOLDER)/" 2>/dev/null || echo "Warning: README.md not found"
+# Actualitza Info.plist amb VERSION i metadades
+	@echo "Actualizando Info.plist con versión $(VERSION)..."
+	@RAW_VERSION=$$(echo "$(VERSION)" | sed 's/^v//'); \
+	sed -i '' '/<key>CFBundleShortVersionString<\/key>/{n;s|<string>.*</string>|<string>'"$$RAW_VERSION"'</string>|;}' "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"; \
+	sed -i '' '/<key>CFBundleVersion<\/key>/{n;s|<string>.*</string>|<string>'"$$RAW_VERSION"'</string>|;}' "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"; \
+	sed -i '' '/<key>CFBundleExecutable<\/key>/{n;s|<string>.*</string>|<string>$(PROJECT)</string>|;}' "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"; \
+	sed -i '' '/<key>CFBundleName<\/key>/{n;s|<string>.*</string>|<string>$(APP_NAME)</string>|;}' "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"; \
+	sed -i '' '/<key>CFBundleDisplayName<\/key>/{n;s|<string>.*</string>|<string>$(APP_NAME)</string>|;}' "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/Info.plist"
 
-	# Compile resource file
-	@x86_64-w64-mingw32-windres release/$(TARGET_NAME).rc -O coff -o release/$(TARGET_NAME).res 2>/dev/null || echo "Warning: windres failed"
+# Còpia del binari al bundle
+	cp "$(BUILDDIR)/arm/$(PROJECT)" "$(RELEASE_FOLDER)/$(APP_NAME).app/Contents/MacOS/$(PROJECT)"
 
-	# Cross-compile
-	@echo "Compiling with MinGW cross-compiler..."
-	@x86_64-w64-mingw32-g++ -std=c++20 -Wall -O2 -DWINDOWS_BUILD -DRELEASE_BUILD \
-		-static-libstdc++ -static-libgcc -Wl,-subsystem,windows \
-		-Isource -Ibuild \
-		$$(find source/core source/game -name "*.cpp") source/main.cpp \
-		release/$(TARGET_NAME).res \
-		-lmingw32 -lSDL3 -o "$(RELEASE_FILE).exe" || echo "Error: Compilation failed"
-	@x86_64-w64-mingw32-strip "$(RELEASE_FILE).exe" || true
+# Firma ad-hoc del bundle
+	codesign --deep --force --sign - --timestamp=none "$(RELEASE_FOLDER)/$(APP_NAME).app"
 
-	# Package
-	@cd "$(RELEASE_FOLDER)" && zip -r ../$(WINDOWS_RELEASE) *
-	@echo "✓ Windows cross-compiled release created: $(WINDOWS_RELEASE)"
+# Empaqueta el .dmg
+	@echo "Creando DMG Apple Silicon con iconos de 96x96..."
+	create-dmg \
+	  --volname "$(APP_NAME)" \
+	  --window-pos 200 120 \
+	  --window-size 720 300 \
+	  --icon-size 96 \
+	  --text-size 12 \
+	  --icon "$(APP_NAME).app" 278 102 \
+	  --icon "LICENSE" 441 102 \
+	  --icon "README.md" 604 102 \
+	  --app-drop-link 115 102 \
+	  --hide-extension "$(APP_NAME).app" \
+	  "$(MACOS_APPLE_SILICON_RELEASE)" \
+	  "$(RELEASE_FOLDER)" || true
+	@echo "Release Apple Silicon creado: $(MACOS_APPLE_SILICON_RELEASE)"
 
-	# Cleanup
-	@$(RMDIR) "$(RELEASE_FOLDER)"
+# Neteja temporals
+	$(RMDIR) "$(RELEASE_FOLDER)"
+	$(RMDIR) $(BUILDDIR)/arm
+	$(RMFILE) "$(DIST_DIR)"/rw.* 2>/dev/null || true
+
+show-version:
+	@echo "$(PROJECT) $(VERSION) ($(GIT_HASH))"
 
-# Clean build artifacts
 clean:
-ifeq ($(OS),Windows_NT)
-	@if exist $(call FixPath,$(TARGET_FILE).exe) $(RMFILE) $(call FixPath,$(TARGET_FILE).exe)
-	@if exist $(call FixPath,$(TARGET_FILE)_debug.exe) $(RMFILE) $(call FixPath,$(TARGET_FILE)_debug.exe)
-	@if exist build $(RMDIR) build
-	@if exist $(RELEASE_FOLDER) $(RMDIR) $(RELEASE_FOLDER)
-else
-	@$(RMFILE) $(TARGET_FILE) $(TARGET_FILE)_debug
-	@$(RMDIR) build $(RELEASE_FOLDER)
-	@$(RMFILE) *.dmg *.zip *.tar.gz 2>/dev/null || true
-	@$(RMFILE) resources.pack 2>/dev/null || true
-	@make -C tools/pack_resources clean 2>/dev/null || true
-endif
-	@echo "Clean complete"
+	@rm -rf $(BUILDDIR) $(DIST_DIR)
 
-# Backup to remote server
-backup:
-	@echo "Backing up project to maverick:/home/sergio/git-backup/orni..."
-	rsync -a --delete \
-		--exclude='build/' \
-		--exclude='*.o' \
-		--exclude='*.exe' \
-		--exclude='orni' \
-		--exclude='orni_debug' \
-		--exclude='*_release/' \
-		$(DIR_ROOT) maverick:/home/sergio/git-backup/orni/
-	@echo "Backup completed successfully"
+rebuild: clean all
 
-# Help target
+# Empaqueta data/ a $(BUILDDIR)/resources.pack. Força un rebuild del pack encara
+# que res no hagi canviat dins data/. L'empaquetat també es fa automàticament a
+# cada `make`/`make debug` via el target CMake `resource_pack`.
+pack:
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) --target pack_resources
+	@./$(BUILDDIR)/pack_resources data $(BUILDDIR)/resources.pack
+
+# ==============================================================================
+# CODE QUALITY (delegats a cmake)
+# ==============================================================================
+format:
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) --target format
+
+format-check:
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) --target format-check
+
+tidy:
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) --target tidy
+
+tidy-fix:
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) --target tidy-fix
+
+cppcheck:
+	@cmake -S . -B $(BUILDDIR) $(CMAKE_GEN) -DCMAKE_BUILD_TYPE=Release $(CMAKE_DEFS)
+	@cmake --build $(BUILDDIR) --target cppcheck
+
+# ==============================================================================
+# GIT HOOKS
+# ==============================================================================
+hooks-install:
+	@git config core.hooksPath .githooks
+	@echo "Git hooks activats: $(shell pwd)/.githooks"
+
+# ==============================================================================
+# AJUDA
+# ==============================================================================
 help:
-	@echo "Available targets:"
+	@echo "Makefile per a $(PROJECT)"
 	@echo ""
-	@echo "Build:"
-	@echo "  all               - Build the game (default, delegates to CMake)"
-	@echo "  debug             - Build with debug symbols"
-	@echo "  clean             - Remove build artifacts and release packages"
+	@echo "  Compilació:"
+	@echo "    make                     - Compilar amb cmake (Release)"
+	@echo "    make debug               - Compilar amb cmake (Debug)"
 	@echo ""
-	@echo "Release Packaging:"
-	@echo "  macos_release     - Create macOS .app bundle + .dmg (Apple Silicon)"
-	@echo "  linux_release     - Create Linux .tar.gz"
-	@echo "  windows_release   - Create Windows .zip (requires MinGW on Windows)"
-	@echo "  windows_cross     - Cross-compile Windows from Linux/macOS (requires MinGW)"
-	@echo "  rpi_release       - Cross-compile for Raspberry Pi ARM64"
+	@echo "  Execució:"
+	@echo "    make run                 - Compilar (Release) i executar"
+	@echo "    make run-debug           - Compilar (Debug) i executar"
 	@echo ""
-	@echo "Other:"
-	@echo "  backup            - Backup project to remote server"
-	@echo "  help              - Show this help message"
+	@echo "  Release:"
+	@echo "    make release             - Release + empaquetat (zip/dmg/tar.gz segons SO)"
 	@echo ""
-	@echo "Current configuration:"
-	@echo "  Project:      $(LONG_NAME)"
-	@echo "  Target:       $(TARGET_NAME)"
-	@echo "  Version:      $(VERSION)"
-	@echo "  Platform:     $(UNAME_S)"
+	@echo "  Recursos:"
+	@echo "    make pack                - Empaquetar data/ a $(BUILDDIR)/resources.pack"
+	@echo ""
+	@echo "  Qualitat de codi:"
+	@echo "    make format              - Formatar codi amb clang-format"
+	@echo "    make format-check        - Verificar format sense modificar"
+	@echo "    make tidy                - Anàlisi estàtic amb clang-tidy"
+	@echo "    make tidy-fix            - Anàlisi estàtic amb auto-fix"
+	@echo "    make cppcheck            - Anàlisi estàtic amb cppcheck"
+	@echo ""
+	@echo "  Altres:"
+	@echo "    make clean               - Esborrar $(BUILDDIR)/ i $(DIST_DIR)/"
+	@echo "    make rebuild             - clean + all"
+	@echo "    make show-version        - Mostrar versió"
+	@echo "    make hooks-install       - Activar git hooks del projecte"
+	@echo ""
+	@echo "  Versió actual: $(VERSION) ($(GIT_HASH))"

data/config/postfx.yaml

@@ -0,0 +1,40 @@
+# postfx.yaml - Parámetros del shader de postprocesado
+#
+# Este archivo configura el pase final del renderer (bloom + flicker +
+# background pulse). Se carga al iniciar el juego desde resources.pack.
+# Si falta o tiene errores, se usan los valores por defecto de
+# Defaults::PostFx (defaults.hpp).
+#
+# Tip de tuning:
+#   - Para más "neón vector", sube bloom.intensity y bloom.radius_px.
+#   - Para más "CRT viejo", sube flicker.amplitude (riesgo de mareo si >0.3).
+#   - Background es muy sutil; pasa los componentes G a 0.15-0.20 para
+#     un fondo verde-tenue más marcado.
+
+# Bloom / glow: separable gaussian blur de dues passes (H + V).
+# Equivalent matemàtic d'un kernel 15×15 dens (225 mostres) però només cosTa
+# 30 mostres per píxel. Sense moiré: sigma_px controla l'amplada del halo.
+bloom:
+  enabled: true
+  intensity: 1.8        # 0..2 — cuanto del bloom se suma a la imagen
+  threshold: 0.20       # 0..1 — luminància mínima que aporta al bloom
+  sigma_px: 5.0         # sigma de la gaussiana en texels (~1.5..6 raonable;
+                        # halo ≈ 3·sigma a cada banda. 3.5 → halo de ~10 px)
+
+# Flicker: modulación global de brillo (efecto fósforo CRT).
+# Sustituye a la antigua oscilación CPU del ColorOscillator.
+# Solo afecta a `(lines + bloom)` en el shader; NO toca el fondo, así que
+# los píxeles negros siguen siendo negros (no pulsan).
+flicker:
+  enabled: true
+  amplitude: 0.18       # 0..1 — profundidad del flicker
+  frequency_hz: 6.0     # Hz — velocidad de la pulsación
+
+# Background pulse: color de fondo oscilante (suma aditiva).
+# Desactivado: fondo negro puro. Se mantienen los valores por si queremos
+# reactivar más adelante un tinte verdoso muy tenue al estilo CRT.
+background:
+  enabled: false
+  color_min: [0, 0, 0]      # negro puro
+  color_max: [0, 0, 0]      # negro puro
+  pulse_frequency_hz: 6.0   # Hz — sincronizado con flicker por defecto

data/shapes/bullet.shp

@@ -1,23 +1,7 @@
-# bullet.shp - Projectil (petit pentàgon)
-# © 1999 Visente i Sergi (versió Pascal)
-# © 2025 Port a C++20 amb SDL3
+# bullet.shp - Projectil (octàgon, radi=3)
 
 name: bullet
 scale: 1.0
 center: 0, 0
 
-# Cercle (octàgon regular radi=3)
-# 8 punts equidistants (45° entre ells) per aproximar un cercle
-# Començant a angle=-90° (amunt), rotant sentit horari
-#
-# Conversió polar→cartesià (radi=3, SDL: Y creix cap avall):
-#   angle=-90°:  (0.00, -3.00)
-#   angle=-45°:  (2.12, -2.12)
-#   angle=0°:    (3.00, 0.00)
-#   angle=45°:   (2.12, 2.12)
-#   angle=90°:   (0.00, 3.00)
-#   angle=135°:  (-2.12, 2.12)
-#   angle=180°:  (-3.00, 0.00)
-#   angle=225°:  (-2.12, -2.12)
-
 polyline: 0,-3  2.12,-2.12  3,0  2.12,2.12  0,3  -2.12,2.12  -3,0  -2.12,-2.12  0,-3

data/shapes/enemy_pentagon.shp

@@ -1,21 +1,7 @@
-# enemy_pentagon.shp - ORNI enemic (pentàgon regular)
-# © 1999 Visente i Sergi (versió Pascal)
-# © 2025 Port a C++20 amb SDL3
+# enemy_pentagon.shp - ORNI enemic (pentàgon regular, radi=20)
 
 name: enemy_pentagon
 scale: 1.0
 center: 0, 0
 
-# Pentàgon regular radi=20
-# 5 punts equidistants al voltant d'un cercle (72° entre ells)
-# Començant a angle=-90° (amunt), rotant sentit antihorari
-#
-# Angles: -90°, -18°, 54°, 126°, 198°
-# Conversió polar→cartesià (SDL: Y creix cap avall):
-#   angle=-90°: (0.00, -20.00)
-#   angle=-18°: (19.02, -6.18)
-#   angle=54°:  (11.76, 16.18)
-#   angle=126°: (-11.76, 16.18)
-#   angle=198°: (-19.02, -6.18)
-
 polyline: 0,-20  19.02,-6.18  11.76,16.18  -11.76,16.18  -19.02,-6.18  0,-20

data/shapes/enemy_pinwheel.shp

@@ -1,5 +1,5 @@
 # enemy_pinwheel.shp - ORNI enemic (molinillo de 4 triangles)
-# © 2025 Port a C++20 amb SDL3
+# © 2026 JailDesigner
 
 name: enemy_pinwheel
 scale: 1.0

data/shapes/enemy_square.shp

@@ -1,19 +1,7 @@
-# enemy_square.shp - ORNI enemic (quadrat regular)
-# © 2025 Port a C++20 amb SDL3
+# enemy_square.shp - ORNI enemic (quadrat regular, radi=20)
 
 name: enemy_square
 scale: 1.0
 center: 0, 0
 
-# Quadrat regular radi=20 (circumscrit)
-# 4 punts equidistants al voltant d'un cercle (90° entre ells)
-# Començant a angle=-90° (amunt), rotant sentit horari
-#
-# Angles: -90°, 0°, 90°, 180°
-# Conversió polar→cartesià (SDL: Y creix cap avall):
-#   angle=-90°: (0.00, -20.00)
-#   angle=0°:   (20.00, 0.00)
-#   angle=90°:  (0.00, 20.00)
-#   angle=180°: (-20.00, 0.00)
-
 polyline: 0,-20  20,0  0,20  -20,0  0,-20

data/shapes/ship.shp

@@ -1,24 +1,8 @@
-# ship.shp - Nau del jugador 1 (triangle amb base còncava - punta de fletxa)
-# © 1999 Visente i Sergi (versió Pascal)
-# © 2025 Port a C++20 amb SDL3
+# ship.shp - Nau del jugador 1
+# Triangle amb base còncava (punta de fletxa)
 
 name: ship
 scale: 1.0
 center: 0, 0
 
-# Triangle amb base còncava tipus "punta de fletxa"
-# Punts originals (polar):
-#   p1: r=12, angle=270° (3π/2) → punta amunt
-#   p2: r=12, angle=45° (π/4) → base dreta-darrere
-#   p3: r=12, angle=135° (3π/4) → base esquerra-darrere
-#
-# MODIFICACIÓ: afegit p4 al mig de la base, desplaçat cap al centre
-#   p4: (0, 4) → punt central de la base, cap endins
-#
-# Conversió polar→cartesià (angle-90° perquè origen visual és amunt):
-#   p1: (0, -12) → punta
-#   p2: (8.49, 8.49) → base dreta
-#   p4: (0, 4) → base centre (cap endins)
-#   p3: (-8.49, 8.49) → base esquerra
-
 polyline: 0,-12  8.49,8.49  0,4  -8.49,8.49  0,-12

data/shapes/ship2.shp

@@ -1,30 +1,11 @@
-# ship2.shp - Nau del jugador 2 (triangle amb circulito central)
-# © 1999 Visente i Sergi (versió Pascal)
-# © 2025 Port a C++20 amb SDL3
+# ship2.shp - Nau del jugador 2
+# Triangle amb cercle central (distintiu visual)
 
 name: ship2
 scale: 1.0
 center: 0, 0
 
-# Triangle amb base còncava tipus "punta de fletxa"
-# (Mateix que ship.shp)
-# Punts originals (polar):
-#   p1: r=12, angle=270° (3π/2) → punta amunt
-#   p2: r=12, angle=45° (π/4) → base dreta-darrere
-#   p3: r=12, angle=135° (3π/4) → base esquerra-darrere
-#
-# MODIFICACIÓ: afegit p4 al mig de la base, desplaçat cap al centre
-#   p4: (0, 4) → punt central de la base, cap endins
-#
-# Conversió polar→cartesià (angle-90° perquè origen visual és amunt):
-#   p1: (0, -12) → punta
-#   p2: (8.49, 8.49) → base dreta
-#   p4: (0, 4) → base centre (cap endins)
-#   p3: (-8.49, 8.49) → base esquerra
-
-#polyline: 0,-12  8.49,8.49  0,4  -8.49,8.49  0,-12
 polyline: 0,-12  8.49,8.49  -8.49,8.49  0,-12
 
-# Circulito central (octàgon r=2.5)
-# Distintiu visual del jugador 2
+# Octàgon central (radi=2.5)
 polyline: 0,-2.5  1.77,-1.77  2.5,0  1.77,1.77  0,2.5  -1.77,1.77  -2.5,0  -1.77,-1.77  0,-2.5

data/shapes/ship3.shp

@@ -1,5 +1,5 @@
 # ship2.shp - Nau del jugador 2 (interceptor amb ales)
-# © 2025 Orni Attack - Jugador 2
+# © 2026 JailDesigner
 
 name: ship2
 scale: 1.0

data/shapes/star.shp

@@ -1,5 +1,5 @@
 # star.shp - Estrella per a starfield
-# © 2025 Orni Attack
+# © 2026 JailDesigner
 
 name: star
 scale: 1.0

data/stages/stages.yaml

@@ -1,5 +1,5 @@
 # stages.yaml - Configuració de les 10 etapes d'Orni Attack
-# © 2025 Orni Attack
+# © 2026 JailDesigner
 
 metadata:
   version: "1.0"
@@ -9,14 +9,14 @@ metadata:
 stages:
   # STAGE 1: Tutorial - Only pentagons, slow speed
   - stage_id: 1
-    total_enemies: 5
+    total_enemies: 50
     spawn_config:
       mode: "progressive"
-      initial_delay: 2.0
-      spawn_interval: 3.0
+      initial_delay: 0.3
+      spawn_interval: 0.4
     enemy_distribution:
       pentagon: 100
-      quadrat: 0
+      cuadrado: 0
       molinillo: 0
     difficulty_multipliers:
       speed_multiplier: 0.7
@@ -32,7 +32,7 @@ stages:
       spawn_interval: 2.5
     enemy_distribution:
       pentagon: 70
-      quadrat: 30
+      cuadrado: 30
       molinillo: 0
     difficulty_multipliers:
       speed_multiplier: 0.85
@@ -48,7 +48,7 @@ stages:
       spawn_interval: 2.0
     enemy_distribution:
       pentagon: 50
-      quadrat: 30
+      cuadrado: 30
       molinillo: 20
     difficulty_multipliers:
       speed_multiplier: 1.0
@@ -64,7 +64,7 @@ stages:
       spawn_interval: 1.8
     enemy_distribution:
       pentagon: 40
-      quadrat: 35
+      cuadrado: 35
       molinillo: 25
     difficulty_multipliers:
       speed_multiplier: 1.1
@@ -80,7 +80,7 @@ stages:
       spawn_interval: 1.5
     enemy_distribution:
       pentagon: 35
-      quadrat: 35
+      cuadrado: 35
       molinillo: 30
     difficulty_multipliers:
       speed_multiplier: 1.2
@@ -96,7 +96,7 @@ stages:
       spawn_interval: 1.3
     enemy_distribution:
       pentagon: 30
-      quadrat: 30
+      cuadrado: 30
       molinillo: 40
     difficulty_multipliers:
       speed_multiplier: 1.3
@@ -112,7 +112,7 @@ stages:
       spawn_interval: 1.0
     enemy_distribution:
       pentagon: 25
-      quadrat: 30
+      cuadrado: 30
       molinillo: 45
     difficulty_multipliers:
       speed_multiplier: 1.4
@@ -128,7 +128,7 @@ stages:
       spawn_interval: 0.8
     enemy_distribution:
       pentagon: 20
-      quadrat: 30
+      cuadrado: 30
       molinillo: 50
     difficulty_multipliers:
       speed_multiplier: 1.5
@@ -144,7 +144,7 @@ stages:
       spawn_interval: 0.6
     enemy_distribution:
       pentagon: 15
-      quadrat: 25
+      cuadrado: 25
       molinillo: 60
     difficulty_multipliers:
       speed_multiplier: 1.6
@@ -160,7 +160,7 @@ stages:
       spawn_interval: 0.5
     enemy_distribution:
       pentagon: 10
-      quadrat: 20
+      cuadrado: 20
       molinillo: 70
     difficulty_multipliers:
       speed_multiplier: 1.8

release/frameworks/SDL3.xcframework/ios-arm64/dSYMs/SDL3.framework.dSYM/Contents/Info.plist

@@ -1,20 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-	<dict>
-		<key>CFBundleDevelopmentRegion</key>
-		<string>English</string>
-		<key>CFBundleIdentifier</key>
-		<string>com.apple.xcode.dsym.org.libsdl.SDL3</string>
-		<key>CFBundleInfoDictionaryVersion</key>
-		<string>6.0</string>
-		<key>CFBundlePackageType</key>
-		<string>dSYM</string>
-		<key>CFBundleSignature</key>
-		<string>????</string>
-		<key>CFBundleShortVersionString</key>
-		<string>3.2.26</string>
-		<key>CFBundleVersion</key>
-		<string>3.2.26</string>
-	</dict>
-</plist>

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/CMake/SDL3Config.cmake

@@ -1,106 +0,0 @@
-# SDL3 CMake configuration file:
-# This file is meant to be placed in Resources/CMake of a SDL3 framework
-
-# INTERFACE_LINK_OPTIONS needs CMake 3.12
-cmake_minimum_required(VERSION 3.12)
-
-include(FeatureSummary)
-set_package_properties(SDL3 PROPERTIES
-    URL "https://www.libsdl.org/"
-    DESCRIPTION "low level access to audio, keyboard, mouse, joystick, and graphics hardware"
-)
-
-# Copied from `configure_package_config_file`
-macro(set_and_check _var _file)
-    set(${_var} "${_file}")
-    if(NOT EXISTS "${_file}")
-        message(FATAL_ERROR "File or directory ${_file} referenced by variable ${_var} does not exist !")
-    endif()
-endmacro()
-
-# Copied from `configure_package_config_file`
-macro(check_required_components _NAME)
-    foreach(comp ${${_NAME}_FIND_COMPONENTS})
-        if(NOT ${_NAME}_${comp}_FOUND)
-            if(${_NAME}_FIND_REQUIRED_${comp})
-                set(${_NAME}_FOUND FALSE)
-            endif()
-        endif()
-    endforeach()
-endmacro()
-
-set(SDL3_FOUND TRUE)
-
-# Compute the installation prefix relative to this file.
-set(_sdl3_framework_path "${CMAKE_CURRENT_LIST_DIR}")                               # > /SDL3.framework/Resources/CMake/
-get_filename_component(_sdl3_framework_path "${_sdl3_framework_path}" REALPATH)     # > /SDL3.framework/Versions/Current/Resources/CMake
-get_filename_component(_sdl3_framework_path "${_sdl3_framework_path}" REALPATH)     # > /SDL3.framework/Versions/A/Resources/CMake/
-get_filename_component(_sdl3_framework_path "${_sdl3_framework_path}" PATH)         # > /SDL3.framework/Versions/A/Resources/
-get_filename_component(_sdl3_framework_path "${_sdl3_framework_path}" PATH)         # > /SDL3.framework/Versions/A/
-get_filename_component(_sdl3_framework_path "${_sdl3_framework_path}" PATH)         # > /SDL3.framework/Versions/
-get_filename_component(_sdl3_framework_path "${_sdl3_framework_path}" PATH)         # > /SDL3.framework/
-get_filename_component(_sdl3_framework_parent_path "${_sdl3_framework_path}" PATH)  # > /
-
-
-# All targets are created, even when some might not be requested though COMPONENTS.
-# This is done for compatibility with CMake generated SDL3-target.cmake files.
-
-if(NOT TARGET SDL3::Headers)
-    add_library(SDL3::Headers INTERFACE IMPORTED)
-    set_target_properties(SDL3::Headers
-        PROPERTIES
-            INTERFACE_COMPILE_OPTIONS "SHELL:-F \"${_sdl3_framework_parent_path}\""
-    )
-endif()
-set(SDL3_Headers_FOUND TRUE)
-
-if(NOT TARGET SDL3::SDL3-shared)
-    add_library(SDL3::SDL3-shared SHARED IMPORTED)
-    set_target_properties(SDL3::SDL3-shared
-        PROPERTIES
-            FRAMEWORK "TRUE"
-            IMPORTED_LOCATION "${_sdl3_framework_path}/SDL3"
-            INTERFACE_LINK_LIBRARIES "SDL3::Headers"
-            COMPATIBLE_INTERFACE_BOOL "SDL3_SHARED"
-            INTERFACE_SDL3_SHARED "ON"
-            COMPATIBLE_INTERFACE_STRING "SDL_VERSION"
-            INTERFACE_SDL_VERSION "SDL3"
-    )
-endif()
-set(SDL3_SDL3-shared_FOUND TRUE)
-
-set(SDL3_SDL3-static FALSE)
-
-set(SDL3_SDL3_test FALSE)
-
-unset(_sdl3_framework_parent_path)
-unset(_sdl3_framework_path)
-
-if(SDL3_SDL3-shared_FOUND)
-    set(SDL3_SDL3_FOUND TRUE)
-endif()
-
-function(_sdl_create_target_alias_compat NEW_TARGET TARGET)
-    if(CMAKE_VERSION VERSION_LESS "3.18")
-        # Aliasing local targets is not supported on CMake < 3.18, so make it global.
-        add_library(${NEW_TARGET} INTERFACE IMPORTED)
-        set_target_properties(${NEW_TARGET} PROPERTIES INTERFACE_LINK_LIBRARIES "${TARGET}")
-    else()
-        add_library(${NEW_TARGET} ALIAS ${TARGET})
-    endif()
-endfunction()
-
-# Make sure SDL3::SDL3 always exists
-if(NOT TARGET SDL3::SDL3)
-    if(TARGET SDL3::SDL3-shared)
-        _sdl_create_target_alias_compat(SDL3::SDL3 SDL3::SDL3-shared)
-    endif()
-endif()
-
-check_required_components(SDL3)
-
-set(SDL3_LIBRARIES SDL3::SDL3)
-set(SDL3_STATIC_LIBRARIES SDL3::SDL3-static)
-set(SDL3_STATIC_PRIVATE_LIBS)
-
-set(SDL3TEST_LIBRARY SDL3::SDL3_test)

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/CMake/SDL3ConfigVersion.cmake

@@ -1,57 +0,0 @@
-# based on the files generated by CMake's write_basic_package_version_file
-
-# SDL CMake version configuration file:
-# This file is meant to be placed in Resources/CMake of a SDL3 framework
-
-cmake_minimum_required(VERSION 3.12)
-
-if(NOT EXISTS "${CMAKE_CURRENT_LIST_DIR}/../../Headers/SDL_version.h")
-    message(AUTHOR_WARNING "Could not find SDL_version.h. This script is meant to be placed in the Resources/CMake directory of SDL2.framework")
-    return()
-endif()
-
-file(READ "${CMAKE_CURRENT_LIST_DIR}/../../Headers/SDL_version.h" _sdl_version_h)
-string(REGEX MATCH "#define[ \t]+SDL_MAJOR_VERSION[ \t]+([0-9]+)" _sdl_major_re "${_sdl_version_h}")
-set(_sdl_major "${CMAKE_MATCH_1}")
-string(REGEX MATCH "#define[ \t]+SDL_MINOR_VERSION[ \t]+([0-9]+)" _sdl_minor_re "${_sdl_version_h}")
-set(_sdl_minor "${CMAKE_MATCH_1}")
-string(REGEX MATCH "#define[ \t]+SDL_MICRO_VERSION[ \t]+([0-9]+)" _sdl_micro_re "${_sdl_version_h}")
-set(_sdl_micro "${CMAKE_MATCH_1}")
-if(_sdl_major_re AND _sdl_minor_re AND _sdl_micro_re)
-    set(PACKAGE_VERSION "${_sdl_major}.${_sdl_minor}.${_sdl_micro}")
-else()
-    message(AUTHOR_WARNING "Could not extract version from SDL_version.h.")
-    return()
-endif()
-
-unset(_sdl_major_re)
-unset(_sdl_major)
-unset(_sdl_minor_re)
-unset(_sdl_minor)
-unset(_sdl_micro_re)
-unset(_sdl_micro)
-
-if(PACKAGE_FIND_VERSION_RANGE)
-    # Package version must be in the requested version range
-    if ((PACKAGE_FIND_VERSION_RANGE_MIN STREQUAL "INCLUDE" AND PACKAGE_VERSION VERSION_LESS PACKAGE_FIND_VERSION_MIN)
-        OR ((PACKAGE_FIND_VERSION_RANGE_MAX STREQUAL "INCLUDE" AND PACKAGE_VERSION VERSION_GREATER PACKAGE_FIND_VERSION_MAX)
-        OR (PACKAGE_FIND_VERSION_RANGE_MAX STREQUAL "EXCLUDE" AND PACKAGE_VERSION VERSION_GREATER_EQUAL PACKAGE_FIND_VERSION_MAX)))
-        set(PACKAGE_VERSION_COMPATIBLE FALSE)
-    else()
-        set(PACKAGE_VERSION_COMPATIBLE TRUE)
-    endif()
-else()
-    if(PACKAGE_VERSION VERSION_LESS PACKAGE_FIND_VERSION)
-        set(PACKAGE_VERSION_COMPATIBLE FALSE)
-    else()
-        set(PACKAGE_VERSION_COMPATIBLE TRUE)
-        if(PACKAGE_FIND_VERSION STREQUAL PACKAGE_VERSION)
-            set(PACKAGE_VERSION_EXACT TRUE)
-        endif()
-    endif()
-endif()
-
-# The SDL3.xcframework only contains 64-bit archives
-if(NOT "${CMAKE_SIZEOF_VOID_P}" EQUAL "8")
-    set(PACKAGE_VERSION_UNSUITABLE TRUE)
-endif()

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL.h

@@ -1,90 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * Main include header for the SDL library, version 3.2.26
- *
- * It is almost always best to include just this one header instead of
- * picking out individual headers included here. There are exceptions to
- * this rule--SDL_main.h is special and not included here--but usually
- * letting SDL.h include the kitchen sink for you is the correct approach.
- */
-
-#ifndef SDL_h_
-#define SDL_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_assert.h>
-#include <SDL3/SDL_asyncio.h>
-#include <SDL3/SDL_atomic.h>
-#include <SDL3/SDL_audio.h>
-#include <SDL3/SDL_bits.h>
-#include <SDL3/SDL_blendmode.h>
-#include <SDL3/SDL_camera.h>
-#include <SDL3/SDL_clipboard.h>
-#include <SDL3/SDL_cpuinfo.h>
-#include <SDL3/SDL_dialog.h>
-#include <SDL3/SDL_endian.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_events.h>
-#include <SDL3/SDL_filesystem.h>
-#include <SDL3/SDL_gamepad.h>
-#include <SDL3/SDL_gpu.h>
-#include <SDL3/SDL_guid.h>
-#include <SDL3/SDL_haptic.h>
-#include <SDL3/SDL_hidapi.h>
-#include <SDL3/SDL_hints.h>
-#include <SDL3/SDL_init.h>
-#include <SDL3/SDL_iostream.h>
-#include <SDL3/SDL_joystick.h>
-#include <SDL3/SDL_keyboard.h>
-#include <SDL3/SDL_keycode.h>
-#include <SDL3/SDL_loadso.h>
-#include <SDL3/SDL_locale.h>
-#include <SDL3/SDL_log.h>
-#include <SDL3/SDL_messagebox.h>
-#include <SDL3/SDL_metal.h>
-#include <SDL3/SDL_misc.h>
-#include <SDL3/SDL_mouse.h>
-#include <SDL3/SDL_mutex.h>
-#include <SDL3/SDL_pen.h>
-#include <SDL3/SDL_pixels.h>
-#include <SDL3/SDL_platform.h>
-#include <SDL3/SDL_power.h>
-#include <SDL3/SDL_process.h>
-#include <SDL3/SDL_properties.h>
-#include <SDL3/SDL_rect.h>
-#include <SDL3/SDL_render.h>
-#include <SDL3/SDL_scancode.h>
-#include <SDL3/SDL_sensor.h>
-#include <SDL3/SDL_storage.h>
-#include <SDL3/SDL_surface.h>
-#include <SDL3/SDL_system.h>
-#include <SDL3/SDL_thread.h>
-#include <SDL3/SDL_time.h>
-#include <SDL3/SDL_timer.h>
-#include <SDL3/SDL_tray.h>
-#include <SDL3/SDL_touch.h>
-#include <SDL3/SDL_version.h>
-#include <SDL3/SDL_video.h>
-#include <SDL3/SDL_oldnames.h>
-
-#endif /* SDL_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_assert.h

@@ -1,662 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryAssert
- *
- * A helpful assertion macro!
- *
- * SDL assertions operate like your usual `assert` macro, but with some added
- * features:
- *
- * - It uses a trick with the `sizeof` operator, so disabled assertions
- *   vaporize out of the compiled code, but variables only referenced in the
- *   assertion won't trigger compiler warnings about being unused.
- * - It is safe to use with a dangling-else: `if (x) SDL_assert(y); else
- *   do_something();`
- * - It works the same everywhere, instead of counting on various platforms'
- *   compiler and C runtime to behave.
- * - It provides multiple levels of assertion (SDL_assert, SDL_assert_release,
- *   SDL_assert_paranoid) instead of a single all-or-nothing option.
- * - It offers a variety of responses when an assertion fails (retry, trigger
- *   the debugger, abort the program, ignore the failure once, ignore it for
- *   the rest of the program's run).
- * - It tries to show the user a dialog by default, if possible, but the app
- *   can provide a callback to handle assertion failures however they like.
- * - It lets failed assertions be retried. Perhaps you had a network failure
- *   and just want to retry the test after plugging your network cable back
- *   in? You can.
- * - It lets the user ignore an assertion failure, if there's a harmless
- *   problem that one can continue past.
- * - It lets the user mark an assertion as ignored for the rest of the
- *   program's run; if there's a harmless problem that keeps popping up.
- * - It provides statistics and data on all failed assertions to the app.
- * - It allows the default assertion handler to be controlled with environment
- *   variables, in case an automated script needs to control it.
- * - It can be used as an aid to Clang's static analysis; it will treat SDL
- *   assertions as universally true (under the assumption that you are serious
- *   about the asserted claims and that your debug builds will detect when
- *   these claims were wrong). This can help the analyzer avoid false
- *   positives.
- *
- * To use it: compile a debug build and just sprinkle around tests to check
- * your code!
- */
-
-#ifndef SDL_assert_h_
-#define SDL_assert_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * The level of assertion aggressiveness.
- *
- * This value changes depending on compiler options and other preprocessor
- * defines.
- *
- * It is currently one of the following values, but future SDL releases might
- * add more:
- *
- * - 0: All SDL assertion macros are disabled.
- * - 1: Release settings: SDL_assert disabled, SDL_assert_release enabled.
- * - 2: Debug settings: SDL_assert and SDL_assert_release enabled.
- * - 3: Paranoid settings: All SDL assertion macros enabled, including
- *   SDL_assert_paranoid.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_ASSERT_LEVEL SomeNumberBasedOnVariousFactors
-
-#elif !defined(SDL_ASSERT_LEVEL)
-#ifdef SDL_DEFAULT_ASSERT_LEVEL
-#define SDL_ASSERT_LEVEL SDL_DEFAULT_ASSERT_LEVEL
-#elif defined(_DEBUG) || defined(DEBUG) || \
-      (defined(__GNUC__) && !defined(__OPTIMIZE__))
-#define SDL_ASSERT_LEVEL 2
-#else
-#define SDL_ASSERT_LEVEL 1
-#endif
-#endif
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * Attempt to tell an attached debugger to pause.
- *
- * This allows an app to programmatically halt ("break") the debugger as if it
- * had hit a breakpoint, allowing the developer to examine program state, etc.
- *
- * This is a macro--not a function--so that the debugger breaks on the source
- * code line that used SDL_TriggerBreakpoint and not in some random guts of
- * SDL. SDL_assert uses this macro for the same reason.
- *
- * If the program is not running under a debugger, SDL_TriggerBreakpoint will
- * likely terminate the app, possibly without warning. If the current platform
- * isn't supported, this macro is left undefined.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_TriggerBreakpoint() TriggerABreakpointInAPlatformSpecificManner
-
-#elif defined(__MINGW32__) || (defined(_MSC_VER) && _MSC_VER >= 1310)
-    /* Don't include intrin.h here because it contains C++ code */
-    extern void __cdecl __debugbreak(void);
-    #define SDL_TriggerBreakpoint() __debugbreak()
-#elif defined(_MSC_VER) && defined(_M_IX86)
-    #define SDL_TriggerBreakpoint() { _asm { int 0x03 }  }
-#elif defined(ANDROID)
-    #include <assert.h>
-    #define SDL_TriggerBreakpoint() assert(0)
-#elif SDL_HAS_BUILTIN(__builtin_debugtrap)
-    #define SDL_TriggerBreakpoint() __builtin_debugtrap()
-#elif SDL_HAS_BUILTIN(__builtin_trap)
-    #define SDL_TriggerBreakpoint() __builtin_trap()
-#elif (defined(__GNUC__) || defined(__clang__)) && (defined(__i386__) || defined(__x86_64__))
-    #define SDL_TriggerBreakpoint() __asm__ __volatile__ ( "int $3\n\t" )
-#elif (defined(__GNUC__) || defined(__clang__)) && defined(__riscv)
-    #define SDL_TriggerBreakpoint() __asm__ __volatile__ ( "ebreak\n\t" )
-#elif ( defined(SDL_PLATFORM_APPLE) && (defined(__arm64__) || defined(__aarch64__)) )  /* this might work on other ARM targets, but this is a known quantity... */
-    #define SDL_TriggerBreakpoint() __asm__ __volatile__ ( "brk #22\n\t" )
-#elif defined(SDL_PLATFORM_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(__GNUC__) || defined(__clang__)
-    #define SDL_TriggerBreakpoint() __builtin_trap()  /* older gcc may not support SDL_HAS_BUILTIN(__builtin_trap) above */
-#elif defined(__386__) && defined(__WATCOMC__)
-    #define SDL_TriggerBreakpoint() { _asm { int 0x03 } }
-#elif defined(HAVE_SIGNAL_H) && !defined(__WATCOMC__)
-    #include <signal.h>
-    #define SDL_TriggerBreakpoint() raise(SIGTRAP)
-#else
-    /* SDL_TriggerBreakpoint is intentionally left undefined on unknown platforms. */
-#endif
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A macro that reports the current function being compiled.
- *
- * If SDL can't figure how the compiler reports this, it will use "???".
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_FUNCTION __FUNCTION__
-
-#elif defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) /* C99 supports __func__ as a standard. */
-#   define SDL_FUNCTION __func__
-#elif ((defined(__GNUC__) && (__GNUC__ >= 2)) || defined(_MSC_VER) || defined (__WATCOMC__))
-#   define SDL_FUNCTION __FUNCTION__
-#else
-#   define SDL_FUNCTION "???"
-#endif
-
-/**
- * A macro that reports the current file being compiled.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_FILE    __FILE__
-
-/**
- * A macro that reports the current line number of the file being compiled.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_LINE    __LINE__
-
-/*
-sizeof (x) makes the compiler still parse the expression even without
-assertions enabled, so the code is always checked at compile time, but
-doesn't actually generate code for it, so there are no side effects or
-expensive checks at run time, just the constant size of what x WOULD be,
-which presumably gets optimized out as unused.
-This also solves the problem of...
-
-    int somevalue = blah();
-    SDL_assert(somevalue == 1);
-
-...which would cause compiles to complain that somevalue is unused if we
-disable assertions.
-*/
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A macro for wrapping code in `do {} while (0);` without compiler warnings.
- *
- * Visual Studio with really aggressive warnings enabled needs this to avoid
- * compiler complaints.
- *
- * the `do {} while (0);` trick is useful for wrapping code in a macro that
- * may or may not be a single statement, to avoid various C language
- * accidents.
- *
- * To use:
- *
- * ```c
- * do { SomethingOnce(); } while (SDL_NULL_WHILE_LOOP_CONDITION (0));
- * ```
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_NULL_WHILE_LOOP_CONDITION (0)
-
-#elif defined(_MSC_VER)  /* Avoid /W4 warnings. */
-/* "while (0,0)" fools Microsoft's compiler's /W4 warning level into thinking
-    this condition isn't constant. And looks like an owl's face! */
-#define SDL_NULL_WHILE_LOOP_CONDITION (0,0)
-#else
-#define SDL_NULL_WHILE_LOOP_CONDITION (0)
-#endif
-
-/**
- * The macro used when an assertion is disabled.
- *
- * This isn't for direct use by apps, but this is the code that is inserted
- * when an SDL_assert is disabled (perhaps in a release build).
- *
- * The code does nothing, but wraps `condition` in a sizeof operator, which
- * generates no code and has no side effects, but avoid compiler warnings
- * about unused variables.
- *
- * \param condition the condition to assert (but not actually run here).
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_disabled_assert(condition) \
-    do { (void) sizeof ((condition)); } while (SDL_NULL_WHILE_LOOP_CONDITION)
-
-/**
- * Possible outcomes from a triggered assertion.
- *
- * When an enabled assertion triggers, it may call the assertion handler
- * (possibly one provided by the app via SDL_SetAssertionHandler), which will
- * return one of these values, possibly after asking the user.
- *
- * Then SDL will respond based on this outcome (loop around to retry the
- * condition, try to break in a debugger, kill the program, or ignore the
- * problem).
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_AssertState
-{
-    SDL_ASSERTION_RETRY,  /**< Retry the assert immediately. */
-    SDL_ASSERTION_BREAK,  /**< Make the debugger trigger a breakpoint. */
-    SDL_ASSERTION_ABORT,  /**< Terminate the program. */
-    SDL_ASSERTION_IGNORE,  /**< Ignore the assert. */
-    SDL_ASSERTION_ALWAYS_IGNORE  /**< Ignore the assert from now on. */
-} SDL_AssertState;
-
-/**
- * Information about an assertion failure.
- *
- * This structure is filled in with information about a triggered assertion,
- * used by the assertion handler, then added to the assertion report. This is
- * returned as a linked list from SDL_GetAssertionReport().
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_AssertData
-{
-    bool always_ignore;  /**< true if app should always continue when assertion is triggered. */
-    unsigned int trigger_count; /**< Number of times this assertion has been triggered. */
-    const char *condition;  /**< A string of this assert's test code. */
-    const char *filename;  /**< The source file where this assert lives. */
-    int linenum;  /**< The line in `filename` where this assert lives. */
-    const char *function;  /**< The name of the function where this assert lives. */
-    const struct SDL_AssertData *next;  /**< next item in the linked list. */
-} SDL_AssertData;
-
-/**
- * Never call this directly.
- *
- * Use the SDL_assert macros instead.
- *
- * \param data assert data structure.
- * \param func function name.
- * \param file file name.
- * \param line line number.
- * \returns assert state.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_AssertState SDLCALL SDL_ReportAssertion(SDL_AssertData *data,
-                                                            const char *func,
-                                                            const char *file, int line) SDL_ANALYZER_NORETURN;
-
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * The macro used when an assertion triggers a breakpoint.
- *
- * This isn't for direct use by apps; use SDL_assert or SDL_TriggerBreakpoint
- * instead.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_AssertBreakpoint() SDL_TriggerBreakpoint()
-
-#elif !defined(SDL_AssertBreakpoint)
-#  if defined(ANDROID) && defined(assert)
-     /* Define this as empty in case assert() is defined as SDL_assert */
-#    define SDL_AssertBreakpoint()
-#  else
-#    define SDL_AssertBreakpoint() SDL_TriggerBreakpoint()
-#  endif
-#endif /* !SDL_AssertBreakpoint */
-
-/**
- * The macro used when an assertion is enabled.
- *
- * This isn't for direct use by apps, but this is the code that is inserted
- * when an SDL_assert is enabled.
- *
- * The `do {} while(0)` avoids dangling else problems:
- *
- * ```c
- * if (x) SDL_assert(y); else blah();
- * ```
- *
- * ... without the do/while, the "else" could attach to this macro's "if". We
- * try to handle just the minimum we need here in a macro...the loop, the
- * static vars, and break points. The heavy lifting is handled in
- * SDL_ReportAssertion().
- *
- * \param condition the condition to assert.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_enabled_assert(condition) \
-    do { \
-        while ( !(condition) ) { \
-            static struct SDL_AssertData sdl_assert_data = { false, 0, #condition, NULL, 0, NULL, NULL }; \
-            const SDL_AssertState sdl_assert_state = SDL_ReportAssertion(&sdl_assert_data, SDL_FUNCTION, SDL_FILE, SDL_LINE); \
-            if (sdl_assert_state == SDL_ASSERTION_RETRY) { \
-                continue; /* go again. */ \
-            } else if (sdl_assert_state == SDL_ASSERTION_BREAK) { \
-                SDL_AssertBreakpoint(); \
-            } \
-            break; /* not retrying. */ \
-        } \
-    } while (SDL_NULL_WHILE_LOOP_CONDITION)
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * An assertion test that is normally performed only in debug builds.
- *
- * This macro is enabled when the SDL_ASSERT_LEVEL is >= 2, otherwise it is
- * disabled. This is meant to only do these tests in debug builds, so they can
- * tend to be more expensive, and they are meant to bring everything to a halt
- * when they fail, with the programmer there to assess the problem.
- *
- * In short: you can sprinkle these around liberally and assume they will
- * evaporate out of the build when building for end-users.
- *
- * When assertions are disabled, this wraps `condition` in a `sizeof`
- * operator, which means any function calls and side effects will not run, but
- * the compiler will not complain about any otherwise-unused variables that
- * are only referenced in the assertion.
- *
- * One can set the environment variable "SDL_ASSERT" to one of several strings
- * ("abort", "break", "retry", "ignore", "always_ignore") to force a default
- * behavior, which may be desirable for automation purposes. If your platform
- * requires GUI interfaces to happen on the main thread but you're debugging
- * an assertion in a background thread, it might be desirable to set this to
- * "break" so that your debugger takes control as soon as assert is triggered,
- * instead of risking a bad UI interaction (deadlock, etc) in the application.
- *
- * \param condition boolean value to test.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_assert(condition) if (assertion_enabled && (condition)) { trigger_assertion; }
-
-/**
- * An assertion test that is performed even in release builds.
- *
- * This macro is enabled when the SDL_ASSERT_LEVEL is >= 1, otherwise it is
- * disabled. This is meant to be for tests that are cheap to make and
- * extremely unlikely to fail; generally it is frowned upon to have an
- * assertion failure in a release build, so these assertions generally need to
- * be of more than life-and-death importance if there's a chance they might
- * trigger. You should almost always consider handling these cases more
- * gracefully than an assert allows.
- *
- * When assertions are disabled, this wraps `condition` in a `sizeof`
- * operator, which means any function calls and side effects will not run, but
- * the compiler will not complain about any otherwise-unused variables that
- * are only referenced in the assertion.
- *
- * One can set the environment variable "SDL_ASSERT" to one of several strings
- * ("abort", "break", "retry", "ignore", "always_ignore") to force a default
- * behavior, which may be desirable for automation purposes. If your platform
- * requires GUI interfaces to happen on the main thread but you're debugging
- * an assertion in a background thread, it might be desirable to set this to
- * "break" so that your debugger takes control as soon as assert is triggered,
- * instead of risking a bad UI interaction (deadlock, etc) in the application.
- * *
- *
- * \param condition boolean value to test.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_assert_release(condition) SDL_disabled_assert(condition)
-
-/**
- * An assertion test that is performed only when built with paranoid settings.
- *
- * This macro is enabled when the SDL_ASSERT_LEVEL is >= 3, otherwise it is
- * disabled. This is a higher level than both release and debug, so these
- * tests are meant to be expensive and only run when specifically looking for
- * extremely unexpected failure cases in a special build.
- *
- * When assertions are disabled, this wraps `condition` in a `sizeof`
- * operator, which means any function calls and side effects will not run, but
- * the compiler will not complain about any otherwise-unused variables that
- * are only referenced in the assertion.
- *
- * One can set the environment variable "SDL_ASSERT" to one of several strings
- * ("abort", "break", "retry", "ignore", "always_ignore") to force a default
- * behavior, which may be desirable for automation purposes. If your platform
- * requires GUI interfaces to happen on the main thread but you're debugging
- * an assertion in a background thread, it might be desirable to set this to
- * "break" so that your debugger takes control as soon as assert is triggered,
- * instead of risking a bad UI interaction (deadlock, etc) in the application.
- *
- * \param condition boolean value to test.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_assert_paranoid(condition) SDL_disabled_assert(condition)
-
-/* Enable various levels of assertions. */
-#elif SDL_ASSERT_LEVEL == 0   /* assertions disabled */
-#   define SDL_assert(condition) SDL_disabled_assert(condition)
-#   define SDL_assert_release(condition) SDL_disabled_assert(condition)
-#   define SDL_assert_paranoid(condition) SDL_disabled_assert(condition)
-#elif SDL_ASSERT_LEVEL == 1  /* release settings. */
-#   define SDL_assert(condition) SDL_disabled_assert(condition)
-#   define SDL_assert_release(condition) SDL_enabled_assert(condition)
-#   define SDL_assert_paranoid(condition) SDL_disabled_assert(condition)
-#elif SDL_ASSERT_LEVEL == 2  /* debug settings. */
-#   define SDL_assert(condition) SDL_enabled_assert(condition)
-#   define SDL_assert_release(condition) SDL_enabled_assert(condition)
-#   define SDL_assert_paranoid(condition) SDL_disabled_assert(condition)
-#elif SDL_ASSERT_LEVEL == 3  /* paranoid settings. */
-#   define SDL_assert(condition) SDL_enabled_assert(condition)
-#   define SDL_assert_release(condition) SDL_enabled_assert(condition)
-#   define SDL_assert_paranoid(condition) SDL_enabled_assert(condition)
-#else
-#   error Unknown assertion level.
-#endif
-
-/**
- * An assertion test that is always performed.
- *
- * This macro is always enabled no matter what SDL_ASSERT_LEVEL is set to. You
- * almost never want to use this, as it could trigger on an end-user's system,
- * crashing your program.
- *
- * One can set the environment variable "SDL_ASSERT" to one of several strings
- * ("abort", "break", "retry", "ignore", "always_ignore") to force a default
- * behavior, which may be desirable for automation purposes. If your platform
- * requires GUI interfaces to happen on the main thread but you're debugging
- * an assertion in a background thread, it might be desirable to set this to
- * "break" so that your debugger takes control as soon as assert is triggered,
- * instead of risking a bad UI interaction (deadlock, etc) in the application.
- *
- * \param condition boolean value to test.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_assert_always(condition) SDL_enabled_assert(condition)
-
-
-/**
- * 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().
- * \returns an SDL_AssertState value indicating how to handle the failure.
- *
- * \threadsafety This callback may be called from any thread that triggers an
- *               assert at any time.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef SDL_AssertState (SDLCALL *SDL_AssertionHandler)(
-                                 const SDL_AssertData *data, void *userdata);
-
-/**
- * Set an application-defined assertion handler.
- *
- * This function allows an application to show its own assertion UI and/or
- * force the response to an assertion failure. If the application doesn't
- * provide this, SDL will try to do the right thing, popping up a
- * system-specific GUI dialog, and probably minimizing any fullscreen windows.
- *
- * This callback may fire from any thread, but it runs wrapped in a mutex, so
- * it will only fire from one thread at a time.
- *
- * 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`.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetAssertionHandler
- */
-extern SDL_DECLSPEC void SDLCALL SDL_SetAssertionHandler(
-                                            SDL_AssertionHandler handler,
-                                            void *userdata);
-
-/**
- * Get the default assertion handler.
- *
- * This returns the function pointer that is called by default when an
- * assertion is triggered. This is an internal function provided by SDL, that
- * is used for assertions when SDL_SetAssertionHandler() hasn't been used to
- * provide a different function.
- *
- * \returns the default SDL_AssertionHandler that is called when an assert
- *          triggers.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetAssertionHandler
- */
-extern SDL_DECLSPEC SDL_AssertionHandler SDLCALL SDL_GetDefaultAssertionHandler(void);
-
-/**
- * Get the current assertion handler.
- *
- * This returns the function pointer that is called when an assertion is
- * triggered. This is either the value last passed to
- * SDL_SetAssertionHandler(), or if no application-specified function is set,
- * is equivalent to calling SDL_GetDefaultAssertionHandler().
- *
- * The parameter `puserdata` is a pointer to a void*, which will store the
- * "userdata" pointer that was passed to SDL_SetAssertionHandler(). This value
- * will always be NULL for the default handler. If you don't care about this
- * 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().
- * \returns the SDL_AssertionHandler that is called when an assert triggers.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetAssertionHandler
- */
-extern SDL_DECLSPEC SDL_AssertionHandler SDLCALL SDL_GetAssertionHandler(void **puserdata);
-
-/**
- * Get a list of all assertion failures.
- *
- * This function gets all assertions triggered since the last call to
- * SDL_ResetAssertionReport(), or the start of the program.
- *
- * The proper way to examine this data looks something like this:
- *
- * ```c
- * const SDL_AssertData *item = SDL_GetAssertionReport();
- * while (item) {
- *    printf("'%s', %s (%s:%d), triggered %u times, always ignore: %s.\\n",
- *           item->condition, item->function, item->filename,
- *           item->linenum, item->trigger_count,
- *           item->always_ignore ? "yes" : "no");
- *    item = item->next;
- * }
- * ```
- *
- * \returns a list of all failed assertions or NULL if the list is empty. This
- *          memory should not be modified or freed by the application. This
- *          pointer remains valid until the next call to SDL_Quit() or
- *          SDL_ResetAssertionReport().
- *
- * \threadsafety This function is not thread safe. Other threads calling
- *               SDL_ResetAssertionReport() simultaneously, may render the
- *               returned pointer invalid.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ResetAssertionReport
- */
-extern SDL_DECLSPEC const SDL_AssertData * SDLCALL SDL_GetAssertionReport(void);
-
-/**
- * Clear the list of all assertion failures.
- *
- * This function will clear the list of all assertions triggered up to that
- * point. Immediately following this call, SDL_GetAssertionReport will return
- * no items. In addition, any previously-triggered assertions will be reset to
- * a trigger_count of zero, and their always_ignore state will be false.
- *
- * \threadsafety This function is not thread safe. Other threads triggering an
- *               assertion, or simultaneously calling this function may cause
- *               memory leaks or crashes.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetAssertionReport
- */
-extern SDL_DECLSPEC void SDLCALL SDL_ResetAssertionReport(void);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_assert_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_asyncio.h

@@ -1,546 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: AsyncIO */
-
-/**
- * # CategoryAsyncIO
- *
- * SDL offers a way to perform I/O asynchronously. This allows an app to read
- * or write files without waiting for data to actually transfer; the functions
- * that request I/O never block while the request is fulfilled.
- *
- * Instead, the data moves in the background and the app can check for results
- * at their leisure.
- *
- * This is more complicated than just reading and writing files in a
- * synchronous way, but it can allow for more efficiency, and never having
- * framerate drops as the hard drive catches up, etc.
- *
- * The general usage pattern for async I/O is:
- *
- * - Create one or more SDL_AsyncIOQueue objects.
- * - Open files with SDL_AsyncIOFromFile.
- * - Start I/O tasks to the files with SDL_ReadAsyncIO or SDL_WriteAsyncIO,
- *   putting those tasks into one of the queues.
- * - Later on, use SDL_GetAsyncIOResult on a queue to see if any task is
- *   finished without blocking. Tasks might finish in any order with success
- *   or failure.
- * - When all your tasks are done, close the file with SDL_CloseAsyncIO. This
- *   also generates a task, since it might flush data to disk!
- *
- * This all works, without blocking, in a single thread, but one can also wait
- * on a queue in a background thread, sleeping until new results have arrived:
- *
- * - Call SDL_WaitAsyncIOResult from one or more threads to efficiently block
- *   until new tasks complete.
- * - When shutting down, call SDL_SignalAsyncIOQueue to unblock any sleeping
- *   threads despite there being no new tasks completed.
- *
- * And, of course, to match the synchronous SDL_LoadFile, we offer
- * SDL_LoadFileAsync as a convenience function. This will handle allocating a
- * buffer, slurping in the file data, and null-terminating it; you still check
- * for results later.
- *
- * Behind the scenes, SDL will use newer, efficient APIs on platforms that
- * support them: Linux's io_uring and Windows 11's IoRing, for example. If
- * those technologies aren't available, SDL will offload the work to a thread
- * pool that will manage otherwise-synchronous loads without blocking the app.
- *
- * ## Best Practices
- *
- * Simple non-blocking I/O--for an app that just wants to pick up data
- * whenever it's ready without losing framerate waiting on disks to spin--can
- * use whatever pattern works well for the program. In this case, simply call
- * SDL_ReadAsyncIO, or maybe SDL_LoadFileAsync, as needed. Once a frame, call
- * SDL_GetAsyncIOResult to check for any completed tasks and deal with the
- * data as it arrives.
- *
- * If two separate pieces of the same program need their own I/O, it is legal
- * for each to create their own queue. This will prevent either piece from
- * accidentally consuming the other's completed tasks. Each queue does require
- * some amount of resources, but it is not an overwhelming cost. Do not make a
- * queue for each task, however. It is better to put many tasks into a single
- * queue. They will be reported in order of completion, not in the order they
- * were submitted, so it doesn't generally matter what order tasks are
- * started.
- *
- * One async I/O queue can be shared by multiple threads, or one thread can
- * have more than one queue, but the most efficient way--if ruthless
- * efficiency is the goal--is to have one queue per thread, with multiple
- * threads working in parallel, and attempt to keep each queue loaded with
- * tasks that are both started by and consumed by the same thread. On modern
- * platforms that can use newer interfaces, this can keep data flowing as
- * efficiently as possible all the way from storage hardware to the app, with
- * no contention between threads for access to the same queue.
- *
- * Written data is not guaranteed to make it to physical media by the time a
- * closing task is completed, unless SDL_CloseAsyncIO is called with its
- * `flush` parameter set to true, which is to say that a successful result
- * here can still result in lost data during an unfortunately-timed power
- * outage if not flushed. However, flushing will take longer and may be
- * unnecessary, depending on the app's needs.
- */
-
-#ifndef SDL_asyncio_h_
-#define SDL_asyncio_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * The asynchronous I/O operation structure.
- *
- * This operates as an opaque handle. One can then request read or write
- * operations on it.
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_AsyncIOFromFile
- */
-typedef struct SDL_AsyncIO SDL_AsyncIO;
-
-/**
- * Types of asynchronous I/O tasks.
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_AsyncIOTaskType
-{
-    SDL_ASYNCIO_TASK_READ,   /**< A read operation. */
-    SDL_ASYNCIO_TASK_WRITE,  /**< A write operation. */
-    SDL_ASYNCIO_TASK_CLOSE   /**< A close operation. */
-} SDL_AsyncIOTaskType;
-
-/**
- * Possible outcomes of an asynchronous I/O task.
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_AsyncIOResult
-{
-    SDL_ASYNCIO_COMPLETE,  /**< request was completed without error */
-    SDL_ASYNCIO_FAILURE,   /**< request failed for some reason; check SDL_GetError()! */
-    SDL_ASYNCIO_CANCELED   /**< request was canceled before completing. */
-} SDL_AsyncIOResult;
-
-/**
- * Information about a completed asynchronous I/O request.
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_AsyncIOOutcome
-{
-    SDL_AsyncIO *asyncio;   /**< what generated this task. This pointer will be invalid if it was closed! */
-    SDL_AsyncIOTaskType type;  /**< What sort of task was this? Read, write, etc? */
-    SDL_AsyncIOResult result;  /**< the result of the work (success, failure, cancellation). */
-    void *buffer;  /**< buffer where data was read/written. */
-    Uint64 offset;  /**< offset in the SDL_AsyncIO where data was read/written. */
-    Uint64 bytes_requested;  /**< number of bytes the task was to read/write. */
-    Uint64 bytes_transferred;  /**< actual number of bytes that were read/written. */
-    void *userdata;    /**< pointer provided by the app when starting the task */
-} SDL_AsyncIOOutcome;
-
-/**
- * A queue of completed asynchronous I/O tasks.
- *
- * When starting an asynchronous operation, you specify a queue for the new
- * task. A queue can be asked later if any tasks in it have completed,
- * allowing an app to manage multiple pending tasks in one place, in whatever
- * order they complete.
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_CreateAsyncIOQueue
- * \sa SDL_ReadAsyncIO
- * \sa SDL_WriteAsyncIO
- * \sa SDL_GetAsyncIOResult
- * \sa SDL_WaitAsyncIOResult
- */
-typedef struct SDL_AsyncIOQueue SDL_AsyncIOQueue;
-
-/**
- * Use this function to create a new SDL_AsyncIO object for reading from
- * and/or writing to a named file.
- *
- * The `mode` string understands the following values:
- *
- * - "r": Open a file for reading only. It must exist.
- * - "w": Open a file for writing only. It will create missing files or
- *   truncate existing ones.
- * - "r+": Open a file for update both reading and writing. The file must
- *   exist.
- * - "w+": Create an empty file for both reading and writing. If a file with
- *   the same name already exists its content is erased and the file is
- *   treated as a new empty file.
- *
- * There is no "b" mode, as there is only "binary" style I/O, and no "a" mode
- * for appending, since you specify the position when starting a task.
- *
- * This function supports Unicode filenames, but they must be encoded in UTF-8
- * format, regardless of the underlying operating system.
- *
- * This call is _not_ asynchronous; it will open the file before returning,
- * under the assumption that doing so is generally a fast operation. Future
- * reads and writes to the opened file will be async, however.
- *
- * \param file a UTF-8 string representing the filename to open.
- * \param mode an ASCII string representing the mode to be used for opening
- *             the file.
- * \returns a pointer to the SDL_AsyncIO structure that is created or NULL on
- *          failure; call SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CloseAsyncIO
- * \sa SDL_ReadAsyncIO
- * \sa SDL_WriteAsyncIO
- */
-extern SDL_DECLSPEC SDL_AsyncIO * SDLCALL SDL_AsyncIOFromFile(const char *file, const char *mode);
-
-/**
- * Use this function to get the size of the data stream in an SDL_AsyncIO.
- *
- * This call is _not_ asynchronous; it assumes that obtaining this info is a
- * non-blocking operation in most reasonable cases.
- *
- * \param asyncio the SDL_AsyncIO to get the size of the data stream from.
- * \returns the size of the data stream in the SDL_IOStream on success or a
- *          negative error code on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC Sint64 SDLCALL SDL_GetAsyncIOSize(SDL_AsyncIO *asyncio);
-
-/**
- * Start an async read.
- *
- * This function reads up to `size` bytes from `offset` position in the data
- * source to the area pointed at by `ptr`. This function may read less bytes
- * than requested.
- *
- * This function returns as quickly as possible; it does not wait for the read
- * to complete. On a successful return, this work will continue in the
- * background. If the work begins, even failure is asynchronous: a failing
- * return value from this function only means the work couldn't start at all.
- *
- * `ptr` must remain available until the work is done, and may be accessed by
- * the system at any time until then. Do not allocate it on the stack, as this
- * might take longer than the life of the calling function to complete!
- *
- * An SDL_AsyncIOQueue must be specified. The newly-created task will be added
- * to it when it completes its work.
- *
- * \param asyncio a pointer to an SDL_AsyncIO structure.
- * \param ptr a pointer to a buffer to read data into.
- * \param offset the position to start reading in the data source.
- * \param size the number of bytes to read from the data source.
- * \param queue a queue to add the new SDL_AsyncIO to.
- * \param userdata an app-defined pointer that will be provided with the task
- *                 results.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_WriteAsyncIO
- * \sa SDL_CreateAsyncIOQueue
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ReadAsyncIO(SDL_AsyncIO *asyncio, void *ptr, Uint64 offset, Uint64 size, SDL_AsyncIOQueue *queue, void *userdata);
-
-/**
- * Start an async write.
- *
- * This function writes `size` bytes from `offset` position in the data source
- * to the area pointed at by `ptr`.
- *
- * This function returns as quickly as possible; it does not wait for the
- * write to complete. On a successful return, this work will continue in the
- * background. If the work begins, even failure is asynchronous: a failing
- * return value from this function only means the work couldn't start at all.
- *
- * `ptr` must remain available until the work is done, and may be accessed by
- * the system at any time until then. Do not allocate it on the stack, as this
- * might take longer than the life of the calling function to complete!
- *
- * An SDL_AsyncIOQueue must be specified. The newly-created task will be added
- * to it when it completes its work.
- *
- * \param asyncio a pointer to an SDL_AsyncIO structure.
- * \param ptr a pointer to a buffer to write data from.
- * \param offset the position to start writing to the data source.
- * \param size the number of bytes to write to the data source.
- * \param queue a queue to add the new SDL_AsyncIO to.
- * \param userdata an app-defined pointer that will be provided with the task
- *                 results.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ReadAsyncIO
- * \sa SDL_CreateAsyncIOQueue
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_WriteAsyncIO(SDL_AsyncIO *asyncio, void *ptr, Uint64 offset, Uint64 size, SDL_AsyncIOQueue *queue, void *userdata);
-
-/**
- * Close and free any allocated resources for an async I/O object.
- *
- * Closing a file is _also_ an asynchronous task! If a write failure were to
- * happen during the closing process, for example, the task results will
- * report it as usual.
- *
- * Closing a file that has been written to does not guarantee the data has
- * made it to physical media; it may remain in the operating system's file
- * cache, for later writing to disk. This means that a successfully-closed
- * file can be lost if the system crashes or loses power in this small window.
- * To prevent this, call this function with the `flush` parameter set to true.
- * This will make the operation take longer, and perhaps increase system load
- * in general, but a successful result guarantees that the data has made it to
- * physical storage. Don't use this for temporary files, caches, and
- * unimportant data, and definitely use it for crucial irreplaceable files,
- * like game saves.
- *
- * This function guarantees that the close will happen after any other pending
- * tasks to `asyncio`, so it's safe to open a file, start several operations,
- * close the file immediately, then check for all results later. This function
- * will not block until the tasks have completed.
- *
- * Once this function returns true, `asyncio` is no longer valid, regardless
- * of any future outcomes. Any completed tasks might still contain this
- * pointer in their SDL_AsyncIOOutcome data, in case the app was using this
- * value to track information, but it should not be used again.
- *
- * If this function returns false, the close wasn't started at all, and it's
- * safe to attempt to close again later.
- *
- * An SDL_AsyncIOQueue must be specified. The newly-created task will be added
- * to it when it completes its work.
- *
- * \param asyncio a pointer to an SDL_AsyncIO structure to close.
- * \param flush true if data should sync to disk before the task completes.
- * \param queue a queue to add the new SDL_AsyncIO to.
- * \param userdata an app-defined pointer that will be provided with the task
- *                 results.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread, but two
- *               threads should not attempt to close the same object.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CloseAsyncIO(SDL_AsyncIO *asyncio, bool flush, SDL_AsyncIOQueue *queue, void *userdata);
-
-/**
- * Create a task queue for tracking multiple I/O operations.
- *
- * Async I/O operations are assigned to a queue when started. The queue can be
- * checked for completed tasks thereafter.
- *
- * \returns a new task queue object or NULL if there was an error; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_DestroyAsyncIOQueue
- * \sa SDL_GetAsyncIOResult
- * \sa SDL_WaitAsyncIOResult
- */
-extern SDL_DECLSPEC SDL_AsyncIOQueue * SDLCALL SDL_CreateAsyncIOQueue(void);
-
-/**
- * Destroy a previously-created async I/O task queue.
- *
- * If there are still tasks pending for this queue, this call will block until
- * those tasks are finished. All those tasks will be deallocated. Their
- * results will be lost to the app.
- *
- * Any pending reads from SDL_LoadFileAsync() that are still in this queue
- * will have their buffers deallocated by this function, to prevent a memory
- * leak.
- *
- * Once this function is called, the queue is no longer valid and should not
- * be used, including by other threads that might access it while destruction
- * is blocking on pending tasks.
- *
- * Do not destroy a queue that still has threads waiting on it through
- * SDL_WaitAsyncIOResult(). You can call SDL_SignalAsyncIOQueue() first to
- * unblock those threads, and take measures (such as SDL_WaitThread()) to make
- * sure they have finished their wait and won't wait on the queue again.
- *
- * \param queue the task queue to destroy.
- *
- * \threadsafety It is safe to call this function from any thread, so long as
- *               no other thread is waiting on the queue with
- *               SDL_WaitAsyncIOResult.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC void SDLCALL SDL_DestroyAsyncIOQueue(SDL_AsyncIOQueue *queue);
-
-/**
- * Query an async I/O task queue for completed tasks.
- *
- * If a task assigned to this queue has finished, this will return true and
- * fill in `outcome` with the details of the task. If no task in the queue has
- * finished, this function will return false. This function does not block.
- *
- * If a task has completed, this function will free its resources and the task
- * pointer will no longer be valid. The task will be removed from the queue.
- *
- * It is safe for multiple threads to call this function on the same queue at
- * once; a completed task will only go to one of the threads.
- *
- * \param queue the async I/O task queue to query.
- * \param outcome details of a finished task will be written here. May not be
- *                NULL.
- * \returns true if a task has completed, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_WaitAsyncIOResult
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetAsyncIOResult(SDL_AsyncIOQueue *queue, SDL_AsyncIOOutcome *outcome);
-
-/**
- * Block until an async I/O task queue has a completed task.
- *
- * This function puts the calling thread to sleep until there a task assigned
- * to the queue that has finished.
- *
- * If a task assigned to the queue has finished, this will return true and
- * fill in `outcome` with the details of the task. If no task in the queue has
- * finished, this function will return false.
- *
- * If a task has completed, this function will free its resources and the task
- * pointer will no longer be valid. The task will be removed from the queue.
- *
- * It is safe for multiple threads to call this function on the same queue at
- * once; a completed task will only go to one of the threads.
- *
- * Note that by the nature of various platforms, more than one waiting thread
- * may wake to handle a single task, but only one will obtain it, so
- * `timeoutMS` is a _maximum_ wait time, and this function may return false
- * sooner.
- *
- * This function may return false if there was a system error, the OS
- * inadvertently awoke multiple threads, or if SDL_SignalAsyncIOQueue() was
- * called to wake up all waiting threads without a finished task.
- *
- * A timeout can be used to specify a maximum wait time, but rather than
- * polling, it is possible to have a timeout of -1 to wait forever, and use
- * SDL_SignalAsyncIOQueue() to wake up the waiting threads later.
- *
- * \param queue the async I/O task queue to wait on.
- * \param outcome details of a finished task will be written here. May not be
- *                NULL.
- * \param timeoutMS the maximum time to wait, in milliseconds, or -1 to wait
- *                  indefinitely.
- * \returns true if task has completed, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SignalAsyncIOQueue
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_WaitAsyncIOResult(SDL_AsyncIOQueue *queue, SDL_AsyncIOOutcome *outcome, Sint32 timeoutMS);
-
-/**
- * Wake up any threads that are blocking in SDL_WaitAsyncIOResult().
- *
- * This will unblock any threads that are sleeping in a call to
- * SDL_WaitAsyncIOResult for the specified queue, and cause them to return
- * from that function.
- *
- * This can be useful when destroying a queue to make sure nothing is touching
- * it indefinitely. In this case, once this call completes, the caller should
- * take measures to make sure any previously-blocked threads have returned
- * from their wait and will not touch the queue again (perhaps by setting a
- * flag to tell the threads to terminate and then using SDL_WaitThread() to
- * make sure they've done so).
- *
- * \param queue the async I/O task queue to signal.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_WaitAsyncIOResult
- */
-extern SDL_DECLSPEC void SDLCALL SDL_SignalAsyncIOQueue(SDL_AsyncIOQueue *queue);
-
-/**
- * Load all the data from a file path, asynchronously.
- *
- * This function returns as quickly as possible; it does not wait for the read
- * to complete. On a successful return, this work will continue in the
- * background. If the work begins, even failure is asynchronous: a failing
- * return value from this function only means the work couldn't start at all.
- *
- * The data is allocated with a zero byte at the end (null terminated) for
- * convenience. This extra byte is not included in SDL_AsyncIOOutcome's
- * bytes_transferred value.
- *
- * This function will allocate the buffer to contain the file. It must be
- * deallocated by calling SDL_free() on SDL_AsyncIOOutcome's buffer field
- * after completion.
- *
- * An SDL_AsyncIOQueue must be specified. The newly-created task will be added
- * to it when it completes its work.
- *
- * \param file the path to read all available data from.
- * \param queue a queue to add the new SDL_AsyncIO to.
- * \param userdata an app-defined pointer that will be provided with the task
- *                 results.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_LoadFile_IO
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_LoadFileAsync(const char *file, SDL_AsyncIOQueue *queue, void *userdata);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_asyncio_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_atomic.h

@@ -1,664 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryAtomic
- *
- * Atomic operations.
- *
- * 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.
- *
- * ***Seriously, here be dragons!***
- *
- * 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:
- *
- * - 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.
- */
-
-#ifndef SDL_atomic_h_
-#define SDL_atomic_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_platform_defines.h>
-
-#include <SDL3/SDL_begin_code.h>
-
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * An atomic spinlock.
- *
- * The atomic locks are efficient spinlocks using CPU instructions, but are
- * vulnerable to starvation and can spin forever if a thread holding a lock
- * has been terminated. For this reason you should minimize the code executed
- * inside an atomic lock and never do expensive things like API or system
- * calls while holding them.
- *
- * They are also vulnerable to starvation if the thread holding the lock is
- * lower priority than other threads and doesn't get scheduled. In general you
- * should use mutexes instead, since they have better performance and
- * contention behavior.
- *
- * The atomic locks are not safe to lock recursively.
- *
- * Porting Note: The spin lock functions and type are required and can not be
- * emulated because they are used in the atomic emulation code.
- */
-typedef int SDL_SpinLock;
-
-/**
- * Try to lock a spin lock by setting it to a non-zero value.
- *
- * ***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.
- * \returns true if the lock succeeded, false if the lock is already held.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_LockSpinlock
- * \sa SDL_UnlockSpinlock
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_TryLockSpinlock(SDL_SpinLock *lock);
-
-/**
- * Lock a spin lock by setting it to a non-zero value.
- *
- * ***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.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_TryLockSpinlock
- * \sa SDL_UnlockSpinlock
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LockSpinlock(SDL_SpinLock *lock);
-
-/**
- * Unlock a spin lock by setting it to 0.
- *
- * Always returns immediately.
- *
- * ***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.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_LockSpinlock
- * \sa SDL_TryLockSpinlock
- */
-extern SDL_DECLSPEC void SDLCALL SDL_UnlockSpinlock(SDL_SpinLock *lock);
-
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * Mark a compiler barrier.
- *
- * A compiler barrier prevents the compiler from reordering reads and writes
- * to globally visible variables across the call.
- *
- * This macro only prevents the compiler from reordering reads and writes, it
- * does not prevent the CPU from reordering reads and writes. However, all of
- * the atomic operations that modify memory are full memory barriers.
- *
- * \threadsafety Obviously this macro is safe to use from any thread at any
- *               time, but if you find yourself needing this, you are probably
- *               dealing with some very sensitive code; be careful!
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_CompilerBarrier() DoCompilerSpecificReadWriteBarrier()
-
-#elif defined(_MSC_VER) && (_MSC_VER > 1200) && !defined(__clang__)
-void _ReadWriteBarrier(void);
-#pragma intrinsic(_ReadWriteBarrier)
-#define SDL_CompilerBarrier()   _ReadWriteBarrier()
-#elif (defined(__GNUC__) && !defined(SDL_PLATFORM_EMSCRIPTEN)) || (defined(__SUNPRO_C) && (__SUNPRO_C >= 0x5120))
-/* This is correct for all CPUs when using GCC or Solaris Studio 12.1+. */
-#define SDL_CompilerBarrier()   __asm__ __volatile__ ("" : : : "memory")
-#elif defined(__WATCOMC__)
-extern __inline void SDL_CompilerBarrier(void);
-#pragma aux SDL_CompilerBarrier = "" parm [] modify exact [];
-#else
-#define SDL_CompilerBarrier()   \
-{ SDL_SpinLock _tmp = 0; SDL_LockSpinlock(&_tmp); SDL_UnlockSpinlock(&_tmp); }
-#endif
-
-/**
- * Insert a memory release barrier (function version).
- *
- * Please refer to SDL_MemoryBarrierRelease for details. This is a function
- * version, which might be useful if you need to use this functionality from a
- * scripting language, etc. Also, some of the macro versions call this
- * function behind the scenes, where more heavy lifting can happen inside of
- * SDL. Generally, though, an app written in C/C++/etc should use the macro
- * version, as it will be more efficient.
- *
- * \threadsafety Obviously this function is safe to use from any thread at any
- *               time, but if you find yourself needing this, you are probably
- *               dealing with some very sensitive code; be careful!
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_MemoryBarrierRelease
- */
-extern SDL_DECLSPEC void SDLCALL SDL_MemoryBarrierReleaseFunction(void);
-
-/**
- * Insert a memory acquire barrier (function version).
- *
- * Please refer to SDL_MemoryBarrierRelease for details. This is a function
- * version, which might be useful if you need to use this functionality from a
- * scripting language, etc. Also, some of the macro versions call this
- * function behind the scenes, where more heavy lifting can happen inside of
- * SDL. Generally, though, an app written in C/C++/etc should use the macro
- * version, as it will be more efficient.
- *
- * \threadsafety Obviously this function is safe to use from any thread at any
- *               time, but if you find yourself needing this, you are probably
- *               dealing with some very sensitive code; be careful!
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_MemoryBarrierAcquire
- */
-extern SDL_DECLSPEC void SDLCALL SDL_MemoryBarrierAcquireFunction(void);
-
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * Insert a memory release barrier (macro version).
- *
- * Memory barriers are designed to prevent reads and writes from being
- * reordered by the compiler and being seen out of order on multi-core CPUs.
- *
- * A typical pattern would be for thread A to write some data and a flag, and
- * for thread B to read the flag and get the data. In this case you would
- * insert a release barrier between writing the data and the flag,
- * guaranteeing that the data write completes no later than the flag is
- * written, and you would insert an acquire barrier between reading the flag
- * and reading the data, to ensure that all the reads associated with the flag
- * have completed.
- *
- * In this pattern you should always see a release barrier paired with an
- * acquire barrier and you should gate the data reads/writes with a single
- * flag variable.
- *
- * For more information on these semantics, take a look at the blog post:
- * http://preshing.com/20120913/acquire-and-release-semantics
- *
- * This is the macro version of this functionality; if possible, SDL will use
- * compiler intrinsics or inline assembly, but some platforms might need to
- * call the function version of this, SDL_MemoryBarrierReleaseFunction to do
- * the heavy lifting. Apps that can use the macro should favor it over the
- * function.
- *
- * \threadsafety Obviously this macro is safe to use from any thread at any
- *               time, but if you find yourself needing this, you are probably
- *               dealing with some very sensitive code; be careful!
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_MemoryBarrierAcquire
- * \sa SDL_MemoryBarrierReleaseFunction
- */
-#define SDL_MemoryBarrierRelease() SDL_MemoryBarrierReleaseFunction()
-
-/**
- * Insert a memory acquire barrier (macro version).
- *
- * Please see SDL_MemoryBarrierRelease for the details on what memory barriers
- * are and when to use them.
- *
- * This is the macro version of this functionality; if possible, SDL will use
- * compiler intrinsics or inline assembly, but some platforms might need to
- * call the function version of this, SDL_MemoryBarrierAcquireFunction, to do
- * the heavy lifting. Apps that can use the macro should favor it over the
- * function.
- *
- * \threadsafety Obviously this macro is safe to use from any thread at any
- *               time, but if you find yourself needing this, you are probably
- *               dealing with some very sensitive code; be careful!
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_MemoryBarrierRelease
- * \sa SDL_MemoryBarrierAcquireFunction
- */
-#define SDL_MemoryBarrierAcquire() SDL_MemoryBarrierAcquireFunction()
-
-#elif defined(__GNUC__) && (defined(__powerpc__) || defined(__ppc__))
-#define SDL_MemoryBarrierRelease()   __asm__ __volatile__ ("lwsync" : : : "memory")
-#define SDL_MemoryBarrierAcquire()   __asm__ __volatile__ ("lwsync" : : : "memory")
-#elif defined(__GNUC__) && defined(__aarch64__)
-#define SDL_MemoryBarrierRelease()   __asm__ __volatile__ ("dmb ish" : : : "memory")
-#define SDL_MemoryBarrierAcquire()   __asm__ __volatile__ ("dmb ish" : : : "memory")
-#elif defined(__GNUC__) && defined(__arm__)
-#if 0 /* defined(SDL_PLATFORM_LINUX) || defined(SDL_PLATFORM_ANDROID) */
-/* Information from:
-   https://chromium.googlesource.com/chromium/chromium/+/trunk/base/atomicops_internals_arm_gcc.h#19
-
-   The Linux kernel provides a helper function which provides the right code for a memory barrier,
-   hard-coded at address 0xffff0fa0
-*/
-typedef void (*SDL_KernelMemoryBarrierFunc)();
-#define SDL_MemoryBarrierRelease()  ((SDL_KernelMemoryBarrierFunc)0xffff0fa0)()
-#define SDL_MemoryBarrierAcquire()  ((SDL_KernelMemoryBarrierFunc)0xffff0fa0)()
-#else
-#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__)
-#ifdef __thumb__
-/* The mcr instruction isn't available in thumb mode, use real functions */
-#define SDL_MEMORY_BARRIER_USES_FUNCTION
-#define SDL_MemoryBarrierRelease()   SDL_MemoryBarrierReleaseFunction()
-#define SDL_MemoryBarrierAcquire()   SDL_MemoryBarrierAcquireFunction()
-#else
-#define SDL_MemoryBarrierRelease()   __asm__ __volatile__ ("mcr p15, 0, %0, c7, c10, 5" : : "r"(0) : "memory")
-#define SDL_MemoryBarrierAcquire()   __asm__ __volatile__ ("mcr p15, 0, %0, c7, c10, 5" : : "r"(0) : "memory")
-#endif /* __thumb__ */
-#else
-#define SDL_MemoryBarrierRelease()   __asm__ __volatile__ ("" : : : "memory")
-#define SDL_MemoryBarrierAcquire()   __asm__ __volatile__ ("" : : : "memory")
-#endif /* SDL_PLATFORM_LINUX || SDL_PLATFORM_ANDROID */
-#endif /* __GNUC__ && __arm__ */
-#else
-#if (defined(__SUNPRO_C) && (__SUNPRO_C >= 0x5120))
-/* This is correct for all CPUs on Solaris when using Solaris Studio 12.1+. */
-#include <mbarrier.h>
-#define SDL_MemoryBarrierRelease()  __machine_rel_barrier()
-#define SDL_MemoryBarrierAcquire()  __machine_acq_barrier()
-#else
-/* This is correct for the x86 and x64 CPUs, and we'll expand this over time. */
-#define SDL_MemoryBarrierRelease()  SDL_CompilerBarrier()
-#define SDL_MemoryBarrierAcquire()  SDL_CompilerBarrier()
-#endif
-#endif
-
-/* "REP NOP" is PAUSE, coded for tools that don't know it by that name. */
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A macro to insert a CPU-specific "pause" instruction into the program.
- *
- * This can be useful in busy-wait loops, as it serves as a hint to the CPU as
- * to the program's intent; some CPUs can use this to do more efficient
- * processing. On some platforms, this doesn't do anything, so using this
- * macro might just be a harmless no-op.
- *
- * Note that if you are busy-waiting, there are often more-efficient
- * approaches with other synchronization primitives: mutexes, semaphores,
- * condition variables, etc.
- *
- * \threadsafety This macro is safe to use from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_CPUPauseInstruction() DoACPUPauseInACompilerAndArchitectureSpecificWay
-
-#elif (defined(__GNUC__) || defined(__clang__)) && (defined(__i386__) || defined(__x86_64__))
-    #define SDL_CPUPauseInstruction() __asm__ __volatile__("pause\n")  /* Some assemblers can't do REP NOP, so go with PAUSE. */
-#elif (defined(__arm__) && defined(__ARM_ARCH) && __ARM_ARCH >= 7) || defined(__aarch64__)
-    #define SDL_CPUPauseInstruction() __asm__ __volatile__("yield" ::: "memory")
-#elif (defined(__powerpc__) || defined(__powerpc64__))
-    #define SDL_CPUPauseInstruction() __asm__ __volatile__("or 27,27,27");
-#elif (defined(__riscv) && __riscv_xlen == 64)
-    #define SDL_CPUPauseInstruction() __asm__ __volatile__(".insn i 0x0F, 0, x0, x0, 0x010");
-#elif defined(_MSC_VER) && (defined(_M_IX86) || defined(_M_X64))
-    #define SDL_CPUPauseInstruction() _mm_pause()  /* this is actually "rep nop" and not a SIMD instruction. No inline asm in MSVC x86-64! */
-#elif defined(_MSC_VER) && (defined(_M_ARM) || defined(_M_ARM64))
-    #define SDL_CPUPauseInstruction() __yield()
-#elif defined(__WATCOMC__) && defined(__386__)
-    extern __inline void SDL_CPUPauseInstruction(void);
-    #pragma aux SDL_CPUPauseInstruction = ".686p" ".xmm2" "pause"
-#else
-    #define SDL_CPUPauseInstruction()
-#endif
-
-
-/**
- * A type representing an atomic integer value.
- *
- * This can be used to manage a value that is synchronized across multiple
- * CPUs without a race condition; when an app sets a value with
- * SDL_SetAtomicInt all other threads, regardless of the CPU it is running on,
- * will see that value when retrieved with SDL_GetAtomicInt, regardless of CPU
- * caches, etc.
- *
- * This is also useful for atomic compare-and-swap operations: a thread can
- * change the value as long as its current value matches expectations. When
- * done in a loop, one can guarantee data consistency across threads without a
- * lock (but the usual warnings apply: if you don't know what you're doing, or
- * you don't do it carefully, you can confidently cause any number of
- * disasters with this, so in most cases, you _should_ use a mutex instead of
- * this!).
- *
- * This is a struct so people don't accidentally use numeric operations on it
- * directly. You have to use SDL atomic functions.
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_CompareAndSwapAtomicInt
- * \sa SDL_GetAtomicInt
- * \sa SDL_SetAtomicInt
- * \sa SDL_AddAtomicInt
- */
-typedef struct SDL_AtomicInt { int value; } SDL_AtomicInt;
-
-/**
- * Set an atomic variable to a new value if it is currently an old value.
- *
- * ***Note: If you don't know what this function is for, you shouldn't use
- * it!***
- *
- * \param a a pointer to an SDL_AtomicInt variable to be modified.
- * \param oldval the old value.
- * \param newval the new value.
- * \returns true if the atomic variable was set, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetAtomicInt
- * \sa SDL_SetAtomicInt
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CompareAndSwapAtomicInt(SDL_AtomicInt *a, int oldval, int newval);
-
-/**
- * Set an atomic variable to a value.
- *
- * This function also acts as a full memory barrier.
- *
- * ***Note: If you don't know what this function is for, you shouldn't use
- * it!***
- *
- * \param a a pointer to an SDL_AtomicInt variable to be modified.
- * \param v the desired value.
- * \returns the previous value of the atomic variable.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetAtomicInt
- */
-extern SDL_DECLSPEC int SDLCALL SDL_SetAtomicInt(SDL_AtomicInt *a, int v);
-
-/**
- * Get the value of an atomic variable.
- *
- * ***Note: If you don't know what this function is for, you shouldn't use
- * it!***
- *
- * \param a a pointer to an SDL_AtomicInt variable.
- * \returns the current value of an atomic variable.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetAtomicInt
- */
-extern SDL_DECLSPEC int SDLCALL SDL_GetAtomicInt(SDL_AtomicInt *a);
-
-/**
- * Add to an atomic variable.
- *
- * This function also acts as a full memory barrier.
- *
- * ***Note: If you don't know what this function is for, you shouldn't use
- * it!***
- *
- * \param a a pointer to an SDL_AtomicInt variable to be modified.
- * \param v the desired value to add.
- * \returns the previous value of the atomic variable.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_AtomicDecRef
- * \sa SDL_AtomicIncRef
- */
-extern SDL_DECLSPEC int SDLCALL SDL_AddAtomicInt(SDL_AtomicInt *a, int v);
-
-#ifndef SDL_AtomicIncRef
-
-/**
- * Increment an atomic variable used as a reference count.
- *
- * ***Note: If you don't know what this macro is for, you shouldn't use it!***
- *
- * \param a a pointer to an SDL_AtomicInt to increment.
- * \returns the previous value of the atomic variable.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_AtomicDecRef
- */
-#define SDL_AtomicIncRef(a)    SDL_AddAtomicInt(a, 1)
-#endif
-
-#ifndef SDL_AtomicDecRef
-
-/**
- * Decrement an atomic variable used as a reference count.
- *
- * ***Note: If you don't know what this macro is for, you shouldn't use it!***
- *
- * \param a a pointer to an SDL_AtomicInt to decrement.
- * \returns true if the variable reached zero after decrementing, false
- *          otherwise.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_AtomicIncRef
- */
-#define SDL_AtomicDecRef(a)    (SDL_AddAtomicInt(a, -1) == 1)
-#endif
-
-/**
- * A type representing an atomic unsigned 32-bit value.
- *
- * This can be used to manage a value that is synchronized across multiple
- * CPUs without a race condition; when an app sets a value with
- * SDL_SetAtomicU32 all other threads, regardless of the CPU it is running on,
- * will see that value when retrieved with SDL_GetAtomicU32, regardless of CPU
- * caches, etc.
- *
- * This is also useful for atomic compare-and-swap operations: a thread can
- * change the value as long as its current value matches expectations. When
- * done in a loop, one can guarantee data consistency across threads without a
- * lock (but the usual warnings apply: if you don't know what you're doing, or
- * you don't do it carefully, you can confidently cause any number of
- * disasters with this, so in most cases, you _should_ use a mutex instead of
- * this!).
- *
- * This is a struct so people don't accidentally use numeric operations on it
- * directly. You have to use SDL atomic functions.
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_CompareAndSwapAtomicU32
- * \sa SDL_GetAtomicU32
- * \sa SDL_SetAtomicU32
- */
-typedef struct SDL_AtomicU32 { Uint32 value; } SDL_AtomicU32;
-
-/**
- * Set an atomic variable to a new value if it is currently an old value.
- *
- * ***Note: If you don't know what this function is for, you shouldn't use
- * it!***
- *
- * \param a a pointer to an SDL_AtomicU32 variable to be modified.
- * \param oldval the old value.
- * \param newval the new value.
- * \returns true if the atomic variable was set, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetAtomicU32
- * \sa SDL_SetAtomicU32
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CompareAndSwapAtomicU32(SDL_AtomicU32 *a, Uint32 oldval, Uint32 newval);
-
-/**
- * Set an atomic variable to a value.
- *
- * This function also acts as a full memory barrier.
- *
- * ***Note: If you don't know what this function is for, you shouldn't use
- * it!***
- *
- * \param a a pointer to an SDL_AtomicU32 variable to be modified.
- * \param v the desired value.
- * \returns the previous value of the atomic variable.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetAtomicU32
- */
-extern SDL_DECLSPEC Uint32 SDLCALL SDL_SetAtomicU32(SDL_AtomicU32 *a, Uint32 v);
-
-/**
- * Get the value of an atomic variable.
- *
- * ***Note: If you don't know what this function is for, you shouldn't use
- * it!***
- *
- * \param a a pointer to an SDL_AtomicU32 variable.
- * \returns the current value of an atomic variable.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetAtomicU32
- */
-extern SDL_DECLSPEC Uint32 SDLCALL SDL_GetAtomicU32(SDL_AtomicU32 *a);
-
-/**
- * Set a pointer to a new value if it is currently an old value.
- *
- * ***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.
- * \returns true if the pointer was set, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CompareAndSwapAtomicInt
- * \sa SDL_GetAtomicPointer
- * \sa SDL_SetAtomicPointer
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CompareAndSwapAtomicPointer(void **a, void *oldval, void *newval);
-
-/**
- * Set a pointer to a value atomically.
- *
- * ***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.
- * \returns the previous value of the pointer.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CompareAndSwapAtomicPointer
- * \sa SDL_GetAtomicPointer
- */
-extern SDL_DECLSPEC void * SDLCALL SDL_SetAtomicPointer(void **a, void *v);
-
-/**
- * Get the value of a pointer atomically.
- *
- * ***Note: If you don't know what this function is for, you shouldn't use
- * it!***
- *
- * \param a a pointer to a pointer.
- * \returns the current value of a pointer.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CompareAndSwapAtomicPointer
- * \sa SDL_SetAtomicPointer
- */
-extern SDL_DECLSPEC void * SDLCALL SDL_GetAtomicPointer(void **a);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_atomic_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_begin_code.h

@@ -1,486 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: BeginCode */
-
-/**
- * # CategoryBeginCode
- *
- * `SDL_begin_code.h` sets things up for C dynamic library function
- * definitions, static inlined functions, and structures aligned at 4-byte
- * alignment. If you don't like ugly C preprocessor code, don't look at this
- * file. :)
- *
- * SDL's headers use this; applications generally should not include this
- * header directly.
- */
-
-/* This shouldn't be nested -- included it around code only. */
-#ifdef SDL_begin_code_h
-#error Nested inclusion of SDL_begin_code.h
-#endif
-#define SDL_begin_code_h
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A macro to tag a symbol as deprecated.
- *
- * A function is marked deprecated by adding this macro to its declaration:
- *
- * ```c
- * extern SDL_DEPRECATED int ThisFunctionWasABadIdea(void);
- * ```
- *
- * Compilers with deprecation support can give a warning when a deprecated
- * function is used. This symbol may be used in SDL's headers, but apps are
- * welcome to use it for their own interfaces as well.
- *
- * SDL, on occasion, might deprecate a function for various reasons. However,
- * SDL never removes symbols before major versions, so deprecated interfaces
- * in SDL3 will remain available until SDL4, where it would be expected an app
- * would have to take steps to migrate anyhow.
- *
- * On compilers without a deprecation mechanism, this is defined to nothing,
- * and using a deprecated function will not generate a warning.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_DEPRECATED __attribute__((deprecated))
-
-/**
- * A macro to tag a symbol as a public API.
- *
- * SDL uses this macro for all its public functions. On some targets, it is
- * used to signal to the compiler that this function needs to be exported from
- * a shared library, but it might have other side effects.
- *
- * This symbol is used in SDL's headers, but apps and other libraries are
- * welcome to use it for their own interfaces as well.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_DECLSPEC __attribute__ ((visibility("default")))
-
-/**
- * A macro to set a function's calling conventions.
- *
- * SDL uses this macro for all its public functions, and any callbacks it
- * defines. This macro guarantees that calling conventions match between SDL
- * and the app, even if the two were built with different compilers or
- * optimization settings.
- *
- * When writing a callback function, it is very important for it to be
- * correctly tagged with SDLCALL, as mismatched calling conventions can cause
- * strange behaviors and can be difficult to diagnose. Plus, on many
- * platforms, SDLCALL is defined to nothing, so compilers won't be able to
- * warn that the tag is missing.
- *
- * This symbol is used in SDL's headers, but apps and other libraries are
- * welcome to use it for their own interfaces as well.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDLCALL __cdecl
-
-/**
- * A macro to request a function be inlined.
- *
- * This is a hint to the compiler to inline a function. The compiler is free
- * to ignore this request. On compilers without inline support, this is
- * defined to nothing.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_INLINE __inline
-
-/**
- * A macro to demand a function be inlined.
- *
- * This is a command to the compiler to inline a function. SDL uses this macro
- * in its public headers for a handful of simple functions. On compilers
- * without forceinline support, this is defined to `static SDL_INLINE`, which
- * is often good enough.
- *
- * This symbol is used in SDL's headers, but apps and other libraries are
- * welcome to use it for their own interfaces as well.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_FORCE_INLINE __forceinline
-
-/**
- * A macro to tag a function as never-returning.
- *
- * This is a hint to the compiler that a function does not return. An example
- * of a function like this is the C runtime's exit() function.
- *
- * This hint can lead to code optimizations, and help analyzers understand
- * code flow better. On compilers without noreturn support, this is defined to
- * nothing.
- *
- * This symbol is used in SDL's headers, but apps and other libraries are
- * welcome to use it for their own interfaces as well.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_NORETURN __attribute__((noreturn))
-
-/**
- * A macro to tag a function as never-returning (for analysis purposes).
- *
- * This is almost identical to SDL_NORETURN, except functions marked with this
- * _can_ actually return. The difference is that this isn't used for code
- * generation, but rather static analyzers use this information to assume
- * truths about program state and available code paths. Specifically, this tag
- * is useful for writing an assertion mechanism. Indeed, SDL_assert uses this
- * tag behind the scenes. Generally, apps that don't understand the specific
- * use-case for this tag should avoid using it directly.
- *
- * On compilers without analyzer_noreturn support, this is defined to nothing.
- *
- * This symbol is used in SDL's headers, but apps and other libraries are
- * welcome to use it for their own interfaces as well.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_ANALYZER_NORETURN __attribute__((analyzer_noreturn))
-
-
-/**
- * A macro to signal that a case statement without a `break` is intentional.
- *
- * C compilers have gotten more aggressive about warning when a switch's
- * `case` block does not end with a `break` or other flow control statement,
- * flowing into the next case's code, as this is a common accident that leads
- * to strange bugs. But sometimes falling through to the next case is the
- * correct and desired behavior. This symbol lets an app communicate this
- * intention to the compiler, so it doesn't generate a warning.
- *
- * It is used like this:
- *
- * ```c
- * switch (x) {
- *     case 1:
- *         DoSomethingOnlyForOne();
- *         SDL_FALLTHROUGH;  // tell the compiler this was intentional.
- *     case 2:
- *         DoSomethingForOneAndTwo();
- *         break;
- * }
- * ```
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_FALLTHROUGH [[fallthrough]]
-
-/**
- * A macro to tag a function's return value as critical.
- *
- * This is a hint to the compiler that a function's return value should not be
- * ignored.
- *
- * If an NODISCARD function's return value is thrown away (the function is
- * called as if it returns `void`), the compiler will issue a warning.
- *
- * While it's generally good practice to check return values for errors, often
- * times legitimate programs do not for good reasons. Be careful about what
- * functions are tagged as NODISCARD. It operates best when used on a function
- * that's failure is surprising and catastrophic; a good example would be a
- * program that checks the return values of all its file write function calls
- * but not the call to close the file, which it assumes incorrectly never
- * fails.
- *
- * Function callers that want to throw away a NODISCARD return value can call
- * the function with a `(void)` cast, which informs the compiler the act is
- * intentional.
- *
- * On compilers without nodiscard support, this is defined to nothing.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_NODISCARD [[nodiscard]]
-
-/**
- * A macro to tag a function as an allocator.
- *
- * This is a hint to the compiler that a function is an allocator, like
- * malloc(), with certain rules. A description of how GCC treats this hint is
- * here:
- *
- * https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-malloc-function-attribute
- *
- * On compilers without allocator tag support, this is defined to nothing.
- *
- * Most apps don't need to, and should not, use this directly.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_MALLOC __declspec(allocator) __desclspec(restrict)
-
-/**
- * A macro to tag a function as returning a certain allocation.
- *
- * This is a hint to the compiler that a function allocates and returns a
- * specific amount of memory based on one of its arguments. For example, the C
- * runtime's malloc() function could use this macro with an argument of 1
- * (first argument to malloc is the size of the allocation).
- *
- * On compilers without alloc_size support, this is defined to nothing.
- *
- * Most apps don't need to, and should not, use this directly.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_ALLOC_SIZE(p) __attribute__((alloc_size(p)))
-
-/**
- * A macro to tag a pointer variable, to help with pointer aliasing.
- *
- * A good explanation of the restrict keyword is here:
- *
- * https://en.wikipedia.org/wiki/Restrict
- *
- * On compilers without restrict support, this is defined to nothing.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_RESTRICT __restrict__
-
-/**
- * Check if the compiler supports a given builtin functionality.
- *
- * This allows preprocessor checks for things that otherwise might fail to
- * compile.
- *
- * Supported by virtually all clang versions and more-recent GCCs. Use this
- * instead of checking the clang version if possible.
- *
- * On compilers without has_builtin support, this is defined to 0 (always
- * false).
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_HAS_BUILTIN(x) __has_builtin(x)
-
-/* end of wiki documentation section. */
-#endif
-
-#ifndef SDL_HAS_BUILTIN
-#ifdef __has_builtin
-#define SDL_HAS_BUILTIN(x) __has_builtin(x)
-#else
-#define SDL_HAS_BUILTIN(x) 0
-#endif
-#endif
-
-#ifndef SDL_DEPRECATED
-#  if defined(__GNUC__) && (__GNUC__ >= 4)  /* technically, this arrived in gcc 3.1, but oh well. */
-#    define SDL_DEPRECATED __attribute__((deprecated))
-#  elif defined(_MSC_VER)
-#    define SDL_DEPRECATED __declspec(deprecated)
-#  else
-#    define SDL_DEPRECATED
-#  endif
-#endif
-
-#ifndef SDL_UNUSED
-#  ifdef __GNUC__
-#    define SDL_UNUSED __attribute__((unused))
-#  else
-#    define SDL_UNUSED
-#  endif
-#endif
-
-/* Some compilers use a special export keyword */
-#ifndef SDL_DECLSPEC
-# if defined(SDL_PLATFORM_WINDOWS)
-#  ifdef DLL_EXPORT
-#   define SDL_DECLSPEC __declspec(dllexport)
-#  else
-#   define SDL_DECLSPEC
-#  endif
-# else
-#  if defined(__GNUC__) && __GNUC__ >= 4
-#   define SDL_DECLSPEC __attribute__ ((visibility("default")))
-#  else
-#   define SDL_DECLSPEC
-#  endif
-# endif
-#endif
-
-/* By default SDL uses the C calling convention */
-#ifndef SDLCALL
-#if defined(SDL_PLATFORM_WINDOWS) && !defined(__GNUC__)
-#define SDLCALL __cdecl
-#else
-#define SDLCALL
-#endif
-#endif /* SDLCALL */
-
-/* Force structure packing at 4 byte alignment.
-   This is necessary if the header is included in code which has structure
-   packing set to an alternate value, say for loading structures from disk.
-   The packing is reset to the previous value in SDL_close_code.h
- */
-#if defined(_MSC_VER) || defined(__MWERKS__) || defined(__BORLANDC__)
-#ifdef _MSC_VER
-#pragma warning(disable: 4103)
-#endif
-#ifdef __clang__
-#pragma clang diagnostic ignored "-Wpragma-pack"
-#endif
-#ifdef __BORLANDC__
-#pragma nopackwarning
-#endif
-#ifdef _WIN64
-/* Use 8-byte alignment on 64-bit architectures, so pointers are aligned */
-#pragma pack(push,8)
-#else
-#pragma pack(push,4)
-#endif
-#endif /* Compiler needs structure packing set */
-
-#ifndef SDL_INLINE
-#ifdef __GNUC__
-#define SDL_INLINE __inline__
-#elif defined(_MSC_VER) || defined(__BORLANDC__) || \
-      defined(__DMC__) || defined(__SC__) || \
-      defined(__WATCOMC__) || defined(__LCC__) || \
-      defined(__DECC) || defined(__CC_ARM)
-#define SDL_INLINE __inline
-#ifndef __inline__
-#define __inline__ __inline
-#endif
-#else
-#define SDL_INLINE inline
-#ifndef __inline__
-#define __inline__ inline
-#endif
-#endif
-#endif /* SDL_INLINE not defined */
-
-#ifndef SDL_FORCE_INLINE
-#ifdef _MSC_VER
-#define SDL_FORCE_INLINE __forceinline
-#elif ( (defined(__GNUC__) && (__GNUC__ >= 4)) || defined(__clang__) )
-#define SDL_FORCE_INLINE __attribute__((always_inline)) static __inline__
-#else
-#define SDL_FORCE_INLINE static SDL_INLINE
-#endif
-#endif /* SDL_FORCE_INLINE not defined */
-
-#ifndef SDL_NORETURN
-#ifdef __GNUC__
-#define SDL_NORETURN __attribute__((noreturn))
-#elif defined(_MSC_VER)
-#define SDL_NORETURN __declspec(noreturn)
-#else
-#define SDL_NORETURN
-#endif
-#endif /* SDL_NORETURN not defined */
-
-#ifdef __clang__
-#if __has_feature(attribute_analyzer_noreturn)
-#define SDL_ANALYZER_NORETURN __attribute__((analyzer_noreturn))
-#endif
-#endif
-
-#ifndef SDL_ANALYZER_NORETURN
-#define SDL_ANALYZER_NORETURN
-#endif
-
-/* Apparently this is needed by several Windows compilers */
-#ifndef __MACH__
-#ifndef NULL
-#ifdef __cplusplus
-#define NULL 0
-#else
-#define NULL ((void *)0)
-#endif
-#endif /* NULL */
-#endif /* ! macOS - breaks precompiled headers */
-
-#ifndef SDL_FALLTHROUGH
-#if (defined(__cplusplus) && __cplusplus >= 201703L) || \
-    (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 202000L)
-#define SDL_FALLTHROUGH [[fallthrough]]
-#else
-#if defined(__has_attribute) && !defined(__SUNPRO_C) && !defined(__SUNPRO_CC)
-#define SDL_HAS_FALLTHROUGH __has_attribute(__fallthrough__)
-#else
-#define SDL_HAS_FALLTHROUGH 0
-#endif /* __has_attribute */
-#if SDL_HAS_FALLTHROUGH && \
-   ((defined(__GNUC__) && __GNUC__ >= 7) || \
-    (defined(__clang_major__) && __clang_major__ >= 10))
-#define SDL_FALLTHROUGH __attribute__((__fallthrough__))
-#else
-#define SDL_FALLTHROUGH do {} while (0) /* fallthrough */
-#endif /* SDL_HAS_FALLTHROUGH */
-#undef SDL_HAS_FALLTHROUGH
-#endif /* C++17 or C2x */
-#endif /* SDL_FALLTHROUGH not defined */
-
-#ifndef SDL_NODISCARD
-#if (defined(__cplusplus) && __cplusplus >= 201703L) || \
-    (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 202311L)
-#define SDL_NODISCARD [[nodiscard]]
-#elif ( (defined(__GNUC__) && (__GNUC__ >= 4)) || defined(__clang__) )
-#define SDL_NODISCARD __attribute__((warn_unused_result))
-#elif defined(_MSC_VER) && (_MSC_VER >= 1700)
-#define SDL_NODISCARD _Check_return_
-#else
-#define SDL_NODISCARD
-#endif /* C++17 or C23 */
-#endif /* SDL_NODISCARD not defined */
-
-#ifndef SDL_MALLOC
-#if defined(__GNUC__) && (__GNUC__ >= 3)
-#define SDL_MALLOC __attribute__((malloc))
-/** FIXME
-#elif defined(_MSC_VER)
-#define SDL_MALLOC __declspec(allocator) __desclspec(restrict)
-**/
-#else
-#define SDL_MALLOC
-#endif
-#endif /* SDL_MALLOC not defined */
-
-#ifndef SDL_ALLOC_SIZE
-#if (defined(__clang__) && __clang_major__ >= 4) || (defined(__GNUC__) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3)))
-#define SDL_ALLOC_SIZE(p) __attribute__((alloc_size(p)))
-#elif defined(_MSC_VER)
-#define SDL_ALLOC_SIZE(p)
-#else
-#define SDL_ALLOC_SIZE(p)
-#endif
-#endif /* SDL_ALLOC_SIZE not defined */
-
-#ifndef SDL_ALLOC_SIZE2
-#if (defined(__clang__) && __clang_major__ >= 4) || (defined(__GNUC__) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3)))
-#define SDL_ALLOC_SIZE2(p1, p2) __attribute__((alloc_size(p1, p2)))
-#elif defined(_MSC_VER)
-#define SDL_ALLOC_SIZE2(p1, p2)
-#else
-#define SDL_ALLOC_SIZE2(p1, p2)
-#endif
-#endif /* SDL_ALLOC_SIZE2 not defined */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_bits.h

@@ -1,147 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryBits
- *
- * Functions for fiddling with bits and bitmasks.
- */
-
-#ifndef SDL_bits_h_
-#define SDL_bits_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-#if defined(__WATCOMC__) && defined(__386__)
-extern __inline int _SDL_bsr_watcom(Uint32);
-#pragma aux _SDL_bsr_watcom = \
-    "bsr eax, eax" \
-    parm [eax] nomemory \
-    value [eax] \
-    modify exact [eax] nomemory;
-#endif
-
-/**
- * Get the index of the most significant (set) bit in a 32-bit number.
- *
- * Result is undefined when called with 0. This operation can also be stated
- * as "count leading zeroes" and "log base 2".
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param x the 32-bit value to examine.
- * \returns the index of the most significant bit, or -1 if the value is 0.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE int SDL_MostSignificantBitIndex32(Uint32 x)
-{
-#if defined(__GNUC__) && (__GNUC__ >= 4 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4))
-    /* Count Leading Zeroes builtin in GCC.
-     * http://gcc.gnu.org/onlinedocs/gcc-4.3.4/gcc/Other-Builtins.html
-     */
-    if (x == 0) {
-        return -1;
-    }
-    return 31 - __builtin_clz(x);
-#elif defined(__WATCOMC__) && defined(__386__)
-    if (x == 0) {
-        return -1;
-    }
-    return _SDL_bsr_watcom(x);
-#elif defined(_MSC_VER) && _MSC_VER >= 1400
-    unsigned long index;
-    if (_BitScanReverse(&index, x)) {
-        return (int)index;
-    }
-    return -1;
-#else
-    /* Based off of Bit Twiddling Hacks by Sean Eron Anderson
-     * <seander@cs.stanford.edu>, released in the public domain.
-     * http://graphics.stanford.edu/~seander/bithacks.html#IntegerLog
-     */
-    const Uint32 b[] = {0x2, 0xC, 0xF0, 0xFF00, 0xFFFF0000};
-    const int    S[] = {1, 2, 4, 8, 16};
-
-    int msbIndex = 0;
-    int i;
-
-    if (x == 0) {
-        return -1;
-    }
-
-    for (i = 4; i >= 0; i--)
-    {
-        if (x & b[i])
-        {
-            x >>= S[i];
-            msbIndex |= S[i];
-        }
-    }
-
-    return msbIndex;
-#endif
-}
-
-/**
- * Determine if a unsigned 32-bit value has exactly one bit set.
- *
- * If there are no bits set (`x` is zero), or more than one bit set, this
- * returns false. If any one bit is exclusively set, this returns true.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param x the 32-bit value to examine.
- * \returns true if exactly one bit is set in `x`, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE bool SDL_HasExactlyOneBitSet32(Uint32 x)
-{
-    if (x && !(x & (x - 1))) {
-        return true;
-    }
-    return false;
-}
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_bits_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_blendmode.h

@@ -1,202 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryBlendmode
- *
- * Blend modes decide how two colors will mix together. There are both
- * standard modes for basic needs and a means to create custom modes,
- * dictating what sort of math to do on what color components.
- */
-
-#ifndef SDL_blendmode_h_
-#define SDL_blendmode_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * A set of blend modes used in drawing operations.
- *
- * These predefined blend modes are supported everywhere.
- *
- * Additional values may be obtained from SDL_ComposeCustomBlendMode.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_ComposeCustomBlendMode
- */
-typedef Uint32 SDL_BlendMode;
-
-#define SDL_BLENDMODE_NONE                  0x00000000u /**< no blending: dstRGBA = srcRGBA */
-#define SDL_BLENDMODE_BLEND                 0x00000001u /**< alpha blending: dstRGB = (srcRGB * srcA) + (dstRGB * (1-srcA)), dstA = srcA + (dstA * (1-srcA)) */
-#define SDL_BLENDMODE_BLEND_PREMULTIPLIED   0x00000010u /**< pre-multiplied alpha blending: dstRGBA = srcRGBA + (dstRGBA * (1-srcA)) */
-#define SDL_BLENDMODE_ADD                   0x00000002u /**< additive blending: dstRGB = (srcRGB * srcA) + dstRGB, dstA = dstA */
-#define SDL_BLENDMODE_ADD_PREMULTIPLIED     0x00000020u /**< pre-multiplied additive blending: dstRGB = srcRGB + dstRGB, dstA = dstA */
-#define SDL_BLENDMODE_MOD                   0x00000004u /**< color modulate: dstRGB = srcRGB * dstRGB, dstA = dstA */
-#define SDL_BLENDMODE_MUL                   0x00000008u /**< color multiply: dstRGB = (srcRGB * dstRGB) + (dstRGB * (1-srcA)), dstA = dstA */
-#define SDL_BLENDMODE_INVALID               0x7FFFFFFFu
-
-/**
- * The blend operation used when combining source and destination pixel
- * components.
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_BlendOperation
-{
-    SDL_BLENDOPERATION_ADD              = 0x1,  /**< dst + src: supported by all renderers */
-    SDL_BLENDOPERATION_SUBTRACT         = 0x2,  /**< src - dst : supported by D3D, OpenGL, OpenGLES, and Vulkan */
-    SDL_BLENDOPERATION_REV_SUBTRACT     = 0x3,  /**< dst - src : supported by D3D, OpenGL, OpenGLES, and Vulkan */
-    SDL_BLENDOPERATION_MINIMUM          = 0x4,  /**< min(dst, src) : supported by D3D, OpenGL, OpenGLES, and Vulkan */
-    SDL_BLENDOPERATION_MAXIMUM          = 0x5   /**< max(dst, src) : supported by D3D, OpenGL, OpenGLES, and Vulkan */
-} SDL_BlendOperation;
-
-/**
- * The normalized factor used to multiply pixel components.
- *
- * The blend factors are multiplied with the pixels from a drawing operation
- * (src) and the pixels from the render target (dst) before the blend
- * operation. The comma-separated factors listed above are always applied in
- * the component order red, green, blue, and alpha.
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_BlendFactor
-{
-    SDL_BLENDFACTOR_ZERO                = 0x1,  /**< 0, 0, 0, 0 */
-    SDL_BLENDFACTOR_ONE                 = 0x2,  /**< 1, 1, 1, 1 */
-    SDL_BLENDFACTOR_SRC_COLOR           = 0x3,  /**< srcR, srcG, srcB, srcA */
-    SDL_BLENDFACTOR_ONE_MINUS_SRC_COLOR = 0x4,  /**< 1-srcR, 1-srcG, 1-srcB, 1-srcA */
-    SDL_BLENDFACTOR_SRC_ALPHA           = 0x5,  /**< srcA, srcA, srcA, srcA */
-    SDL_BLENDFACTOR_ONE_MINUS_SRC_ALPHA = 0x6,  /**< 1-srcA, 1-srcA, 1-srcA, 1-srcA */
-    SDL_BLENDFACTOR_DST_COLOR           = 0x7,  /**< dstR, dstG, dstB, dstA */
-    SDL_BLENDFACTOR_ONE_MINUS_DST_COLOR = 0x8,  /**< 1-dstR, 1-dstG, 1-dstB, 1-dstA */
-    SDL_BLENDFACTOR_DST_ALPHA           = 0x9,  /**< dstA, dstA, dstA, dstA */
-    SDL_BLENDFACTOR_ONE_MINUS_DST_ALPHA = 0xA   /**< 1-dstA, 1-dstA, 1-dstA, 1-dstA */
-} SDL_BlendFactor;
-
-/**
- * Compose a custom blend mode for renderers.
- *
- * The functions SDL_SetRenderDrawBlendMode and SDL_SetTextureBlendMode accept
- * the SDL_BlendMode returned by this function if the renderer supports it.
- *
- * A blend mode controls how the pixels from a drawing operation (source) get
- * combined with the pixels from the render target (destination). First, the
- * components of the source and destination pixels get multiplied with their
- * blend factors. Then, the blend operation takes the two products and
- * calculates the result that will get stored in the render target.
- *
- * Expressed in pseudocode, it would look like this:
- *
- * ```c
- * dstRGB = colorOperation(srcRGB * srcColorFactor, dstRGB * dstColorFactor);
- * dstA = alphaOperation(srcA * srcAlphaFactor, dstA * dstAlphaFactor);
- * ```
- *
- * Where the functions `colorOperation(src, dst)` and `alphaOperation(src,
- * dst)` can return one of the following:
- *
- * - `src + dst`
- * - `src - dst`
- * - `dst - src`
- * - `min(src, dst)`
- * - `max(src, dst)`
- *
- * The red, green, and blue components are always multiplied with the first,
- * second, and third components of the SDL_BlendFactor, respectively. The
- * fourth component is not used.
- *
- * The alpha component is always multiplied with the fourth component of the
- * SDL_BlendFactor. The other components are not used in the alpha
- * calculation.
- *
- * Support for these blend modes varies for each renderer. To check if a
- * specific SDL_BlendMode is supported, create a renderer and pass it to
- * either SDL_SetRenderDrawBlendMode or SDL_SetTextureBlendMode. They will
- * return with an error if the blend mode is not supported.
- *
- * This list describes the support of custom blend modes for each renderer.
- * All renderers support the four blend modes listed in the SDL_BlendMode
- * enumeration.
- *
- * - **direct3d**: Supports all operations with all factors. However, some
- *   factors produce unexpected results with `SDL_BLENDOPERATION_MINIMUM` and
- *   `SDL_BLENDOPERATION_MAXIMUM`.
- * - **direct3d11**: Same as Direct3D 9.
- * - **opengl**: Supports the `SDL_BLENDOPERATION_ADD` operation with all
- *   factors. OpenGL versions 1.1, 1.2, and 1.3 do not work correctly here.
- * - **opengles2**: Supports the `SDL_BLENDOPERATION_ADD`,
- *   `SDL_BLENDOPERATION_SUBTRACT`, `SDL_BLENDOPERATION_REV_SUBTRACT`
- *   operations with all factors.
- * - **psp**: No custom blend mode support.
- * - **software**: No custom blend mode support.
- *
- * Some renderers do not provide an alpha component for the default render
- * target. The `SDL_BLENDFACTOR_DST_ALPHA` and
- * `SDL_BLENDFACTOR_ONE_MINUS_DST_ALPHA` factors do not have an effect in this
- * case.
- *
- * \param srcColorFactor the SDL_BlendFactor applied to the red, green, and
- *                       blue components of the source pixels.
- * \param dstColorFactor the SDL_BlendFactor applied to the red, green, and
- *                       blue components of the destination pixels.
- * \param colorOperation the SDL_BlendOperation used to combine the red,
- *                       green, and blue components of the source and
- *                       destination pixels.
- * \param srcAlphaFactor the SDL_BlendFactor applied to the alpha component of
- *                       the source pixels.
- * \param dstAlphaFactor the SDL_BlendFactor applied to the alpha component of
- *                       the destination pixels.
- * \param alphaOperation the SDL_BlendOperation used to combine the alpha
- *                       component of the source and destination pixels.
- * \returns an SDL_BlendMode that represents the chosen factors and
- *          operations.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetRenderDrawBlendMode
- * \sa SDL_GetRenderDrawBlendMode
- * \sa SDL_SetTextureBlendMode
- * \sa SDL_GetTextureBlendMode
- */
-extern SDL_DECLSPEC SDL_BlendMode SDLCALL SDL_ComposeCustomBlendMode(SDL_BlendFactor srcColorFactor,
-                                                                 SDL_BlendFactor dstColorFactor,
-                                                                 SDL_BlendOperation colorOperation,
-                                                                 SDL_BlendFactor srcAlphaFactor,
-                                                                 SDL_BlendFactor dstAlphaFactor,
-                                                                 SDL_BlendOperation alphaOperation);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_blendmode_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_camera.h

@@ -1,519 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryCamera
- *
- * Video capture for the SDL library.
- *
- * This API lets apps read input from video sources, like webcams. Camera
- * devices can be enumerated, queried, and opened. Once opened, it will
- * provide SDL_Surface objects as new frames of video come in. These surfaces
- * can be uploaded to an SDL_Texture or processed as pixels in memory.
- *
- * Several platforms will alert the user if an app tries to access a camera,
- * and some will present a UI asking the user if your application should be
- * allowed to obtain images at all, which they can deny. A successfully opened
- * camera will not provide images until permission is granted. Applications,
- * after opening a camera device, can see if they were granted access by
- * either polling with the SDL_GetCameraPermissionState() function, or waiting
- * for an SDL_EVENT_CAMERA_DEVICE_APPROVED or SDL_EVENT_CAMERA_DEVICE_DENIED
- * event. Platforms that don't have any user approval process will report
- * approval immediately.
- *
- * Note that SDL cameras only provide video as individual frames; they will
- * not provide full-motion video encoded in a movie file format, although an
- * app is free to encode the acquired frames into any format it likes. It also
- * does not provide audio from the camera hardware through this API; not only
- * do many webcams not have microphones at all, many people--from streamers to
- * people on Zoom calls--will want to use a separate microphone regardless of
- * the camera. In any case, recorded audio will be available through SDL's
- * audio API no matter what hardware provides the microphone.
- *
- * ## Camera gotchas
- *
- * Consumer-level camera hardware tends to take a little while to warm up,
- * once the device has been opened. Generally most camera apps have some sort
- * of UI to take a picture (a button to snap a pic while a preview is showing,
- * some sort of multi-second countdown for the user to pose, like a photo
- * booth), which puts control in the users' hands, or they are intended to
- * stay on for long times (Pokemon Go, etc).
- *
- * It's not uncommon that a newly-opened camera will provide a couple of
- * completely black frames, maybe followed by some under-exposed images. If
- * taking a single frame automatically, or recording video from a camera's
- * input without the user initiating it from a preview, it could be wise to
- * drop the first several frames (if not the first several _seconds_ worth of
- * frames!) before using images from a camera.
- */
-
-#ifndef SDL_camera_h_
-#define SDL_camera_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_pixels.h>
-#include <SDL3/SDL_properties.h>
-#include <SDL3/SDL_surface.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * This is a unique ID for a camera device for the time it is connected to the
- * system, and is never reused for the lifetime of the application.
- *
- * If the device is disconnected and reconnected, it will get a new ID.
- *
- * The value 0 is an invalid ID.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_GetCameras
- */
-typedef Uint32 SDL_CameraID;
-
-/**
- * The opaque structure used to identify an opened SDL camera.
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_Camera SDL_Camera;
-
-/**
- * The details of an output format for a camera device.
- *
- * Cameras often support multiple formats; each one will be encapsulated in
- * this struct.
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_GetCameraSupportedFormats
- * \sa SDL_GetCameraFormat
- */
-typedef struct SDL_CameraSpec
-{
-    SDL_PixelFormat format;     /**< Frame format */
-    SDL_Colorspace colorspace;  /**< Frame colorspace */
-    int width;                  /**< Frame width */
-    int height;                 /**< Frame height */
-    int framerate_numerator;     /**< Frame rate numerator ((num / denom) == FPS, (denom / num) == duration in seconds) */
-    int framerate_denominator;   /**< Frame rate denominator ((num / denom) == FPS, (denom / num) == duration in seconds) */
-} SDL_CameraSpec;
-
-/**
- * The position of camera in relation to system device.
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_GetCameraPosition
- */
-typedef enum SDL_CameraPosition
-{
-    SDL_CAMERA_POSITION_UNKNOWN,
-    SDL_CAMERA_POSITION_FRONT_FACING,
-    SDL_CAMERA_POSITION_BACK_FACING
-} SDL_CameraPosition;
-
-
-/**
- * Use this function to get the number of built-in camera drivers.
- *
- * This function returns a hardcoded number. This never returns a negative
- * value; if there are no drivers compiled into this build of SDL, this
- * function returns zero. The presence of a driver in this list does not mean
- * it will function, it just means SDL is capable of interacting with that
- * interface. For example, a build of SDL might have v4l2 support, but if
- * there's no kernel support available, SDL's v4l2 driver would fail if used.
- *
- * By default, SDL tries all drivers, in its preferred order, until one is
- * found to be usable.
- *
- * \returns the number of built-in camera drivers.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetCameraDriver
- */
-extern SDL_DECLSPEC int SDLCALL SDL_GetNumCameraDrivers(void);
-
-/**
- * Use this function to get the name of a built in camera driver.
- *
- * The list of camera drivers is given in the order that they are normally
- * initialized by default; the drivers that seem more reasonable to choose
- * first (as far as the SDL developers believe) are earlier in the list.
- *
- * The names of drivers are all simple, low-ASCII identifiers, like "v4l2",
- * "coremedia" or "android". These never have Unicode characters, and are not
- * meant to be proper names.
- *
- * \param index the index of the camera driver; the value ranges from 0 to
- *              SDL_GetNumCameraDrivers() - 1.
- * \returns the name of the camera driver at the requested index, or NULL if
- *          an invalid index was specified.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetNumCameraDrivers
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetCameraDriver(int index);
-
-/**
- * Get the name of the current camera driver.
- *
- * The names of drivers are all simple, low-ASCII identifiers, like "v4l2",
- * "coremedia" or "android". These never have Unicode characters, and are not
- * meant to be proper names.
- *
- * \returns the name of the current camera driver or NULL if no driver has
- *          been initialized.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetCurrentCameraDriver(void);
-
-/**
- * Get a list of currently connected camera devices.
- *
- * \param count a pointer filled in with the number of cameras returned, may
- *              be NULL.
- * \returns a 0 terminated array of camera instance IDs or NULL on failure;
- *          call SDL_GetError() for more information. This should be freed
- *          with SDL_free() when it is no longer needed.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_OpenCamera
- */
-extern SDL_DECLSPEC SDL_CameraID * SDLCALL SDL_GetCameras(int *count);
-
-/**
- * Get the list of native formats/sizes a camera supports.
- *
- * This returns a list of all formats and frame sizes that a specific camera
- * can offer. This is useful if your app can accept a variety of image formats
- * and sizes and so want to find the optimal spec that doesn't require
- * conversion.
- *
- * This function isn't strictly required; if you call SDL_OpenCamera with a
- * NULL spec, SDL will choose a native format for you, and if you instead
- * specify a desired format, it will transparently convert to the requested
- * format on your behalf.
- *
- * If `count` is not NULL, it will be filled with the number of elements in
- * the returned array.
- *
- * Note that it's legal for a camera to supply an empty list. This is what
- * will happen on Emscripten builds, since that platform won't tell _anything_
- * about available cameras until you've opened one, and won't even tell if
- * there _is_ a camera until the user has given you permission to check
- * through a scary warning popup.
- *
- * \param instance_id the camera device instance ID.
- * \param count a pointer filled in with the number of elements in the list,
- *              may be NULL.
- * \returns a NULL terminated array of pointers to SDL_CameraSpec or NULL on
- *          failure; call SDL_GetError() for more information. This is a
- *          single allocation that should be freed with SDL_free() when it is
- *          no longer needed.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetCameras
- * \sa SDL_OpenCamera
- */
-extern SDL_DECLSPEC SDL_CameraSpec ** SDLCALL SDL_GetCameraSupportedFormats(SDL_CameraID instance_id, int *count);
-
-/**
- * Get the human-readable device name for a camera.
- *
- * \param instance_id the camera device instance ID.
- * \returns a human-readable device name or NULL on failure; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetCameras
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetCameraName(SDL_CameraID instance_id);
-
-/**
- * Get the position of the camera in relation to the system.
- *
- * Most platforms will report UNKNOWN, but mobile devices, like phones, can
- * often make a distinction between cameras on the front of the device (that
- * points towards the user, for taking "selfies") and cameras on the back (for
- * filming in the direction the user is facing).
- *
- * \param instance_id the camera device instance ID.
- * \returns the position of the camera on the system hardware.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetCameras
- */
-extern SDL_DECLSPEC SDL_CameraPosition SDLCALL SDL_GetCameraPosition(SDL_CameraID instance_id);
-
-/**
- * Open a video recording device (a "camera").
- *
- * You can open the device with any reasonable spec, and if the hardware can't
- * directly support it, it will convert data seamlessly to the requested
- * format. This might incur overhead, including scaling of image data.
- *
- * If you would rather accept whatever format the device offers, you can pass
- * a NULL spec here and it will choose one for you (and you can use
- * SDL_Surface's conversion/scaling functions directly if necessary).
- *
- * You can call SDL_GetCameraFormat() to get the actual data format if passing
- * a NULL spec here. You can see the exact specs a device can support without
- * conversion with SDL_GetCameraSupportedFormats().
- *
- * SDL will not attempt to emulate framerate; it will try to set the hardware
- * to the rate closest to the requested speed, but it won't attempt to limit
- * or duplicate frames artificially; call SDL_GetCameraFormat() to see the
- * actual framerate of the opened the device, and check your timestamps if
- * this is crucial to your app!
- *
- * Note that the camera is not usable until the user approves its use! On some
- * platforms, the operating system will prompt the user to permit access to
- * the camera, and they can choose Yes or No at that point. Until they do, the
- * camera will not be usable. The app should either wait for an
- * SDL_EVENT_CAMERA_DEVICE_APPROVED (or SDL_EVENT_CAMERA_DEVICE_DENIED) event,
- * or poll SDL_GetCameraPermissionState() occasionally until it returns
- * non-zero. On platforms that don't require explicit user approval (and
- * perhaps in places where the user previously permitted access), the approval
- * event might come immediately, but it might come seconds, minutes, or hours
- * later!
- *
- * \param instance_id the camera device instance ID.
- * \param spec the desired format for data the device will provide. Can be
- *             NULL.
- * \returns an SDL_Camera object or NULL on failure; call SDL_GetError() for
- *          more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetCameras
- * \sa SDL_GetCameraFormat
- */
-extern SDL_DECLSPEC SDL_Camera * SDLCALL SDL_OpenCamera(SDL_CameraID instance_id, const SDL_CameraSpec *spec);
-
-/**
- * Query if camera access has been approved by the user.
- *
- * Cameras will not function between when the device is opened by the app and
- * when the user permits access to the hardware. On some platforms, this
- * presents as a popup dialog where the user has to explicitly approve access;
- * on others the approval might be implicit and not alert the user at all.
- *
- * This function can be used to check the status of that approval. It will
- * return 0 if still waiting for user response, 1 if the camera is approved
- * for use, and -1 if the user denied access.
- *
- * Instead of polling with this function, you can wait for a
- * SDL_EVENT_CAMERA_DEVICE_APPROVED (or SDL_EVENT_CAMERA_DEVICE_DENIED) event
- * in the standard SDL event loop, which is guaranteed to be sent once when
- * permission to use the camera is decided.
- *
- * If a camera is declined, there's nothing to be done but call
- * SDL_CloseCamera() to dispose of it.
- *
- * \param camera the opened camera device to query.
- * \returns -1 if user denied access to the camera, 1 if user approved access,
- *          0 if no decision has been made yet.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_OpenCamera
- * \sa SDL_CloseCamera
- */
-extern SDL_DECLSPEC int SDLCALL SDL_GetCameraPermissionState(SDL_Camera *camera);
-
-/**
- * Get the instance ID of an opened camera.
- *
- * \param camera an SDL_Camera to query.
- * \returns the instance ID of the specified camera on success or 0 on
- *          failure; call SDL_GetError() for more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_OpenCamera
- */
-extern SDL_DECLSPEC SDL_CameraID SDLCALL SDL_GetCameraID(SDL_Camera *camera);
-
-/**
- * Get the properties associated with an opened camera.
- *
- * \param camera the SDL_Camera obtained from SDL_OpenCamera().
- * \returns a valid property ID on success or 0 on failure; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_PropertiesID SDLCALL SDL_GetCameraProperties(SDL_Camera *camera);
-
-/**
- * Get the spec that a camera is using when generating images.
- *
- * Note that this might not be the native format of the hardware, as SDL might
- * be converting to this format behind the scenes.
- *
- * If the system is waiting for the user to approve access to the camera, as
- * some platforms require, this will return false, but this isn't necessarily
- * a fatal error; you should either wait for an
- * SDL_EVENT_CAMERA_DEVICE_APPROVED (or SDL_EVENT_CAMERA_DEVICE_DENIED) event,
- * or poll SDL_GetCameraPermissionState() occasionally until it returns
- * non-zero.
- *
- * \param camera opened camera device.
- * \param spec the SDL_CameraSpec to be initialized by this function.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_OpenCamera
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetCameraFormat(SDL_Camera *camera, SDL_CameraSpec *spec);
-
-/**
- * Acquire a frame.
- *
- * The frame is a memory pointer to the image data, whose size and format are
- * given by the spec requested when opening the device.
- *
- * This is a non blocking API. If there is a frame available, a non-NULL
- * surface is returned, and timestampNS will be filled with a non-zero value.
- *
- * Note that an error case can also return NULL, but a NULL by itself is
- * normal and just signifies that a new frame is not yet available. Note that
- * even if a camera device fails outright (a USB camera is unplugged while in
- * use, etc), SDL will send an event separately to notify the app, but
- * continue to provide blank frames at ongoing intervals until
- * SDL_CloseCamera() is called, so real failure here is almost always an out
- * of memory condition.
- *
- * After use, the frame should be released with SDL_ReleaseCameraFrame(). If
- * you don't do this, the system may stop providing more video!
- *
- * Do not call SDL_DestroySurface() on the returned surface! It must be given
- * back to the camera subsystem with SDL_ReleaseCameraFrame!
- *
- * If the system is waiting for the user to approve access to the camera, as
- * some platforms require, this will return NULL (no frames available); you
- * should either wait for an SDL_EVENT_CAMERA_DEVICE_APPROVED (or
- * SDL_EVENT_CAMERA_DEVICE_DENIED) event, or poll
- * SDL_GetCameraPermissionState() occasionally until it returns non-zero.
- *
- * \param camera opened camera device.
- * \param timestampNS a pointer filled in with the frame's timestamp, or 0 on
- *                    error. Can be NULL.
- * \returns a new frame of video on success, NULL if none is currently
- *          available.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ReleaseCameraFrame
- */
-extern SDL_DECLSPEC SDL_Surface * SDLCALL SDL_AcquireCameraFrame(SDL_Camera *camera, Uint64 *timestampNS);
-
-/**
- * Release a frame of video acquired from a camera.
- *
- * Let the back-end re-use the internal buffer for camera.
- *
- * This function _must_ be called only on surface objects returned by
- * SDL_AcquireCameraFrame(). This function should be called as quickly as
- * possible after acquisition, as SDL keeps a small FIFO queue of surfaces for
- * video frames; if surfaces aren't released in a timely manner, SDL may drop
- * upcoming video frames from the camera.
- *
- * If the app needs to keep the surface for a significant time, they should
- * make a copy of it and release the original.
- *
- * The app should not use the surface again after calling this function;
- * assume the surface is freed and the pointer is invalid.
- *
- * \param camera opened camera device.
- * \param frame the video frame surface to release.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_AcquireCameraFrame
- */
-extern SDL_DECLSPEC void SDLCALL SDL_ReleaseCameraFrame(SDL_Camera *camera, SDL_Surface *frame);
-
-/**
- * Use this function to shut down camera processing and close the camera
- * device.
- *
- * \param camera opened camera device.
- *
- * \threadsafety It is safe to call this function from any thread, but no
- *               thread may reference `device` once this function is called.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_OpenCamera
- */
-extern SDL_DECLSPEC void SDLCALL SDL_CloseCamera(SDL_Camera *camera);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_camera_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_clipboard.h

@@ -1,330 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryClipboard
- *
- * SDL provides access to the system clipboard, both for reading information
- * from other processes and publishing information of its own.
- *
- * This is not just text! SDL apps can access and publish data by mimetype.
- *
- * ## Basic use (text)
- *
- * Obtaining and publishing simple text to the system clipboard is as easy as
- * calling SDL_GetClipboardText() and SDL_SetClipboardText(), respectively.
- * These deal with C strings in UTF-8 encoding. Data transmission and encoding
- * conversion is completely managed by SDL.
- *
- * ## Clipboard callbacks (data other than text)
- *
- * Things get more complicated when the clipboard contains something other
- * than text. Not only can the system clipboard contain data of any type, in
- * some cases it can contain the same data in different formats! For example,
- * an image painting app might let the user copy a graphic to the clipboard,
- * and offers it in .BMP, .JPG, or .PNG format for other apps to consume.
- *
- * Obtaining clipboard data ("pasting") like this is a matter of calling
- * SDL_GetClipboardData() and telling it the mimetype of the data you want.
- * But how does one know if that format is available? SDL_HasClipboardData()
- * can report if a specific mimetype is offered, and
- * SDL_GetClipboardMimeTypes() can provide the entire list of mimetypes
- * available, so the app can decide what to do with the data and what formats
- * it can support.
- *
- * Setting the clipboard ("copying") to arbitrary data is done with
- * SDL_SetClipboardData. The app does not provide the data in this call, but
- * rather the mimetypes it is willing to provide and a callback function.
- * During the callback, the app will generate the data. This allows massive
- * data sets to be provided to the clipboard, without any data being copied
- * before it is explicitly requested. More specifically, it allows an app to
- * offer data in multiple formats without providing a copy of all of them
- * upfront. If the app has an image that it could provide in PNG or JPG
- * format, it doesn't have to encode it to either of those unless and until
- * something tries to paste it.
- *
- * ## Primary Selection
- *
- * The X11 and Wayland video targets have a concept of the "primary selection"
- * in addition to the usual clipboard. This is generally highlighted (but not
- * explicitly copied) text from various apps. SDL offers APIs for this through
- * SDL_GetPrimarySelectionText() and SDL_SetPrimarySelectionText(). SDL offers
- * these APIs on platforms without this concept, too, but only so far that it
- * will keep a copy of a string that the app sets for later retrieval; the
- * operating system will not ever attempt to change the string externally if
- * it doesn't support a primary selection.
- */
-
-#ifndef SDL_clipboard_h_
-#define SDL_clipboard_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* Function prototypes */
-
-/**
- * Put UTF-8 text into the clipboard.
- *
- * \param text the text to store in the clipboard.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetClipboardText
- * \sa SDL_HasClipboardText
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetClipboardText(const char *text);
-
-/**
- * Get UTF-8 text from the clipboard.
- *
- * This function returns an empty string if there is not enough memory left
- * for a copy of the clipboard's content.
- *
- * \returns the clipboard text on success or an empty string on failure; call
- *          SDL_GetError() for more information. This should be freed with
- *          SDL_free() when it is no longer needed.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasClipboardText
- * \sa SDL_SetClipboardText
- */
-extern SDL_DECLSPEC char * SDLCALL SDL_GetClipboardText(void);
-
-/**
- * Query whether the clipboard exists and contains a non-empty text string.
- *
- * \returns true if the clipboard has text, or false if it does not.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetClipboardText
- * \sa SDL_SetClipboardText
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasClipboardText(void);
-
-/**
- * Put UTF-8 text into the primary selection.
- *
- * \param text the text to store in the primary selection.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPrimarySelectionText
- * \sa SDL_HasPrimarySelectionText
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetPrimarySelectionText(const char *text);
-
-/**
- * Get UTF-8 text from the primary selection.
- *
- * This function returns an empty string if there is not enough memory left
- * for a copy of the primary selection's content.
- *
- * \returns the primary selection text on success or an empty string on
- *          failure; call SDL_GetError() for more information. This should be
- *          freed with SDL_free() when it is no longer needed.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasPrimarySelectionText
- * \sa SDL_SetPrimarySelectionText
- */
-extern SDL_DECLSPEC char * SDLCALL SDL_GetPrimarySelectionText(void);
-
-/**
- * Query whether the primary selection exists and contains a non-empty text
- * string.
- *
- * \returns true if the primary selection has text, or false if it does not.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPrimarySelectionText
- * \sa SDL_SetPrimarySelectionText
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasPrimarySelectionText(void);
-
-/**
- * Callback function that will be called when data for the specified mime-type
- * is requested by the OS.
- *
- * The callback function is called with NULL as the mime_type when the
- * clipboard is cleared or new data is set. The clipboard is automatically
- * cleared in SDL_Quit().
- *
- * \param userdata a pointer to the provided user data.
- * \param mime_type the requested mime-type.
- * \param size a pointer filled in with the length of the returned data.
- * \returns a pointer to the data for the provided mime-type. Returning NULL
- *          or setting the length to 0 will cause zero length data to be sent
- *          to the "receiver", which should be able to handle this. The
- *          returned data will not be freed, so it needs to be retained and
- *          dealt with internally.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetClipboardData
- */
-typedef const void *(SDLCALL *SDL_ClipboardDataCallback)(void *userdata, const char *mime_type, size_t *size);
-
-/**
- * Callback function that will be called when the clipboard is cleared, or when new
- * data is set.
- *
- * \param userdata a pointer to the provided user data.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetClipboardData
- */
-typedef void (SDLCALL *SDL_ClipboardCleanupCallback)(void *userdata);
-
-/**
- * Offer clipboard data to the OS.
- *
- * Tell the operating system that the application is offering clipboard data
- * for each of the provided mime-types. Once another application requests the
- * data the callback function will be called, allowing it to generate and
- * respond with the data for the requested mime-type.
- *
- * The size of text data does not include any terminator, and the text does
- * not need to be null-terminated (e.g., you can directly copy a portion of a
- * document).
- *
- * \param callback a function pointer to the function that provides the
- *                 clipboard data.
- * \param cleanup a function pointer to the function that cleans up the
- *                clipboard data.
- * \param userdata an opaque pointer that will be forwarded to the callbacks.
- * \param mime_types a list of mime-types that are being offered. SDL copies the given list.
- * \param num_mime_types the number of mime-types in the mime_types list.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ClearClipboardData
- * \sa SDL_GetClipboardData
- * \sa SDL_HasClipboardData
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetClipboardData(SDL_ClipboardDataCallback callback, SDL_ClipboardCleanupCallback cleanup, void *userdata, const char **mime_types, size_t num_mime_types);
-
-/**
- * Clear the clipboard data.
- *
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetClipboardData
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ClearClipboardData(void);
-
-/**
- * Get the data from the clipboard for a given mime type.
- *
- * The size of text data does not include the terminator, but the text is
- * guaranteed to be null-terminated.
- *
- * \param mime_type the mime type to read from the clipboard.
- * \param size a pointer filled in with the length of the returned data.
- * \returns the retrieved data buffer or NULL on failure; call SDL_GetError()
- *          for more information. This should be freed with SDL_free() when it
- *          is no longer needed.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasClipboardData
- * \sa SDL_SetClipboardData
- */
-extern SDL_DECLSPEC void * SDLCALL SDL_GetClipboardData(const char *mime_type, size_t *size);
-
-/**
- * Query whether there is data in the clipboard for the provided mime type.
- *
- * \param mime_type the mime type to check for data.
- * \returns true if data exists in the clipboard for the provided mime type,
- *          false if it does not.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetClipboardData
- * \sa SDL_GetClipboardData
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasClipboardData(const char *mime_type);
-
-/**
- * Retrieve the list of mime types available in the clipboard.
- *
- * \param num_mime_types a pointer filled with the number of mime types, may
- *                       be NULL.
- * \returns a null-terminated array of strings with mime types, or NULL on
- *          failure; call SDL_GetError() for more information. This should be
- *          freed with SDL_free() when it is no longer needed.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetClipboardData
- */
-extern SDL_DECLSPEC char ** SDLCALL SDL_GetClipboardMimeTypes(size_t *num_mime_types);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_clipboard_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_close_code.h

@@ -1,41 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/*
- * This file reverses the effects of SDL_begin_code.h and should be included
- * after you finish any function and structure declarations in your headers.
- *
- * SDL's headers use this; applications generally should not include this
- * header directly.
- */
-
-#ifndef SDL_begin_code_h
-#error SDL_close_code.h included without matching SDL_begin_code.h
-#endif
-#undef SDL_begin_code_h
-
-/* Reset structure packing at previous byte alignment */
-#if defined(_MSC_VER) || defined(__MWERKS__) || defined(__BORLANDC__)
-#ifdef __BORLANDC__
-#pragma nopackwarning
-#endif
-#pragma pack(pop)
-#endif /* Compiler needs structure packing set */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_copying.h

@@ -1,22 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* Header file containing SDL's license. */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_cpuinfo.h

@@ -1,353 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: CPUInfo */
-
-/**
- * # CategoryCPUInfo
- *
- * CPU feature detection for SDL.
- *
- * These functions are largely concerned with reporting if the system has
- * access to various SIMD instruction sets, but also has other important info
- * to share, such as system RAM size and number of logical CPU cores.
- *
- * CPU instruction set checks, like SDL_HasSSE() and SDL_HasNEON(), are
- * available on all platforms, even if they don't make sense (an ARM processor
- * will never have SSE and an x86 processor will never have NEON, for example,
- * but these functions still exist and will simply return false in these
- * cases).
- */
-
-#ifndef SDL_cpuinfo_h_
-#define SDL_cpuinfo_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * A guess for the cacheline size used for padding.
- *
- * Most x86 processors have a 64 byte cache line. The 64-bit PowerPC
- * processors have a 128 byte cache line. We use the larger value to be
- * generally safe.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_CACHELINE_SIZE  128
-
-/**
- * Get the number of logical CPU cores available.
- *
- * \returns the total number of logical CPU cores. On CPUs that include
- *          technologies such as hyperthreading, the number of logical cores
- *          may be more than the number of physical cores.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_GetNumLogicalCPUCores(void);
-
-/**
- * Determine the L1 cache line size of the CPU.
- *
- * This is useful for determining multi-threaded structure padding or SIMD
- * prefetch sizes.
- *
- * \returns the L1 cache line size of the CPU, in bytes.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_GetCPUCacheLineSize(void);
-
-/**
- * Determine whether the CPU has AltiVec features.
- *
- * This always returns false on CPUs that aren't using PowerPC instruction
- * sets.
- *
- * \returns true if the CPU has AltiVec features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasAltiVec(void);
-
-/**
- * Determine whether the CPU has MMX features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has MMX features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasMMX(void);
-
-/**
- * Determine whether the CPU has SSE features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has SSE features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasSSE2
- * \sa SDL_HasSSE3
- * \sa SDL_HasSSE41
- * \sa SDL_HasSSE42
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasSSE(void);
-
-/**
- * Determine whether the CPU has SSE2 features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has SSE2 features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasSSE
- * \sa SDL_HasSSE3
- * \sa SDL_HasSSE41
- * \sa SDL_HasSSE42
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasSSE2(void);
-
-/**
- * Determine whether the CPU has SSE3 features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has SSE3 features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasSSE
- * \sa SDL_HasSSE2
- * \sa SDL_HasSSE41
- * \sa SDL_HasSSE42
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasSSE3(void);
-
-/**
- * Determine whether the CPU has SSE4.1 features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has SSE4.1 features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasSSE
- * \sa SDL_HasSSE2
- * \sa SDL_HasSSE3
- * \sa SDL_HasSSE42
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasSSE41(void);
-
-/**
- * Determine whether the CPU has SSE4.2 features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has SSE4.2 features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasSSE
- * \sa SDL_HasSSE2
- * \sa SDL_HasSSE3
- * \sa SDL_HasSSE41
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasSSE42(void);
-
-/**
- * Determine whether the CPU has AVX features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has AVX features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasAVX2
- * \sa SDL_HasAVX512F
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasAVX(void);
-
-/**
- * Determine whether the CPU has AVX2 features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has AVX2 features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasAVX
- * \sa SDL_HasAVX512F
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasAVX2(void);
-
-/**
- * Determine whether the CPU has AVX-512F (foundation) features.
- *
- * This always returns false on CPUs that aren't using Intel instruction sets.
- *
- * \returns true if the CPU has AVX-512F features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasAVX
- * \sa SDL_HasAVX2
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasAVX512F(void);
-
-/**
- * Determine whether the CPU has ARM SIMD (ARMv6) features.
- *
- * This is different from ARM NEON, which is a different instruction set.
- *
- * This always returns false on CPUs that aren't using ARM instruction sets.
- *
- * \returns true if the CPU has ARM SIMD features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasNEON
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasARMSIMD(void);
-
-/**
- * Determine whether the CPU has NEON (ARM SIMD) features.
- *
- * This always returns false on CPUs that aren't using ARM instruction sets.
- *
- * \returns true if the CPU has ARM NEON features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasNEON(void);
-
-/**
- * Determine whether the CPU has LSX (LOONGARCH SIMD) features.
- *
- * This always returns false on CPUs that aren't using LOONGARCH instruction
- * sets.
- *
- * \returns true if the CPU has LOONGARCH LSX features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasLSX(void);
-
-/**
- * Determine whether the CPU has LASX (LOONGARCH SIMD) features.
- *
- * This always returns false on CPUs that aren't using LOONGARCH instruction
- * sets.
- *
- * \returns true if the CPU has LOONGARCH LASX features or false if not.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasLASX(void);
-
-/**
- * Get the amount of RAM configured in the system.
- *
- * \returns the amount of RAM configured in the system in MiB.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_GetSystemRAM(void);
-
-/**
- * Report the alignment this system needs for SIMD allocations.
- *
- * This will return the minimum number of bytes to which a pointer must be
- * aligned to be compatible with SIMD instructions on the current machine. For
- * example, if the machine supports SSE only, it will return 16, but if it
- * supports AVX-512F, it'll return 64 (etc). This only reports values for
- * instruction sets SDL knows about, so if your SDL build doesn't have
- * SDL_HasAVX512F(), then it might return 16 for the SSE support it sees and
- * not 64 for the AVX-512 instructions that exist but SDL doesn't know about.
- * Plan accordingly.
- *
- * \returns the alignment in bytes needed for available, known SIMD
- *          instructions.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_aligned_alloc
- * \sa SDL_aligned_free
- */
-extern SDL_DECLSPEC size_t SDLCALL SDL_GetSIMDAlignment(void);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_cpuinfo_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_dialog.h

@@ -1,341 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryDialog
- *
- * File dialog support.
- *
- * SDL offers file dialogs, to let users select files with native GUI
- * interfaces. There are "open" dialogs, "save" dialogs, and folder selection
- * dialogs. The app can control some details, such as filtering to specific
- * files, or whether multiple files can be selected by the user.
- *
- * Note that launching a file dialog is a non-blocking operation; control
- * returns to the app immediately, and a callback is called later (possibly in
- * another thread) when the user makes a choice.
- */
-
-#ifndef SDL_dialog_h_
-#define SDL_dialog_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_properties.h>
-#include <SDL3/SDL_video.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * An entry for filters for file dialogs.
- *
- * `name` is a user-readable label for the filter (for example, "Office
- * document").
- *
- * `pattern` is a semicolon-separated list of file extensions (for example,
- * "doc;docx"). File extensions may only contain alphanumeric characters,
- * hyphens, underscores and periods. Alternatively, the whole string can be a
- * single asterisk ("*"), which serves as an "All files" filter.
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_DialogFileCallback
- * \sa SDL_ShowOpenFileDialog
- * \sa SDL_ShowSaveFileDialog
- * \sa SDL_ShowOpenFolderDialog
- * \sa SDL_ShowFileDialogWithProperties
- */
-typedef struct SDL_DialogFileFilter
-{
-    const char *name;
-    const char *pattern;
-} SDL_DialogFileFilter;
-
-/**
- * Callback used by file dialog functions.
- *
- * The specific usage is described in each function.
- *
- * If `filelist` is:
- *
- * - NULL, an error occurred. Details can be obtained with SDL_GetError().
- * - A pointer to NULL, the user either didn't choose any file or canceled the
- *   dialog.
- * - A pointer to non-`NULL`, the user chose one or more files. The argument
- *   is a null-terminated array of pointers to UTF-8 encoded strings, each
- *   containing a path.
- *
- * The filelist argument should not be freed; it will automatically be freed
- * when the callback returns.
- *
- * The filter argument is the index of the filter that was selected, or -1 if
- * no filter was selected or if the platform or method doesn't support
- * fetching the selected filter.
- *
- * In Android, the `filelist` are `content://` URIs. They should be opened
- * using SDL_IOFromFile() with appropriate modes. This applies both to open
- * and save file dialog.
- *
- * \param userdata an app-provided pointer, for the callback's use.
- * \param filelist the file(s) chosen by the user.
- * \param filter index of the selected filter.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_DialogFileFilter
- * \sa SDL_ShowOpenFileDialog
- * \sa SDL_ShowSaveFileDialog
- * \sa SDL_ShowOpenFolderDialog
- * \sa SDL_ShowFileDialogWithProperties
- */
-typedef void (SDLCALL *SDL_DialogFileCallback)(void *userdata, const char * const *filelist, int filter);
-
-/**
- * Displays a dialog that lets the user select a file on their filesystem.
- *
- * This is an asynchronous function; it will return immediately, and the
- * result will be passed to the callback.
- *
- * The callback will be invoked with a null-terminated list of files the user
- * chose. The list will be empty if the user canceled the dialog, and it will
- * be NULL if an error occurred.
- *
- * Note that the callback may be called from a different thread than the one
- * the function was invoked on.
- *
- * Depending on the platform, the user may be allowed to input paths that
- * don't yet exist.
- *
- * On Linux, dialogs may require XDG Portals, which requires DBus, which
- * requires an event-handling loop. Apps that do not use SDL to handle events
- * should add a call to SDL_PumpEvents in their main loop.
- *
- * \param callback a function pointer to be invoked when the user selects a
- *                 file and accepts, or cancels the dialog, or an error
- *                 occurs.
- * \param userdata an optional pointer to pass extra data to the callback when
- *                 it will be invoked.
- * \param window the window that the dialog should be modal for, may be NULL.
- *               Not all platforms support this option.
- * \param filters a list of filters, may be NULL. Not all platforms support
- *                this option, and platforms that do support it may allow the
- *                user to ignore the filters. If non-NULL, it must remain
- *                valid at least until the callback is invoked.
- * \param nfilters the number of filters. Ignored if filters is NULL.
- * \param default_location the default folder or file to start the dialog at,
- *                         may be NULL. Not all platforms support this option.
- * \param allow_many if non-zero, the user will be allowed to select multiple
- *                   entries. Not all platforms support this option.
- *
- * \threadsafety This function should be called only from the main thread. The
- *               callback may be invoked from the same thread or from a
- *               different one, depending on the OS's constraints.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_DialogFileCallback
- * \sa SDL_DialogFileFilter
- * \sa SDL_ShowSaveFileDialog
- * \sa SDL_ShowOpenFolderDialog
- * \sa SDL_ShowFileDialogWithProperties
- */
-extern SDL_DECLSPEC void SDLCALL SDL_ShowOpenFileDialog(SDL_DialogFileCallback callback, void *userdata, SDL_Window *window, const SDL_DialogFileFilter *filters, int nfilters, const char *default_location, bool allow_many);
-
-/**
- * Displays a dialog that lets the user choose a new or existing file on their
- * filesystem.
- *
- * This is an asynchronous function; it will return immediately, and the
- * result will be passed to the callback.
- *
- * The callback will be invoked with a null-terminated list of files the user
- * chose. The list will be empty if the user canceled the dialog, and it will
- * be NULL if an error occurred.
- *
- * Note that the callback may be called from a different thread than the one
- * the function was invoked on.
- *
- * The chosen file may or may not already exist.
- *
- * On Linux, dialogs may require XDG Portals, which requires DBus, which
- * requires an event-handling loop. Apps that do not use SDL to handle events
- * should add a call to SDL_PumpEvents in their main loop.
- *
- * \param callback a function pointer to be invoked when the user selects a
- *                 file and accepts, or cancels the dialog, or an error
- *                 occurs.
- * \param userdata an optional pointer to pass extra data to the callback when
- *                 it will be invoked.
- * \param window the window that the dialog should be modal for, may be NULL.
- *               Not all platforms support this option.
- * \param filters a list of filters, may be NULL. Not all platforms support
- *                this option, and platforms that do support it may allow the
- *                user to ignore the filters. If non-NULL, it must remain
- *                valid at least until the callback is invoked.
- * \param nfilters the number of filters. Ignored if filters is NULL.
- * \param default_location the default folder or file to start the dialog at,
- *                         may be NULL. Not all platforms support this option.
- *
- * \threadsafety This function should be called only from the main thread. The
- *               callback may be invoked from the same thread or from a
- *               different one, depending on the OS's constraints.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_DialogFileCallback
- * \sa SDL_DialogFileFilter
- * \sa SDL_ShowOpenFileDialog
- * \sa SDL_ShowOpenFolderDialog
- * \sa SDL_ShowFileDialogWithProperties
- */
-extern SDL_DECLSPEC void SDLCALL SDL_ShowSaveFileDialog(SDL_DialogFileCallback callback, void *userdata, SDL_Window *window, const SDL_DialogFileFilter *filters, int nfilters, const char *default_location);
-
-/**
- * Displays a dialog that lets the user select a folder on their filesystem.
- *
- * This is an asynchronous function; it will return immediately, and the
- * result will be passed to the callback.
- *
- * The callback will be invoked with a null-terminated list of files the user
- * chose. The list will be empty if the user canceled the dialog, and it will
- * be NULL if an error occurred.
- *
- * Note that the callback may be called from a different thread than the one
- * the function was invoked on.
- *
- * Depending on the platform, the user may be allowed to input paths that
- * don't yet exist.
- *
- * On Linux, dialogs may require XDG Portals, which requires DBus, which
- * requires an event-handling loop. Apps that do not use SDL to handle events
- * should add a call to SDL_PumpEvents in their main loop.
- *
- * \param callback a function pointer to be invoked when the user selects a
- *                 file and accepts, or cancels the dialog, or an error
- *                 occurs.
- * \param userdata an optional pointer to pass extra data to the callback when
- *                 it will be invoked.
- * \param window the window that the dialog should be modal for, may be NULL.
- *               Not all platforms support this option.
- * \param default_location the default folder or file to start the dialog at,
- *                         may be NULL. Not all platforms support this option.
- * \param allow_many if non-zero, the user will be allowed to select multiple
- *                   entries. Not all platforms support this option.
- *
- * \threadsafety This function should be called only from the main thread. The
- *               callback may be invoked from the same thread or from a
- *               different one, depending on the OS's constraints.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_DialogFileCallback
- * \sa SDL_ShowOpenFileDialog
- * \sa SDL_ShowSaveFileDialog
- * \sa SDL_ShowFileDialogWithProperties
- */
-extern SDL_DECLSPEC void SDLCALL SDL_ShowOpenFolderDialog(SDL_DialogFileCallback callback, void *userdata, SDL_Window *window, const char *default_location, bool allow_many);
-
-/**
- * Various types of file dialogs.
- *
- * This is used by SDL_ShowFileDialogWithProperties() to decide what kind of
- * dialog to present to the user.
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_ShowFileDialogWithProperties
- */
-typedef enum SDL_FileDialogType
-{
-    SDL_FILEDIALOG_OPENFILE,
-    SDL_FILEDIALOG_SAVEFILE,
-    SDL_FILEDIALOG_OPENFOLDER
-} SDL_FileDialogType;
-
-/**
- * Create and launch a file dialog with the specified properties.
- *
- * These are the supported properties:
- *
- * - `SDL_PROP_FILE_DIALOG_FILTERS_POINTER`: a pointer to a list of
- *   SDL_DialogFileFilter structs, which will be used as filters for
- *   file-based selections. Ignored if the dialog is an "Open Folder" dialog.
- *   If non-NULL, the array of filters must remain valid at least until the
- *   callback is invoked.
- * - `SDL_PROP_FILE_DIALOG_NFILTERS_NUMBER`: the number of filters in the
- *   array of filters, if it exists.
- * - `SDL_PROP_FILE_DIALOG_WINDOW_POINTER`: the window that the dialog should
- *   be modal for.
- * - `SDL_PROP_FILE_DIALOG_LOCATION_STRING`: the default folder or file to
- *   start the dialog at.
- * - `SDL_PROP_FILE_DIALOG_MANY_BOOLEAN`: true to allow the user to select
- *   more than one entry.
- * - `SDL_PROP_FILE_DIALOG_TITLE_STRING`: the title for the dialog.
- * - `SDL_PROP_FILE_DIALOG_ACCEPT_STRING`: the label that the accept button
- *   should have.
- * - `SDL_PROP_FILE_DIALOG_CANCEL_STRING`: the label that the cancel button
- *   should have.
- *
- * Note that each platform may or may not support any of the properties.
- *
- * \param type the type of file dialog.
- * \param callback a function pointer to be invoked when the user selects a
- *                 file and accepts, or cancels the dialog, or an error
- *                 occurs.
- * \param userdata an optional pointer to pass extra data to the callback when
- *                 it will be invoked.
- * \param props the properties to use.
- *
- * \threadsafety This function should be called only from the main thread. The
- *               callback may be invoked from the same thread or from a
- *               different one, depending on the OS's constraints.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_FileDialogType
- * \sa SDL_DialogFileCallback
- * \sa SDL_DialogFileFilter
- * \sa SDL_ShowOpenFileDialog
- * \sa SDL_ShowSaveFileDialog
- * \sa SDL_ShowOpenFolderDialog
- */
-extern SDL_DECLSPEC void SDLCALL SDL_ShowFileDialogWithProperties(SDL_FileDialogType type, SDL_DialogFileCallback callback, void *userdata, SDL_PropertiesID props);
-
-#define SDL_PROP_FILE_DIALOG_FILTERS_POINTER     "SDL.filedialog.filters"
-#define SDL_PROP_FILE_DIALOG_NFILTERS_NUMBER     "SDL.filedialog.nfilters"
-#define SDL_PROP_FILE_DIALOG_WINDOW_POINTER      "SDL.filedialog.window"
-#define SDL_PROP_FILE_DIALOG_LOCATION_STRING     "SDL.filedialog.location"
-#define SDL_PROP_FILE_DIALOG_MANY_BOOLEAN        "SDL.filedialog.many"
-#define SDL_PROP_FILE_DIALOG_TITLE_STRING        "SDL.filedialog.title"
-#define SDL_PROP_FILE_DIALOG_ACCEPT_STRING       "SDL.filedialog.accept"
-#define SDL_PROP_FILE_DIALOG_CANCEL_STRING       "SDL.filedialog.cancel"
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_dialog_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_endian.h

@@ -1,645 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryEndian
- *
- * Functions converting endian-specific values to different byte orders.
- *
- * These functions either unconditionally swap byte order (SDL_Swap16,
- * SDL_Swap32, SDL_Swap64, SDL_SwapFloat), or they swap to/from the system's
- * native byte order (SDL_Swap16LE, SDL_Swap16BE, SDL_Swap32LE, SDL_Swap32BE,
- * SDL_Swap32LE, SDL_Swap32BE, SDL_SwapFloatLE, SDL_SwapFloatBE). In the
- * latter case, the functionality is provided by macros that become no-ops if
- * a swap isn't necessary: on an x86 (littleendian) processor, SDL_Swap32LE
- * does nothing, but SDL_Swap32BE reverses the bytes of the data. On a PowerPC
- * processor (bigendian), the macros behavior is reversed.
- *
- * The swap routines are inline functions, and attempt to use compiler
- * intrinsics, inline assembly, and other magic to make byteswapping
- * efficient.
- */
-
-#ifndef SDL_endian_h_
-#define SDL_endian_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#if defined(_MSC_VER) && (_MSC_VER >= 1400)
-/* As of Clang 11, '_m_prefetchw' is conflicting with the winnt.h's version,
-   so we define the needed '_m_prefetch' here as a pseudo-header, until the issue is fixed. */
-#if defined(__clang__) &&  !SDL_HAS_BUILTIN(_m_prefetch)
-#ifndef __PRFCHWINTRIN_H
-#define __PRFCHWINTRIN_H
-static __inline__ void __attribute__((__always_inline__, __nodebug__))
-_m_prefetch(void *__P)
-{
-  __builtin_prefetch(__P, 0, 3 /* _MM_HINT_T0 */);
-}
-#endif /* __PRFCHWINTRIN_H */
-#endif /* __clang__ */
-
-#include <intrin.h>
-#endif
-
-/**
- *  \name The two types of endianness
- */
-/* @{ */
-
-
-/**
- * A value to represent littleendian byteorder.
- *
- * This is used with the preprocessor macro SDL_BYTEORDER, to determine a
- * platform's byte ordering:
- *
- * ```c
- * #if SDL_BYTEORDER == SDL_LIL_ENDIAN
- * SDL_Log("This system is littleendian.");
- * #endif
- * ```
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_BYTEORDER
- * \sa SDL_BIG_ENDIAN
- */
-#define SDL_LIL_ENDIAN  1234
-
-/**
- * A value to represent bigendian byteorder.
- *
- * This is used with the preprocessor macro SDL_BYTEORDER, to determine a
- * platform's byte ordering:
- *
- * ```c
- * #if SDL_BYTEORDER == SDL_BIG_ENDIAN
- * SDL_Log("This system is bigendian.");
- * #endif
- * ```
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_BYTEORDER
- * \sa SDL_LIL_ENDIAN
- */
-#define SDL_BIG_ENDIAN  4321
-
-/* @} */
-
-#ifndef SDL_BYTEORDER
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A macro that reports the target system's byte order.
- *
- * This is set to either SDL_LIL_ENDIAN or SDL_BIG_ENDIAN (and maybe other
- * values in the future, if something else becomes popular). This can be
- * tested with the preprocessor, so decisions can be made at compile time.
- *
- * ```c
- * #if SDL_BYTEORDER == SDL_BIG_ENDIAN
- * SDL_Log("This system is bigendian.");
- * #endif
- * ```
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_LIL_ENDIAN
- * \sa SDL_BIG_ENDIAN
- */
-#define SDL_BYTEORDER   SDL_LIL_ENDIAN___or_maybe___SDL_BIG_ENDIAN
-#elif defined(SDL_PLATFORM_LINUX) || defined(__GLIBC__)
-#include <endian.h>
-#define SDL_BYTEORDER  __BYTE_ORDER
-#elif defined(SDL_PLATFORM_SOLARIS)
-#include <sys/byteorder.h>
-#if defined(_LITTLE_ENDIAN)
-#define SDL_BYTEORDER   SDL_LIL_ENDIAN
-#elif defined(_BIG_ENDIAN)
-#define SDL_BYTEORDER   SDL_BIG_ENDIAN
-#else
-#error Unsupported endianness
-#endif
-#elif defined(SDL_PLATFORM_OPENBSD) || defined(__DragonFly__)
-#include <endian.h>
-#define SDL_BYTEORDER  BYTE_ORDER
-#elif defined(SDL_PLATFORM_FREEBSD) || defined(SDL_PLATFORM_NETBSD)
-#include <sys/endian.h>
-#define SDL_BYTEORDER  BYTE_ORDER
-/* predefs from newer gcc and clang versions: */
-#elif defined(__ORDER_LITTLE_ENDIAN__) && defined(__ORDER_BIG_ENDIAN__) && defined(__BYTE_ORDER__)
-#if (__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__)
-#define SDL_BYTEORDER   SDL_LIL_ENDIAN
-#elif (__BYTE_ORDER__ == __ORDER_BIG_ENDIAN__)
-#define SDL_BYTEORDER   SDL_BIG_ENDIAN
-#else
-#error Unsupported endianness
-#endif /**/
-#else
-#if defined(__hppa__) || \
-    defined(__m68k__) || defined(mc68000) || defined(_M_M68K) || \
-    (defined(__MIPS__) && defined(__MIPSEB__)) || \
-    defined(__ppc__) || defined(__POWERPC__) || defined(__powerpc__) || defined(__PPC__) || \
-    defined(__sparc__) || defined(__sparc)
-#define SDL_BYTEORDER   SDL_BIG_ENDIAN
-#else
-#define SDL_BYTEORDER   SDL_LIL_ENDIAN
-#endif
-#endif /* SDL_PLATFORM_LINUX */
-#endif /* !SDL_BYTEORDER */
-
-#ifndef SDL_FLOATWORDORDER
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A macro that reports the target system's floating point word order.
- *
- * This is set to either SDL_LIL_ENDIAN or SDL_BIG_ENDIAN (and maybe other
- * values in the future, if something else becomes popular). This can be
- * tested with the preprocessor, so decisions can be made at compile time.
- *
- * ```c
- * #if SDL_FLOATWORDORDER == SDL_BIG_ENDIAN
- * SDL_Log("This system's floats are bigendian.");
- * #endif
- * ```
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_LIL_ENDIAN
- * \sa SDL_BIG_ENDIAN
- */
-#define SDL_FLOATWORDORDER   SDL_LIL_ENDIAN___or_maybe___SDL_BIG_ENDIAN
-/* predefs from newer gcc versions: */
-#elif defined(__ORDER_LITTLE_ENDIAN__) && defined(__ORDER_BIG_ENDIAN__) && defined(__FLOAT_WORD_ORDER__)
-#if (__FLOAT_WORD_ORDER__ == __ORDER_LITTLE_ENDIAN__)
-#define SDL_FLOATWORDORDER   SDL_LIL_ENDIAN
-#elif (__FLOAT_WORD_ORDER__ == __ORDER_BIG_ENDIAN__)
-#define SDL_FLOATWORDORDER   SDL_BIG_ENDIAN
-#else
-#error Unsupported endianness
-#endif /**/
-#elif defined(__MAVERICK__)
-/* For Maverick, float words are always little-endian. */
-#define SDL_FLOATWORDORDER   SDL_LIL_ENDIAN
-#elif (defined(__arm__) || defined(__thumb__)) && !defined(__VFP_FP__) && !defined(__ARM_EABI__)
-/* For FPA, float words are always big-endian. */
-#define SDL_FLOATWORDORDER   SDL_BIG_ENDIAN
-#else
-/* By default, assume that floats words follow the memory system mode. */
-#define SDL_FLOATWORDORDER   SDL_BYTEORDER
-#endif /* __FLOAT_WORD_ORDER__ */
-#endif /* !SDL_FLOATWORDORDER */
-
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* various modern compilers may have builtin swap */
-#if defined(__GNUC__) || defined(__clang__)
-#   define HAS_BUILTIN_BSWAP16 (SDL_HAS_BUILTIN(__builtin_bswap16)) || \
-        (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8))
-#   define HAS_BUILTIN_BSWAP32 (SDL_HAS_BUILTIN(__builtin_bswap32)) || \
-        (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))
-#   define HAS_BUILTIN_BSWAP64 (SDL_HAS_BUILTIN(__builtin_bswap64)) || \
-        (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))
-
-    /* this one is broken */
-#   define HAS_BROKEN_BSWAP (__GNUC__ == 2 && __GNUC_MINOR__ <= 95)
-#else
-#   define HAS_BUILTIN_BSWAP16 0
-#   define HAS_BUILTIN_BSWAP32 0
-#   define HAS_BUILTIN_BSWAP64 0
-#   define HAS_BROKEN_BSWAP 0
-#endif
-
-/* Byte swap 16-bit integer. */
-#ifndef SDL_WIKI_DOCUMENTATION_SECTION
-#if HAS_BUILTIN_BSWAP16
-#define SDL_Swap16(x) __builtin_bswap16(x)
-#elif (defined(_MSC_VER) && (_MSC_VER >= 1400)) && !defined(__ICL)
-#pragma intrinsic(_byteswap_ushort)
-#define SDL_Swap16(x) _byteswap_ushort(x)
-#elif defined(__i386__) && !HAS_BROKEN_BSWAP
-SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
-{
-  __asm__("xchgb %b0,%h0": "=q"(x):"0"(x));
-    return x;
-}
-#elif defined(__x86_64__)
-SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
-{
-  __asm__("xchgb %b0,%h0": "=Q"(x):"0"(x));
-    return x;
-}
-#elif (defined(__powerpc__) || defined(__ppc__))
-SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
-{
-    int result;
-
-  __asm__("rlwimi %0,%2,8,16,23": "=&r"(result):"0"(x >> 8), "r"(x));
-    return (Uint16)result;
-}
-#elif (defined(__m68k__) && !defined(__mcoldfire__))
-SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
-{
-  __asm__("rorw #8,%0": "=d"(x): "0"(x):"cc");
-    return x;
-}
-#elif defined(__WATCOMC__) && defined(__386__)
-extern __inline Uint16 SDL_Swap16(Uint16);
-#pragma aux SDL_Swap16 = \
-  "xchg al, ah" \
-  parm   [ax]   \
-  modify [ax];
-#else
-SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
-{
-    return SDL_static_cast(Uint16, ((x << 8) | (x >> 8)));
-}
-#endif
-#endif
-
-/* Byte swap 32-bit integer. */
-#ifndef SDL_WIKI_DOCUMENTATION_SECTION
-#if HAS_BUILTIN_BSWAP32
-#define SDL_Swap32(x) __builtin_bswap32(x)
-#elif (defined(_MSC_VER) && (_MSC_VER >= 1400)) && !defined(__ICL)
-#pragma intrinsic(_byteswap_ulong)
-#define SDL_Swap32(x) _byteswap_ulong(x)
-#elif defined(__i386__) && !HAS_BROKEN_BSWAP
-SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
-{
-  __asm__("bswap %0": "=r"(x):"0"(x));
-    return x;
-}
-#elif defined(__x86_64__)
-SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
-{
-  __asm__("bswapl %0": "=r"(x):"0"(x));
-    return x;
-}
-#elif (defined(__powerpc__) || defined(__ppc__))
-SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
-{
-    Uint32 result;
-
-  __asm__("rlwimi %0,%2,24,16,23": "=&r"(result): "0" (x>>24),  "r"(x));
-  __asm__("rlwimi %0,%2,8,8,15"  : "=&r"(result): "0" (result), "r"(x));
-  __asm__("rlwimi %0,%2,24,0,7"  : "=&r"(result): "0" (result), "r"(x));
-    return result;
-}
-#elif (defined(__m68k__) && !defined(__mcoldfire__))
-SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
-{
-  __asm__("rorw #8,%0\n\tswap %0\n\trorw #8,%0": "=d"(x): "0"(x):"cc");
-    return x;
-}
-#elif defined(__WATCOMC__) && defined(__386__)
-extern __inline Uint32 SDL_Swap32(Uint32);
-#pragma aux SDL_Swap32 = \
-  "bswap eax"  \
-  parm   [eax] \
-  modify [eax];
-#else
-SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
-{
-    return SDL_static_cast(Uint32, ((x << 24) | ((x << 8) & 0x00FF0000) |
-                                    ((x >> 8) & 0x0000FF00) | (x >> 24)));
-}
-#endif
-#endif
-
-/* Byte swap 64-bit integer. */
-#ifndef SDL_WIKI_DOCUMENTATION_SECTION
-#if HAS_BUILTIN_BSWAP64
-#define SDL_Swap64(x) __builtin_bswap64(x)
-#elif (defined(_MSC_VER) && (_MSC_VER >= 1400)) && !defined(__ICL)
-#pragma intrinsic(_byteswap_uint64)
-#define SDL_Swap64(x) _byteswap_uint64(x)
-#elif defined(__i386__) && !HAS_BROKEN_BSWAP
-SDL_FORCE_INLINE Uint64 SDL_Swap64(Uint64 x)
-{
-    union {
-        struct {
-            Uint32 a, b;
-        } s;
-        Uint64 u;
-    } v;
-    v.u = x;
-  __asm__("bswapl %0 ; bswapl %1 ; xchgl %0,%1"
-          : "=r"(v.s.a), "=r"(v.s.b)
-          : "0" (v.s.a),  "1"(v.s.b));
-    return v.u;
-}
-#elif defined(__x86_64__)
-SDL_FORCE_INLINE Uint64 SDL_Swap64(Uint64 x)
-{
-  __asm__("bswapq %0": "=r"(x):"0"(x));
-    return x;
-}
-#elif defined(__WATCOMC__) && defined(__386__)
-extern __inline Uint64 SDL_Swap64(Uint64);
-#pragma aux SDL_Swap64 = \
-  "bswap eax"     \
-  "bswap edx"     \
-  "xchg eax,edx"  \
-  parm [eax edx]  \
-  modify [eax edx];
-#else
-SDL_FORCE_INLINE Uint64 SDL_Swap64(Uint64 x)
-{
-    Uint32 hi, lo;
-
-    /* Separate into high and low 32-bit values and swap them */
-    lo = SDL_static_cast(Uint32, x & 0xFFFFFFFF);
-    x >>= 32;
-    hi = SDL_static_cast(Uint32, x & 0xFFFFFFFF);
-    x = SDL_Swap32(lo);
-    x <<= 32;
-    x |= SDL_Swap32(hi);
-    return (x);
-}
-#endif
-#endif
-
-/**
- * Byte-swap a floating point number.
- *
- * This will always byte-swap the value, whether it's currently in the native
- * byteorder of the system or not. You should use SDL_SwapFloatLE or
- * SDL_SwapFloatBE instead, in most cases.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param x the value to byte-swap.
- * \returns x, with its bytes in the opposite endian order.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE float SDL_SwapFloat(float x)
-{
-    union {
-        float f;
-        Uint32 ui32;
-    } swapper;
-    swapper.f = x;
-    swapper.ui32 = SDL_Swap32(swapper.ui32);
-    return swapper.f;
-}
-
-/* remove extra macros */
-#undef HAS_BROKEN_BSWAP
-#undef HAS_BUILTIN_BSWAP16
-#undef HAS_BUILTIN_BSWAP32
-#undef HAS_BUILTIN_BSWAP64
-
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * Byte-swap an unsigned 16-bit number.
- *
- * This will always byte-swap the value, whether it's currently in the native
- * byteorder of the system or not. You should use SDL_Swap16LE or SDL_Swap16BE
- * instead, in most cases.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param x the value to byte-swap.
- * \returns `x`, with its bytes in the opposite endian order.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x) { return x_but_byteswapped; }
-
-/**
- * Byte-swap an unsigned 32-bit number.
- *
- * This will always byte-swap the value, whether it's currently in the native
- * byteorder of the system or not. You should use SDL_Swap32LE or SDL_Swap32BE
- * instead, in most cases.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param x the value to byte-swap.
- * \returns `x`, with its bytes in the opposite endian order.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x) { return x_but_byteswapped; }
-
-/**
- * Byte-swap an unsigned 64-bit number.
- *
- * This will always byte-swap the value, whether it's currently in the native
- * byteorder of the system or not. You should use SDL_Swap64LE or SDL_Swap64BE
- * instead, in most cases.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param x the value to byte-swap.
- * \returns `x`, with its bytes in the opposite endian order.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE Uint64 SDL_Swap64(Uint64 x) { return x_but_byteswapped; }
-
-/**
- * Swap a 16-bit value from littleendian to native byte order.
- *
- * If this is running on a littleendian system, `x` is returned unchanged.
- *
- * This macro never references `x` more than once, avoiding side effects.
- *
- * \param x the value to swap, in littleendian byte order.
- * \returns `x` in native byte order.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_Swap16LE(x) SwapOnlyIfNecessary(x)
-
-/**
- * Swap a 32-bit value from littleendian to native byte order.
- *
- * If this is running on a littleendian system, `x` is returned unchanged.
- *
- * This macro never references `x` more than once, avoiding side effects.
- *
- * \param x the value to swap, in littleendian byte order.
- * \returns `x` in native byte order.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_Swap32LE(x) SwapOnlyIfNecessary(x)
-
-/**
- * Swap a 64-bit value from littleendian to native byte order.
- *
- * If this is running on a littleendian system, `x` is returned unchanged.
- *
- * This macro never references `x` more than once, avoiding side effects.
- *
- * \param x the value to swap, in littleendian byte order.
- * \returns `x` in native byte order.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_Swap64LE(x) SwapOnlyIfNecessary(x)
-
-/**
- * Swap a floating point value from littleendian to native byte order.
- *
- * If this is running on a littleendian system, `x` is returned unchanged.
- *
- * This macro never references `x` more than once, avoiding side effects.
- *
- * \param x the value to swap, in littleendian byte order.
- * \returns `x` in native byte order.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_SwapFloatLE(x) SwapOnlyIfNecessary(x)
-
-/**
- * Swap a 16-bit value from bigendian to native byte order.
- *
- * If this is running on a bigendian system, `x` is returned unchanged.
- *
- * This macro never references `x` more than once, avoiding side effects.
- *
- * \param x the value to swap, in bigendian byte order.
- * \returns `x` in native byte order.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_Swap16BE(x) SwapOnlyIfNecessary(x)
-
-/**
- * Swap a 32-bit value from bigendian to native byte order.
- *
- * If this is running on a bigendian system, `x` is returned unchanged.
- *
- * This macro never references `x` more than once, avoiding side effects.
- *
- * \param x the value to swap, in bigendian byte order.
- * \returns `x` in native byte order.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_Swap32BE(x) SwapOnlyIfNecessary(x)
-
-/**
- * Swap a 64-bit value from bigendian to native byte order.
- *
- * If this is running on a bigendian system, `x` is returned unchanged.
- *
- * This macro never references `x` more than once, avoiding side effects.
- *
- * \param x the value to swap, in bigendian byte order.
- * \returns `x` in native byte order.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_Swap64BE(x) SwapOnlyIfNecessary(x)
-
-/**
- * Swap a floating point value from bigendian to native byte order.
- *
- * If this is running on a bigendian system, `x` is returned unchanged.
- *
- * This macro never references `x` more than once, avoiding side effects.
- *
- * \param x the value to swap, in bigendian byte order.
- * \returns `x` in native byte order.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_SwapFloatBE(x) SwapOnlyIfNecessary(x)
-
-#elif SDL_BYTEORDER == SDL_LIL_ENDIAN
-#define SDL_Swap16LE(x)     (x)
-#define SDL_Swap32LE(x)     (x)
-#define SDL_Swap64LE(x)     (x)
-#define SDL_SwapFloatLE(x)  (x)
-#define SDL_Swap16BE(x)     SDL_Swap16(x)
-#define SDL_Swap32BE(x)     SDL_Swap32(x)
-#define SDL_Swap64BE(x)     SDL_Swap64(x)
-#define SDL_SwapFloatBE(x)  SDL_SwapFloat(x)
-#else
-#define SDL_Swap16LE(x)     SDL_Swap16(x)
-#define SDL_Swap32LE(x)     SDL_Swap32(x)
-#define SDL_Swap64LE(x)     SDL_Swap64(x)
-#define SDL_SwapFloatLE(x)  SDL_SwapFloat(x)
-#define SDL_Swap16BE(x)     (x)
-#define SDL_Swap32BE(x)     (x)
-#define SDL_Swap64BE(x)     (x)
-#define SDL_SwapFloatBE(x)  (x)
-#endif
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_endian_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_error.h

@@ -1,226 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryError
- *
- * Simple error message routines for SDL.
- *
- * Most apps will interface with these APIs in exactly one function: when
- * almost any SDL function call reports failure, you can get a human-readable
- * string of the problem from SDL_GetError().
- *
- * These strings are maintained per-thread, and apps are welcome to set their
- * own errors, which is popular when building libraries on top of SDL for
- * other apps to consume. These strings are set by calling SDL_SetError().
- *
- * A common usage pattern is to have a function that returns true for success
- * and false for failure, and do this when something fails:
- *
- * ```c
- * if (something_went_wrong) {
- *    return SDL_SetError("The thing broke in this specific way: %d", errcode);
- * }
- * ```
- *
- * It's also common to just return `false` in this case if the failing thing
- * is known to call SDL_SetError(), so errors simply propagate through.
- */
-
-#ifndef SDL_error_h_
-#define SDL_error_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* Public functions */
-
-
-/**
- * Set the SDL error message for the current thread.
- *
- * Calling this function will replace any previous error message that was set.
- *
- * This function always returns false, since SDL frequently uses false to
- * signify a failing result, leading to this idiom:
- *
- * ```c
- * if (error_code) {
- *     return SDL_SetError("This operation has failed: %d", error_code);
- * }
- * ```
- *
- * \param fmt a printf()-style message format string.
- * \param ... additional parameters matching % tokens in the `fmt` string, if
- *            any.
- * \returns false.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ClearError
- * \sa SDL_GetError
- * \sa SDL_SetErrorV
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetError(SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(1);
-
-/**
- * Set the SDL error message for the current thread.
- *
- * Calling this function will replace any previous error message that was set.
- *
- * \param fmt a printf()-style message format string.
- * \param ap a variable argument list.
- * \returns false.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ClearError
- * \sa SDL_GetError
- * \sa SDL_SetError
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetErrorV(SDL_PRINTF_FORMAT_STRING const char *fmt, va_list ap) SDL_PRINTF_VARARG_FUNCV(1);
-
-/**
- * Set an error indicating that memory allocation failed.
- *
- * This function does not do any memory allocation.
- *
- * \returns false.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_OutOfMemory(void);
-
-/**
- * Retrieve a message about the last error that occurred on the current
- * thread.
- *
- * It is possible for multiple errors to occur before calling SDL_GetError().
- * Only the last error is returned.
- *
- * The message is only applicable when an SDL function has signaled an error.
- * You must check the return values of SDL function calls to determine when to
- * appropriately call SDL_GetError(). You should *not* use the results of
- * SDL_GetError() to decide if an error has occurred! Sometimes SDL will set
- * an error string even when reporting success.
- *
- * SDL will *not* clear the error string for successful API calls. You *must*
- * check return values for failure cases before you can assume the error
- * string applies.
- *
- * Error strings are set per-thread, so an error set in a different thread
- * will not interfere with the current thread's operation.
- *
- * The returned value is a thread-local string which will remain valid until
- * the current thread's error string is changed. The caller should make a copy
- * if the value is needed after the next SDL API call.
- *
- * \returns a message with information about the specific error that occurred,
- *          or an empty string if there hasn't been an error message set since
- *          the last call to SDL_ClearError().
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ClearError
- * \sa SDL_SetError
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetError(void);
-
-/**
- * Clear any previous error message for this thread.
- *
- * \returns true.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetError
- * \sa SDL_SetError
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ClearError(void);
-
-/**
- *  \name Internal error functions
- *
- *  \internal
- *  Private error reporting function - used internally.
- */
-/* @{ */
-
-/**
- * A macro to standardize error reporting on unsupported operations.
- *
- * This simply calls SDL_SetError() with a standardized error string, for
- * convenience, consistency, and clarity.
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_Unsupported()               SDL_SetError("That operation is not supported")
-
-/**
- * A macro to standardize error reporting on unsupported operations.
- *
- * This simply calls SDL_SetError() with a standardized error string, for
- * convenience, consistency, and clarity.
- *
- * A common usage pattern inside SDL is this:
- *
- * ```c
- * bool MyFunction(const char *str) {
- *     if (!str) {
- *         return SDL_InvalidParamError("str");  // returns false.
- *     }
- *     DoSomething(str);
- *     return true;
- * }
- * ```
- *
- * \threadsafety It is safe to call this macro from any thread.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_InvalidParamError(param)    SDL_SetError("Parameter '%s' is invalid", (param))
-
-/* @} *//* Internal error functions */
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_error_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_filesystem.h

@@ -1,503 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryFilesystem
- *
- * SDL offers an API for examining and manipulating the system's filesystem.
- * This covers most things one would need to do with directories, except for
- * actual file I/O (which is covered by [CategoryIOStream](CategoryIOStream)
- * and [CategoryAsyncIO](CategoryAsyncIO) instead).
- *
- * There are functions to answer necessary path questions:
- *
- * - Where is my app's data? SDL_GetBasePath().
- * - Where can I safely write files? SDL_GetPrefPath().
- * - Where are paths like Downloads, Desktop, Music? SDL_GetUserFolder().
- * - What is this thing at this location? SDL_GetPathInfo().
- * - What items live in this folder? SDL_EnumerateDirectory().
- * - What items live in this folder by wildcard? SDL_GlobDirectory().
- * - What is my current working directory? SDL_GetCurrentDirectory().
- *
- * SDL also offers functions to manipulate the directory tree: renaming,
- * removing, copying files.
- */
-
-#ifndef SDL_filesystem_h_
-#define SDL_filesystem_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * Get the directory where the application was run from.
- *
- * SDL caches the result of this call internally, but the first call to this
- * function is not necessarily fast, so plan accordingly.
- *
- * **macOS and iOS Specific Functionality**: If the application is in a ".app"
- * bundle, this function returns the Resource directory (e.g.
- * MyApp.app/Contents/Resources/). This behaviour can be overridden by adding
- * a property to the Info.plist file. Adding a string key with the name
- * SDL_FILESYSTEM_BASE_DIR_TYPE with a supported value will change the
- * behaviour.
- *
- * Supported values for the SDL_FILESYSTEM_BASE_DIR_TYPE property (Given an
- * application in /Applications/SDLApp/MyApp.app):
- *
- * - `resource`: bundle resource directory (the default). For example:
- *   `/Applications/SDLApp/MyApp.app/Contents/Resources`
- * - `bundle`: the Bundle directory. For example:
- *   `/Applications/SDLApp/MyApp.app/`
- * - `parent`: the containing directory of the bundle. For example:
- *   `/Applications/SDLApp/`
- *
- * **Nintendo 3DS Specific Functionality**: This function returns "romfs"
- * directory of the application as it is uncommon to store resources outside
- * the executable. As such it is not a writable directory.
- *
- * The returned path is guaranteed to end with a path separator ('\\' on
- * Windows, '/' on most other platforms).
- *
- * \returns an absolute path in UTF-8 encoding to the application data
- *          directory. NULL will be returned on error or when the platform
- *          doesn't implement this functionality, call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPrefPath
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetBasePath(void);
-
-/**
- * Get the user-and-app-specific path where files can be written.
- *
- * Get the "pref dir". This is meant to be where users can write personal
- * files (preferences and save games, etc) that are specific to your
- * application. This directory is unique per user, per application.
- *
- * This function will decide the appropriate location in the native
- * filesystem, create the directory if necessary, and return a string of the
- * absolute path to the directory in UTF-8 encoding.
- *
- * On Windows, the string might look like:
- *
- * `C:\\Users\\bob\\AppData\\Roaming\\My Company\\My Program Name\\`
- *
- * On Linux, the string might look like:
- *
- * `/home/bob/.local/share/My Program Name/`
- *
- * On macOS, the string might look like:
- *
- * `/Users/bob/Library/Application Support/My Program Name/`
- *
- * You should assume the path returned by this function is the only safe place
- * to write files (and that SDL_GetBasePath(), while it might be writable, or
- * even the parent of the returned path, isn't where you should be writing
- * things).
- *
- * Both the org and app strings may become part of a directory name, so please
- * follow these rules:
- *
- * - Try to use the same org string (_including case-sensitivity_) for all
- *   your applications that use this function.
- * - Always use a unique app string for each one, and make sure it never
- *   changes for an app once you've decided on it.
- * - Unicode characters are legal, as long as they are UTF-8 encoded, but...
- * - ...only use letters, numbers, and spaces. Avoid punctuation like "Game
- *   Name 2: Bad Guy's Revenge!" ... "Game Name 2" is sufficient.
- *
- * The returned path is guaranteed to end with a path separator ('\\' on
- * Windows, '/' on most other platforms).
- *
- * \param org the name of your organization.
- * \param app the name of your application.
- * \returns a UTF-8 string of the user directory in platform-dependent
- *          notation. NULL if there's a problem (creating directory failed,
- *          etc.). This should be freed with SDL_free() when it is no longer
- *          needed.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetBasePath
- */
-extern SDL_DECLSPEC char * SDLCALL SDL_GetPrefPath(const char *org, const char *app);
-
-/**
- * The type of the OS-provided default folder for a specific purpose.
- *
- * Note that the Trash folder isn't included here, because trashing files
- * usually involves extra OS-specific functionality to remember the file's
- * original location.
- *
- * The folders supported per platform are:
- *
- * |             | Windows | macOS/iOS | tvOS | Unix (XDG) | Haiku | Emscripten |
- * | ----------- | ------- | --------- | ---- | ---------- | ----- | ---------- |
- * | HOME        | X       | X         |      | X          | X     | X          |
- * | DESKTOP     | X       | X         |      | X          | X     |            |
- * | DOCUMENTS   | X       | X         |      | X          |       |            |
- * | DOWNLOADS   | Vista+  | X         |      | X          |       |            |
- * | MUSIC       | X       | X         |      | X          |       |            |
- * | PICTURES    | X       | X         |      | X          |       |            |
- * | PUBLICSHARE |         | X         |      | X          |       |            |
- * | SAVEDGAMES  | Vista+  |           |      |            |       |            |
- * | SCREENSHOTS | Vista+  |           |      |            |       |            |
- * | TEMPLATES   | X       | X         |      | X          |       |            |
- * | VIDEOS      | X       | X*        |      | X          |       |            |
- *
- * Note that on macOS/iOS, the Videos folder is called "Movies".
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_GetUserFolder
- */
-typedef enum SDL_Folder
-{
-    SDL_FOLDER_HOME,        /**< The folder which contains all of the current user's data, preferences, and documents. It usually contains most of the other folders. If a requested folder does not exist, the home folder can be considered a safe fallback to store a user's documents. */
-    SDL_FOLDER_DESKTOP,     /**< The folder of files that are displayed on the desktop. Note that the existence of a desktop folder does not guarantee that the system does show icons on its desktop; certain GNU/Linux distros with a graphical environment may not have desktop icons. */
-    SDL_FOLDER_DOCUMENTS,   /**< User document files, possibly application-specific. This is a good place to save a user's projects. */
-    SDL_FOLDER_DOWNLOADS,   /**< Standard folder for user files downloaded from the internet. */
-    SDL_FOLDER_MUSIC,       /**< Music files that can be played using a standard music player (mp3, ogg...). */
-    SDL_FOLDER_PICTURES,    /**< Image files that can be displayed using a standard viewer (png, jpg...). */
-    SDL_FOLDER_PUBLICSHARE, /**< Files that are meant to be shared with other users on the same computer. */
-    SDL_FOLDER_SAVEDGAMES,  /**< Save files for games. */
-    SDL_FOLDER_SCREENSHOTS, /**< Application screenshots. */
-    SDL_FOLDER_TEMPLATES,   /**< Template files to be used when the user requests the desktop environment to create a new file in a certain folder, such as "New Text File.txt".  Any file in the Templates folder can be used as a starting point for a new file. */
-    SDL_FOLDER_VIDEOS,      /**< Video files that can be played using a standard video player (mp4, webm...). */
-    SDL_FOLDER_COUNT        /**< Total number of types in this enum, not a folder type by itself. */
-} SDL_Folder;
-
-/**
- * Finds the most suitable user folder for a specific purpose.
- *
- * Many OSes provide certain standard folders for certain purposes, such as
- * storing pictures, music or videos for a certain user. This function gives
- * the path for many of those special locations.
- *
- * This function is specifically for _user_ folders, which are meant for the
- * user to access and manage. For application-specific folders, meant to hold
- * data for the application to manage, see SDL_GetBasePath() and
- * SDL_GetPrefPath().
- *
- * The returned path is guaranteed to end with a path separator ('\\' on
- * Windows, '/' on most other platforms).
- *
- * If NULL is returned, the error may be obtained with SDL_GetError().
- *
- * \param folder the type of folder to find.
- * \returns either a null-terminated C string containing the full path to the
- *          folder, or NULL if an error happened.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetUserFolder(SDL_Folder folder);
-
-
-/* Abstract filesystem interface */
-
-/**
- * Types of filesystem entries.
- *
- * Note that there may be other sorts of items on a filesystem: devices,
- * symlinks, named pipes, etc. They are currently reported as
- * SDL_PATHTYPE_OTHER.
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_PathInfo
- */
-typedef enum SDL_PathType
-{
-    SDL_PATHTYPE_NONE,      /**< path does not exist */
-    SDL_PATHTYPE_FILE,      /**< a normal file */
-    SDL_PATHTYPE_DIRECTORY, /**< a directory */
-    SDL_PATHTYPE_OTHER      /**< something completely different like a device node (not a symlink, those are always followed) */
-} SDL_PathType;
-
-/**
- * Information about a path on the filesystem.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_GetPathInfo
- * \sa SDL_GetStoragePathInfo
- */
-typedef struct SDL_PathInfo
-{
-    SDL_PathType type;      /**< the path type */
-    Uint64 size;            /**< the file size in bytes */
-    SDL_Time create_time;   /**< the time when the path was created */
-    SDL_Time modify_time;   /**< the last time the path was modified */
-    SDL_Time access_time;   /**< the last time the path was read */
-} SDL_PathInfo;
-
-/**
- * Flags for path matching.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_GlobDirectory
- * \sa SDL_GlobStorageDirectory
- */
-typedef Uint32 SDL_GlobFlags;
-
-#define SDL_GLOB_CASEINSENSITIVE (1u << 0)
-
-/**
- * Create a directory, and any missing parent directories.
- *
- * This reports success if `path` already exists as a directory.
- *
- * If parent directories are missing, it will also create them. Note that if
- * this fails, it will not remove any parent directories it already made.
- *
- * \param path the path of the directory to create.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CreateDirectory(const char *path);
-
-/**
- * Possible results from an enumeration callback.
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_EnumerateDirectoryCallback
- */
-typedef enum SDL_EnumerationResult
-{
-    SDL_ENUM_CONTINUE,   /**< Value that requests that enumeration continue. */
-    SDL_ENUM_SUCCESS,    /**< Value that requests that enumeration stop, successfully. */
-    SDL_ENUM_FAILURE     /**< Value that requests that enumeration stop, as a failure. */
-} SDL_EnumerationResult;
-
-/**
- * Callback for directory enumeration.
- *
- * Enumeration of directory entries will continue until either all entries
- * have been provided to the callback, or the callback has requested a stop
- * through its return value.
- *
- * Returning SDL_ENUM_CONTINUE will let enumeration proceed, calling the
- * callback with further entries. SDL_ENUM_SUCCESS and SDL_ENUM_FAILURE will
- * terminate the enumeration early, and dictate the return value of the
- * enumeration function itself.
- *
- * `dirname` is guaranteed to end with a path separator ('\\' on Windows, '/'
- * on most other platforms).
- *
- * \param userdata an app-controlled pointer that is passed to the callback.
- * \param dirname the directory that is being enumerated.
- * \param fname the next entry in the enumeration.
- * \returns how the enumeration should proceed.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_EnumerateDirectory
- */
-typedef SDL_EnumerationResult (SDLCALL *SDL_EnumerateDirectoryCallback)(void *userdata, const char *dirname, const char *fname);
-
-/**
- * Enumerate a directory through a callback function.
- *
- * This function provides every directory entry through an app-provided
- * callback, called once for each directory entry, until all results have been
- * provided or the callback returns either SDL_ENUM_SUCCESS or
- * SDL_ENUM_FAILURE.
- *
- * This will return false if there was a system problem in general, or if a
- * callback returns SDL_ENUM_FAILURE. A successful return means a callback
- * returned SDL_ENUM_SUCCESS to halt enumeration, or all directory entries
- * were enumerated.
- *
- * \param path the path of the directory to enumerate.
- * \param callback a function that is called for each entry in the directory.
- * \param userdata a pointer that is passed to `callback`.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_EnumerateDirectory(const char *path, SDL_EnumerateDirectoryCallback callback, void *userdata);
-
-/**
- * Remove a file or an empty directory.
- *
- * Directories that are not empty will fail; this function will not recursely
- * delete directory trees.
- *
- * \param path the path to remove from the filesystem.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_RemovePath(const char *path);
-
-/**
- * Rename a file or directory.
- *
- * If the file at `newpath` already exists, it will replaced.
- *
- * Note that this will not copy files across filesystems/drives/volumes, as
- * that is a much more complicated (and possibly time-consuming) operation.
- *
- * Which is to say, if this function fails, SDL_CopyFile() to a temporary file
- * in the same directory as `newpath`, then SDL_RenamePath() from the
- * temporary file to `newpath` and SDL_RemovePath() on `oldpath` might work
- * for files. Renaming a non-empty directory across filesystems is
- * dramatically more complex, however.
- *
- * \param oldpath the old path.
- * \param newpath the new path.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_RenamePath(const char *oldpath, const char *newpath);
-
-/**
- * Copy a file.
- *
- * If the file at `newpath` already exists, it will be overwritten with the
- * contents of the file at `oldpath`.
- *
- * This function will block until the copy is complete, which might be a
- * significant time for large files on slow disks. On some platforms, the copy
- * can be handed off to the OS itself, but on others SDL might just open both
- * paths, and read from one and write to the other.
- *
- * Note that this is not an atomic operation! If something tries to read from
- * `newpath` while the copy is in progress, it will see an incomplete copy of
- * the data, and if the calling thread terminates (or the power goes out)
- * during the copy, `newpath`'s previous contents will be gone, replaced with
- * an incomplete copy of the data. To avoid this risk, it is recommended that
- * the app copy to a temporary file in the same directory as `newpath`, and if
- * the copy is successful, use SDL_RenamePath() to replace `newpath` with the
- * temporary file. This will ensure that reads of `newpath` will either see a
- * complete copy of the data, or it will see the pre-copy state of `newpath`.
- *
- * This function attempts to synchronize the newly-copied data to disk before
- * returning, if the platform allows it, so that the renaming trick will not
- * have a problem in a system crash or power failure, where the file could be
- * renamed but the contents never made it from the system file cache to the
- * physical disk.
- *
- * If the copy fails for any reason, the state of `newpath` is undefined. It
- * might be half a copy, it might be the untouched data of what was already
- * there, or it might be a zero-byte file, etc.
- *
- * \param oldpath the old path.
- * \param newpath the new path.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CopyFile(const char *oldpath, const char *newpath);
-
-/**
- * Get information about a filesystem path.
- *
- * \param path the path to query.
- * \param info a pointer filled in with information about the path, or NULL to
- *             check for the existence of a file.
- * \returns true on success or false if the file doesn't exist, or another
- *          failure; call SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetPathInfo(const char *path, SDL_PathInfo *info);
-
-/**
- * Enumerate a directory tree, filtered by pattern, and return a list.
- *
- * Files are filtered out if they don't match the string in `pattern`, which
- * may contain wildcard characters '\*' (match everything) and '?' (match one
- * character). If pattern is NULL, no filtering is done and all results are
- * returned. Subdirectories are permitted, and are specified with a path
- * separator of '/'. Wildcard characters '\*' and '?' never match a path
- * separator.
- *
- * `flags` may be set to SDL_GLOB_CASEINSENSITIVE to make the pattern matching
- * case-insensitive.
- *
- * The returned array is always NULL-terminated, for your iterating
- * convenience, but if `count` is non-NULL, on return it will contain the
- * number of items in the array, not counting the NULL terminator.
- *
- * \param path the path of the directory to enumerate.
- * \param pattern the pattern that files in the directory must match. Can be
- *                NULL.
- * \param flags `SDL_GLOB_*` bitflags that affect this search.
- * \param count on return, will be set to the number of items in the returned
- *              array. Can be NULL.
- * \returns an array of strings on success or NULL on failure; call
- *          SDL_GetError() for more information. This is a single allocation
- *          that should be freed with SDL_free() when it is no longer needed.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC char ** SDLCALL SDL_GlobDirectory(const char *path, const char *pattern, SDL_GlobFlags flags, int *count);
-
-/**
- * Get what the system believes is the "current working directory."
- *
- * For systems without a concept of a current working directory, this will
- * still attempt to provide something reasonable.
- *
- * SDL does not provide a means to _change_ the current working directory; for
- * platforms without this concept, this would cause surprises with file access
- * outside of SDL.
- *
- * The returned path is guaranteed to end with a path separator ('\\' on
- * Windows, '/' on most other platforms).
- *
- * \returns a UTF-8 string of the current working directory in
- *          platform-dependent notation. NULL if there's a problem. This
- *          should be freed with SDL_free() when it is no longer needed.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC char * SDLCALL SDL_GetCurrentDirectory(void);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_filesystem_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_guid.h

@@ -1,106 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: GUID */
-
-/**
- * # CategoryGUID
- *
- * A GUID is a 128-bit value that represents something that is uniquely
- * identifiable by this value: "globally unique."
- *
- * SDL provides functions to convert a GUID to/from a string.
- */
-
-#ifndef SDL_guid_h_
-#define SDL_guid_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * An SDL_GUID is a 128-bit identifier for an input device that identifies
- * that device across runs of SDL programs on the same platform.
- *
- * If the device is detached and then re-attached to a different port, or if
- * the base system is rebooted, the device should still report the same GUID.
- *
- * GUIDs are as precise as possible but are not guaranteed to distinguish
- * physically distinct but equivalent devices. For example, two game
- * controllers from the same vendor with the same product ID and revision may
- * have the same GUID.
- *
- * GUIDs may be platform-dependent (i.e., the same device may report different
- * GUIDs on different operating systems).
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_GUID {
-    Uint8 data[16];
-} SDL_GUID;
-
-/* Function prototypes */
-
-/**
- * Get an ASCII string representation for a given SDL_GUID.
- *
- * \param guid the SDL_GUID you wish to convert to string.
- * \param pszGUID buffer in which to write the ASCII string.
- * \param cbGUID the size of pszGUID, should be at least 33 bytes.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StringToGUID
- */
-extern SDL_DECLSPEC void SDLCALL SDL_GUIDToString(SDL_GUID guid, char *pszGUID, int cbGUID);
-
-/**
- * Convert a GUID string into a SDL_GUID structure.
- *
- * Performs no error checking. If this function is given a string containing
- * an invalid GUID, the function will silently succeed, but the GUID generated
- * will not be useful.
- *
- * \param pchGUID string containing an ASCII representation of a GUID.
- * \returns a SDL_GUID structure.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GUIDToString
- */
-extern SDL_DECLSPEC SDL_GUID SDLCALL SDL_StringToGUID(const char *pchGUID);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_guid_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_hidapi.h

@@ -1,552 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: HIDAPI */
-
-/**
- * # CategoryHIDAPI
- *
- * Header file for SDL HIDAPI functions.
- *
- * This is an adaptation of the original HIDAPI interface by Alan Ott, and
- * includes source code licensed under the following license:
- *
- * ```
- * HIDAPI - Multi-Platform library for
- * communication with HID devices.
- *
- * Copyright 2009, Alan Ott, Signal 11 Software.
- * All Rights Reserved.
- *
- * This software may be used by anyone for any reason so
- * long as the copyright notice in the source files
- * remains intact.
- * ```
- *
- * (Note that this license is the same as item three of SDL's zlib license, so
- * it adds no new requirements on the user.)
- *
- * If you would like a version of SDL without this code, you can build SDL
- * with SDL_HIDAPI_DISABLED defined to 1. You might want to do this for
- * example on iOS or tvOS to avoid a dependency on the CoreBluetooth
- * framework.
- */
-
-#ifndef SDL_hidapi_h_
-#define SDL_hidapi_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * An opaque handle representing an open HID device.
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_hid_device SDL_hid_device;
-
-/**
- * HID underlying bus types.
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_hid_bus_type {
-    /** Unknown bus type */
-    SDL_HID_API_BUS_UNKNOWN = 0x00,
-
-    /** USB bus
-       Specifications:
-       https://usb.org/hid */
-    SDL_HID_API_BUS_USB = 0x01,
-
-    /** Bluetooth or Bluetooth LE bus
-       Specifications:
-       https://www.bluetooth.com/specifications/specs/human-interface-device-profile-1-1-1/
-       https://www.bluetooth.com/specifications/specs/hid-service-1-0/
-       https://www.bluetooth.com/specifications/specs/hid-over-gatt-profile-1-0/ */
-    SDL_HID_API_BUS_BLUETOOTH = 0x02,
-
-    /** I2C bus
-       Specifications:
-       https://docs.microsoft.com/previous-versions/windows/hardware/design/dn642101(v=vs.85) */
-    SDL_HID_API_BUS_I2C = 0x03,
-
-    /** SPI bus
-       Specifications:
-       https://www.microsoft.com/download/details.aspx?id=103325 */
-    SDL_HID_API_BUS_SPI = 0x04
-
-} SDL_hid_bus_type;
-
-/** hidapi info structure */
-
-/**
- * Information about a connected HID device
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_hid_device_info
-{
-    /** Platform-specific device path */
-    char *path;
-    /** Device Vendor ID */
-    unsigned short vendor_id;
-    /** Device Product ID */
-    unsigned short product_id;
-    /** Serial Number */
-    wchar_t *serial_number;
-    /** Device Release Number in binary-coded decimal,
-        also known as Device Version Number */
-    unsigned short release_number;
-    /** Manufacturer String */
-    wchar_t *manufacturer_string;
-    /** Product string */
-    wchar_t *product_string;
-    /** Usage Page for this Device/Interface
-        (Windows/Mac/hidraw only) */
-    unsigned short usage_page;
-    /** Usage for this Device/Interface
-        (Windows/Mac/hidraw only) */
-    unsigned short usage;
-    /** The USB interface which this logical device
-        represents.
-
-        Valid only if the device is a USB HID device.
-        Set to -1 in all other cases.
-    */
-    int interface_number;
-
-    /** Additional information about the USB interface.
-        Valid on libusb and Android implementations. */
-    int interface_class;
-    int interface_subclass;
-    int interface_protocol;
-
-    /** Underlying bus type */
-    SDL_hid_bus_type bus_type;
-
-    /** Pointer to the next device */
-    struct SDL_hid_device_info *next;
-
-} SDL_hid_device_info;
-
-
-/**
- * Initialize the HIDAPI library.
- *
- * This function initializes the HIDAPI library. Calling it is not strictly
- * necessary, as it will be called automatically by SDL_hid_enumerate() and
- * any of the SDL_hid_open_*() functions if it is needed. This function should
- * be called at the beginning of execution however, if there is a chance of
- * HIDAPI handles being opened by different threads simultaneously.
- *
- * Each call to this function should have a matching call to SDL_hid_exit()
- *
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_hid_exit
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_init(void);
-
-/**
- * Finalize the HIDAPI library.
- *
- * This function frees all of the static data associated with HIDAPI. It
- * should be called at the end of execution to avoid memory leaks.
- *
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_hid_init
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_exit(void);
-
-/**
- * Check to see if devices may have been added or removed.
- *
- * Enumerating the HID devices is an expensive operation, so you can call this
- * to see if there have been any system device changes since the last call to
- * this function. A change in the counter returned doesn't necessarily mean
- * that anything has changed, but you can call SDL_hid_enumerate() to get an
- * updated device list.
- *
- * Calling this function for the first time may cause a thread or other system
- * resource to be allocated to track device change notifications.
- *
- * \returns a change counter that is incremented with each potential device
- *          change, or 0 if device change detection isn't available.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_hid_enumerate
- */
-extern SDL_DECLSPEC Uint32 SDLCALL SDL_hid_device_change_count(void);
-
-/**
- * Enumerate the HID Devices.
- *
- * This function returns a linked list of all the HID devices attached to the
- * system which match vendor_id and product_id. If `vendor_id` is set to 0
- * then any vendor matches. If `product_id` is set to 0 then any product
- * matches. If `vendor_id` and `product_id` are both set to 0, then all HID
- * devices will be returned.
- *
- * By default SDL will only enumerate controllers, to reduce risk of hanging
- * or crashing on bad drivers, but SDL_HINT_HIDAPI_ENUMERATE_ONLY_CONTROLLERS
- * can be set to "0" to enumerate all HID devices.
- *
- * \param vendor_id the Vendor ID (VID) of the types of device to open, or 0
- *                  to match any vendor.
- * \param product_id the Product ID (PID) of the types of device to open, or 0
- *                   to match any product.
- * \returns a pointer to a linked list of type SDL_hid_device_info, containing
- *          information about the HID devices attached to the system, or NULL
- *          in the case of failure. Free this linked list by calling
- *          SDL_hid_free_enumeration().
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_hid_device_change_count
- */
-extern SDL_DECLSPEC SDL_hid_device_info * SDLCALL SDL_hid_enumerate(unsigned short vendor_id, unsigned short product_id);
-
-/**
- * Free an enumeration linked list.
- *
- * This function frees a linked list created by SDL_hid_enumerate().
- *
- * \param devs pointer to a list of struct_device returned from
- *             SDL_hid_enumerate().
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC void SDLCALL SDL_hid_free_enumeration(SDL_hid_device_info *devs);
-
-/**
- * Open a HID device using a Vendor ID (VID), Product ID (PID) and optionally
- * a serial number.
- *
- * If `serial_number` is NULL, the first device with the specified VID and PID
- * is opened.
- *
- * \param vendor_id the Vendor ID (VID) of the device to open.
- * \param product_id the Product ID (PID) of the device to open.
- * \param serial_number the Serial Number of the device to open (Optionally
- *                      NULL).
- * \returns a pointer to a SDL_hid_device object on success or NULL on
- *          failure; call SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_hid_device * SDLCALL SDL_hid_open(unsigned short vendor_id, unsigned short product_id, const wchar_t *serial_number);
-
-/**
- * Open a HID device by its path name.
- *
- * The path name be determined by calling SDL_hid_enumerate(), or a
- * platform-specific path name can be used (eg: /dev/hidraw0 on Linux).
- *
- * \param path the path name of the device to open.
- * \returns a pointer to a SDL_hid_device object on success or NULL on
- *          failure; call SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_hid_device * SDLCALL SDL_hid_open_path(const char *path);
-
-/**
- * Write an Output report to a HID device.
- *
- * The first byte of `data` must contain the Report ID. For devices which only
- * support a single report, this must be set to 0x0. The remaining bytes
- * contain the report data. Since the Report ID is mandatory, calls to
- * SDL_hid_write() will always contain one more byte than the report contains.
- * For example, if a hid report is 16 bytes long, 17 bytes must be passed to
- * SDL_hid_write(), the Report ID (or 0x0, for devices with a single report),
- * followed by the report data (16 bytes). In this example, the length passed
- * in would be 17.
- *
- * SDL_hid_write() will send the data on the first OUT endpoint, if one
- * exists. If it does not, it will send the data through the Control Endpoint
- * (Endpoint 0).
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param data the data to send, including the report number as the first
- *             byte.
- * \param length the length in bytes of the data to send.
- * \returns the actual number of bytes written and -1 on on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_write(SDL_hid_device *dev, const unsigned char *data, size_t length);
-
-/**
- * Read an Input report from a HID device with timeout.
- *
- * Input reports are returned to the host through the INTERRUPT IN endpoint.
- * The first byte will contain the Report number if the device uses numbered
- * reports.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param data a buffer to put the read data into.
- * \param length the number of bytes to read. For devices with multiple
- *               reports, make sure to read an extra byte for the report
- *               number.
- * \param milliseconds timeout in milliseconds or -1 for blocking wait.
- * \returns the actual number of bytes read and -1 on on failure; call
- *          SDL_GetError() for more information. If no packet was available to
- *          be read within the timeout period, this function returns 0.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_read_timeout(SDL_hid_device *dev, unsigned char *data, size_t length, int milliseconds);
-
-/**
- * Read an Input report from a HID device.
- *
- * Input reports are returned to the host through the INTERRUPT IN endpoint.
- * The first byte will contain the Report number if the device uses numbered
- * reports.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param data a buffer to put the read data into.
- * \param length the number of bytes to read. For devices with multiple
- *               reports, make sure to read an extra byte for the report
- *               number.
- * \returns the actual number of bytes read and -1 on failure; call
- *          SDL_GetError() for more information. If no packet was available to
- *          be read and the handle is in non-blocking mode, this function
- *          returns 0.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_read(SDL_hid_device *dev, unsigned char *data, size_t length);
-
-/**
- * Set the device handle to be non-blocking.
- *
- * In non-blocking mode calls to SDL_hid_read() will return immediately with a
- * value of 0 if there is no data to be read. In blocking mode, SDL_hid_read()
- * will wait (block) until there is data to read before returning.
- *
- * Nonblocking can be turned on and off at any time.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param nonblock enable or not the nonblocking reads - 1 to enable
- *                 nonblocking - 0 to disable nonblocking.
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_set_nonblocking(SDL_hid_device *dev, int nonblock);
-
-/**
- * Send a Feature report to the device.
- *
- * Feature reports are sent over the Control endpoint as a Set_Report
- * transfer. The first byte of `data` must contain the Report ID. For devices
- * which only support a single report, this must be set to 0x0. The remaining
- * bytes contain the report data. Since the Report ID is mandatory, calls to
- * SDL_hid_send_feature_report() will always contain one more byte than the
- * report contains. For example, if a hid report is 16 bytes long, 17 bytes
- * must be passed to SDL_hid_send_feature_report(): the Report ID (or 0x0, for
- * devices which do not use numbered reports), followed by the report data (16
- * bytes). In this example, the length passed in would be 17.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param data the data to send, including the report number as the first
- *             byte.
- * \param length the length in bytes of the data to send, including the report
- *               number.
- * \returns the actual number of bytes written and -1 on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_send_feature_report(SDL_hid_device *dev, const unsigned char *data, size_t length);
-
-/**
- * Get a feature report from a HID device.
- *
- * Set the first byte of `data` to the Report ID of the report to be read.
- * Make sure to allow space for this extra byte in `data`. Upon return, the
- * first byte will still contain the Report ID, and the report data will start
- * in data[1].
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param data a buffer to put the read data into, including the Report ID.
- *             Set the first byte of `data` to the Report ID of the report to
- *             be read, or set it to zero if your device does not use numbered
- *             reports.
- * \param length the number of bytes to read, including an extra byte for the
- *               report ID. The buffer can be longer than the actual report.
- * \returns the number of bytes read plus one for the report ID (which is
- *          still in the first byte), or -1 on on failure; call SDL_GetError()
- *          for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_get_feature_report(SDL_hid_device *dev, unsigned char *data, size_t length);
-
-/**
- * Get an input report from a HID device.
- *
- * Set the first byte of `data` to the Report ID of the report to be read.
- * Make sure to allow space for this extra byte in `data`. Upon return, the
- * first byte will still contain the Report ID, and the report data will start
- * in data[1].
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param data a buffer to put the read data into, including the Report ID.
- *             Set the first byte of `data` to the Report ID of the report to
- *             be read, or set it to zero if your device does not use numbered
- *             reports.
- * \param length the number of bytes to read, including an extra byte for the
- *               report ID. The buffer can be longer than the actual report.
- * \returns the number of bytes read plus one for the report ID (which is
- *          still in the first byte), or -1 on on failure; call SDL_GetError()
- *          for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_get_input_report(SDL_hid_device *dev, unsigned char *data, size_t length);
-
-/**
- * Close a HID device.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_close(SDL_hid_device *dev);
-
-/**
- * Get The Manufacturer String from a HID device.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param string a wide string buffer to put the data into.
- * \param maxlen the length of the buffer in multiples of wchar_t.
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_get_manufacturer_string(SDL_hid_device *dev, wchar_t *string, size_t maxlen);
-
-/**
- * Get The Product String from a HID device.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param string a wide string buffer to put the data into.
- * \param maxlen the length of the buffer in multiples of wchar_t.
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_get_product_string(SDL_hid_device *dev, wchar_t *string, size_t maxlen);
-
-/**
- * Get The Serial Number String from a HID device.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param string a wide string buffer to put the data into.
- * \param maxlen the length of the buffer in multiples of wchar_t.
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_get_serial_number_string(SDL_hid_device *dev, wchar_t *string, size_t maxlen);
-
-/**
- * Get a string from a HID device, based on its string index.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param string_index the index of the string to get.
- * \param string a wide string buffer to put the data into.
- * \param maxlen the length of the buffer in multiples of wchar_t.
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_get_indexed_string(SDL_hid_device *dev, int string_index, wchar_t *string, size_t maxlen);
-
-/**
- * Get the device info from a HID device.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \returns a pointer to the SDL_hid_device_info for this hid_device or NULL
- *          on failure; call SDL_GetError() for more information. This struct
- *          is valid until the device is closed with SDL_hid_close().
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_hid_device_info * SDLCALL SDL_hid_get_device_info(SDL_hid_device *dev);
-
-/**
- * Get a report descriptor from a HID device.
- *
- * User has to provide a preallocated buffer where descriptor will be copied
- * to. The recommended size for a preallocated buffer is 4096 bytes.
- *
- * \param dev a device handle returned from SDL_hid_open().
- * \param buf the buffer to copy descriptor into.
- * \param buf_size the size of the buffer in bytes.
- * \returns the number of bytes actually copied or -1 on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_hid_get_report_descriptor(SDL_hid_device *dev, unsigned char *buf, size_t buf_size);
-
-/**
- * Start or stop a BLE scan on iOS and tvOS to pair Steam Controllers.
- *
- * \param active true to start the scan, false to stop the scan.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC void SDLCALL SDL_hid_ble_scan(bool active);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_hidapi_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_init.h

@@ -1,497 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryInit
- *
- * All SDL programs need to initialize the library before starting to work
- * with it.
- *
- * Almost everything can simply call SDL_Init() near startup, with a handful
- * of flags to specify subsystems to touch. These are here to make sure SDL
- * does not even attempt to touch low-level pieces of the operating system
- * that you don't intend to use. For example, you might be using SDL for video
- * and input but chose an external library for audio, and in this case you
- * would just need to leave off the `SDL_INIT_AUDIO` flag to make sure that
- * external library has complete control.
- *
- * Most apps, when terminating, should call SDL_Quit(). This will clean up
- * (nearly) everything that SDL might have allocated, and crucially, it'll
- * make sure that the display's resolution is back to what the user expects if
- * you had previously changed it for your game.
- *
- * SDL3 apps are strongly encouraged to call SDL_SetAppMetadata() at startup
- * to fill in details about the program. This is completely optional, but it
- * helps in small ways (we can provide an About dialog box for the macOS menu,
- * we can name the app in the system's audio mixer, etc). Those that want to
- * provide a _lot_ of information should look at the more-detailed
- * SDL_SetAppMetadataProperty().
- */
-
-#ifndef SDL_init_h_
-#define SDL_init_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_events.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* As of version 0.5, SDL is loaded dynamically into the application */
-
-/**
- * Initialization flags for SDL_Init and/or SDL_InitSubSystem
- *
- * These are the flags which may be passed to SDL_Init(). You should specify
- * the subsystems which you will be using in your application.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_Init
- * \sa SDL_Quit
- * \sa SDL_InitSubSystem
- * \sa SDL_QuitSubSystem
- * \sa SDL_WasInit
- */
-typedef Uint32 SDL_InitFlags;
-
-#define SDL_INIT_AUDIO      0x00000010u /**< `SDL_INIT_AUDIO` implies `SDL_INIT_EVENTS` */
-#define SDL_INIT_VIDEO      0x00000020u /**< `SDL_INIT_VIDEO` implies `SDL_INIT_EVENTS`, should be initialized on the main thread */
-#define SDL_INIT_JOYSTICK   0x00000200u /**< `SDL_INIT_JOYSTICK` implies `SDL_INIT_EVENTS` */
-#define SDL_INIT_HAPTIC     0x00001000u
-#define SDL_INIT_GAMEPAD    0x00002000u /**< `SDL_INIT_GAMEPAD` implies `SDL_INIT_JOYSTICK` */
-#define SDL_INIT_EVENTS     0x00004000u
-#define SDL_INIT_SENSOR     0x00008000u /**< `SDL_INIT_SENSOR` implies `SDL_INIT_EVENTS` */
-#define SDL_INIT_CAMERA     0x00010000u /**< `SDL_INIT_CAMERA` implies `SDL_INIT_EVENTS` */
-
-/**
- * Return values for optional main callbacks.
- *
- * Returning SDL_APP_SUCCESS or SDL_APP_FAILURE from SDL_AppInit,
- * SDL_AppEvent, or SDL_AppIterate will terminate the program and report
- * success/failure to the operating system. What that means is
- * platform-dependent. On Unix, for example, on success, the process error
- * code will be zero, and on failure it will be 1. This interface doesn't
- * allow you to return specific exit codes, just whether there was an error
- * generally or not.
- *
- * Returning SDL_APP_CONTINUE from these functions will let the app continue
- * to run.
- *
- * See
- * [Main callbacks in SDL3](https://wiki.libsdl.org/SDL3/README/main-functions#main-callbacks-in-sdl3)
- * for complete details.
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_AppResult
-{
-    SDL_APP_CONTINUE,   /**< Value that requests that the app continue from the main callbacks. */
-    SDL_APP_SUCCESS,    /**< Value that requests termination with success from the main callbacks. */
-    SDL_APP_FAILURE     /**< Value that requests termination with error from the main callbacks. */
-} SDL_AppResult;
-
-/**
- * Function pointer typedef for SDL_AppInit.
- *
- * These are used by SDL_EnterAppMainCallbacks. This mechanism operates behind
- * the scenes for apps using the optional main callbacks. Apps that want to
- * use this should just implement SDL_AppInit directly.
- *
- * \param appstate a place where the app can optionally store a pointer for
- *                 future use.
- * \param argc the standard ANSI C main's argc; number of elements in `argv`.
- * \param argv the standard ANSI C main's argv; array of command line
- *             arguments.
- * \returns SDL_APP_FAILURE to terminate with an error, SDL_APP_SUCCESS to
- *          terminate with success, SDL_APP_CONTINUE to continue.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef SDL_AppResult (SDLCALL *SDL_AppInit_func)(void **appstate, int argc, char *argv[]);
-
-/**
- * Function pointer typedef for SDL_AppIterate.
- *
- * These are used by SDL_EnterAppMainCallbacks. This mechanism operates behind
- * the scenes for apps using the optional main callbacks. Apps that want to
- * use this should just implement SDL_AppIterate directly.
- *
- * \param appstate an optional pointer, provided by the app in SDL_AppInit.
- * \returns SDL_APP_FAILURE to terminate with an error, SDL_APP_SUCCESS to
- *          terminate with success, SDL_APP_CONTINUE to continue.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef SDL_AppResult (SDLCALL *SDL_AppIterate_func)(void *appstate);
-
-/**
- * Function pointer typedef for SDL_AppEvent.
- *
- * These are used by SDL_EnterAppMainCallbacks. This mechanism operates behind
- * the scenes for apps using the optional main callbacks. Apps that want to
- * use this should just implement SDL_AppEvent directly.
- *
- * \param appstate an optional pointer, provided by the app in SDL_AppInit.
- * \param event the new event for the app to examine.
- * \returns SDL_APP_FAILURE to terminate with an error, SDL_APP_SUCCESS to
- *          terminate with success, SDL_APP_CONTINUE to continue.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef SDL_AppResult (SDLCALL *SDL_AppEvent_func)(void *appstate, SDL_Event *event);
-
-/**
- * Function pointer typedef for SDL_AppQuit.
- *
- * These are used by SDL_EnterAppMainCallbacks. This mechanism operates behind
- * the scenes for apps using the optional main callbacks. Apps that want to
- * use this should just implement SDL_AppEvent directly.
- *
- * \param appstate an optional pointer, provided by the app in SDL_AppInit.
- * \param result the result code that terminated the app (success or failure).
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef void (SDLCALL *SDL_AppQuit_func)(void *appstate, SDL_AppResult result);
-
-
-/**
- * Initialize the SDL library.
- *
- * SDL_Init() simply forwards to calling SDL_InitSubSystem(). Therefore, the
- * two may be used interchangeably. Though for readability of your code
- * SDL_InitSubSystem() might be preferred.
- *
- * The file I/O (for example: SDL_IOFromFile) and threading (SDL_CreateThread)
- * subsystems are initialized by default. Message boxes
- * (SDL_ShowSimpleMessageBox) also attempt to work without initializing the
- * video subsystem, in hopes of being useful in showing an error dialog when
- * SDL_Init fails. You must specifically initialize other subsystems if you
- * use them in your application.
- *
- * Logging (such as SDL_Log) works without initialization, too.
- *
- * `flags` may be any of the following OR'd together:
- *
- * - `SDL_INIT_AUDIO`: audio subsystem; automatically initializes the events
- *   subsystem
- * - `SDL_INIT_VIDEO`: video subsystem; automatically initializes the events
- *   subsystem, should be initialized on the main thread.
- * - `SDL_INIT_JOYSTICK`: joystick subsystem; automatically initializes the
- *   events subsystem
- * - `SDL_INIT_HAPTIC`: haptic (force feedback) subsystem
- * - `SDL_INIT_GAMEPAD`: gamepad subsystem; automatically initializes the
- *   joystick subsystem
- * - `SDL_INIT_EVENTS`: events subsystem
- * - `SDL_INIT_SENSOR`: sensor subsystem; automatically initializes the events
- *   subsystem
- * - `SDL_INIT_CAMERA`: camera subsystem; automatically initializes the events
- *   subsystem
- *
- * Subsystem initialization is ref-counted, you must call SDL_QuitSubSystem()
- * for each SDL_InitSubSystem() to correctly shutdown a subsystem manually (or
- * call SDL_Quit() to force shutdown). If a subsystem is already loaded then
- * this call will increase the ref-count and return.
- *
- * Consider reporting some basic metadata about your application before
- * calling SDL_Init, using either SDL_SetAppMetadata() or
- * SDL_SetAppMetadataProperty().
- *
- * \param flags subsystem initialization flags.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetAppMetadata
- * \sa SDL_SetAppMetadataProperty
- * \sa SDL_InitSubSystem
- * \sa SDL_Quit
- * \sa SDL_SetMainReady
- * \sa SDL_WasInit
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_Init(SDL_InitFlags flags);
-
-/**
- * Compatibility function to initialize the SDL library.
- *
- * This function and SDL_Init() are interchangeable.
- *
- * \param flags any of the flags used by SDL_Init(); see SDL_Init for details.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Init
- * \sa SDL_Quit
- * \sa SDL_QuitSubSystem
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_InitSubSystem(SDL_InitFlags flags);
-
-/**
- * Shut down specific SDL subsystems.
- *
- * You still need to call SDL_Quit() even if you close all open subsystems
- * with SDL_QuitSubSystem().
- *
- * \param flags any of the flags used by SDL_Init(); see SDL_Init for details.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_InitSubSystem
- * \sa SDL_Quit
- */
-extern SDL_DECLSPEC void SDLCALL SDL_QuitSubSystem(SDL_InitFlags flags);
-
-/**
- * Get a mask of the specified subsystems which are currently initialized.
- *
- * \param flags any of the flags used by SDL_Init(); see SDL_Init for details.
- * \returns a mask of all initialized subsystems if `flags` is 0, otherwise it
- *          returns the initialization status of the specified subsystems.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Init
- * \sa SDL_InitSubSystem
- */
-extern SDL_DECLSPEC SDL_InitFlags SDLCALL SDL_WasInit(SDL_InitFlags flags);
-
-/**
- * Clean up all initialized subsystems.
- *
- * You should call this function even if you have already shutdown each
- * initialized subsystem with SDL_QuitSubSystem(). It is safe to call this
- * function even in the case of errors in initialization.
- *
- * You can use this function with atexit() to ensure that it is run when your
- * application is shutdown, but it is not wise to do this from a library or
- * other dynamically loaded code.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Init
- * \sa SDL_QuitSubSystem
- */
-extern SDL_DECLSPEC void SDLCALL SDL_Quit(void);
-
-/**
- * Return whether this is the main thread.
- *
- * On Apple platforms, the main thread is the thread that runs your program's
- * main() entry point. On other platforms, the main thread is the one that
- * calls SDL_Init(SDL_INIT_VIDEO), which should usually be the one that runs
- * your program's main() entry point. If you are using the main callbacks,
- * SDL_AppInit(), SDL_AppIterate(), and SDL_AppQuit() are all called on the
- * main thread.
- *
- * \returns true if this thread is the main thread, or false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_RunOnMainThread
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_IsMainThread(void);
-
-/**
- * Callback run on the main thread.
- *
- * \param userdata an app-controlled pointer that is passed to the callback.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_RunOnMainThread
- */
-typedef void (SDLCALL *SDL_MainThreadCallback)(void *userdata);
-
-/**
- * Call a function on the main thread during event processing.
- *
- * If this is called on the main thread, the callback is executed immediately.
- * If this is called on another thread, this callback is queued for execution
- * on the main thread during event processing.
- *
- * Be careful of deadlocks when using this functionality. You should not have
- * the main thread wait for the current thread while this function is being
- * called with `wait_complete` true.
- *
- * \param callback the callback to call on the main thread.
- * \param userdata a pointer that is passed to `callback`.
- * \param wait_complete true to wait for the callback to complete, false to
- *                      return immediately.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_IsMainThread
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_RunOnMainThread(SDL_MainThreadCallback callback, void *userdata, bool wait_complete);
-
-/**
- * Specify basic metadata about your app.
- *
- * You can optionally provide metadata about your app to SDL. This is not
- * required, but strongly encouraged.
- *
- * There are several locations where SDL can make use of metadata (an "About"
- * box in the macOS menu bar, the name of the app can be shown on some audio
- * mixers, etc). Any piece of metadata can be left as NULL, if a specific
- * detail doesn't make sense for the app.
- *
- * This function should be called as early as possible, before SDL_Init.
- * Multiple calls to this function are allowed, but various state might not
- * change once it has been set up with a previous call to this function.
- *
- * Passing a NULL removes any previous metadata.
- *
- * This is a simplified interface for the most important information. You can
- * supply significantly more detailed metadata with
- * SDL_SetAppMetadataProperty().
- *
- * \param appname The name of the application ("My Game 2: Bad Guy's
- *                Revenge!").
- * \param appversion The version of the application ("1.0.0beta5" or a git
- *                   hash, or whatever makes sense).
- * \param appidentifier A unique string in reverse-domain format that
- *                      identifies this app ("com.example.mygame2").
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetAppMetadataProperty
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetAppMetadata(const char *appname, const char *appversion, const char *appidentifier);
-
-/**
- * Specify metadata about your app through a set of properties.
- *
- * You can optionally provide metadata about your app to SDL. This is not
- * required, but strongly encouraged.
- *
- * There are several locations where SDL can make use of metadata (an "About"
- * box in the macOS menu bar, the name of the app can be shown on some audio
- * mixers, etc). Any piece of metadata can be left out, if a specific detail
- * doesn't make sense for the app.
- *
- * This function should be called as early as possible, before SDL_Init.
- * Multiple calls to this function are allowed, but various state might not
- * change once it has been set up with a previous call to this function.
- *
- * Once set, this metadata can be read using SDL_GetAppMetadataProperty().
- *
- * These are the supported properties:
- *
- * - `SDL_PROP_APP_METADATA_NAME_STRING`: The human-readable name of the
- *   application, like "My Game 2: Bad Guy's Revenge!". This will show up
- *   anywhere the OS shows the name of the application separately from window
- *   titles, such as volume control applets, etc. This defaults to "SDL
- *   Application".
- * - `SDL_PROP_APP_METADATA_VERSION_STRING`: The version of the app that is
- *   running; there are no rules on format, so "1.0.3beta2" and "April 22nd,
- *   2024" and a git hash are all valid options. This has no default.
- * - `SDL_PROP_APP_METADATA_IDENTIFIER_STRING`: A unique string that
- *   identifies this app. This must be in reverse-domain format, like
- *   "com.example.mygame2". This string is used by desktop compositors to
- *   identify and group windows together, as well as match applications with
- *   associated desktop settings and icons. If you plan to package your
- *   application in a container such as Flatpak, the app ID should match the
- *   name of your Flatpak container as well. This has no default.
- * - `SDL_PROP_APP_METADATA_CREATOR_STRING`: The human-readable name of the
- *   creator/developer/maker of this app, like "MojoWorkshop, LLC"
- * - `SDL_PROP_APP_METADATA_COPYRIGHT_STRING`: The human-readable copyright
- *   notice, like "Copyright (c) 2024 MojoWorkshop, LLC" or whatnot. Keep this
- *   to one line, don't paste a copy of a whole software license in here. This
- *   has no default.
- * - `SDL_PROP_APP_METADATA_URL_STRING`: A URL to the app on the web. Maybe a
- *   product page, or a storefront, or even a GitHub repository, for user's
- *   further information This has no default.
- * - `SDL_PROP_APP_METADATA_TYPE_STRING`: The type of application this is.
- *   Currently this string can be "game" for a video game, "mediaplayer" for a
- *   media player, or generically "application" if nothing else applies.
- *   Future versions of SDL might add new types. This defaults to
- *   "application".
- *
- * \param name the name of the metadata property to set.
- * \param value the value of the property, or NULL to remove that property.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetAppMetadataProperty
- * \sa SDL_SetAppMetadata
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetAppMetadataProperty(const char *name, const char *value);
-
-#define SDL_PROP_APP_METADATA_NAME_STRING         "SDL.app.metadata.name"
-#define SDL_PROP_APP_METADATA_VERSION_STRING      "SDL.app.metadata.version"
-#define SDL_PROP_APP_METADATA_IDENTIFIER_STRING   "SDL.app.metadata.identifier"
-#define SDL_PROP_APP_METADATA_CREATOR_STRING      "SDL.app.metadata.creator"
-#define SDL_PROP_APP_METADATA_COPYRIGHT_STRING    "SDL.app.metadata.copyright"
-#define SDL_PROP_APP_METADATA_URL_STRING          "SDL.app.metadata.url"
-#define SDL_PROP_APP_METADATA_TYPE_STRING         "SDL.app.metadata.type"
-
-/**
- * Get metadata about your app.
- *
- * This returns metadata previously set using SDL_SetAppMetadata() or
- * SDL_SetAppMetadataProperty(). See SDL_SetAppMetadataProperty() for the list
- * of available properties and their meanings.
- *
- * \param name the name of the metadata property to get.
- * \returns the current value of the metadata property, or the default if it
- *          is not set, NULL for properties with no default.
- *
- * \threadsafety It is safe to call this function from any thread, although
- *               the string returned is not protected and could potentially be
- *               freed if you call SDL_SetAppMetadataProperty() to set that
- *               property from another thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetAppMetadata
- * \sa SDL_SetAppMetadataProperty
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetAppMetadataProperty(const char *name);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_init_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_intrin.h

@@ -1,407 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: Intrinsics */
-
-/**
- * # CategoryIntrinsics
- *
- * SDL does some preprocessor gymnastics to determine if any CPU-specific
- * compiler intrinsics are available, as this is not necessarily an easy thing
- * to calculate, and sometimes depends on quirks of a system, versions of
- * build tools, and other external forces.
- *
- * Apps including SDL's headers will be able to check consistent preprocessor
- * definitions to decide if it's safe to use compiler intrinsics for a
- * specific CPU architecture. This check only tells you that the compiler is
- * capable of using those intrinsics; at runtime, you should still check if
- * they are available on the current system with the
- * [CPU info functions](https://wiki.libsdl.org/SDL3/CategoryCPUInfo)
- * , such as SDL_HasSSE() or SDL_HasNEON(). Otherwise, the process might crash
- * for using an unsupported CPU instruction.
- *
- * SDL only sets preprocessor defines for CPU intrinsics if they are
- * supported, so apps should check with `#ifdef` and not `#if`.
- *
- * SDL will also include the appropriate instruction-set-specific support
- * headers, so if SDL decides to define SDL_SSE2_INTRINSICS, it will also
- * `#include <emmintrin.h>` as well.
- */
-
-#ifndef SDL_intrin_h_
-#define SDL_intrin_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * Defined if (and only if) the compiler supports Loongarch LSX intrinsics.
- *
- * If this macro is defined, SDL will have already included `<lsxintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_LASX_INTRINSICS
- */
-#define SDL_LSX_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Loongarch LSX intrinsics.
- *
- * If this macro is defined, SDL will have already included `<lasxintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_LASX_INTRINSICS
- */
-#define SDL_LASX_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports ARM NEON intrinsics.
- *
- * If this macro is defined, SDL will have already included `<armintr.h>`
- * `<arm_neon.h>`, `<arm64intr.h>`, and `<arm64_neon.h>`, as appropriate.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_NEON_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports PowerPC Altivec intrinsics.
- *
- * If this macro is defined, SDL will have already included `<altivec.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_ALTIVEC_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel MMX intrinsics.
- *
- * If this macro is defined, SDL will have already included `<mmintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_SSE_INTRINSICS
- */
-#define SDL_MMX_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel SSE intrinsics.
- *
- * If this macro is defined, SDL will have already included `<xmmintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_SSE2_INTRINSICS
- * \sa SDL_SSE3_INTRINSICS
- * \sa SDL_SSE4_1_INTRINSICS
- * \sa SDL_SSE4_2_INTRINSICS
- */
-#define SDL_SSE_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel SSE2 intrinsics.
- *
- * If this macro is defined, SDL will have already included `<emmintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_SSE_INTRINSICS
- * \sa SDL_SSE3_INTRINSICS
- * \sa SDL_SSE4_1_INTRINSICS
- * \sa SDL_SSE4_2_INTRINSICS
- */
-#define SDL_SSE2_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel SSE3 intrinsics.
- *
- * If this macro is defined, SDL will have already included `<pmmintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_SSE_INTRINSICS
- * \sa SDL_SSE2_INTRINSICS
- * \sa SDL_SSE4_1_INTRINSICS
- * \sa SDL_SSE4_2_INTRINSICS
- */
-#define SDL_SSE3_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel SSE4.1 intrinsics.
- *
- * If this macro is defined, SDL will have already included `<smmintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_SSE_INTRINSICS
- * \sa SDL_SSE2_INTRINSICS
- * \sa SDL_SSE3_INTRINSICS
- * \sa SDL_SSE4_2_INTRINSICS
- */
-#define SDL_SSE4_1_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel SSE4.2 intrinsics.
- *
- * If this macro is defined, SDL will have already included `<nmmintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_SSE_INTRINSICS
- * \sa SDL_SSE2_INTRINSICS
- * \sa SDL_SSE3_INTRINSICS
- * \sa SDL_SSE4_1_INTRINSICS
- */
-#define SDL_SSE4_2_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel AVX intrinsics.
- *
- * If this macro is defined, SDL will have already included `<immintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_AVX2_INTRINSICS
- * \sa SDL_AVX512F_INTRINSICS
- */
-#define SDL_AVX_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel AVX2 intrinsics.
- *
- * If this macro is defined, SDL will have already included `<immintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_AVX_INTRINSICS
- * \sa SDL_AVX512F_INTRINSICS
- */
-#define SDL_AVX2_INTRINSICS 1
-
-/**
- * Defined if (and only if) the compiler supports Intel AVX-512F intrinsics.
- *
- * AVX-512F is also sometimes referred to as "AVX-512 Foundation."
- *
- * If this macro is defined, SDL will have already included `<immintrin.h>`
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_AVX_INTRINSICS
- * \sa SDL_AVX2_INTRINSICS
- */
-#define SDL_AVX512F_INTRINSICS 1
-#endif
-
-/* Need to do this here because intrin.h has C++ code in it */
-/* Visual Studio 2005 has a bug where intrin.h conflicts with winnt.h */
-#if defined(_MSC_VER) && (_MSC_VER >= 1500) && (defined(_M_IX86) || defined(_M_X64))
-#ifdef __clang__
-/* As of Clang 11, '_m_prefetchw' is conflicting with the winnt.h's version,
-   so we define the needed '_m_prefetch' here as a pseudo-header, until the issue is fixed. */
-#ifndef __PRFCHWINTRIN_H
-#define __PRFCHWINTRIN_H
-static __inline__ void __attribute__((__always_inline__, __nodebug__))
-_m_prefetch(void *__P)
-{
-  __builtin_prefetch (__P, 0, 3 /* _MM_HINT_T0 */);
-}
-#endif /* __PRFCHWINTRIN_H */
-#endif /* __clang__ */
-#include <intrin.h>
-
-#elif defined(__MINGW64_VERSION_MAJOR)
-#include <intrin.h>
-#if defined(__ARM_NEON) && !defined(SDL_DISABLE_NEON)
-#  define SDL_NEON_INTRINSICS 1
-#  include <arm_neon.h>
-#endif
-
-#else
-/* altivec.h redefining bool causes a number of problems, see bugs 3993 and 4392, so you need to explicitly define SDL_ENABLE_ALTIVEC to have it included. */
-#if defined(__ALTIVEC__) && defined(SDL_ENABLE_ALTIVEC)
-#define SDL_ALTIVEC_INTRINSICS 1
-#include <altivec.h>
-#endif
-#ifndef SDL_DISABLE_NEON
-#  ifdef __ARM_NEON
-#    define SDL_NEON_INTRINSICS 1
-#    include <arm_neon.h>
-#  elif defined(SDL_PLATFORM_WINDOWS)
-/* Visual Studio doesn't define __ARM_ARCH, but _M_ARM (if set, always 7), and _M_ARM64 (if set, always 1). */
-#    ifdef _M_ARM
-#      define SDL_NEON_INTRINSICS 1
-#      include <armintr.h>
-#      include <arm_neon.h>
-#      define __ARM_NEON 1 /* Set __ARM_NEON so that it can be used elsewhere, at compile time */
-#    endif
-#    if defined (_M_ARM64)
-#      define SDL_NEON_INTRINSICS 1
-#      include <arm64intr.h>
-#      include <arm64_neon.h>
-#      define __ARM_NEON 1 /* Set __ARM_NEON so that it can be used elsewhere, at compile time */
-#      define __ARM_ARCH 8
-#    endif
-#  endif
-#endif
-#endif /* compiler version */
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-/**
- * A macro to decide if the compiler supports `__attribute__((target))`.
- *
- * Even though this is defined in SDL's public headers, it is generally not
- * used directly by apps. Apps should probably just use SDL_TARGETING
- * directly, instead.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_TARGETING
- */
-#define SDL_HAS_TARGET_ATTRIBS
-
-#elif defined(__clang__) && defined(__has_attribute)
-# if __has_attribute(target)
-# define SDL_HAS_TARGET_ATTRIBS
-# endif
-#elif defined(__GNUC__) && (__GNUC__ + (__GNUC_MINOR__ >= 9) > 4) /* gcc >= 4.9 */
-# define SDL_HAS_TARGET_ATTRIBS
-#elif defined(__ICC) && __ICC >= 1600
-# define SDL_HAS_TARGET_ATTRIBS
-#endif
-
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A macro to tag a function as targeting a specific CPU architecture.
- *
- * This is a hint to the compiler that a function should be built with support
- * for a CPU instruction set that might be different than the rest of the
- * program.
- *
- * The particulars of this are explained in the GCC documentation:
- *
- * https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-target-function-attribute
- *
- * An example of using this feature is to turn on SSE2 support for a specific
- * function, even if the rest of the source code is not compiled to use SSE2
- * code:
- *
- * ```c
- * #ifdef SDL_SSE2_INTRINSICS
- * static void SDL_TARGETING("sse2") DoSomethingWithSSE2(char *x) {
- *    ...use SSE2 intrinsic functions, etc...
- * }
- * #endif
- *
- * // later...
- * #ifdef SDL_SSE2_INTRINSICS
- * if (SDL_HasSSE2()) {
- *     DoSomethingWithSSE2(str);
- * }
- * #endif
- * ```
- *
- * The application is, on a whole, built without SSE2 instructions, so it will
- * run on Intel machines that don't support SSE2. But then at runtime, it
- * checks if the system supports the instructions, and then calls into a
- * function that uses SSE2 opcodes. The ifdefs make sure that this code isn't
- * used on platforms that don't have SSE2 at all.
- *
- * On compilers without target support, this is defined to nothing.
- *
- * This symbol is used by SDL internally, but apps and other libraries are
- * welcome to use it for their own interfaces as well.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_TARGETING(x) __attribute__((target(x)))
-
-#elif defined(SDL_HAS_TARGET_ATTRIBS)
-# define SDL_TARGETING(x) __attribute__((target(x)))
-#else
-# define SDL_TARGETING(x)
-#endif
-
-#ifdef __loongarch64
-# ifndef SDL_DISABLE_LSX
-#  define SDL_LSX_INTRINSICS 1
-#  include <lsxintrin.h>
-# endif
-# ifndef SDL_DISABLE_LASX
-#  define SDL_LASX_INTRINSICS 1
-#  include <lasxintrin.h>
-# endif
-#endif
-
-#if defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || defined(_M_IX86)
-# if ((defined(_MSC_VER) && !defined(_M_X64)) || defined(__MMX__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_MMX)
-#  define SDL_MMX_INTRINSICS 1
-#  include <mmintrin.h>
-# endif
-# if (defined(_MSC_VER) || defined(__SSE__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE)
-#  define SDL_SSE_INTRINSICS 1
-#  include <xmmintrin.h>
-# endif
-# if (defined(_MSC_VER) || defined(__SSE2__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE2)
-#  define SDL_SSE2_INTRINSICS 1
-#  include <emmintrin.h>
-# endif
-# if (defined(_MSC_VER) || defined(__SSE3__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE3)
-#  define SDL_SSE3_INTRINSICS 1
-#  include <pmmintrin.h>
-# endif
-# if (defined(_MSC_VER) || defined(__SSE4_1__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE4_1)
-#  define SDL_SSE4_1_INTRINSICS 1
-#  include <smmintrin.h>
-# endif
-# if (defined(_MSC_VER) || defined(__SSE4_2__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE4_2)
-#  define SDL_SSE4_2_INTRINSICS 1
-#  include <nmmintrin.h>
-# endif
-# if defined(__clang__) && (defined(_MSC_VER) || defined(__SCE__)) && !defined(__AVX__) && !defined(SDL_DISABLE_AVX)
-#  define SDL_DISABLE_AVX       /* see https://reviews.llvm.org/D20291 and https://reviews.llvm.org/D79194 */
-# endif
-# if (defined(_MSC_VER) || defined(__AVX__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(_M_ARM64EC) && !defined(SDL_DISABLE_AVX)
-#  define SDL_AVX_INTRINSICS 1
-#  include <immintrin.h>
-# endif
-# if defined(__clang__) && (defined(_MSC_VER) || defined(__SCE__)) && !defined(__AVX2__) && !defined(SDL_DISABLE_AVX2)
-#  define SDL_DISABLE_AVX2      /* see https://reviews.llvm.org/D20291 and https://reviews.llvm.org/D79194 */
-# endif
-# if (defined(_MSC_VER) || defined(__AVX2__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(_M_ARM64EC) && !defined(SDL_DISABLE_AVX2)
-#  define SDL_AVX2_INTRINSICS 1
-#  include <immintrin.h>
-# endif
-# if defined(__clang__) && (defined(_MSC_VER) || defined(__SCE__)) && !defined(__AVX512F__) && !defined(SDL_DISABLE_AVX512F)
-#  define SDL_DISABLE_AVX512F   /* see https://reviews.llvm.org/D20291 and https://reviews.llvm.org/D79194 */
-# endif
-# if (defined(_MSC_VER) || defined(__AVX512F__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(_M_ARM64EC) && !defined(SDL_DISABLE_AVX512F)
-#  define SDL_AVX512F_INTRINSICS 1
-#  include <immintrin.h>
-# endif
-#endif /* defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || defined(_M_IX86) */
-
-#endif /* SDL_intrin_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_keyboard.h

@@ -1,609 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryKeyboard
- *
- * SDL keyboard management.
- *
- * Please refer to the Best Keyboard Practices document for details on how
- * best to accept keyboard input in various types of programs:
- *
- * https://wiki.libsdl.org/SDL3/BestKeyboardPractices
- */
-
-#ifndef SDL_keyboard_h_
-#define SDL_keyboard_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_keycode.h>
-#include <SDL3/SDL_properties.h>
-#include <SDL3/SDL_rect.h>
-#include <SDL3/SDL_scancode.h>
-#include <SDL3/SDL_video.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * This is a unique ID for a keyboard for the time it is connected to the
- * system, and is never reused for the lifetime of the application.
- *
- * If the keyboard is disconnected and reconnected, it will get a new ID.
- *
- * The value 0 is an invalid ID.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_KeyboardID;
-
-/* Function prototypes */
-
-/**
- * Return whether a keyboard is currently connected.
- *
- * \returns true if a keyboard is connected, false otherwise.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyboards
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasKeyboard(void);
-
-/**
- * Get a list of currently connected keyboards.
- *
- * Note that this will include any device or virtual driver that includes
- * keyboard functionality, including some mice, KVM switches, motherboard
- * power buttons, etc. You should wait for input from a device before you
- * consider it actively in use.
- *
- * \param count a pointer filled in with the number of keyboards returned, may
- *              be NULL.
- * \returns a 0 terminated array of keyboards instance IDs or NULL on failure;
- *          call SDL_GetError() for more information. This should be freed
- *          with SDL_free() when it is no longer needed.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyboardNameForID
- * \sa SDL_HasKeyboard
- */
-extern SDL_DECLSPEC SDL_KeyboardID * SDLCALL SDL_GetKeyboards(int *count);
-
-/**
- * Get the name of a keyboard.
- *
- * This function returns "" if the keyboard doesn't have a name.
- *
- * \param instance_id the keyboard instance ID.
- * \returns the name of the selected keyboard or NULL on failure; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyboards
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetKeyboardNameForID(SDL_KeyboardID instance_id);
-
-/**
- * Query the window which currently has keyboard focus.
- *
- * \returns the window with keyboard focus.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_GetKeyboardFocus(void);
-
-/**
- * Get a snapshot of the current state of the keyboard.
- *
- * The pointer returned is a pointer to an internal SDL array. It will be
- * valid for the whole lifetime of the application and should not be freed by
- * the caller.
- *
- * A array element with a value of true means that the key is pressed and a
- * value of false means that it is not. Indexes into this array are obtained
- * by using SDL_Scancode values.
- *
- * Use SDL_PumpEvents() to update the state array.
- *
- * This function gives you the current state after all events have been
- * processed, so if a key or button has been pressed and released before you
- * process events, then the pressed state will never show up in the
- * SDL_GetKeyboardState() calls.
- *
- * Note: This function doesn't take into account whether shift has been
- * pressed or not.
- *
- * \param numkeys if non-NULL, receives the length of the returned array.
- * \returns a pointer to an array of key states.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_PumpEvents
- * \sa SDL_ResetKeyboard
- */
-extern SDL_DECLSPEC const bool * SDLCALL SDL_GetKeyboardState(int *numkeys);
-
-/**
- * Clear the state of the keyboard.
- *
- * This function will generate key up events for all pressed keys.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyboardState
- */
-extern SDL_DECLSPEC void SDLCALL SDL_ResetKeyboard(void);
-
-/**
- * Get the current key modifier state for the keyboard.
- *
- * \returns an OR'd combination of the modifier keys for the keyboard. See
- *          SDL_Keymod for details.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyboardState
- * \sa SDL_SetModState
- */
-extern SDL_DECLSPEC SDL_Keymod SDLCALL SDL_GetModState(void);
-
-/**
- * Set the current key modifier state for the keyboard.
- *
- * The inverse of SDL_GetModState(), SDL_SetModState() allows you to impose
- * modifier key states on your application. Simply pass your desired modifier
- * states into `modstate`. This value may be a bitwise, OR'd combination of
- * SDL_Keymod values.
- *
- * This does not change the keyboard state, only the key modifier flags that
- * SDL reports.
- *
- * \param modstate the desired SDL_Keymod for the keyboard.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetModState
- */
-extern SDL_DECLSPEC void SDLCALL SDL_SetModState(SDL_Keymod modstate);
-
-/**
- * Get the key code corresponding to the given scancode according to the
- * current keyboard layout.
- *
- * If you want to get the keycode as it would be delivered in key events,
- * including options specified in SDL_HINT_KEYCODE_OPTIONS, then you should
- * pass `key_event` as true. Otherwise this function simply translates the
- * scancode based on the given modifier state.
- *
- * \param scancode the desired SDL_Scancode to query.
- * \param modstate the modifier state to use when translating the scancode to
- *                 a keycode.
- * \param key_event true if the keycode will be used in key events.
- * \returns the SDL_Keycode that corresponds to the given SDL_Scancode.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyName
- * \sa SDL_GetScancodeFromKey
- */
-extern SDL_DECLSPEC SDL_Keycode SDLCALL SDL_GetKeyFromScancode(SDL_Scancode scancode, SDL_Keymod modstate, bool key_event);
-
-/**
- * Get the scancode corresponding to the given key code according to the
- * current keyboard layout.
- *
- * Note that there may be multiple scancode+modifier states that can generate
- * this keycode, this will just return the first one found.
- *
- * \param key the desired SDL_Keycode to query.
- * \param modstate a pointer to the modifier state that would be used when the
- *                 scancode generates this key, may be NULL.
- * \returns the SDL_Scancode that corresponds to the given SDL_Keycode.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyFromScancode
- * \sa SDL_GetScancodeName
- */
-extern SDL_DECLSPEC SDL_Scancode SDLCALL SDL_GetScancodeFromKey(SDL_Keycode key, SDL_Keymod *modstate);
-
-/**
- * Set a human-readable name for a scancode.
- *
- * \param scancode the desired SDL_Scancode.
- * \param name the name to use for the scancode, encoded as UTF-8. The string
- *             is not copied, so the pointer given to this function must stay
- *             valid while SDL is being used.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetScancodeName
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetScancodeName(SDL_Scancode scancode, const char *name);
-
-/**
- * Get a human-readable name for a scancode.
- *
- * **Warning**: The returned name is by design not stable across platforms,
- * e.g. the name for `SDL_SCANCODE_LGUI` is "Left GUI" under Linux but "Left
- * Windows" under Microsoft Windows, and some scancodes like
- * `SDL_SCANCODE_NONUSBACKSLASH` don't have any name at all. There are even
- * scancodes that share names, e.g. `SDL_SCANCODE_RETURN` and
- * `SDL_SCANCODE_RETURN2` (both called "Return"). This function is therefore
- * unsuitable for creating a stable cross-platform two-way mapping between
- * strings and scancodes.
- *
- * \param scancode the desired SDL_Scancode to query.
- * \returns a pointer to the name for the scancode. If the scancode doesn't
- *          have a name this function returns an empty string ("").
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetScancodeFromKey
- * \sa SDL_GetScancodeFromName
- * \sa SDL_SetScancodeName
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetScancodeName(SDL_Scancode scancode);
-
-/**
- * Get a scancode from a human-readable name.
- *
- * \param name the human-readable scancode name.
- * \returns the SDL_Scancode, or `SDL_SCANCODE_UNKNOWN` if the name wasn't
- *          recognized; call SDL_GetError() for more information.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyFromName
- * \sa SDL_GetScancodeFromKey
- * \sa SDL_GetScancodeName
- */
-extern SDL_DECLSPEC SDL_Scancode SDLCALL SDL_GetScancodeFromName(const char *name);
-
-/**
- * Get a human-readable name for a key.
- *
- * If the key doesn't have a name, this function returns an empty string ("").
- *
- * Letters will be presented in their uppercase form, if applicable.
- *
- * \param key the desired SDL_Keycode to query.
- * \returns a UTF-8 encoded string of the key name.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyFromName
- * \sa SDL_GetKeyFromScancode
- * \sa SDL_GetScancodeFromKey
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetKeyName(SDL_Keycode key);
-
-/**
- * Get a key code from a human-readable name.
- *
- * \param name the human-readable key name.
- * \returns key code, or `SDLK_UNKNOWN` if the name wasn't recognized; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetKeyFromScancode
- * \sa SDL_GetKeyName
- * \sa SDL_GetScancodeFromName
- */
-extern SDL_DECLSPEC SDL_Keycode SDLCALL SDL_GetKeyFromName(const char *name);
-
-/**
- * Start accepting Unicode text input events in a window.
- *
- * This function will enable text input (SDL_EVENT_TEXT_INPUT and
- * SDL_EVENT_TEXT_EDITING events) in the specified window. Please use this
- * function paired with SDL_StopTextInput().
- *
- * Text input events are not received by default.
- *
- * On some platforms using this function shows the screen keyboard and/or
- * activates an IME, which can prevent some key press events from being passed
- * through.
- *
- * \param window the window to enable text input.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetTextInputArea
- * \sa SDL_StartTextInputWithProperties
- * \sa SDL_StopTextInput
- * \sa SDL_TextInputActive
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_StartTextInput(SDL_Window *window);
-
-/**
- * Text input type.
- *
- * These are the valid values for SDL_PROP_TEXTINPUT_TYPE_NUMBER. Not every
- * value is valid on every platform, but where a value isn't supported, a
- * reasonable fallback will be used.
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_StartTextInputWithProperties
- */
-typedef enum SDL_TextInputType
-{
-    SDL_TEXTINPUT_TYPE_TEXT,                        /**< The input is text */
-    SDL_TEXTINPUT_TYPE_TEXT_NAME,                   /**< The input is a person's name */
-    SDL_TEXTINPUT_TYPE_TEXT_EMAIL,                  /**< The input is an e-mail address */
-    SDL_TEXTINPUT_TYPE_TEXT_USERNAME,               /**< The input is a username */
-    SDL_TEXTINPUT_TYPE_TEXT_PASSWORD_HIDDEN,        /**< The input is a secure password that is hidden */
-    SDL_TEXTINPUT_TYPE_TEXT_PASSWORD_VISIBLE,       /**< The input is a secure password that is visible */
-    SDL_TEXTINPUT_TYPE_NUMBER,                      /**< The input is a number */
-    SDL_TEXTINPUT_TYPE_NUMBER_PASSWORD_HIDDEN,      /**< The input is a secure PIN that is hidden */
-    SDL_TEXTINPUT_TYPE_NUMBER_PASSWORD_VISIBLE      /**< The input is a secure PIN that is visible */
-} SDL_TextInputType;
-
-/**
- * Auto capitalization type.
- *
- * These are the valid values for SDL_PROP_TEXTINPUT_CAPITALIZATION_NUMBER.
- * Not every value is valid on every platform, but where a value isn't
- * supported, a reasonable fallback will be used.
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_StartTextInputWithProperties
- */
-typedef enum SDL_Capitalization
-{
-    SDL_CAPITALIZE_NONE,        /**< No auto-capitalization will be done */
-    SDL_CAPITALIZE_SENTENCES,   /**< The first letter of sentences will be capitalized */
-    SDL_CAPITALIZE_WORDS,       /**< The first letter of words will be capitalized */
-    SDL_CAPITALIZE_LETTERS      /**< All letters will be capitalized */
-} SDL_Capitalization;
-
-/**
- * Start accepting Unicode text input events in a window, with properties
- * describing the input.
- *
- * This function will enable text input (SDL_EVENT_TEXT_INPUT and
- * SDL_EVENT_TEXT_EDITING events) in the specified window. Please use this
- * function paired with SDL_StopTextInput().
- *
- * Text input events are not received by default.
- *
- * On some platforms using this function shows the screen keyboard and/or
- * activates an IME, which can prevent some key press events from being passed
- * through.
- *
- * These are the supported properties:
- *
- * - `SDL_PROP_TEXTINPUT_TYPE_NUMBER` - an SDL_TextInputType value that
- *   describes text being input, defaults to SDL_TEXTINPUT_TYPE_TEXT.
- * - `SDL_PROP_TEXTINPUT_CAPITALIZATION_NUMBER` - an SDL_Capitalization value
- *   that describes how text should be capitalized, defaults to
- *   SDL_CAPITALIZE_SENTENCES for normal text entry, SDL_CAPITALIZE_WORDS for
- *   SDL_TEXTINPUT_TYPE_TEXT_NAME, and SDL_CAPITALIZE_NONE for e-mail
- *   addresses, usernames, and passwords.
- * - `SDL_PROP_TEXTINPUT_AUTOCORRECT_BOOLEAN` - true to enable auto completion
- *   and auto correction, defaults to true.
- * - `SDL_PROP_TEXTINPUT_MULTILINE_BOOLEAN` - true if multiple lines of text
- *   are allowed. This defaults to true if SDL_HINT_RETURN_KEY_HIDES_IME is
- *   "0" or is not set, and defaults to false if SDL_HINT_RETURN_KEY_HIDES_IME
- *   is "1".
- *
- * On Android you can directly specify the input type:
- *
- * - `SDL_PROP_TEXTINPUT_ANDROID_INPUTTYPE_NUMBER` - the text input type to
- *   use, overriding other properties. This is documented at
- *   https://developer.android.com/reference/android/text/InputType
- *
- * \param window the window to enable text input.
- * \param props the properties to use.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetTextInputArea
- * \sa SDL_StartTextInput
- * \sa SDL_StopTextInput
- * \sa SDL_TextInputActive
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_StartTextInputWithProperties(SDL_Window *window, SDL_PropertiesID props);
-
-#define SDL_PROP_TEXTINPUT_TYPE_NUMBER                  "SDL.textinput.type"
-#define SDL_PROP_TEXTINPUT_CAPITALIZATION_NUMBER        "SDL.textinput.capitalization"
-#define SDL_PROP_TEXTINPUT_AUTOCORRECT_BOOLEAN          "SDL.textinput.autocorrect"
-#define SDL_PROP_TEXTINPUT_MULTILINE_BOOLEAN            "SDL.textinput.multiline"
-#define SDL_PROP_TEXTINPUT_ANDROID_INPUTTYPE_NUMBER     "SDL.textinput.android.inputtype"
-
-/**
- * Check whether or not Unicode text input events are enabled for a window.
- *
- * \param window the window to check.
- * \returns true if text input events are enabled else false.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StartTextInput
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_TextInputActive(SDL_Window *window);
-
-/**
- * Stop receiving any text input events in a window.
- *
- * If SDL_StartTextInput() showed the screen keyboard, this function will hide
- * it.
- *
- * \param window the window to disable text input.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StartTextInput
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_StopTextInput(SDL_Window *window);
-
-/**
- * Dismiss the composition window/IME without disabling the subsystem.
- *
- * \param window the window to affect.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StartTextInput
- * \sa SDL_StopTextInput
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ClearComposition(SDL_Window *window);
-
-/**
- * Set the area used to type Unicode text input.
- *
- * Native input methods may place a window with word suggestions near the
- * cursor, without covering the text being entered.
- *
- * \param window the window for which to set the text input area.
- * \param rect the SDL_Rect representing the text input area, in window
- *             coordinates, or NULL to clear it.
- * \param cursor the offset of the current cursor location relative to
- *               `rect->x`, in window coordinates.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetTextInputArea
- * \sa SDL_StartTextInput
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetTextInputArea(SDL_Window *window, const SDL_Rect *rect, int cursor);
-
-/**
- * Get the area used to type Unicode text input.
- *
- * This returns the values previously set by SDL_SetTextInputArea().
- *
- * \param window the window for which to query the text input area.
- * \param rect a pointer to an SDL_Rect filled in with the text input area,
- *             may be NULL.
- * \param cursor a pointer to the offset of the current cursor location
- *               relative to `rect->x`, may be NULL.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetTextInputArea
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetTextInputArea(SDL_Window *window, SDL_Rect *rect, int *cursor);
-
-/**
- * Check whether the platform has screen keyboard support.
- *
- * \returns true if the platform has some screen keyboard support or false if
- *          not.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StartTextInput
- * \sa SDL_ScreenKeyboardShown
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasScreenKeyboardSupport(void);
-
-/**
- * Check whether the screen keyboard is shown for given window.
- *
- * \param window the window for which screen keyboard should be queried.
- * \returns true if screen keyboard is shown or false if not.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasScreenKeyboardSupport
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ScreenKeyboardShown(SDL_Window *window);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_keyboard_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_keycode.h

@@ -1,343 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryKeycode
- *
- * Defines constants which identify keyboard keys and modifiers.
- *
- * Please refer to the Best Keyboard Practices document for details on what
- * this information means and how best to use it.
- *
- * https://wiki.libsdl.org/SDL3/BestKeyboardPractices
- */
-
-#ifndef SDL_keycode_h_
-#define SDL_keycode_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_scancode.h>
-
-/**
- * The SDL virtual key representation.
- *
- * Values of this type are used to represent keyboard keys using the current
- * layout of the keyboard. These values include Unicode values representing
- * the unmodified character that would be generated by pressing the key, or an
- * `SDLK_*` constant for those keys that do not generate characters.
- *
- * A special exception is the number keys at the top of the keyboard which map
- * to SDLK_0...SDLK_9 on AZERTY layouts.
- *
- * Keys with the `SDLK_EXTENDED_MASK` bit set do not map to a scancode or
- * unicode code point.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_Keycode;
-
-#define SDLK_EXTENDED_MASK          (1u << 29)
-#define SDLK_SCANCODE_MASK          (1u << 30)
-#define SDL_SCANCODE_TO_KEYCODE(X)  (X | SDLK_SCANCODE_MASK)
-#define SDLK_UNKNOWN                0x00000000u /**< 0 */
-#define SDLK_RETURN                 0x0000000du /**< '\r' */
-#define SDLK_ESCAPE                 0x0000001bu /**< '\x1B' */
-#define SDLK_BACKSPACE              0x00000008u /**< '\b' */
-#define SDLK_TAB                    0x00000009u /**< '\t' */
-#define SDLK_SPACE                  0x00000020u /**< ' ' */
-#define SDLK_EXCLAIM                0x00000021u /**< '!' */
-#define SDLK_DBLAPOSTROPHE          0x00000022u /**< '"' */
-#define SDLK_HASH                   0x00000023u /**< '#' */
-#define SDLK_DOLLAR                 0x00000024u /**< '$' */
-#define SDLK_PERCENT                0x00000025u /**< '%' */
-#define SDLK_AMPERSAND              0x00000026u /**< '&' */
-#define SDLK_APOSTROPHE             0x00000027u /**< '\'' */
-#define SDLK_LEFTPAREN              0x00000028u /**< '(' */
-#define SDLK_RIGHTPAREN             0x00000029u /**< ')' */
-#define SDLK_ASTERISK               0x0000002au /**< '*' */
-#define SDLK_PLUS                   0x0000002bu /**< '+' */
-#define SDLK_COMMA                  0x0000002cu /**< ',' */
-#define SDLK_MINUS                  0x0000002du /**< '-' */
-#define SDLK_PERIOD                 0x0000002eu /**< '.' */
-#define SDLK_SLASH                  0x0000002fu /**< '/' */
-#define SDLK_0                      0x00000030u /**< '0' */
-#define SDLK_1                      0x00000031u /**< '1' */
-#define SDLK_2                      0x00000032u /**< '2' */
-#define SDLK_3                      0x00000033u /**< '3' */
-#define SDLK_4                      0x00000034u /**< '4' */
-#define SDLK_5                      0x00000035u /**< '5' */
-#define SDLK_6                      0x00000036u /**< '6' */
-#define SDLK_7                      0x00000037u /**< '7' */
-#define SDLK_8                      0x00000038u /**< '8' */
-#define SDLK_9                      0x00000039u /**< '9' */
-#define SDLK_COLON                  0x0000003au /**< ':' */
-#define SDLK_SEMICOLON              0x0000003bu /**< ';' */
-#define SDLK_LESS                   0x0000003cu /**< '<' */
-#define SDLK_EQUALS                 0x0000003du /**< '=' */
-#define SDLK_GREATER                0x0000003eu /**< '>' */
-#define SDLK_QUESTION               0x0000003fu /**< '?' */
-#define SDLK_AT                     0x00000040u /**< '@' */
-#define SDLK_LEFTBRACKET            0x0000005bu /**< '[' */
-#define SDLK_BACKSLASH              0x0000005cu /**< '\\' */
-#define SDLK_RIGHTBRACKET           0x0000005du /**< ']' */
-#define SDLK_CARET                  0x0000005eu /**< '^' */
-#define SDLK_UNDERSCORE             0x0000005fu /**< '_' */
-#define SDLK_GRAVE                  0x00000060u /**< '`' */
-#define SDLK_A                      0x00000061u /**< 'a' */
-#define SDLK_B                      0x00000062u /**< 'b' */
-#define SDLK_C                      0x00000063u /**< 'c' */
-#define SDLK_D                      0x00000064u /**< 'd' */
-#define SDLK_E                      0x00000065u /**< 'e' */
-#define SDLK_F                      0x00000066u /**< 'f' */
-#define SDLK_G                      0x00000067u /**< 'g' */
-#define SDLK_H                      0x00000068u /**< 'h' */
-#define SDLK_I                      0x00000069u /**< 'i' */
-#define SDLK_J                      0x0000006au /**< 'j' */
-#define SDLK_K                      0x0000006bu /**< 'k' */
-#define SDLK_L                      0x0000006cu /**< 'l' */
-#define SDLK_M                      0x0000006du /**< 'm' */
-#define SDLK_N                      0x0000006eu /**< 'n' */
-#define SDLK_O                      0x0000006fu /**< 'o' */
-#define SDLK_P                      0x00000070u /**< 'p' */
-#define SDLK_Q                      0x00000071u /**< 'q' */
-#define SDLK_R                      0x00000072u /**< 'r' */
-#define SDLK_S                      0x00000073u /**< 's' */
-#define SDLK_T                      0x00000074u /**< 't' */
-#define SDLK_U                      0x00000075u /**< 'u' */
-#define SDLK_V                      0x00000076u /**< 'v' */
-#define SDLK_W                      0x00000077u /**< 'w' */
-#define SDLK_X                      0x00000078u /**< 'x' */
-#define SDLK_Y                      0x00000079u /**< 'y' */
-#define SDLK_Z                      0x0000007au /**< 'z' */
-#define SDLK_LEFTBRACE              0x0000007bu /**< '{' */
-#define SDLK_PIPE                   0x0000007cu /**< '|' */
-#define SDLK_RIGHTBRACE             0x0000007du /**< '}' */
-#define SDLK_TILDE                  0x0000007eu /**< '~' */
-#define SDLK_DELETE                 0x0000007fu /**< '\x7F' */
-#define SDLK_PLUSMINUS              0x000000b1u /**< '\xB1' */
-#define SDLK_CAPSLOCK               0x40000039u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CAPSLOCK) */
-#define SDLK_F1                     0x4000003au /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F1) */
-#define SDLK_F2                     0x4000003bu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F2) */
-#define SDLK_F3                     0x4000003cu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F3) */
-#define SDLK_F4                     0x4000003du /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F4) */
-#define SDLK_F5                     0x4000003eu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F5) */
-#define SDLK_F6                     0x4000003fu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F6) */
-#define SDLK_F7                     0x40000040u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F7) */
-#define SDLK_F8                     0x40000041u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F8) */
-#define SDLK_F9                     0x40000042u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F9) */
-#define SDLK_F10                    0x40000043u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F10) */
-#define SDLK_F11                    0x40000044u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F11) */
-#define SDLK_F12                    0x40000045u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F12) */
-#define SDLK_PRINTSCREEN            0x40000046u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_PRINTSCREEN) */
-#define SDLK_SCROLLLOCK             0x40000047u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_SCROLLLOCK) */
-#define SDLK_PAUSE                  0x40000048u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_PAUSE) */
-#define SDLK_INSERT                 0x40000049u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_INSERT) */
-#define SDLK_HOME                   0x4000004au /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_HOME) */
-#define SDLK_PAGEUP                 0x4000004bu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_PAGEUP) */
-#define SDLK_END                    0x4000004du /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_END) */
-#define SDLK_PAGEDOWN               0x4000004eu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_PAGEDOWN) */
-#define SDLK_RIGHT                  0x4000004fu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_RIGHT) */
-#define SDLK_LEFT                   0x40000050u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_LEFT) */
-#define SDLK_DOWN                   0x40000051u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_DOWN) */
-#define SDLK_UP                     0x40000052u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_UP) */
-#define SDLK_NUMLOCKCLEAR           0x40000053u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_NUMLOCKCLEAR) */
-#define SDLK_KP_DIVIDE              0x40000054u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_DIVIDE) */
-#define SDLK_KP_MULTIPLY            0x40000055u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MULTIPLY) */
-#define SDLK_KP_MINUS               0x40000056u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MINUS) */
-#define SDLK_KP_PLUS                0x40000057u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_PLUS) */
-#define SDLK_KP_ENTER               0x40000058u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_ENTER) */
-#define SDLK_KP_1                   0x40000059u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_1) */
-#define SDLK_KP_2                   0x4000005au /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_2) */
-#define SDLK_KP_3                   0x4000005bu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_3) */
-#define SDLK_KP_4                   0x4000005cu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_4) */
-#define SDLK_KP_5                   0x4000005du /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_5) */
-#define SDLK_KP_6                   0x4000005eu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_6) */
-#define SDLK_KP_7                   0x4000005fu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_7) */
-#define SDLK_KP_8                   0x40000060u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_8) */
-#define SDLK_KP_9                   0x40000061u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_9) */
-#define SDLK_KP_0                   0x40000062u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_0) */
-#define SDLK_KP_PERIOD              0x40000063u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_PERIOD) */
-#define SDLK_APPLICATION            0x40000065u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_APPLICATION) */
-#define SDLK_POWER                  0x40000066u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_POWER) */
-#define SDLK_KP_EQUALS              0x40000067u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_EQUALS) */
-#define SDLK_F13                    0x40000068u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F13) */
-#define SDLK_F14                    0x40000069u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F14) */
-#define SDLK_F15                    0x4000006au /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F15) */
-#define SDLK_F16                    0x4000006bu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F16) */
-#define SDLK_F17                    0x4000006cu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F17) */
-#define SDLK_F18                    0x4000006du /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F18) */
-#define SDLK_F19                    0x4000006eu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F19) */
-#define SDLK_F20                    0x4000006fu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F20) */
-#define SDLK_F21                    0x40000070u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F21) */
-#define SDLK_F22                    0x40000071u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F22) */
-#define SDLK_F23                    0x40000072u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F23) */
-#define SDLK_F24                    0x40000073u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_F24) */
-#define SDLK_EXECUTE                0x40000074u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_EXECUTE) */
-#define SDLK_HELP                   0x40000075u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_HELP) */
-#define SDLK_MENU                   0x40000076u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MENU) */
-#define SDLK_SELECT                 0x40000077u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_SELECT) */
-#define SDLK_STOP                   0x40000078u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_STOP) */
-#define SDLK_AGAIN                  0x40000079u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AGAIN) */
-#define SDLK_UNDO                   0x4000007au /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_UNDO) */
-#define SDLK_CUT                    0x4000007bu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CUT) */
-#define SDLK_COPY                   0x4000007cu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_COPY) */
-#define SDLK_PASTE                  0x4000007du /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_PASTE) */
-#define SDLK_FIND                   0x4000007eu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_FIND) */
-#define SDLK_MUTE                   0x4000007fu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MUTE) */
-#define SDLK_VOLUMEUP               0x40000080u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_VOLUMEUP) */
-#define SDLK_VOLUMEDOWN             0x40000081u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_VOLUMEDOWN) */
-#define SDLK_KP_COMMA               0x40000085u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_COMMA) */
-#define SDLK_KP_EQUALSAS400         0x40000086u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_EQUALSAS400) */
-#define SDLK_ALTERASE               0x40000099u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_ALTERASE) */
-#define SDLK_SYSREQ                 0x4000009au /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_SYSREQ) */
-#define SDLK_CANCEL                 0x4000009bu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CANCEL) */
-#define SDLK_CLEAR                  0x4000009cu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CLEAR) */
-#define SDLK_PRIOR                  0x4000009du /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_PRIOR) */
-#define SDLK_RETURN2                0x4000009eu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_RETURN2) */
-#define SDLK_SEPARATOR              0x4000009fu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_SEPARATOR) */
-#define SDLK_OUT                    0x400000a0u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_OUT) */
-#define SDLK_OPER                   0x400000a1u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_OPER) */
-#define SDLK_CLEARAGAIN             0x400000a2u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CLEARAGAIN) */
-#define SDLK_CRSEL                  0x400000a3u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CRSEL) */
-#define SDLK_EXSEL                  0x400000a4u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_EXSEL) */
-#define SDLK_KP_00                  0x400000b0u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_00) */
-#define SDLK_KP_000                 0x400000b1u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_000) */
-#define SDLK_THOUSANDSSEPARATOR     0x400000b2u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_THOUSANDSSEPARATOR) */
-#define SDLK_DECIMALSEPARATOR       0x400000b3u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_DECIMALSEPARATOR) */
-#define SDLK_CURRENCYUNIT           0x400000b4u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CURRENCYUNIT) */
-#define SDLK_CURRENCYSUBUNIT        0x400000b5u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CURRENCYSUBUNIT) */
-#define SDLK_KP_LEFTPAREN           0x400000b6u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_LEFTPAREN) */
-#define SDLK_KP_RIGHTPAREN          0x400000b7u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_RIGHTPAREN) */
-#define SDLK_KP_LEFTBRACE           0x400000b8u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_LEFTBRACE) */
-#define SDLK_KP_RIGHTBRACE          0x400000b9u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_RIGHTBRACE) */
-#define SDLK_KP_TAB                 0x400000bau /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_TAB) */
-#define SDLK_KP_BACKSPACE           0x400000bbu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_BACKSPACE) */
-#define SDLK_KP_A                   0x400000bcu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_A) */
-#define SDLK_KP_B                   0x400000bdu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_B) */
-#define SDLK_KP_C                   0x400000beu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_C) */
-#define SDLK_KP_D                   0x400000bfu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_D) */
-#define SDLK_KP_E                   0x400000c0u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_E) */
-#define SDLK_KP_F                   0x400000c1u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_F) */
-#define SDLK_KP_XOR                 0x400000c2u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_XOR) */
-#define SDLK_KP_POWER               0x400000c3u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_POWER) */
-#define SDLK_KP_PERCENT             0x400000c4u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_PERCENT) */
-#define SDLK_KP_LESS                0x400000c5u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_LESS) */
-#define SDLK_KP_GREATER             0x400000c6u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_GREATER) */
-#define SDLK_KP_AMPERSAND           0x400000c7u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_AMPERSAND) */
-#define SDLK_KP_DBLAMPERSAND        0x400000c8u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_DBLAMPERSAND) */
-#define SDLK_KP_VERTICALBAR         0x400000c9u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_VERTICALBAR) */
-#define SDLK_KP_DBLVERTICALBAR      0x400000cau /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_DBLVERTICALBAR) */
-#define SDLK_KP_COLON               0x400000cbu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_COLON) */
-#define SDLK_KP_HASH                0x400000ccu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_HASH) */
-#define SDLK_KP_SPACE               0x400000cdu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_SPACE) */
-#define SDLK_KP_AT                  0x400000ceu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_AT) */
-#define SDLK_KP_EXCLAM              0x400000cfu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_EXCLAM) */
-#define SDLK_KP_MEMSTORE            0x400000d0u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MEMSTORE) */
-#define SDLK_KP_MEMRECALL           0x400000d1u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MEMRECALL) */
-#define SDLK_KP_MEMCLEAR            0x400000d2u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MEMCLEAR) */
-#define SDLK_KP_MEMADD              0x400000d3u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MEMADD) */
-#define SDLK_KP_MEMSUBTRACT         0x400000d4u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MEMSUBTRACT) */
-#define SDLK_KP_MEMMULTIPLY         0x400000d5u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MEMMULTIPLY) */
-#define SDLK_KP_MEMDIVIDE           0x400000d6u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_MEMDIVIDE) */
-#define SDLK_KP_PLUSMINUS           0x400000d7u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_PLUSMINUS) */
-#define SDLK_KP_CLEAR               0x400000d8u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_CLEAR) */
-#define SDLK_KP_CLEARENTRY          0x400000d9u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_CLEARENTRY) */
-#define SDLK_KP_BINARY              0x400000dau /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_BINARY) */
-#define SDLK_KP_OCTAL               0x400000dbu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_OCTAL) */
-#define SDLK_KP_DECIMAL             0x400000dcu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_DECIMAL) */
-#define SDLK_KP_HEXADECIMAL         0x400000ddu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_KP_HEXADECIMAL) */
-#define SDLK_LCTRL                  0x400000e0u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_LCTRL) */
-#define SDLK_LSHIFT                 0x400000e1u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_LSHIFT) */
-#define SDLK_LALT                   0x400000e2u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_LALT) */
-#define SDLK_LGUI                   0x400000e3u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_LGUI) */
-#define SDLK_RCTRL                  0x400000e4u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_RCTRL) */
-#define SDLK_RSHIFT                 0x400000e5u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_RSHIFT) */
-#define SDLK_RALT                   0x400000e6u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_RALT) */
-#define SDLK_RGUI                   0x400000e7u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_RGUI) */
-#define SDLK_MODE                   0x40000101u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MODE) */
-#define SDLK_SLEEP                  0x40000102u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_SLEEP) */
-#define SDLK_WAKE                   0x40000103u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_WAKE) */
-#define SDLK_CHANNEL_INCREMENT      0x40000104u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CHANNEL_INCREMENT) */
-#define SDLK_CHANNEL_DECREMENT      0x40000105u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CHANNEL_DECREMENT) */
-#define SDLK_MEDIA_PLAY             0x40000106u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_PLAY) */
-#define SDLK_MEDIA_PAUSE            0x40000107u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_PAUSE) */
-#define SDLK_MEDIA_RECORD           0x40000108u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_RECORD) */
-#define SDLK_MEDIA_FAST_FORWARD     0x40000109u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_FAST_FORWARD) */
-#define SDLK_MEDIA_REWIND           0x4000010au /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_REWIND) */
-#define SDLK_MEDIA_NEXT_TRACK       0x4000010bu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_NEXT_TRACK) */
-#define SDLK_MEDIA_PREVIOUS_TRACK   0x4000010cu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_PREVIOUS_TRACK) */
-#define SDLK_MEDIA_STOP             0x4000010du /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_STOP) */
-#define SDLK_MEDIA_EJECT            0x4000010eu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_EJECT) */
-#define SDLK_MEDIA_PLAY_PAUSE       0x4000010fu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_PLAY_PAUSE) */
-#define SDLK_MEDIA_SELECT           0x40000110u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_MEDIA_SELECT) */
-#define SDLK_AC_NEW                 0x40000111u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_NEW) */
-#define SDLK_AC_OPEN                0x40000112u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_OPEN) */
-#define SDLK_AC_CLOSE               0x40000113u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_CLOSE) */
-#define SDLK_AC_EXIT                0x40000114u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_EXIT) */
-#define SDLK_AC_SAVE                0x40000115u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_SAVE) */
-#define SDLK_AC_PRINT               0x40000116u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_PRINT) */
-#define SDLK_AC_PROPERTIES          0x40000117u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_PROPERTIES) */
-#define SDLK_AC_SEARCH              0x40000118u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_SEARCH) */
-#define SDLK_AC_HOME                0x40000119u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_HOME) */
-#define SDLK_AC_BACK                0x4000011au /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_BACK) */
-#define SDLK_AC_FORWARD             0x4000011bu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_FORWARD) */
-#define SDLK_AC_STOP                0x4000011cu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_STOP) */
-#define SDLK_AC_REFRESH             0x4000011du /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_REFRESH) */
-#define SDLK_AC_BOOKMARKS           0x4000011eu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_AC_BOOKMARKS) */
-#define SDLK_SOFTLEFT               0x4000011fu /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_SOFTLEFT) */
-#define SDLK_SOFTRIGHT              0x40000120u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_SOFTRIGHT) */
-#define SDLK_CALL                   0x40000121u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_CALL) */
-#define SDLK_ENDCALL                0x40000122u /**< SDL_SCANCODE_TO_KEYCODE(SDL_SCANCODE_ENDCALL) */
-#define SDLK_LEFT_TAB               0x20000001u /**< Extended key Left Tab */
-#define SDLK_LEVEL5_SHIFT           0x20000002u /**< Extended key Level 5 Shift */
-#define SDLK_MULTI_KEY_COMPOSE      0x20000003u /**< Extended key Multi-key Compose */
-#define SDLK_LMETA                  0x20000004u /**< Extended key Left Meta */
-#define SDLK_RMETA                  0x20000005u /**< Extended key Right Meta */
-#define SDLK_LHYPER                 0x20000006u /**< Extended key Left Hyper */
-#define SDLK_RHYPER                 0x20000007u /**< Extended key Right Hyper */
-
-/**
- * Valid key modifiers (possibly OR'd together).
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint16 SDL_Keymod;
-
-#define SDL_KMOD_NONE   0x0000u /**< no modifier is applicable. */
-#define SDL_KMOD_LSHIFT 0x0001u /**< the left Shift key is down. */
-#define SDL_KMOD_RSHIFT 0x0002u /**< the right Shift key is down. */
-#define SDL_KMOD_LEVEL5 0x0004u /**< the Level 5 Shift key is down. */
-#define SDL_KMOD_LCTRL  0x0040u /**< the left Ctrl (Control) key is down. */
-#define SDL_KMOD_RCTRL  0x0080u /**< the right Ctrl (Control) key is down. */
-#define SDL_KMOD_LALT   0x0100u /**< the left Alt key is down. */
-#define SDL_KMOD_RALT   0x0200u /**< the right Alt key is down. */
-#define SDL_KMOD_LGUI   0x0400u /**< the left GUI key (often the Windows key) is down. */
-#define SDL_KMOD_RGUI   0x0800u /**< the right GUI key (often the Windows key) is down. */
-#define SDL_KMOD_NUM    0x1000u /**< the Num Lock key (may be located on an extended keypad) is down. */
-#define SDL_KMOD_CAPS   0x2000u /**< the Caps Lock key is down. */
-#define SDL_KMOD_MODE   0x4000u /**< the !AltGr key is down. */
-#define SDL_KMOD_SCROLL 0x8000u /**< the Scroll Lock key is down. */
-#define SDL_KMOD_CTRL   (SDL_KMOD_LCTRL | SDL_KMOD_RCTRL)   /**< Any Ctrl key is down. */
-#define SDL_KMOD_SHIFT  (SDL_KMOD_LSHIFT | SDL_KMOD_RSHIFT) /**< Any Shift key is down. */
-#define SDL_KMOD_ALT    (SDL_KMOD_LALT | SDL_KMOD_RALT)     /**< Any Alt key is down. */
-#define SDL_KMOD_GUI    (SDL_KMOD_LGUI | SDL_KMOD_RGUI)     /**< Any GUI key is down. */
-
-#endif /* SDL_keycode_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_loadso.h

@@ -1,145 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: SharedObject */
-
-/**
- * # CategorySharedObject
- *
- * System-dependent library loading routines.
- *
- * Shared objects are code that is programmatically loadable at runtime.
- * Windows calls these "DLLs", Linux calls them "shared libraries", etc.
- *
- * To use them, build such a library, then call SDL_LoadObject() on it. Once
- * loaded, you can use SDL_LoadFunction() on that object to find the address
- * of its exported symbols. When done with the object, call SDL_UnloadObject()
- * to dispose of it.
- *
- * Some things to keep in mind:
- *
- * - These functions only work on C function names. Other languages may have
- *   name mangling and intrinsic language support that varies from compiler to
- *   compiler.
- * - Make sure you declare your function pointers with the same calling
- *   convention as the actual library function. Your code will crash
- *   mysteriously if you do not do this.
- * - Avoid namespace collisions. If you load a symbol from the library, it is
- *   not defined whether or not it goes into the global symbol namespace for
- *   the application. If it does and it conflicts with symbols in your code or
- *   other shared libraries, you will not get the results you expect. :)
- * - Once a library is unloaded, all pointers into it obtained through
- *   SDL_LoadFunction() become invalid, even if the library is later reloaded.
- *   Don't unload a library if you plan to use these pointers in the future.
- *   Notably: beware of giving one of these pointers to atexit(), since it may
- *   call that pointer after the library unloads.
- */
-
-#ifndef SDL_loadso_h_
-#define SDL_loadso_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * An opaque datatype that represents a loaded shared object.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_LoadObject
- * \sa SDL_LoadFunction
- * \sa SDL_UnloadObject
- */
-typedef struct SDL_SharedObject SDL_SharedObject;
-
-/**
- * Dynamically load a shared object.
- *
- * \param sofile a system-dependent name of the object file.
- * \returns an opaque pointer to the object handle or NULL on failure; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_LoadFunction
- * \sa SDL_UnloadObject
- */
-extern SDL_DECLSPEC SDL_SharedObject * SDLCALL SDL_LoadObject(const char *sofile);
-
-/**
- * Look up the address of the named function in a shared object.
- *
- * This function pointer is no longer valid after calling SDL_UnloadObject().
- *
- * This function can only look up C function names. Other languages may have
- * name mangling and intrinsic language support that varies from compiler to
- * compiler.
- *
- * Make sure you declare your function pointers with the same calling
- * convention as the actual library function. Your code will crash
- * mysteriously if you do not do this.
- *
- * If the requested function doesn't exist, NULL is returned.
- *
- * \param handle a valid shared object handle returned by SDL_LoadObject().
- * \param name the name of the function to look up.
- * \returns a pointer to the function or NULL on failure; call SDL_GetError()
- *          for more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_LoadObject
- */
-extern SDL_DECLSPEC SDL_FunctionPointer SDLCALL SDL_LoadFunction(SDL_SharedObject *handle, const char *name);
-
-/**
- * Unload a shared object from memory.
- *
- * Note that any pointers from this object looked up through
- * SDL_LoadFunction() will no longer be valid.
- *
- * \param handle a valid shared object handle returned by SDL_LoadObject().
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_LoadObject
- */
-extern SDL_DECLSPEC void SDLCALL SDL_UnloadObject(SDL_SharedObject *handle);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_loadso_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_locale.h

@@ -1,117 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryLocale
- *
- * SDL locale services.
- *
- * This provides a way to get a list of preferred locales (language plus
- * country) for the user. There is exactly one function:
- * SDL_GetPreferredLocales(), which handles all the heavy lifting, and offers
- * documentation on all the strange ways humans might have configured their
- * language settings.
- */
-
-#ifndef SDL_locale_h
-#define SDL_locale_h
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-/* *INDENT-OFF* */
-extern "C" {
-/* *INDENT-ON* */
-#endif
-
-/**
- * A struct to provide locale data.
- *
- * Locale data is split into a spoken language, like English, and an optional
- * country, like Canada. The language will be in ISO-639 format (so English
- * would be "en"), and the country, if not NULL, will be an ISO-3166 country
- * code (so Canada would be "CA").
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPreferredLocales
- */
-typedef struct SDL_Locale
-{
-    const char *language;  /**< A language name, like "en" for English. */
-    const char *country;  /**< A country, like "US" for America. Can be NULL. */
-} SDL_Locale;
-
-/**
- * Report the user's preferred locale.
- *
- * Returned language strings are in the format xx, where 'xx' is an ISO-639
- * language specifier (such as "en" for English, "de" for German, etc).
- * Country strings are in the format YY, where "YY" is an ISO-3166 country
- * code (such as "US" for the United States, "CA" for Canada, etc). Country
- * might be NULL if there's no specific guidance on them (so you might get {
- * "en", "US" } for American English, but { "en", NULL } means "English
- * language, generically"). Language strings are never NULL, except to
- * terminate the array.
- *
- * Please note that not all of these strings are 2 characters; some are three
- * or more.
- *
- * The returned list of locales are in the order of the user's preference. For
- * example, a German citizen that is fluent in US English and knows enough
- * Japanese to navigate around Tokyo might have a list like: { "de", "en_US",
- * "jp", NULL }. Someone from England might prefer British English (where
- * "color" is spelled "colour", etc), but will settle for anything like it: {
- * "en_GB", "en", NULL }.
- *
- * This function returns NULL on error, including when the platform does not
- * supply this information at all.
- *
- * This might be a "slow" call that has to query the operating system. It's
- * best to ask for this once and save the results. However, this list can
- * change, usually because the user has changed a system preference outside of
- * your program; SDL will send an SDL_EVENT_LOCALE_CHANGED event in this case,
- * if possible, and you can call this function again to get an updated copy of
- * preferred locales.
- *
- * \param count a pointer filled in with the number of locales returned, may
- *              be NULL.
- * \returns a NULL terminated array of locale pointers, or NULL on failure;
- *          call SDL_GetError() for more information. This is a single
- *          allocation that should be freed with SDL_free() when it is no
- *          longer needed.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_Locale ** SDLCALL SDL_GetPreferredLocales(int *count);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-/* *INDENT-OFF* */
-}
-/* *INDENT-ON* */
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_locale_h */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_log.h

@@ -1,538 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryLog
- *
- * Simple log messages with priorities and categories. A message's
- * SDL_LogPriority signifies how important the message is. A message's
- * SDL_LogCategory signifies from what domain it belongs to. Every category
- * has a minimum priority specified: when a message belongs to that category,
- * it will only be sent out if it has that minimum priority or higher.
- *
- * SDL's own logs are sent below the default priority threshold, so they are
- * quiet by default.
- *
- * You can change the log verbosity programmatically using
- * SDL_SetLogPriority() or with SDL_SetHint(SDL_HINT_LOGGING, ...), or with
- * the "SDL_LOGGING" environment variable. This variable is a comma separated
- * set of category=level tokens that define the default logging levels for SDL
- * applications.
- *
- * The category can be a numeric category, one of "app", "error", "assert",
- * "system", "audio", "video", "render", "input", "test", or `*` for any
- * unspecified category.
- *
- * The level can be a numeric level, one of "trace", "verbose", "debug",
- * "info", "warn", "error", "critical", or "quiet" to disable that category.
- *
- * You can omit the category if you want to set the logging level for all
- * categories.
- *
- * If this hint isn't set, the default log levels are equivalent to:
- *
- * `app=info,assert=warn,test=verbose,*=error`
- *
- * Here's where the messages go on different platforms:
- *
- * - Windows: debug output stream
- * - Android: log output
- * - Others: standard error output (stderr)
- *
- * You don't need to have a newline (`\n`) on the end of messages, the
- * functions will do that for you. For consistent behavior cross-platform, you
- * shouldn't have any newlines in messages, such as to log multiple lines in
- * one call; unusual platform-specific behavior can be observed in such usage.
- * Do one log call per line instead, with no newlines in messages.
- *
- * Each log call is atomic, so you won't see log messages cut off one another
- * when logging from multiple threads.
- */
-
-#ifndef SDL_log_h_
-#define SDL_log_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * The predefined log categories
- *
- * By default the application and gpu categories are enabled at the INFO
- * level, the assert category is enabled at the WARN level, test is enabled at
- * the VERBOSE level and all other categories are enabled at the ERROR level.
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_LogCategory
-{
-    SDL_LOG_CATEGORY_APPLICATION,
-    SDL_LOG_CATEGORY_ERROR,
-    SDL_LOG_CATEGORY_ASSERT,
-    SDL_LOG_CATEGORY_SYSTEM,
-    SDL_LOG_CATEGORY_AUDIO,
-    SDL_LOG_CATEGORY_VIDEO,
-    SDL_LOG_CATEGORY_RENDER,
-    SDL_LOG_CATEGORY_INPUT,
-    SDL_LOG_CATEGORY_TEST,
-    SDL_LOG_CATEGORY_GPU,
-
-    /* Reserved for future SDL library use */
-    SDL_LOG_CATEGORY_RESERVED2,
-    SDL_LOG_CATEGORY_RESERVED3,
-    SDL_LOG_CATEGORY_RESERVED4,
-    SDL_LOG_CATEGORY_RESERVED5,
-    SDL_LOG_CATEGORY_RESERVED6,
-    SDL_LOG_CATEGORY_RESERVED7,
-    SDL_LOG_CATEGORY_RESERVED8,
-    SDL_LOG_CATEGORY_RESERVED9,
-    SDL_LOG_CATEGORY_RESERVED10,
-
-    /* Beyond this point is reserved for application use, e.g.
-       enum {
-           MYAPP_CATEGORY_AWESOME1 = SDL_LOG_CATEGORY_CUSTOM,
-           MYAPP_CATEGORY_AWESOME2,
-           MYAPP_CATEGORY_AWESOME3,
-           ...
-       };
-     */
-    SDL_LOG_CATEGORY_CUSTOM
-} SDL_LogCategory;
-
-/**
- * The predefined log priorities
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_LogPriority
-{
-    SDL_LOG_PRIORITY_INVALID,
-    SDL_LOG_PRIORITY_TRACE,
-    SDL_LOG_PRIORITY_VERBOSE,
-    SDL_LOG_PRIORITY_DEBUG,
-    SDL_LOG_PRIORITY_INFO,
-    SDL_LOG_PRIORITY_WARN,
-    SDL_LOG_PRIORITY_ERROR,
-    SDL_LOG_PRIORITY_CRITICAL,
-    SDL_LOG_PRIORITY_COUNT
-} SDL_LogPriority;
-
-
-/**
- * Set the priority of all log categories.
- *
- * \param priority the SDL_LogPriority to assign.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ResetLogPriorities
- * \sa SDL_SetLogPriority
- */
-extern SDL_DECLSPEC void SDLCALL SDL_SetLogPriorities(SDL_LogPriority priority);
-
-/**
- * Set the priority of a particular log category.
- *
- * \param category the category to assign a priority to.
- * \param priority the SDL_LogPriority to assign.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetLogPriority
- * \sa SDL_ResetLogPriorities
- * \sa SDL_SetLogPriorities
- */
-extern SDL_DECLSPEC void SDLCALL SDL_SetLogPriority(int category, SDL_LogPriority priority);
-
-/**
- * Get the priority of a particular log category.
- *
- * \param category the category to query.
- * \returns the SDL_LogPriority for the requested category.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetLogPriority
- */
-extern SDL_DECLSPEC SDL_LogPriority SDLCALL SDL_GetLogPriority(int category);
-
-/**
- * Reset all priorities to default.
- *
- * This is called by SDL_Quit().
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetLogPriorities
- * \sa SDL_SetLogPriority
- */
-extern SDL_DECLSPEC void SDLCALL SDL_ResetLogPriorities(void);
-
-/**
- * Set the text prepended to log messages of a given priority.
- *
- * By default SDL_LOG_PRIORITY_INFO and below have no prefix, and
- * SDL_LOG_PRIORITY_WARN and higher have a prefix showing their priority, e.g.
- * "WARNING: ".
- *
- * \param priority the SDL_LogPriority to modify.
- * \param prefix the prefix to use for that log priority, or NULL to use no
- *               prefix.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetLogPriorities
- * \sa SDL_SetLogPriority
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetLogPriorityPrefix(SDL_LogPriority priority, const char *prefix);
-
-/**
- * Log a message with SDL_LOG_CATEGORY_APPLICATION and SDL_LOG_PRIORITY_INFO.
- *
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the `fmt` string, if
- *            any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_LogCritical
- * \sa SDL_LogDebug
- * \sa SDL_LogError
- * \sa SDL_LogInfo
- * \sa SDL_LogMessage
- * \sa SDL_LogMessageV
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_Log(SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(1);
-
-/**
- * Log a message with SDL_LOG_PRIORITY_TRACE.
- *
- * \param category the category of the message.
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the **fmt** string,
- *            if any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogCritical
- * \sa SDL_LogDebug
- * \sa SDL_LogError
- * \sa SDL_LogInfo
- * \sa SDL_LogMessage
- * \sa SDL_LogMessageV
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogTrace(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
-
-/**
- * Log a message with SDL_LOG_PRIORITY_VERBOSE.
- *
- * \param category the category of the message.
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the **fmt** string,
- *            if any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogCritical
- * \sa SDL_LogDebug
- * \sa SDL_LogError
- * \sa SDL_LogInfo
- * \sa SDL_LogMessage
- * \sa SDL_LogMessageV
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogVerbose(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
-
-/**
- * Log a message with SDL_LOG_PRIORITY_DEBUG.
- *
- * \param category the category of the message.
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the **fmt** string,
- *            if any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogCritical
- * \sa SDL_LogError
- * \sa SDL_LogInfo
- * \sa SDL_LogMessage
- * \sa SDL_LogMessageV
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogDebug(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
-
-/**
- * Log a message with SDL_LOG_PRIORITY_INFO.
- *
- * \param category the category of the message.
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the **fmt** string,
- *            if any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogCritical
- * \sa SDL_LogDebug
- * \sa SDL_LogError
- * \sa SDL_LogMessage
- * \sa SDL_LogMessageV
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogInfo(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
-
-/**
- * Log a message with SDL_LOG_PRIORITY_WARN.
- *
- * \param category the category of the message.
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the **fmt** string,
- *            if any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogCritical
- * \sa SDL_LogDebug
- * \sa SDL_LogError
- * \sa SDL_LogInfo
- * \sa SDL_LogMessage
- * \sa SDL_LogMessageV
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogWarn(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
-
-/**
- * Log a message with SDL_LOG_PRIORITY_ERROR.
- *
- * \param category the category of the message.
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the **fmt** string,
- *            if any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogCritical
- * \sa SDL_LogDebug
- * \sa SDL_LogInfo
- * \sa SDL_LogMessage
- * \sa SDL_LogMessageV
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogError(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
-
-/**
- * Log a message with SDL_LOG_PRIORITY_CRITICAL.
- *
- * \param category the category of the message.
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the **fmt** string,
- *            if any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogDebug
- * \sa SDL_LogError
- * \sa SDL_LogInfo
- * \sa SDL_LogMessage
- * \sa SDL_LogMessageV
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogCritical(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
-
-/**
- * Log a message with the specified category and priority.
- *
- * \param category the category of the message.
- * \param priority the priority of the message.
- * \param fmt a printf() style message format string.
- * \param ... additional parameters matching % tokens in the **fmt** string,
- *            if any.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogCritical
- * \sa SDL_LogDebug
- * \sa SDL_LogError
- * \sa SDL_LogInfo
- * \sa SDL_LogMessageV
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogMessage(int category,
-                                            SDL_LogPriority priority,
-                                            SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(3);
-
-/**
- * Log a message with the specified category and priority.
- *
- * \param category the category of the message.
- * \param priority the priority of the message.
- * \param fmt a printf() style message format string.
- * \param ap a variable argument list.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Log
- * \sa SDL_LogCritical
- * \sa SDL_LogDebug
- * \sa SDL_LogError
- * \sa SDL_LogInfo
- * \sa SDL_LogMessage
- * \sa SDL_LogTrace
- * \sa SDL_LogVerbose
- * \sa SDL_LogWarn
- */
-extern SDL_DECLSPEC void SDLCALL SDL_LogMessageV(int category,
-                                             SDL_LogPriority priority,
-                                             SDL_PRINTF_FORMAT_STRING const char *fmt, va_list ap) SDL_PRINTF_VARARG_FUNCV(3);
-
-/**
- * The prototype for the log output callback function.
- *
- * This function is called by SDL when there is new text to be logged. A mutex
- * is held so that this function is never called by more than one thread at
- * once.
- *
- * \param userdata what was passed as `userdata` to
- *                 SDL_SetLogOutputFunction().
- * \param category the category of the message.
- * \param priority the priority of the message.
- * \param message the message being output.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef void (SDLCALL *SDL_LogOutputFunction)(void *userdata, int category, SDL_LogPriority priority, const char *message);
-
-/**
- * Get the default log output function.
- *
- * \returns the default log output callback.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetLogOutputFunction
- * \sa SDL_GetLogOutputFunction
- */
-extern SDL_DECLSPEC SDL_LogOutputFunction SDLCALL SDL_GetDefaultLogOutputFunction(void);
-
-/**
- * Get the current log output function.
- *
- * \param callback an SDL_LogOutputFunction filled in with the current log
- *                 callback.
- * \param userdata a pointer filled in with the pointer that is passed to
- *                 `callback`.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetDefaultLogOutputFunction
- * \sa SDL_SetLogOutputFunction
- */
-extern SDL_DECLSPEC void SDLCALL SDL_GetLogOutputFunction(SDL_LogOutputFunction *callback, void **userdata);
-
-/**
- * Replace the default log output function with one of your own.
- *
- * \param callback an SDL_LogOutputFunction to call instead of the default.
- * \param userdata a pointer that is passed to `callback`.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetDefaultLogOutputFunction
- * \sa SDL_GetLogOutputFunction
- */
-extern SDL_DECLSPEC void SDLCALL SDL_SetLogOutputFunction(SDL_LogOutputFunction callback, void *userdata);
-
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_log_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_main.h

@@ -1,675 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryMain
- *
- * Redefine main() if necessary so that it is called by SDL.
- *
- * In order to make this consistent on all platforms, the application's main()
- * should look like this:
- *
- * ```c
- * #include <SDL3/SDL.h>
- * #include <SDL3/SDL_main.h>
- *
- * int main(int argc, char *argv[])
- * {
- * }
- * ```
- *
- * SDL will take care of platform specific details on how it gets called.
- *
- * This is also where an app can be configured to use the main callbacks, via
- * the SDL_MAIN_USE_CALLBACKS macro.
- *
- * SDL_main.h is a "single-header library," which is to say that including
- * this header inserts code into your program, and you should only include it
- * once in most cases. SDL.h does not include this header automatically.
- *
- * For more information, see:
- *
- * https://wiki.libsdl.org/SDL3/README/main-functions
- */
-
-#ifndef SDL_main_h_
-#define SDL_main_h_
-
-#include <SDL3/SDL_platform_defines.h>
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_events.h>
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * Inform SDL that the app is providing an entry point instead of SDL.
- *
- * SDL does not define this macro, but will check if it is defined when
- * including `SDL_main.h`. If defined, SDL will expect the app to provide the
- * proper entry point for the platform, and all the other magic details
- * needed, like manually calling SDL_SetMainReady.
- *
- * Please see [README/main-functions](README/main-functions), (or
- * docs/README-main-functions.md in the source tree) for a more detailed
- * explanation.
- *
- * \since This macro is used by the headers since SDL 3.2.0.
- */
-#define SDL_MAIN_HANDLED 1
-
-/**
- * Inform SDL to use the main callbacks instead of main.
- *
- * SDL does not define this macro, but will check if it is defined when
- * including `SDL_main.h`. If defined, SDL will expect the app to provide
- * several functions: SDL_AppInit, SDL_AppEvent, SDL_AppIterate, and
- * SDL_AppQuit. The app should not provide a `main` function in this case, and
- * doing so will likely cause the build to fail.
- *
- * Please see [README/main-functions](README/main-functions), (or
- * docs/README-main-functions.md in the source tree) for a more detailed
- * explanation.
- *
- * \since This macro is used by the headers since SDL 3.2.0.
- *
- * \sa SDL_AppInit
- * \sa SDL_AppEvent
- * \sa SDL_AppIterate
- * \sa SDL_AppQuit
- */
-#define SDL_MAIN_USE_CALLBACKS 1
-
-/**
- * Defined if the target platform offers a special mainline through SDL.
- *
- * This won't be defined otherwise. If defined, SDL's headers will redefine
- * `main` to `SDL_main`.
- *
- * This macro is defined by `SDL_main.h`, which is not automatically included
- * by `SDL.h`.
- *
- * Even if available, an app can define SDL_MAIN_HANDLED and provide their
- * own, if they know what they're doing.
- *
- * This macro is used internally by SDL, and apps probably shouldn't rely on it.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_MAIN_AVAILABLE
-
-/**
- * Defined if the target platform _requires_ a special mainline through SDL.
- *
- * This won't be defined otherwise. If defined, SDL's headers will redefine
- * `main` to `SDL_main`.
- *
- * This macro is defined by `SDL_main.h`, which is not automatically included
- * by `SDL.h`.
- *
- * Even if required, an app can define SDL_MAIN_HANDLED and provide their
- * own, if they know what they're doing.
- *
- * This macro is used internally by SDL, and apps probably shouldn't rely on it.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_MAIN_NEEDED
-
-#endif
-
-#if defined(__has_include)
-    #if __has_include("SDL_main_private.h") && __has_include("SDL_main_impl_private.h")
-        #define SDL_PLATFORM_PRIVATE_MAIN
-    #endif
-#endif
-
-#ifndef SDL_MAIN_HANDLED
-    #if defined(SDL_PLATFORM_PRIVATE_MAIN)
-        /* Private platforms may have their own ideas about entry points. */
-        #include "SDL_main_private.h"
-
-    #elif defined(SDL_PLATFORM_WIN32)
-        /* On Windows SDL provides WinMain(), which parses the command line and passes
-           the arguments to your main function.
-
-           If you provide your own WinMain(), you may define SDL_MAIN_HANDLED
-         */
-        #define SDL_MAIN_AVAILABLE
-
-    #elif defined(SDL_PLATFORM_GDK)
-        /* On GDK, SDL provides a main function that initializes the game runtime.
-
-           If you prefer to write your own WinMain-function instead of having SDL
-           provide one that calls your main() function,
-           #define SDL_MAIN_HANDLED before #include'ing SDL_main.h
-           and call the SDL_RunApp function from your entry point.
-        */
-        #define SDL_MAIN_NEEDED
-
-    #elif defined(SDL_PLATFORM_IOS)
-        /* On iOS SDL provides a main function that creates an application delegate
-           and starts the iOS application run loop.
-
-           To use it, just #include SDL_main.h in the source file that contains your
-           main() function.
-
-           See src/video/uikit/SDL_uikitappdelegate.m for more details.
-         */
-        #define SDL_MAIN_NEEDED
-
-    #elif defined(SDL_PLATFORM_ANDROID)
-        /* On Android SDL provides a Java class in SDLActivity.java that is the
-           main activity entry point.
-
-           See docs/README-android.md for more details on extending that class.
-         */
-        #define SDL_MAIN_NEEDED
-
-        /* As this is launched from Java, the real entry point (main() function)
-           is outside of the the binary built from this code.
-           This define makes sure that, unlike on other platforms, SDL_main.h
-           and SDL_main_impl.h export an `SDL_main()` function (to be called
-           from Java), but don't implement a native `int main(int argc, char* argv[])`
-           or similar.
-         */
-        #define SDL_MAIN_EXPORTED
-
-    #elif defined(SDL_PLATFORM_EMSCRIPTEN)
-        /* On Emscripten, SDL provides a main function that converts URL
-           parameters that start with "SDL_" to environment variables, so
-           they can be used as SDL hints, etc.
-
-           This is 100% optional, so if you don't want this to happen, you may
-           define SDL_MAIN_HANDLED
-         */
-        #define SDL_MAIN_AVAILABLE
-
-    #elif defined(SDL_PLATFORM_PSP)
-        /* On PSP SDL provides a main function that sets the module info,
-           activates the GPU and starts the thread required to be able to exit
-           the software.
-
-           If you provide this yourself, you may define SDL_MAIN_HANDLED
-         */
-        #define SDL_MAIN_AVAILABLE
-
-    #elif defined(SDL_PLATFORM_PS2)
-        #define SDL_MAIN_AVAILABLE
-
-        #define SDL_PS2_SKIP_IOP_RESET() \
-           void reset_IOP(); \
-           void reset_IOP() {}
-
-    #elif defined(SDL_PLATFORM_3DS)
-        /*
-          On N3DS, SDL provides a main function that sets up the screens
-          and storage.
-
-          If you provide this yourself, you may define SDL_MAIN_HANDLED
-        */
-        #define SDL_MAIN_AVAILABLE
-
-    #endif
-#endif /* SDL_MAIN_HANDLED */
-
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A macro to tag a main entry point function as exported.
- *
- * Most platforms don't need this, and the macro will be defined to nothing.
- * Some, like Android, keep the entry points in a shared library and need to
- * explicitly export the symbols.
- *
- * External code rarely needs this, and if it needs something, it's almost
- * always SDL_DECLSPEC instead.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_DECLSPEC
- */
-#define SDLMAIN_DECLSPEC
-
-#elif defined(SDL_MAIN_EXPORTED)
-/* We need to export SDL_main so it can be launched from external code,
-   like SDLActivity.java on Android */
-#define SDLMAIN_DECLSPEC    SDL_DECLSPEC
-#else
-/* usually this is empty */
-#define SDLMAIN_DECLSPEC
-#endif /* SDL_MAIN_EXPORTED */
-
-#if defined(SDL_MAIN_NEEDED) || defined(SDL_MAIN_AVAILABLE) || defined(SDL_MAIN_USE_CALLBACKS)
-#define main SDL_main
-#endif
-
-#include <SDL3/SDL_init.h>
-#include <SDL3/SDL_begin_code.h>
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/*
- * You can (optionally!) define SDL_MAIN_USE_CALLBACKS before including
- * SDL_main.h, and then your application will _not_ have a standard
- * "main" entry point. Instead, it will operate as a collection of
- * functions that are called as necessary by the system. On some
- * platforms, this is just a layer where SDL drives your program
- * instead of your program driving SDL, on other platforms this might
- * hook into the OS to manage the lifecycle. Programs on most platforms
- * can use whichever approach they prefer, but the decision boils down
- * to:
- *
- * - Using a standard "main" function: this works like it always has for
- *   the past 50+ years in C programming, and your app is in control.
- * - Using the callback functions: this might clean up some code,
- *   avoid some #ifdef blocks in your program for some platforms, be more
- *   resource-friendly to the system, and possibly be the primary way to
- *   access some future platforms (but none require this at the moment).
- *
- * This is up to the app; both approaches are considered valid and supported
- * ways to write SDL apps.
- *
- * If using the callbacks, don't define a "main" function. Instead, implement
- * the functions listed below in your program.
- */
-#ifdef SDL_MAIN_USE_CALLBACKS
-
-/**
- * App-implemented initial entry point for SDL_MAIN_USE_CALLBACKS apps.
- *
- * Apps implement this function when using SDL_MAIN_USE_CALLBACKS. If using a
- * standard "main" function, you should not supply this.
- *
- * This function is called by SDL once, at startup. The function should
- * initialize whatever is necessary, possibly create windows and open audio
- * devices, etc. The `argc` and `argv` parameters work like they would with a
- * standard "main" function.
- *
- * This function should not go into an infinite mainloop; it should do any
- * one-time setup it requires and then return.
- *
- * The app may optionally assign a pointer to `*appstate`. This pointer will
- * be provided on every future call to the other entry points, to allow
- * application state to be preserved between functions without the app needing
- * to use a global variable. If this isn't set, the pointer will be NULL in
- * future entry points.
- *
- * If this function returns SDL_APP_CONTINUE, the app will proceed to normal
- * operation, and will begin receiving repeated calls to SDL_AppIterate and
- * SDL_AppEvent for the life of the program. If this function returns
- * SDL_APP_FAILURE, SDL will call SDL_AppQuit and terminate the process with
- * an exit code that reports an error to the platform. If it returns
- * SDL_APP_SUCCESS, SDL calls SDL_AppQuit and terminates with an exit code
- * that reports success to the platform.
- *
- * This function is called by SDL on the main thread.
- *
- * \param appstate a place where the app can optionally store a pointer for
- *                 future use.
- * \param argc the standard ANSI C main's argc; number of elements in `argv`.
- * \param argv the standard ANSI C main's argv; array of command line
- *             arguments.
- * \returns SDL_APP_FAILURE to terminate with an error, SDL_APP_SUCCESS to
- *          terminate with success, SDL_APP_CONTINUE to continue.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_AppIterate
- * \sa SDL_AppEvent
- * \sa SDL_AppQuit
- */
-extern SDLMAIN_DECLSPEC SDL_AppResult SDLCALL SDL_AppInit(void **appstate, int argc, char *argv[]);
-
-/**
- * App-implemented iteration entry point for SDL_MAIN_USE_CALLBACKS apps.
- *
- * Apps implement this function when using SDL_MAIN_USE_CALLBACKS. If using a
- * standard "main" function, you should not supply this.
- *
- * This function is called repeatedly by SDL after SDL_AppInit returns 0. The
- * function should operate as a single iteration the program's primary loop;
- * it should update whatever state it needs and draw a new frame of video,
- * usually.
- *
- * On some platforms, this function will be called at the refresh rate of the
- * display (which might change during the life of your app!). There are no
- * promises made about what frequency this function might run at. You should
- * use SDL's timer functions if you need to see how much time has passed since
- * the last iteration.
- *
- * There is no need to process the SDL event queue during this function; SDL
- * will send events as they arrive in SDL_AppEvent, and in most cases the
- * event queue will be empty when this function runs anyhow.
- *
- * This function should not go into an infinite mainloop; it should do one
- * iteration of whatever the program does and return.
- *
- * The `appstate` parameter is an optional pointer provided by the app during
- * SDL_AppInit(). If the app never provided a pointer, this will be NULL.
- *
- * If this function returns SDL_APP_CONTINUE, the app will continue normal
- * operation, receiving repeated calls to SDL_AppIterate and SDL_AppEvent for
- * the life of the program. If this function returns SDL_APP_FAILURE, SDL will
- * call SDL_AppQuit and terminate the process with an exit code that reports
- * an error to the platform. If it returns SDL_APP_SUCCESS, SDL calls
- * SDL_AppQuit and terminates with an exit code that reports success to the
- * platform.
- *
- * This function is called by SDL on the main thread.
- *
- * \param appstate an optional pointer, provided by the app in SDL_AppInit.
- * \returns SDL_APP_FAILURE to terminate with an error, SDL_APP_SUCCESS to
- *          terminate with success, SDL_APP_CONTINUE to continue.
- *
- * \threadsafety This function may get called concurrently with SDL_AppEvent()
- *               for events not pushed on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_AppInit
- * \sa SDL_AppEvent
- */
-extern SDLMAIN_DECLSPEC SDL_AppResult SDLCALL SDL_AppIterate(void *appstate);
-
-/**
- * App-implemented event entry point for SDL_MAIN_USE_CALLBACKS apps.
- *
- * Apps implement this function when using SDL_MAIN_USE_CALLBACKS. If using a
- * standard "main" function, you should not supply this.
- *
- * This function is called as needed by SDL after SDL_AppInit returns
- * SDL_APP_CONTINUE. It is called once for each new event.
- *
- * There is (currently) no guarantee about what thread this will be called
- * from; whatever thread pushes an event onto SDL's queue will trigger this
- * function. SDL is responsible for pumping the event queue between each call
- * to SDL_AppIterate, so in normal operation one should only get events in a
- * serial fashion, but be careful if you have a thread that explicitly calls
- * SDL_PushEvent. SDL itself will push events to the queue on the main thread.
- *
- * Events sent to this function are not owned by the app; if you need to save
- * the data, you should copy it.
- *
- * This function should not go into an infinite mainloop; it should handle the
- * provided event appropriately and return.
- *
- * The `appstate` parameter is an optional pointer provided by the app during
- * SDL_AppInit(). If the app never provided a pointer, this will be NULL.
- *
- * If this function returns SDL_APP_CONTINUE, the app will continue normal
- * operation, receiving repeated calls to SDL_AppIterate and SDL_AppEvent for
- * the life of the program. If this function returns SDL_APP_FAILURE, SDL will
- * call SDL_AppQuit and terminate the process with an exit code that reports
- * an error to the platform. If it returns SDL_APP_SUCCESS, SDL calls
- * SDL_AppQuit and terminates with an exit code that reports success to the
- * platform.
- *
- * \param appstate an optional pointer, provided by the app in SDL_AppInit.
- * \param event the new event for the app to examine.
- * \returns SDL_APP_FAILURE to terminate with an error, SDL_APP_SUCCESS to
- *          terminate with success, SDL_APP_CONTINUE to continue.
- *
- * \threadsafety This function may get called concurrently with
- *               SDL_AppIterate() or SDL_AppQuit() for events not pushed from
- *               the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_AppInit
- * \sa SDL_AppIterate
- */
-extern SDLMAIN_DECLSPEC SDL_AppResult SDLCALL SDL_AppEvent(void *appstate, SDL_Event *event);
-
-/**
- * App-implemented deinit entry point for SDL_MAIN_USE_CALLBACKS apps.
- *
- * Apps implement this function when using SDL_MAIN_USE_CALLBACKS. If using a
- * standard "main" function, you should not supply this.
- *
- * This function is called once by SDL before terminating the program.
- *
- * This function will be called no matter what, even if SDL_AppInit requests
- * termination.
- *
- * This function should not go into an infinite mainloop; it should
- * deinitialize any resources necessary, perform whatever shutdown activities,
- * and return.
- *
- * You do not need to call SDL_Quit() in this function, as SDL will call it
- * after this function returns and before the process terminates, but it is
- * safe to do so.
- *
- * The `appstate` parameter is an optional pointer provided by the app during
- * SDL_AppInit(). If the app never provided a pointer, this will be NULL. This
- * function call is the last time this pointer will be provided, so any
- * resources to it should be cleaned up here.
- *
- * This function is called by SDL on the main thread.
- *
- * \param appstate an optional pointer, provided by the app in SDL_AppInit.
- * \param result the result code that terminated the app (success or failure).
- *
- * \threadsafety SDL_AppEvent() may get called concurrently with this function
- *               if other threads that push events are still active.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_AppInit
- */
-extern SDLMAIN_DECLSPEC void SDLCALL SDL_AppQuit(void *appstate, SDL_AppResult result);
-
-#endif  /* SDL_MAIN_USE_CALLBACKS */
-
-
-/**
- * The prototype for the application's main() function
- *
- * \param argc an ANSI-C style main function's argc.
- * \param argv an ANSI-C style main function's argv.
- * \returns an ANSI-C main return code; generally 0 is considered successful
- *          program completion, and small non-zero values are considered
- *          errors.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef int (SDLCALL *SDL_main_func)(int argc, char *argv[]);
-
-/**
- * An app-supplied function for program entry.
- *
- * Apps do not directly create this function; they should create a standard
- * ANSI-C `main` function instead. If SDL needs to insert some startup code
- * before `main` runs, or the platform doesn't actually _use_ a function
- * called "main", SDL will do some macro magic to redefine `main` to
- * `SDL_main` and provide its own `main`.
- *
- * Apps should include `SDL_main.h` in the same file as their `main` function,
- * and they should not use that symbol for anything else in that file, as it
- * might get redefined.
- *
- * This function is only provided by the app if it isn't using
- * SDL_MAIN_USE_CALLBACKS.
- *
- * Program startup is a surprisingly complex topic. Please see
- * [README/main-functions](README/main-functions), (or
- * docs/README-main-functions.md in the source tree) for a more detailed
- * explanation.
- *
- * \param argc an ANSI-C style main function's argc.
- * \param argv an ANSI-C style main function's argv.
- * \returns an ANSI-C main return code; generally 0 is considered successful
- *          program completion, and small non-zero values are considered
- *          errors.
- *
- * \threadsafety This is the program entry point.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDLMAIN_DECLSPEC int SDLCALL SDL_main(int argc, char *argv[]);
-
-/**
- * Circumvent failure of SDL_Init() when not using SDL_main() as an entry
- * point.
- *
- * This function is defined in SDL_main.h, along with the preprocessor rule to
- * redefine main() as SDL_main(). Thus to ensure that your main() function
- * will not be changed it is necessary to define SDL_MAIN_HANDLED before
- * including SDL.h.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Init
- */
-extern SDL_DECLSPEC void SDLCALL SDL_SetMainReady(void);
-
-/**
- * Initializes and launches an SDL application, by doing platform-specific
- * initialization before calling your mainFunction and cleanups after it
- * returns, if that is needed for a specific platform, otherwise it just calls
- * mainFunction.
- *
- * You can use this if you want to use your own main() implementation without
- * using SDL_main (like when using SDL_MAIN_HANDLED). When using this, you do
- * *not* need SDL_SetMainReady().
- *
- * \param argc the argc parameter from the application's main() function, or 0
- *             if the platform's main-equivalent has no argc.
- * \param argv the argv parameter from the application's main() function, or
- *             NULL if the platform's main-equivalent has no argv.
- * \param mainFunction your SDL app's C-style main(). NOT the function you're
- *                     calling this from! Its name doesn't matter; it doesn't
- *                     literally have to be `main`.
- * \param reserved should be NULL (reserved for future use, will probably be
- *                 platform-specific then).
- * \returns the return value from mainFunction: 0 on success, otherwise
- *          failure; SDL_GetError() might have more information on the
- *          failure.
- *
- * \threadsafety Generally this is called once, near startup, from the
- *               process's initial thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_RunApp(int argc, char *argv[], SDL_main_func mainFunction, void *reserved);
-
-/**
- * An entry point for SDL's use in SDL_MAIN_USE_CALLBACKS.
- *
- * Generally, you should not call this function directly. This only exists to
- * hand off work into SDL as soon as possible, where it has a lot more control
- * and functionality available, and make the inline code in SDL_main.h as
- * small as possible.
- *
- * Not all platforms use this, it's actual use is hidden in a magic
- * header-only library, and you should not call this directly unless you
- * _really_ know what you're doing.
- *
- * \param argc standard Unix main argc.
- * \param argv standard Unix main argv.
- * \param appinit the application's SDL_AppInit function.
- * \param appiter the application's SDL_AppIterate function.
- * \param appevent the application's SDL_AppEvent function.
- * \param appquit the application's SDL_AppQuit function.
- * \returns standard Unix main return value.
- *
- * \threadsafety It is not safe to call this anywhere except as the only
- *               function call in SDL_main.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_EnterAppMainCallbacks(int argc, char *argv[], SDL_AppInit_func appinit, SDL_AppIterate_func appiter, SDL_AppEvent_func appevent, SDL_AppQuit_func appquit);
-
-
-#if defined(SDL_PLATFORM_WINDOWS)
-
-/**
- * Register a win32 window class for SDL's use.
- *
- * This can be called to set the application window class at startup. It is
- * safe to call this multiple times, as long as every call is eventually
- * paired with a call to SDL_UnregisterApp, but a second registration attempt
- * while a previous registration is still active will be ignored, other than
- * to increment a counter.
- *
- * Most applications do not need to, and should not, call this directly; SDL
- * will call it when initializing the video subsystem.
- *
- * \param name the window class name, in UTF-8 encoding. If NULL, SDL
- *             currently uses "SDL_app" but this isn't guaranteed.
- * \param style the value to use in WNDCLASSEX::style. If `name` is NULL, SDL
- *              currently uses `(CS_BYTEALIGNCLIENT | CS_OWNDC)` regardless of
- *              what is specified here.
- * \param hInst the HINSTANCE to use in WNDCLASSEX::hInstance. If zero, SDL
- *              will use `GetModuleHandle(NULL)` instead.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_RegisterApp(const char *name, Uint32 style, void *hInst);
-
-/**
- * Deregister the win32 window class from an SDL_RegisterApp call.
- *
- * This can be called to undo the effects of SDL_RegisterApp.
- *
- * Most applications do not need to, and should not, call this directly; SDL
- * will call it when deinitializing the video subsystem.
- *
- * It is safe to call this multiple times, as long as every call is eventually
- * paired with a prior call to SDL_RegisterApp. The window class will only be
- * deregistered when the registration counter in SDL_RegisterApp decrements to
- * zero through calls to this function.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC void SDLCALL SDL_UnregisterApp(void);
-
-#endif /* defined(SDL_PLATFORM_WINDOWS) */
-
-/**
- * Callback from the application to let the suspend continue.
- *
- * This function is only needed for Xbox GDK support; all other platforms will
- * do nothing and set an "unsupported" error message.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC void SDLCALL SDL_GDKSuspendComplete(void);
-
-#ifdef __cplusplus
-}
-#endif
-
-#include <SDL3/SDL_close_code.h>
-
-#if !defined(SDL_MAIN_HANDLED) && !defined(SDL_MAIN_NOIMPL)
-    /* include header-only SDL_main implementations */
-    #if defined(SDL_MAIN_USE_CALLBACKS) || defined(SDL_MAIN_NEEDED) || defined(SDL_MAIN_AVAILABLE)
-        /* platforms which main (-equivalent) can be implemented in plain C */
-        #include <SDL3/SDL_main_impl.h>
-    #endif
-#endif
-
-#endif /* SDL_main_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_main_impl.h

@@ -1,151 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: Main */
-
-#ifndef SDL_main_impl_h_
-#define SDL_main_impl_h_
-
-#ifndef SDL_main_h_
-#error "This header should not be included directly, but only via SDL_main.h!"
-#endif
-
-/* if someone wants to include SDL_main.h but doesn't want the main handing magic,
-   (maybe to call SDL_RegisterApp()) they can #define SDL_MAIN_HANDLED first.
-   SDL_MAIN_NOIMPL is for SDL-internal usage (only affects implementation,
-   not definition of SDL_MAIN_AVAILABLE etc in SDL_main.h) and if the user wants
-   to have the SDL_main implementation (from this header) in another source file
-   than their main() function, for example if SDL_main requires C++
-   and main() is implemented in plain C */
-#if !defined(SDL_MAIN_HANDLED) && !defined(SDL_MAIN_NOIMPL)
-
-    /* the implementations below must be able to use the implement real main(), nothing renamed
-       (the user's main() will be renamed to SDL_main so it can be called from here) */
-    #ifdef main
-        #undef main
-    #endif
-
-    #ifdef SDL_MAIN_USE_CALLBACKS
-
-        #if 0
-            /* currently there are no platforms that _need_ a magic entry point here
-               for callbacks, but if one shows up, implement it here. */
-
-        #else /* use a standard SDL_main, which the app SHOULD NOT ALSO SUPPLY. */
-
-            /* this define makes the normal SDL_main entry point stuff work...we just provide SDL_main() instead of the app. */
-            #define SDL_MAIN_CALLBACK_STANDARD 1
-
-            int SDL_main(int argc, char **argv)
-            {
-                return SDL_EnterAppMainCallbacks(argc, argv, SDL_AppInit, SDL_AppIterate, SDL_AppEvent, SDL_AppQuit);
-            }
-
-        #endif  /* platform-specific tests */
-
-    #endif  /* SDL_MAIN_USE_CALLBACKS */
-
-
-    /* set up the usual SDL_main stuff if we're not using callbacks or if we are but need the normal entry point,
-       unless the real entry point needs to be somewhere else entirely, like Android where it's in Java code */
-    #if (!defined(SDL_MAIN_USE_CALLBACKS) || defined(SDL_MAIN_CALLBACK_STANDARD)) && !defined(SDL_MAIN_EXPORTED)
-
-        #if defined(SDL_PLATFORM_PRIVATE_MAIN)
-            /* Private platforms may have their own ideas about entry points. */
-            #include "SDL_main_impl_private.h"
-
-        #elif defined(SDL_PLATFORM_WINDOWS)
-
-            /* these defines/typedefs are needed for the WinMain() definition */
-            #ifndef WINAPI
-                #define WINAPI __stdcall
-            #endif
-
-            typedef struct HINSTANCE__ * HINSTANCE;
-            typedef char *LPSTR;
-            typedef wchar_t *PWSTR;
-
-            /* The VC++ compiler needs main/wmain defined, but not for GDK */
-            #if defined(_MSC_VER) && !defined(SDL_PLATFORM_GDK)
-
-                /* This is where execution begins [console apps] */
-                #if defined(UNICODE) && UNICODE
-                    int wmain(int argc, wchar_t *wargv[], wchar_t *wenvp)
-                    {
-                        (void)argc;
-                        (void)wargv;
-                        (void)wenvp;
-                        return SDL_RunApp(0, NULL, SDL_main, NULL);
-                    }
-                #else /* ANSI */
-                    int main(int argc, char *argv[])
-                    {
-                        (void)argc;
-                        (void)argv;
-                        return SDL_RunApp(0, NULL, SDL_main, NULL);
-                    }
-                #endif /* UNICODE */
-
-            #endif /* _MSC_VER && ! SDL_PLATFORM_GDK */
-
-            /* This is where execution begins [windowed apps and GDK] */
-
-            #ifdef __cplusplus
-            extern "C" {
-            #endif
-
-            #if defined(UNICODE) && UNICODE
-            int WINAPI wWinMain(HINSTANCE hInst, HINSTANCE hPrev, PWSTR szCmdLine, int sw)
-            #else /* ANSI */
-            int WINAPI WinMain(HINSTANCE hInst, HINSTANCE hPrev, LPSTR szCmdLine, int sw)
-            #endif
-            {
-                (void)hInst;
-                (void)hPrev;
-                (void)szCmdLine;
-                (void)sw;
-                return SDL_RunApp(0, NULL, SDL_main, NULL);
-            }
-
-            #ifdef __cplusplus
-            } /* extern "C" */
-            #endif
-
-            /* end of SDL_PLATFORM_WINDOWS impls */
-
-        #else /* platforms that use a standard main() and just call SDL_RunApp(), like iOS and 3DS */
-            int main(int argc, char *argv[])
-            {
-                return SDL_RunApp(argc, argv, SDL_main, NULL);
-            }
-
-            /* end of impls for standard-conforming platforms */
-
-        #endif /* SDL_PLATFORM_WIN32 etc */
-
-    #endif /* !defined(SDL_MAIN_USE_CALLBACKS) || defined(SDL_MAIN_CALLBACK_STANDARD) */
-
-    /* rename users main() function to SDL_main() so it can be called from the wrappers above */
-    #define main    SDL_main
-
-#endif /* SDL_MAIN_HANDLED */
-
-#endif /* SDL_main_impl_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_messagebox.h

@@ -1,226 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryMessagebox
- *
- * SDL offers a simple message box API, which is useful for simple alerts,
- * such as informing the user when something fatal happens at startup without
- * the need to build a UI for it (or informing the user _before_ your UI is
- * ready).
- *
- * These message boxes are native system dialogs where possible.
- *
- * There is both a customizable function (SDL_ShowMessageBox()) that offers
- * lots of options for what to display and reports on what choice the user
- * made, and also a much-simplified version (SDL_ShowSimpleMessageBox()),
- * merely takes a text message and title, and waits until the user presses a
- * single "OK" UI button. Often, this is all that is necessary.
- */
-
-#ifndef SDL_messagebox_h_
-#define SDL_messagebox_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_video.h>      /* For SDL_Window */
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * Message box flags.
- *
- * If supported will display warning icon, etc.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_MessageBoxFlags;
-
-#define SDL_MESSAGEBOX_ERROR                    0x00000010u /**< error dialog */
-#define SDL_MESSAGEBOX_WARNING                  0x00000020u /**< warning dialog */
-#define SDL_MESSAGEBOX_INFORMATION              0x00000040u /**< informational dialog */
-#define SDL_MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT    0x00000080u /**< buttons placed left to right */
-#define SDL_MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT    0x00000100u /**< buttons placed right to left */
-
-/**
- * SDL_MessageBoxButtonData flags.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_MessageBoxButtonFlags;
-
-#define SDL_MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT 0x00000001u /**< Marks the default button when return is hit */
-#define SDL_MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT 0x00000002u /**< Marks the default button when escape is hit */
-
-/**
- * Individual button data.
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_MessageBoxButtonData
-{
-    SDL_MessageBoxButtonFlags flags;
-    int buttonID;       /**< User defined button id (value returned via SDL_ShowMessageBox) */
-    const char *text;   /**< The UTF-8 button text */
-} SDL_MessageBoxButtonData;
-
-/**
- * RGB value used in a message box color scheme
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_MessageBoxColor
-{
-    Uint8 r, g, b;
-} SDL_MessageBoxColor;
-
-/**
- * An enumeration of indices inside the colors array of
- * SDL_MessageBoxColorScheme.
- */
-typedef enum SDL_MessageBoxColorType
-{
-    SDL_MESSAGEBOX_COLOR_BACKGROUND,
-    SDL_MESSAGEBOX_COLOR_TEXT,
-    SDL_MESSAGEBOX_COLOR_BUTTON_BORDER,
-    SDL_MESSAGEBOX_COLOR_BUTTON_BACKGROUND,
-    SDL_MESSAGEBOX_COLOR_BUTTON_SELECTED,
-    SDL_MESSAGEBOX_COLOR_COUNT                    /**< Size of the colors array of SDL_MessageBoxColorScheme. */
-} SDL_MessageBoxColorType;
-
-/**
- * A set of colors to use for message box dialogs
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_MessageBoxColorScheme
-{
-    SDL_MessageBoxColor colors[SDL_MESSAGEBOX_COLOR_COUNT];
-} SDL_MessageBoxColorScheme;
-
-/**
- * MessageBox structure containing title, text, window, etc.
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_MessageBoxData
-{
-    SDL_MessageBoxFlags flags;
-    SDL_Window *window;                 /**< Parent window, can be NULL */
-    const char *title;                  /**< UTF-8 title */
-    const char *message;                /**< UTF-8 message text */
-
-    int numbuttons;
-    const SDL_MessageBoxButtonData *buttons;
-
-    const SDL_MessageBoxColorScheme *colorScheme;   /**< SDL_MessageBoxColorScheme, can be NULL to use system settings */
-} SDL_MessageBoxData;
-
-/**
- * Create a modal message box.
- *
- * If your needs aren't complex, it might be easier to use
- * SDL_ShowSimpleMessageBox.
- *
- * This function should be called on the thread that created the parent
- * window, or on the main thread if the messagebox has no parent. It will
- * block execution of that thread until the user clicks a button or closes the
- * messagebox.
- *
- * This function may be called at any time, even before SDL_Init(). This makes
- * it useful for reporting errors like a failure to create a renderer or
- * OpenGL context.
- *
- * On X11, SDL rolls its own dialog box with X11 primitives instead of a
- * formal toolkit like GTK+ or Qt.
- *
- * Note that if SDL_Init() would fail because there isn't any available video
- * target, this function is likely to fail for the same reasons. If this is a
- * concern, check the return value from this function and fall back to writing
- * to stderr if you can.
- *
- * \param messageboxdata the SDL_MessageBoxData structure with title, text and
- *                       other options.
- * \param buttonid the pointer to which user id of hit button should be
- *                 copied.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ShowSimpleMessageBox
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ShowMessageBox(const SDL_MessageBoxData *messageboxdata, int *buttonid);
-
-/**
- * Display a simple modal message box.
- *
- * If your needs aren't complex, this function is preferred over
- * SDL_ShowMessageBox.
- *
- * `flags` may be any of the following:
- *
- * - `SDL_MESSAGEBOX_ERROR`: error dialog
- * - `SDL_MESSAGEBOX_WARNING`: warning dialog
- * - `SDL_MESSAGEBOX_INFORMATION`: informational dialog
- *
- * This function should be called on the thread that created the parent
- * window, or on the main thread if the messagebox has no parent. It will
- * block execution of that thread until the user clicks a button or closes the
- * messagebox.
- *
- * This function may be called at any time, even before SDL_Init(). This makes
- * it useful for reporting errors like a failure to create a renderer or
- * OpenGL context.
- *
- * On X11, SDL rolls its own dialog box with X11 primitives instead of a
- * formal toolkit like GTK+ or Qt.
- *
- * Note that if SDL_Init() would fail because there isn't any available video
- * target, this function is likely to fail for the same reasons. If this is a
- * concern, check the return value from this function and fall back to writing
- * to stderr if you can.
- *
- * \param flags an SDL_MessageBoxFlags value.
- * \param title UTF-8 title text.
- * \param message UTF-8 message text.
- * \param window the parent window, or NULL for no parent.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ShowMessageBox
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags flags, const char *title, const char *message, SDL_Window *window);
-
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_messagebox_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_metal.h

@@ -1,107 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryMetal
- *
- * Functions to creating Metal layers and views on SDL windows.
- *
- * This provides some platform-specific glue for Apple platforms. Most macOS
- * and iOS apps can use SDL without these functions, but this API they can be
- * useful for specific OS-level integration tasks.
- */
-
-#ifndef SDL_metal_h_
-#define SDL_metal_h_
-
-#include <SDL3/SDL_video.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * A handle to a CAMetalLayer-backed NSView (macOS) or UIView (iOS/tvOS).
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef void *SDL_MetalView;
-
-/**
- *  \name Metal support functions
- */
-/* @{ */
-
-/**
- * Create a CAMetalLayer-backed NSView/UIView and attach it to the specified
- * window.
- *
- * On macOS, this does *not* associate a MTLDevice with the CAMetalLayer on
- * its own. It is up to user code to do that.
- *
- * The returned handle can be casted directly to a NSView or UIView. To access
- * the backing CAMetalLayer, call SDL_Metal_GetLayer().
- *
- * \param window the window.
- * \returns handle NSView or UIView.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Metal_DestroyView
- * \sa SDL_Metal_GetLayer
- */
-extern SDL_DECLSPEC SDL_MetalView SDLCALL SDL_Metal_CreateView(SDL_Window *window);
-
-/**
- * Destroy an existing SDL_MetalView object.
- *
- * This should be called before SDL_DestroyWindow, if SDL_Metal_CreateView was
- * called after SDL_CreateWindow.
- *
- * \param view the SDL_MetalView object.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_Metal_CreateView
- */
-extern SDL_DECLSPEC void SDLCALL SDL_Metal_DestroyView(SDL_MetalView view);
-
-/**
- * Get a pointer to the backing CAMetalLayer for the given view.
- *
- * \param view the SDL_MetalView object.
- * \returns a pointer.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC void * SDLCALL SDL_Metal_GetLayer(SDL_MetalView view);
-
-/* @} *//* Metal support functions */
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_metal_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_misc.h

@@ -1,78 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryMisc
- *
- * SDL API functions that don't fit elsewhere.
- */
-
-#ifndef SDL_misc_h_
-#define SDL_misc_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * Open a URL/URI in the browser or other appropriate external application.
- *
- * Open a URL in a separate, system-provided application. How this works will
- * vary wildly depending on the platform. This will likely launch what makes
- * sense to handle a specific URL's protocol (a web browser for `http://`,
- * etc), but it might also be able to launch file managers for directories and
- * other things.
- *
- * What happens when you open a URL varies wildly as well: your game window
- * may lose focus (and may or may not lose focus if your game was fullscreen
- * or grabbing input at the time). On mobile devices, your app will likely
- * move to the background or your process might be paused. Any given platform
- * may or may not handle a given URL.
- *
- * If this is unimplemented (or simply unavailable) for a platform, this will
- * fail with an error. A successful result does not mean the URL loaded, just
- * that we launched _something_ to handle it (or at least believe we did).
- *
- * All this to say: this function can be useful, but you should definitely
- * test it on every platform you target.
- *
- * \param url a valid URL/URI to open. Use `file:///full/path/to/file` for
- *            local files, if supported.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_OpenURL(const char *url);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_misc_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_mouse.h

@@ -1,689 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryMouse
- *
- * Any GUI application has to deal with the mouse, and SDL provides functions
- * to manage mouse input and the displayed cursor.
- *
- * Most interactions with the mouse will come through the event subsystem.
- * Moving a mouse generates an SDL_EVENT_MOUSE_MOTION event, pushing a button
- * generates SDL_EVENT_MOUSE_BUTTON_DOWN, etc, but one can also query the
- * current state of the mouse at any time with SDL_GetMouseState().
- *
- * For certain games, it's useful to disassociate the mouse cursor from mouse
- * input. An FPS, for example, would not want the player's motion to stop as
- * the mouse hits the edge of the window. For these scenarios, use
- * SDL_SetWindowRelativeMouseMode(), which hides the cursor, grabs mouse input
- * to the window, and reads mouse input no matter how far it moves.
- *
- * Games that want the system to track the mouse but want to draw their own
- * cursor can use SDL_HideCursor() and SDL_ShowCursor(). It might be more
- * efficient to let the system manage the cursor, if possible, using
- * SDL_SetCursor() with a custom image made through SDL_CreateColorCursor(),
- * or perhaps just a specific system cursor from SDL_CreateSystemCursor().
- *
- * SDL can, on many platforms, differentiate between multiple connected mice,
- * allowing for interesting input scenarios and multiplayer games. They can be
- * enumerated with SDL_GetMice(), and SDL will send SDL_EVENT_MOUSE_ADDED and
- * SDL_EVENT_MOUSE_REMOVED events as they are connected and unplugged.
- *
- * Since many apps only care about basic mouse input, SDL offers a virtual
- * mouse device for touch and pen input, which often can make a desktop
- * application work on a touchscreen phone without any code changes. Apps that
- * care about touch/pen separately from mouse input should filter out events
- * with a `which` field of SDL_TOUCH_MOUSEID/SDL_PEN_MOUSEID.
- */
-
-#ifndef SDL_mouse_h_
-#define SDL_mouse_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_surface.h>
-#include <SDL3/SDL_video.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * This is a unique ID for a mouse for the time it is connected to the system,
- * and is never reused for the lifetime of the application.
- *
- * If the mouse is disconnected and reconnected, it will get a new ID.
- *
- * The value 0 is an invalid ID.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_MouseID;
-
-/**
- * The structure used to identify an SDL cursor.
- *
- * This is opaque data.
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_Cursor SDL_Cursor;
-
-/**
- * Cursor types for SDL_CreateSystemCursor().
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_SystemCursor
-{
-    SDL_SYSTEM_CURSOR_DEFAULT,      /**< Default cursor. Usually an arrow. */
-    SDL_SYSTEM_CURSOR_TEXT,         /**< Text selection. Usually an I-beam. */
-    SDL_SYSTEM_CURSOR_WAIT,         /**< Wait. Usually an hourglass or watch or spinning ball. */
-    SDL_SYSTEM_CURSOR_CROSSHAIR,    /**< Crosshair. */
-    SDL_SYSTEM_CURSOR_PROGRESS,     /**< Program is busy but still interactive. Usually it's WAIT with an arrow. */
-    SDL_SYSTEM_CURSOR_NWSE_RESIZE,  /**< Double arrow pointing northwest and southeast. */
-    SDL_SYSTEM_CURSOR_NESW_RESIZE,  /**< Double arrow pointing northeast and southwest. */
-    SDL_SYSTEM_CURSOR_EW_RESIZE,    /**< Double arrow pointing west and east. */
-    SDL_SYSTEM_CURSOR_NS_RESIZE,    /**< Double arrow pointing north and south. */
-    SDL_SYSTEM_CURSOR_MOVE,         /**< Four pointed arrow pointing north, south, east, and west. */
-    SDL_SYSTEM_CURSOR_NOT_ALLOWED,  /**< Not permitted. Usually a slashed circle or crossbones. */
-    SDL_SYSTEM_CURSOR_POINTER,      /**< Pointer that indicates a link. Usually a pointing hand. */
-    SDL_SYSTEM_CURSOR_NW_RESIZE,    /**< Window resize top-left. This may be a single arrow or a double arrow like NWSE_RESIZE. */
-    SDL_SYSTEM_CURSOR_N_RESIZE,     /**< Window resize top. May be NS_RESIZE. */
-    SDL_SYSTEM_CURSOR_NE_RESIZE,    /**< Window resize top-right. May be NESW_RESIZE. */
-    SDL_SYSTEM_CURSOR_E_RESIZE,     /**< Window resize right. May be EW_RESIZE. */
-    SDL_SYSTEM_CURSOR_SE_RESIZE,    /**< Window resize bottom-right. May be NWSE_RESIZE. */
-    SDL_SYSTEM_CURSOR_S_RESIZE,     /**< Window resize bottom. May be NS_RESIZE. */
-    SDL_SYSTEM_CURSOR_SW_RESIZE,    /**< Window resize bottom-left. May be NESW_RESIZE. */
-    SDL_SYSTEM_CURSOR_W_RESIZE,     /**< Window resize left. May be EW_RESIZE. */
-    SDL_SYSTEM_CURSOR_COUNT
-} SDL_SystemCursor;
-
-/**
- * Scroll direction types for the Scroll event
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_MouseWheelDirection
-{
-    SDL_MOUSEWHEEL_NORMAL,    /**< The scroll direction is normal */
-    SDL_MOUSEWHEEL_FLIPPED    /**< The scroll direction is flipped / natural */
-} SDL_MouseWheelDirection;
-
-/**
- * A bitmask of pressed mouse buttons, as reported by SDL_GetMouseState, etc.
- *
- * - Button 1: Left mouse button
- * - Button 2: Middle mouse button
- * - Button 3: Right mouse button
- * - Button 4: Side mouse button 1
- * - Button 5: Side mouse button 2
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_GetMouseState
- * \sa SDL_GetGlobalMouseState
- * \sa SDL_GetRelativeMouseState
- */
-typedef Uint32 SDL_MouseButtonFlags;
-
-#define SDL_BUTTON_LEFT     1
-#define SDL_BUTTON_MIDDLE   2
-#define SDL_BUTTON_RIGHT    3
-#define SDL_BUTTON_X1       4
-#define SDL_BUTTON_X2       5
-
-#define SDL_BUTTON_MASK(X)  (1u << ((X)-1))
-#define SDL_BUTTON_LMASK    SDL_BUTTON_MASK(SDL_BUTTON_LEFT)
-#define SDL_BUTTON_MMASK    SDL_BUTTON_MASK(SDL_BUTTON_MIDDLE)
-#define SDL_BUTTON_RMASK    SDL_BUTTON_MASK(SDL_BUTTON_RIGHT)
-#define SDL_BUTTON_X1MASK   SDL_BUTTON_MASK(SDL_BUTTON_X1)
-#define SDL_BUTTON_X2MASK   SDL_BUTTON_MASK(SDL_BUTTON_X2)
-
-
-/* Function prototypes */
-
-/**
- * Return whether a mouse is currently connected.
- *
- * \returns true if a mouse is connected, false otherwise.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetMice
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasMouse(void);
-
-/**
- * Get a list of currently connected mice.
- *
- * Note that this will include any device or virtual driver that includes
- * mouse functionality, including some game controllers, KVM switches, etc.
- * You should wait for input from a device before you consider it actively in
- * use.
- *
- * \param count a pointer filled in with the number of mice returned, may be
- *              NULL.
- * \returns a 0 terminated array of mouse instance IDs or NULL on failure;
- *          call SDL_GetError() for more information. This should be freed
- *          with SDL_free() when it is no longer needed.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetMouseNameForID
- * \sa SDL_HasMouse
- */
-extern SDL_DECLSPEC SDL_MouseID * SDLCALL SDL_GetMice(int *count);
-
-/**
- * Get the name of a mouse.
- *
- * This function returns "" if the mouse doesn't have a name.
- *
- * \param instance_id the mouse instance ID.
- * \returns the name of the selected mouse, or NULL on failure; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetMice
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetMouseNameForID(SDL_MouseID instance_id);
-
-/**
- * Get the window which currently has mouse focus.
- *
- * \returns the window with mouse focus.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_GetMouseFocus(void);
-
-/**
- * Query SDL's cache for the synchronous mouse button state and the
- * window-relative SDL-cursor position.
- *
- * This function returns the cached synchronous state as SDL understands it
- * from the last pump of the event queue.
- *
- * To query the platform for immediate asynchronous state, use
- * SDL_GetGlobalMouseState.
- *
- * Passing non-NULL pointers to `x` or `y` will write the destination with
- * respective x or y coordinates relative to the focused window.
- *
- * In Relative Mode, the SDL-cursor's position usually contradicts the
- * platform-cursor's position as manually calculated from
- * SDL_GetGlobalMouseState() and SDL_GetWindowPosition.
- *
- * \param x a pointer to receive the SDL-cursor's x-position from the focused
- *          window's top left corner, can be NULL if unused.
- * \param y a pointer to receive the SDL-cursor's y-position from the focused
- *          window's top left corner, can be NULL if unused.
- * \returns a 32-bit bitmask of the button state that can be bitwise-compared
- *          against the SDL_BUTTON_MASK(X) macro.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetGlobalMouseState
- * \sa SDL_GetRelativeMouseState
- */
-extern SDL_DECLSPEC SDL_MouseButtonFlags SDLCALL SDL_GetMouseState(float *x, float *y);
-
-/**
- * Query the platform for the asynchronous mouse button state and the
- * desktop-relative platform-cursor position.
- *
- * This function immediately queries the platform for the most recent
- * asynchronous state, more costly than retrieving SDL's cached state in
- * SDL_GetMouseState().
- *
- * Passing non-NULL pointers to `x` or `y` will write the destination with
- * respective x or y coordinates relative to the desktop.
- *
- * In Relative Mode, the platform-cursor's position usually contradicts the
- * SDL-cursor's position as manually calculated from SDL_GetMouseState() and
- * SDL_GetWindowPosition.
- *
- * This function can be useful if you need to track the mouse outside of a
- * specific window and SDL_CaptureMouse() doesn't fit your needs. For example,
- * it could be useful if you need to track the mouse while dragging a window,
- * where coordinates relative to a window might not be in sync at all times.
- *
- * \param x a pointer to receive the platform-cursor's x-position from the
- *          desktop's top left corner, can be NULL if unused.
- * \param y a pointer to receive the platform-cursor's y-position from the
- *          desktop's top left corner, can be NULL if unused.
- * \returns a 32-bit bitmask of the button state that can be bitwise-compared
- *          against the SDL_BUTTON_MASK(X) macro.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CaptureMouse
- * \sa SDL_GetMouseState
- * \sa SDL_GetGlobalMouseState
- */
-extern SDL_DECLSPEC SDL_MouseButtonFlags SDLCALL SDL_GetGlobalMouseState(float *x, float *y);
-
-/**
- * Query SDL's cache for the synchronous mouse button state and accumulated
- * mouse delta since last call.
- *
- * This function returns the cached synchronous state as SDL understands it
- * from the last pump of the event queue.
- *
- * To query the platform for immediate asynchronous state, use
- * SDL_GetGlobalMouseState.
- *
- * Passing non-NULL pointers to `x` or `y` will write the destination with
- * respective x or y deltas accumulated since the last call to this function
- * (or since event initialization).
- *
- * This function is useful for reducing overhead by processing relative mouse
- * inputs in one go per-frame instead of individually per-event, at the
- * expense of losing the order between events within the frame (e.g. quickly
- * pressing and releasing a button within the same frame).
- *
- * \param x a pointer to receive the x mouse delta accumulated since last
- *          call, can be NULL if unused.
- * \param y a pointer to receive the y mouse delta accumulated since last
- *          call, can be NULL if unused.
- * \returns a 32-bit bitmask of the button state that can be bitwise-compared
- *          against the SDL_BUTTON_MASK(X) macro.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetMouseState
- * \sa SDL_GetGlobalMouseState
- */
-extern SDL_DECLSPEC SDL_MouseButtonFlags SDLCALL SDL_GetRelativeMouseState(float *x, float *y);
-
-/**
- * Move the mouse cursor to the given position within the window.
- *
- * This function generates a mouse motion event if relative mode is not
- * enabled. If relative mode is enabled, you can force mouse events for the
- * warp by setting the SDL_HINT_MOUSE_RELATIVE_WARP_MOTION hint.
- *
- * Note that this function will appear to succeed, but not actually move the
- * mouse when used over Microsoft Remote Desktop.
- *
- * \param window the window to move the mouse into, or NULL for the current
- *               mouse focus.
- * \param x the x coordinate within the window.
- * \param y the y coordinate within the window.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_WarpMouseGlobal
- */
-extern SDL_DECLSPEC void SDLCALL SDL_WarpMouseInWindow(SDL_Window *window,
-                                                   float x, float y);
-
-/**
- * Move the mouse to the given position in global screen space.
- *
- * This function generates a mouse motion event.
- *
- * A failure of this function usually means that it is unsupported by a
- * platform.
- *
- * Note that this function will appear to succeed, but not actually move the
- * mouse when used over Microsoft Remote Desktop.
- *
- * \param x the x coordinate.
- * \param y the y coordinate.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_WarpMouseInWindow
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_WarpMouseGlobal(float x, float y);
-
-/**
- * Set relative mouse mode for a window.
- *
- * While the window has focus and relative mouse mode is enabled, the cursor
- * is hidden, the mouse position is constrained to the window, and SDL will
- * report continuous relative mouse motion even if the mouse is at the edge of
- * the window.
- *
- * If you'd like to keep the mouse position fixed while in relative mode you
- * can use SDL_SetWindowMouseRect(). If you'd like the cursor to be at a
- * specific location when relative mode ends, you should use
- * SDL_WarpMouseInWindow() before disabling relative mode.
- *
- * This function will flush any pending mouse motion for this window.
- *
- * \param window the window to change.
- * \param enabled true to enable relative mode, false to disable.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetWindowRelativeMouseMode
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetWindowRelativeMouseMode(SDL_Window *window, bool enabled);
-
-/**
- * Query whether relative mouse mode is enabled for a window.
- *
- * \param window the window to query.
- * \returns true if relative mode is enabled for a window or false otherwise.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetWindowRelativeMouseMode
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetWindowRelativeMouseMode(SDL_Window *window);
-
-/**
- * Capture the mouse and to track input outside an SDL window.
- *
- * Capturing enables your app to obtain mouse events globally, instead of just
- * within your window. Not all video targets support this function. When
- * capturing is enabled, the current window will get all mouse events, but
- * unlike relative mode, no change is made to the cursor and it is not
- * restrained to your window.
- *
- * This function may also deny mouse input to other windows--both those in
- * your application and others on the system--so you should use this function
- * sparingly, and in small bursts. For example, you might want to track the
- * mouse while the user is dragging something, until the user releases a mouse
- * button. It is not recommended that you capture the mouse for long periods
- * of time, such as the entire time your app is running. For that, you should
- * probably use SDL_SetWindowRelativeMouseMode() or SDL_SetWindowMouseGrab(),
- * depending on your goals.
- *
- * While captured, mouse events still report coordinates relative to the
- * current (foreground) window, but those coordinates may be outside the
- * bounds of the window (including negative values). Capturing is only allowed
- * for the foreground window. If the window loses focus while capturing, the
- * capture will be disabled automatically.
- *
- * While capturing is enabled, the current window will have the
- * `SDL_WINDOW_MOUSE_CAPTURE` flag set.
- *
- * Please note that SDL will attempt to "auto capture" the mouse while the
- * user is pressing a button; this is to try and make mouse behavior more
- * consistent between platforms, and deal with the common case of a user
- * dragging the mouse outside of the window. This means that if you are
- * calling SDL_CaptureMouse() only to deal with this situation, you do not
- * have to (although it is safe to do so). If this causes problems for your
- * app, you can disable auto capture by setting the
- * `SDL_HINT_MOUSE_AUTO_CAPTURE` hint to zero.
- *
- * \param enabled true to enable capturing, false to disable.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetGlobalMouseState
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CaptureMouse(bool enabled);
-
-/**
- * Create a cursor using the specified bitmap data and mask (in MSB format).
- *
- * `mask` has to be in MSB (Most Significant Bit) format.
- *
- * The cursor width (`w`) must be a multiple of 8 bits.
- *
- * The cursor is created in black and white according to the following:
- *
- * - data=0, mask=1: white
- * - data=1, mask=1: black
- * - data=0, mask=0: transparent
- * - data=1, mask=0: inverted color if possible, black if not.
- *
- * Cursors created with this function must be freed with SDL_DestroyCursor().
- *
- * If you want to have a color cursor, or create your cursor from an
- * SDL_Surface, you should use SDL_CreateColorCursor(). Alternately, you can
- * hide the cursor and draw your own as part of your game's rendering, but it
- * will be bound to the framerate.
- *
- * Also, SDL_CreateSystemCursor() is available, which provides several
- * readily-available system cursors to pick from.
- *
- * \param data the color value for each pixel of the cursor.
- * \param mask the mask value for each pixel of the cursor.
- * \param w the width of the cursor.
- * \param h the height of the cursor.
- * \param hot_x the x-axis offset from the left of the cursor image to the
- *              mouse x position, in the range of 0 to `w` - 1.
- * \param hot_y the y-axis offset from the top of the cursor image to the
- *              mouse y position, in the range of 0 to `h` - 1.
- * \returns a new cursor with the specified parameters on success or NULL on
- *          failure; call SDL_GetError() for more information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateColorCursor
- * \sa SDL_CreateSystemCursor
- * \sa SDL_DestroyCursor
- * \sa SDL_SetCursor
- */
-extern SDL_DECLSPEC SDL_Cursor * SDLCALL SDL_CreateCursor(const Uint8 *data,
-                                                     const Uint8 *mask,
-                                                     int w, int h, int hot_x,
-                                                     int hot_y);
-
-/**
- * Create a color cursor.
- *
- * If this function is passed a surface with alternate representations, the
- * surface will be interpreted as the content to be used for 100% display
- * scale, and the alternate representations will be used for high DPI
- * situations. For example, if the original surface is 32x32, then on a 2x
- * macOS display or 200% display scale on Windows, a 64x64 version of the
- * image will be used, if available. If a matching version of the image isn't
- * available, the closest larger size image will be downscaled to the
- * appropriate size and be used instead, if available. Otherwise, the closest
- * smaller image will be upscaled and be used instead.
- *
- * \param surface an SDL_Surface structure representing the cursor image.
- * \param hot_x the x position of the cursor hot spot.
- * \param hot_y the y position of the cursor hot spot.
- * \returns the new cursor on success or NULL on failure; call SDL_GetError()
- *          for more information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateCursor
- * \sa SDL_CreateSystemCursor
- * \sa SDL_DestroyCursor
- * \sa SDL_SetCursor
- */
-extern SDL_DECLSPEC SDL_Cursor * SDLCALL SDL_CreateColorCursor(SDL_Surface *surface,
-                                                          int hot_x,
-                                                          int hot_y);
-
-/**
- * Create a system cursor.
- *
- * \param id an SDL_SystemCursor enum value.
- * \returns a cursor on success or NULL on failure; call SDL_GetError() for
- *          more information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_DestroyCursor
- */
-extern SDL_DECLSPEC SDL_Cursor * SDLCALL SDL_CreateSystemCursor(SDL_SystemCursor id);
-
-/**
- * Set the active cursor.
- *
- * This function sets the currently active cursor to the specified one. If the
- * cursor is currently visible, the change will be immediately represented on
- * the display. SDL_SetCursor(NULL) can be used to force cursor redraw, if
- * this is desired for any reason.
- *
- * \param cursor a cursor to make active.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetCursor
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetCursor(SDL_Cursor *cursor);
-
-/**
- * Get the active cursor.
- *
- * This function returns a pointer to the current cursor which is owned by the
- * library. It is not necessary to free the cursor with SDL_DestroyCursor().
- *
- * \returns the active cursor or NULL if there is no mouse.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_SetCursor
- */
-extern SDL_DECLSPEC SDL_Cursor * SDLCALL SDL_GetCursor(void);
-
-/**
- * Get the default cursor.
- *
- * You do not have to call SDL_DestroyCursor() on the return value, but it is
- * safe to do so.
- *
- * \returns the default cursor on success or NULL on failuree; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_Cursor * SDLCALL SDL_GetDefaultCursor(void);
-
-/**
- * Free a previously-created cursor.
- *
- * Use this function to free cursor resources created with SDL_CreateCursor(),
- * SDL_CreateColorCursor() or SDL_CreateSystemCursor().
- *
- * \param cursor the cursor to free.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateColorCursor
- * \sa SDL_CreateCursor
- * \sa SDL_CreateSystemCursor
- */
-extern SDL_DECLSPEC void SDLCALL SDL_DestroyCursor(SDL_Cursor *cursor);
-
-/**
- * Show the cursor.
- *
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CursorVisible
- * \sa SDL_HideCursor
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ShowCursor(void);
-
-/**
- * Hide the cursor.
- *
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CursorVisible
- * \sa SDL_ShowCursor
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HideCursor(void);
-
-/**
- * Return whether the cursor is currently being shown.
- *
- * \returns `true` if the cursor is being shown, or `false` if the cursor is
- *          hidden.
- *
- * \threadsafety This function should only be called on the main thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HideCursor
- * \sa SDL_ShowCursor
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CursorVisible(void);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_mouse_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_opengles.h

@@ -1,38 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/*
- * This is a simple file to encapsulate the OpenGL ES 1.X API headers.
- */
-
-#include <SDL3/SDL_platform_defines.h>
-
-#ifdef SDL_PLATFORM_IOS
-#include <OpenGLES/ES1/gl.h>
-#include <OpenGLES/ES1/glext.h>
-#else
-#include <GLES/gl.h>
-#include <GLES/glext.h>
-#endif
-
-#ifndef APIENTRY
-#define APIENTRY
-#endif

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_opengles2.h

@@ -1,51 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/*
- * This is a simple file to encapsulate the OpenGL ES 2.0 API headers.
- */
-
-#include <SDL3/SDL_platform_defines.h>
-
-#if !defined(_MSC_VER) && !defined(SDL_USE_BUILTIN_OPENGL_DEFINITIONS)
-
-#ifdef SDL_PLATFORM_IOS
-#include <OpenGLES/ES2/gl.h>
-#include <OpenGLES/ES2/glext.h>
-#else
-#include <GLES2/gl2platform.h>
-#include <GLES2/gl2.h>
-#include <GLES2/gl2ext.h>
-#endif
-
-#else /* _MSC_VER */
-
-/* OpenGL ES2 headers for Visual Studio */
-#include <SDL3/SDL_opengles2_khrplatform.h>
-#include <SDL3/SDL_opengles2_gl2platform.h>
-#include <SDL3/SDL_opengles2_gl2.h>
-#include <SDL3/SDL_opengles2_gl2ext.h>
-
-#endif /* _MSC_VER */
-
-#ifndef APIENTRY
-#define APIENTRY GL_APIENTRY
-#endif

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_opengles2_gl2.h

@@ -1,656 +0,0 @@
-#ifndef __gles2_gl2_h_
-#define __gles2_gl2_h_ 1
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/*
-** Copyright 2013-2020 The Khronos Group Inc.
-** SPDX-License-Identifier: MIT
-**
-** This header is generated from the Khronos OpenGL / OpenGL ES XML
-** API Registry. The current version of the Registry, generator scripts
-** used to make the header, and the header can be found at
-**   https://github.com/KhronosGroup/OpenGL-Registry
-*/
-
-/*#include <GLES2/gl2platform.h>*/
-
-#ifndef GL_APIENTRYP
-#define GL_APIENTRYP GL_APIENTRY*
-#endif
-
-#ifndef GL_GLES_PROTOTYPES
-#define GL_GLES_PROTOTYPES 1
-#endif
-
-/* Generated on date 20220530 */
-
-/* Generated C header for:
- * API: gles2
- * Profile: common
- * Versions considered: 2\.[0-9]
- * Versions emitted: .*
- * Default extensions included: None
- * Additional extensions included: _nomatch_^
- * Extensions removed: _nomatch_^
- */
-
-#ifndef GL_ES_VERSION_2_0
-#define GL_ES_VERSION_2_0 1
-/*#include <KHR/khrplatform.h>*/
-typedef khronos_int8_t GLbyte;
-typedef khronos_float_t GLclampf;
-typedef khronos_int32_t GLfixed;
-typedef khronos_int16_t GLshort;
-typedef khronos_uint16_t GLushort;
-typedef void GLvoid;
-typedef struct __GLsync *GLsync;
-typedef khronos_int64_t GLint64;
-typedef khronos_uint64_t GLuint64;
-typedef unsigned int GLenum;
-typedef unsigned int GLuint;
-typedef char GLchar;
-typedef khronos_float_t GLfloat;
-typedef khronos_ssize_t GLsizeiptr;
-typedef khronos_intptr_t GLintptr;
-typedef unsigned int GLbitfield;
-typedef int GLint;
-typedef unsigned char GLboolean;
-typedef int GLsizei;
-typedef khronos_uint8_t GLubyte;
-#define GL_DEPTH_BUFFER_BIT               0x00000100
-#define GL_STENCIL_BUFFER_BIT             0x00000400
-#define GL_COLOR_BUFFER_BIT               0x00004000
-#define GL_FALSE                          0
-#define GL_TRUE                           1
-#define GL_POINTS                         0x0000
-#define GL_LINES                          0x0001
-#define GL_LINE_LOOP                      0x0002
-#define GL_LINE_STRIP                     0x0003
-#define GL_TRIANGLES                      0x0004
-#define GL_TRIANGLE_STRIP                 0x0005
-#define GL_TRIANGLE_FAN                   0x0006
-#define GL_ZERO                           0
-#define GL_ONE                            1
-#define GL_SRC_COLOR                      0x0300
-#define GL_ONE_MINUS_SRC_COLOR            0x0301
-#define GL_SRC_ALPHA                      0x0302
-#define GL_ONE_MINUS_SRC_ALPHA            0x0303
-#define GL_DST_ALPHA                      0x0304
-#define GL_ONE_MINUS_DST_ALPHA            0x0305
-#define GL_DST_COLOR                      0x0306
-#define GL_ONE_MINUS_DST_COLOR            0x0307
-#define GL_SRC_ALPHA_SATURATE             0x0308
-#define GL_FUNC_ADD                       0x8006
-#define GL_BLEND_EQUATION                 0x8009
-#define GL_BLEND_EQUATION_RGB             0x8009
-#define GL_BLEND_EQUATION_ALPHA           0x883D
-#define GL_FUNC_SUBTRACT                  0x800A
-#define GL_FUNC_REVERSE_SUBTRACT          0x800B
-#define GL_BLEND_DST_RGB                  0x80C8
-#define GL_BLEND_SRC_RGB                  0x80C9
-#define GL_BLEND_DST_ALPHA                0x80CA
-#define GL_BLEND_SRC_ALPHA                0x80CB
-#define GL_CONSTANT_COLOR                 0x8001
-#define GL_ONE_MINUS_CONSTANT_COLOR       0x8002
-#define GL_CONSTANT_ALPHA                 0x8003
-#define GL_ONE_MINUS_CONSTANT_ALPHA       0x8004
-#define GL_BLEND_COLOR                    0x8005
-#define GL_ARRAY_BUFFER                   0x8892
-#define GL_ELEMENT_ARRAY_BUFFER           0x8893
-#define GL_ARRAY_BUFFER_BINDING           0x8894
-#define GL_ELEMENT_ARRAY_BUFFER_BINDING   0x8895
-#define GL_STREAM_DRAW                    0x88E0
-#define GL_STATIC_DRAW                    0x88E4
-#define GL_DYNAMIC_DRAW                   0x88E8
-#define GL_BUFFER_SIZE                    0x8764
-#define GL_BUFFER_USAGE                   0x8765
-#define GL_CURRENT_VERTEX_ATTRIB          0x8626
-#define GL_FRONT                          0x0404
-#define GL_BACK                           0x0405
-#define GL_FRONT_AND_BACK                 0x0408
-#define GL_TEXTURE_2D                     0x0DE1
-#define GL_CULL_FACE                      0x0B44
-#define GL_BLEND                          0x0BE2
-#define GL_DITHER                         0x0BD0
-#define GL_STENCIL_TEST                   0x0B90
-#define GL_DEPTH_TEST                     0x0B71
-#define GL_SCISSOR_TEST                   0x0C11
-#define GL_POLYGON_OFFSET_FILL            0x8037
-#define GL_SAMPLE_ALPHA_TO_COVERAGE       0x809E
-#define GL_SAMPLE_COVERAGE                0x80A0
-#define GL_NO_ERROR                       0
-#define GL_INVALID_ENUM                   0x0500
-#define GL_INVALID_VALUE                  0x0501
-#define GL_INVALID_OPERATION              0x0502
-#define GL_OUT_OF_MEMORY                  0x0505
-#define GL_CW                             0x0900
-#define GL_CCW                            0x0901
-#define GL_LINE_WIDTH                     0x0B21
-#define GL_ALIASED_POINT_SIZE_RANGE       0x846D
-#define GL_ALIASED_LINE_WIDTH_RANGE       0x846E
-#define GL_CULL_FACE_MODE                 0x0B45
-#define GL_FRONT_FACE                     0x0B46
-#define GL_DEPTH_RANGE                    0x0B70
-#define GL_DEPTH_WRITEMASK                0x0B72
-#define GL_DEPTH_CLEAR_VALUE              0x0B73
-#define GL_DEPTH_FUNC                     0x0B74
-#define GL_STENCIL_CLEAR_VALUE            0x0B91
-#define GL_STENCIL_FUNC                   0x0B92
-#define GL_STENCIL_FAIL                   0x0B94
-#define GL_STENCIL_PASS_DEPTH_FAIL        0x0B95
-#define GL_STENCIL_PASS_DEPTH_PASS        0x0B96
-#define GL_STENCIL_REF                    0x0B97
-#define GL_STENCIL_VALUE_MASK             0x0B93
-#define GL_STENCIL_WRITEMASK              0x0B98
-#define GL_STENCIL_BACK_FUNC              0x8800
-#define GL_STENCIL_BACK_FAIL              0x8801
-#define GL_STENCIL_BACK_PASS_DEPTH_FAIL   0x8802
-#define GL_STENCIL_BACK_PASS_DEPTH_PASS   0x8803
-#define GL_STENCIL_BACK_REF               0x8CA3
-#define GL_STENCIL_BACK_VALUE_MASK        0x8CA4
-#define GL_STENCIL_BACK_WRITEMASK         0x8CA5
-#define GL_VIEWPORT                       0x0BA2
-#define GL_SCISSOR_BOX                    0x0C10
-#define GL_COLOR_CLEAR_VALUE              0x0C22
-#define GL_COLOR_WRITEMASK                0x0C23
-#define GL_UNPACK_ALIGNMENT               0x0CF5
-#define GL_PACK_ALIGNMENT                 0x0D05
-#define GL_MAX_TEXTURE_SIZE               0x0D33
-#define GL_MAX_VIEWPORT_DIMS              0x0D3A
-#define GL_SUBPIXEL_BITS                  0x0D50
-#define GL_RED_BITS                       0x0D52
-#define GL_GREEN_BITS                     0x0D53
-#define GL_BLUE_BITS                      0x0D54
-#define GL_ALPHA_BITS                     0x0D55
-#define GL_DEPTH_BITS                     0x0D56
-#define GL_STENCIL_BITS                   0x0D57
-#define GL_POLYGON_OFFSET_UNITS           0x2A00
-#define GL_POLYGON_OFFSET_FACTOR          0x8038
-#define GL_TEXTURE_BINDING_2D             0x8069
-#define GL_SAMPLE_BUFFERS                 0x80A8
-#define GL_SAMPLES                        0x80A9
-#define GL_SAMPLE_COVERAGE_VALUE          0x80AA
-#define GL_SAMPLE_COVERAGE_INVERT         0x80AB
-#define GL_NUM_COMPRESSED_TEXTURE_FORMATS 0x86A2
-#define GL_COMPRESSED_TEXTURE_FORMATS     0x86A3
-#define GL_DONT_CARE                      0x1100
-#define GL_FASTEST                        0x1101
-#define GL_NICEST                         0x1102
-#define GL_GENERATE_MIPMAP_HINT           0x8192
-#define GL_BYTE                           0x1400
-#define GL_UNSIGNED_BYTE                  0x1401
-#define GL_SHORT                          0x1402
-#define GL_UNSIGNED_SHORT                 0x1403
-#define GL_INT                            0x1404
-#define GL_UNSIGNED_INT                   0x1405
-#define GL_FLOAT                          0x1406
-#define GL_FIXED                          0x140C
-#define GL_DEPTH_COMPONENT                0x1902
-#define GL_ALPHA                          0x1906
-#define GL_RGB                            0x1907
-#define GL_RGBA                           0x1908
-#define GL_LUMINANCE                      0x1909
-#define GL_LUMINANCE_ALPHA                0x190A
-#define GL_UNSIGNED_SHORT_4_4_4_4         0x8033
-#define GL_UNSIGNED_SHORT_5_5_5_1         0x8034
-#define GL_UNSIGNED_SHORT_5_6_5           0x8363
-#define GL_FRAGMENT_SHADER                0x8B30
-#define GL_VERTEX_SHADER                  0x8B31
-#define GL_MAX_VERTEX_ATTRIBS             0x8869
-#define GL_MAX_VERTEX_UNIFORM_VECTORS     0x8DFB
-#define GL_MAX_VARYING_VECTORS            0x8DFC
-#define GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS 0x8B4D
-#define GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS 0x8B4C
-#define GL_MAX_TEXTURE_IMAGE_UNITS        0x8872
-#define GL_MAX_FRAGMENT_UNIFORM_VECTORS   0x8DFD
-#define GL_SHADER_TYPE                    0x8B4F
-#define GL_DELETE_STATUS                  0x8B80
-#define GL_LINK_STATUS                    0x8B82
-#define GL_VALIDATE_STATUS                0x8B83
-#define GL_ATTACHED_SHADERS               0x8B85
-#define GL_ACTIVE_UNIFORMS                0x8B86
-#define GL_ACTIVE_UNIFORM_MAX_LENGTH      0x8B87
-#define GL_ACTIVE_ATTRIBUTES              0x8B89
-#define GL_ACTIVE_ATTRIBUTE_MAX_LENGTH    0x8B8A
-#define GL_SHADING_LANGUAGE_VERSION       0x8B8C
-#define GL_CURRENT_PROGRAM                0x8B8D
-#define GL_NEVER                          0x0200
-#define GL_LESS                           0x0201
-#define GL_EQUAL                          0x0202
-#define GL_LEQUAL                         0x0203
-#define GL_GREATER                        0x0204
-#define GL_NOTEQUAL                       0x0205
-#define GL_GEQUAL                         0x0206
-#define GL_ALWAYS                         0x0207
-#define GL_KEEP                           0x1E00
-#define GL_REPLACE                        0x1E01
-#define GL_INCR                           0x1E02
-#define GL_DECR                           0x1E03
-#define GL_INVERT                         0x150A
-#define GL_INCR_WRAP                      0x8507
-#define GL_DECR_WRAP                      0x8508
-#define GL_VENDOR                         0x1F00
-#define GL_RENDERER                       0x1F01
-#define GL_VERSION                        0x1F02
-#define GL_EXTENSIONS                     0x1F03
-#define GL_NEAREST                        0x2600
-#define GL_LINEAR                         0x2601
-#define GL_NEAREST_MIPMAP_NEAREST         0x2700
-#define GL_LINEAR_MIPMAP_NEAREST          0x2701
-#define GL_NEAREST_MIPMAP_LINEAR          0x2702
-#define GL_LINEAR_MIPMAP_LINEAR           0x2703
-#define GL_TEXTURE_MAG_FILTER             0x2800
-#define GL_TEXTURE_MIN_FILTER             0x2801
-#define GL_TEXTURE_WRAP_S                 0x2802
-#define GL_TEXTURE_WRAP_T                 0x2803
-#define GL_TEXTURE                        0x1702
-#define GL_TEXTURE_CUBE_MAP               0x8513
-#define GL_TEXTURE_BINDING_CUBE_MAP       0x8514
-#define GL_TEXTURE_CUBE_MAP_POSITIVE_X    0x8515
-#define GL_TEXTURE_CUBE_MAP_NEGATIVE_X    0x8516
-#define GL_TEXTURE_CUBE_MAP_POSITIVE_Y    0x8517
-#define GL_TEXTURE_CUBE_MAP_NEGATIVE_Y    0x8518
-#define GL_TEXTURE_CUBE_MAP_POSITIVE_Z    0x8519
-#define GL_TEXTURE_CUBE_MAP_NEGATIVE_Z    0x851A
-#define GL_MAX_CUBE_MAP_TEXTURE_SIZE      0x851C
-#define GL_TEXTURE0                       0x84C0
-#define GL_TEXTURE1                       0x84C1
-#define GL_TEXTURE2                       0x84C2
-#define GL_TEXTURE3                       0x84C3
-#define GL_TEXTURE4                       0x84C4
-#define GL_TEXTURE5                       0x84C5
-#define GL_TEXTURE6                       0x84C6
-#define GL_TEXTURE7                       0x84C7
-#define GL_TEXTURE8                       0x84C8
-#define GL_TEXTURE9                       0x84C9
-#define GL_TEXTURE10                      0x84CA
-#define GL_TEXTURE11                      0x84CB
-#define GL_TEXTURE12                      0x84CC
-#define GL_TEXTURE13                      0x84CD
-#define GL_TEXTURE14                      0x84CE
-#define GL_TEXTURE15                      0x84CF
-#define GL_TEXTURE16                      0x84D0
-#define GL_TEXTURE17                      0x84D1
-#define GL_TEXTURE18                      0x84D2
-#define GL_TEXTURE19                      0x84D3
-#define GL_TEXTURE20                      0x84D4
-#define GL_TEXTURE21                      0x84D5
-#define GL_TEXTURE22                      0x84D6
-#define GL_TEXTURE23                      0x84D7
-#define GL_TEXTURE24                      0x84D8
-#define GL_TEXTURE25                      0x84D9
-#define GL_TEXTURE26                      0x84DA
-#define GL_TEXTURE27                      0x84DB
-#define GL_TEXTURE28                      0x84DC
-#define GL_TEXTURE29                      0x84DD
-#define GL_TEXTURE30                      0x84DE
-#define GL_TEXTURE31                      0x84DF
-#define GL_ACTIVE_TEXTURE                 0x84E0
-#define GL_REPEAT                         0x2901
-#define GL_CLAMP_TO_EDGE                  0x812F
-#define GL_MIRRORED_REPEAT                0x8370
-#define GL_FLOAT_VEC2                     0x8B50
-#define GL_FLOAT_VEC3                     0x8B51
-#define GL_FLOAT_VEC4                     0x8B52
-#define GL_INT_VEC2                       0x8B53
-#define GL_INT_VEC3                       0x8B54
-#define GL_INT_VEC4                       0x8B55
-#define GL_BOOL                           0x8B56
-#define GL_BOOL_VEC2                      0x8B57
-#define GL_BOOL_VEC3                      0x8B58
-#define GL_BOOL_VEC4                      0x8B59
-#define GL_FLOAT_MAT2                     0x8B5A
-#define GL_FLOAT_MAT3                     0x8B5B
-#define GL_FLOAT_MAT4                     0x8B5C
-#define GL_SAMPLER_2D                     0x8B5E
-#define GL_SAMPLER_CUBE                   0x8B60
-#define GL_VERTEX_ATTRIB_ARRAY_ENABLED    0x8622
-#define GL_VERTEX_ATTRIB_ARRAY_SIZE       0x8623
-#define GL_VERTEX_ATTRIB_ARRAY_STRIDE     0x8624
-#define GL_VERTEX_ATTRIB_ARRAY_TYPE       0x8625
-#define GL_VERTEX_ATTRIB_ARRAY_NORMALIZED 0x886A
-#define GL_VERTEX_ATTRIB_ARRAY_POINTER    0x8645
-#define GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING 0x889F
-#define GL_IMPLEMENTATION_COLOR_READ_TYPE 0x8B9A
-#define GL_IMPLEMENTATION_COLOR_READ_FORMAT 0x8B9B
-#define GL_COMPILE_STATUS                 0x8B81
-#define GL_INFO_LOG_LENGTH                0x8B84
-#define GL_SHADER_SOURCE_LENGTH           0x8B88
-#define GL_SHADER_COMPILER                0x8DFA
-#define GL_SHADER_BINARY_FORMATS          0x8DF8
-#define GL_NUM_SHADER_BINARY_FORMATS      0x8DF9
-#define GL_LOW_FLOAT                      0x8DF0
-#define GL_MEDIUM_FLOAT                   0x8DF1
-#define GL_HIGH_FLOAT                     0x8DF2
-#define GL_LOW_INT                        0x8DF3
-#define GL_MEDIUM_INT                     0x8DF4
-#define GL_HIGH_INT                       0x8DF5
-#define GL_FRAMEBUFFER                    0x8D40
-#define GL_RENDERBUFFER                   0x8D41
-#define GL_RGBA4                          0x8056
-#define GL_RGB5_A1                        0x8057
-#define GL_RGB565                         0x8D62
-#define GL_DEPTH_COMPONENT16              0x81A5
-#define GL_STENCIL_INDEX8                 0x8D48
-#define GL_RENDERBUFFER_WIDTH             0x8D42
-#define GL_RENDERBUFFER_HEIGHT            0x8D43
-#define GL_RENDERBUFFER_INTERNAL_FORMAT   0x8D44
-#define GL_RENDERBUFFER_RED_SIZE          0x8D50
-#define GL_RENDERBUFFER_GREEN_SIZE        0x8D51
-#define GL_RENDERBUFFER_BLUE_SIZE         0x8D52
-#define GL_RENDERBUFFER_ALPHA_SIZE        0x8D53
-#define GL_RENDERBUFFER_DEPTH_SIZE        0x8D54
-#define GL_RENDERBUFFER_STENCIL_SIZE      0x8D55
-#define GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE 0x8CD0
-#define GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME 0x8CD1
-#define GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL 0x8CD2
-#define GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE 0x8CD3
-#define GL_COLOR_ATTACHMENT0              0x8CE0
-#define GL_DEPTH_ATTACHMENT               0x8D00
-#define GL_STENCIL_ATTACHMENT             0x8D20
-#define GL_NONE                           0
-#define GL_FRAMEBUFFER_COMPLETE           0x8CD5
-#define GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT 0x8CD6
-#define GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT 0x8CD7
-#define GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS 0x8CD9
-#define GL_FRAMEBUFFER_UNSUPPORTED        0x8CDD
-#define GL_FRAMEBUFFER_BINDING            0x8CA6
-#define GL_RENDERBUFFER_BINDING           0x8CA7
-#define GL_MAX_RENDERBUFFER_SIZE          0x84E8
-#define GL_INVALID_FRAMEBUFFER_OPERATION  0x0506
-typedef void (GL_APIENTRYP PFNGLACTIVETEXTUREPROC) (GLenum texture);
-typedef void (GL_APIENTRYP PFNGLATTACHSHADERPROC) (GLuint program, GLuint shader);
-typedef void (GL_APIENTRYP PFNGLBINDATTRIBLOCATIONPROC) (GLuint program, GLuint index, const GLchar *name);
-typedef void (GL_APIENTRYP PFNGLBINDBUFFERPROC) (GLenum target, GLuint buffer);
-typedef void (GL_APIENTRYP PFNGLBINDFRAMEBUFFERPROC) (GLenum target, GLuint framebuffer);
-typedef void (GL_APIENTRYP PFNGLBINDRENDERBUFFERPROC) (GLenum target, GLuint renderbuffer);
-typedef void (GL_APIENTRYP PFNGLBINDTEXTUREPROC) (GLenum target, GLuint texture);
-typedef void (GL_APIENTRYP PFNGLBLENDCOLORPROC) (GLfloat red, GLfloat green, GLfloat blue, GLfloat alpha);
-typedef void (GL_APIENTRYP PFNGLBLENDEQUATIONPROC) (GLenum mode);
-typedef void (GL_APIENTRYP PFNGLBLENDEQUATIONSEPARATEPROC) (GLenum modeRGB, GLenum modeAlpha);
-typedef void (GL_APIENTRYP PFNGLBLENDFUNCPROC) (GLenum sfactor, GLenum dfactor);
-typedef void (GL_APIENTRYP PFNGLBLENDFUNCSEPARATEPROC) (GLenum sfactorRGB, GLenum dfactorRGB, GLenum sfactorAlpha, GLenum dfactorAlpha);
-typedef void (GL_APIENTRYP PFNGLBUFFERDATAPROC) (GLenum target, GLsizeiptr size, const void *data, GLenum usage);
-typedef void (GL_APIENTRYP PFNGLBUFFERSUBDATAPROC) (GLenum target, GLintptr offset, GLsizeiptr size, const void *data);
-typedef GLenum (GL_APIENTRYP PFNGLCHECKFRAMEBUFFERSTATUSPROC) (GLenum target);
-typedef void (GL_APIENTRYP PFNGLCLEARPROC) (GLbitfield mask);
-typedef void (GL_APIENTRYP PFNGLCLEARCOLORPROC) (GLfloat red, GLfloat green, GLfloat blue, GLfloat alpha);
-typedef void (GL_APIENTRYP PFNGLCLEARDEPTHFPROC) (GLfloat d);
-typedef void (GL_APIENTRYP PFNGLCLEARSTENCILPROC) (GLint s);
-typedef void (GL_APIENTRYP PFNGLCOLORMASKPROC) (GLboolean red, GLboolean green, GLboolean blue, GLboolean alpha);
-typedef void (GL_APIENTRYP PFNGLCOMPILESHADERPROC) (GLuint shader);
-typedef void (GL_APIENTRYP PFNGLCOMPRESSEDTEXIMAGE2DPROC) (GLenum target, GLint level, GLenum internalformat, GLsizei width, GLsizei height, GLint border, GLsizei imageSize, const void *data);
-typedef void (GL_APIENTRYP PFNGLCOMPRESSEDTEXSUBIMAGE2DPROC) (GLenum target, GLint level, GLint xoffset, GLint yoffset, GLsizei width, GLsizei height, GLenum format, GLsizei imageSize, const void *data);
-typedef void (GL_APIENTRYP PFNGLCOPYTEXIMAGE2DPROC) (GLenum target, GLint level, GLenum internalformat, GLint x, GLint y, GLsizei width, GLsizei height, GLint border);
-typedef void (GL_APIENTRYP PFNGLCOPYTEXSUBIMAGE2DPROC) (GLenum target, GLint level, GLint xoffset, GLint yoffset, GLint x, GLint y, GLsizei width, GLsizei height);
-typedef GLuint (GL_APIENTRYP PFNGLCREATEPROGRAMPROC) (void);
-typedef GLuint (GL_APIENTRYP PFNGLCREATESHADERPROC) (GLenum type);
-typedef void (GL_APIENTRYP PFNGLCULLFACEPROC) (GLenum mode);
-typedef void (GL_APIENTRYP PFNGLDELETEBUFFERSPROC) (GLsizei n, const GLuint *buffers);
-typedef void (GL_APIENTRYP PFNGLDELETEFRAMEBUFFERSPROC) (GLsizei n, const GLuint *framebuffers);
-typedef void (GL_APIENTRYP PFNGLDELETEPROGRAMPROC) (GLuint program);
-typedef void (GL_APIENTRYP PFNGLDELETERENDERBUFFERSPROC) (GLsizei n, const GLuint *renderbuffers);
-typedef void (GL_APIENTRYP PFNGLDELETESHADERPROC) (GLuint shader);
-typedef void (GL_APIENTRYP PFNGLDELETETEXTURESPROC) (GLsizei n, const GLuint *textures);
-typedef void (GL_APIENTRYP PFNGLDEPTHFUNCPROC) (GLenum func);
-typedef void (GL_APIENTRYP PFNGLDEPTHMASKPROC) (GLboolean flag);
-typedef void (GL_APIENTRYP PFNGLDEPTHRANGEFPROC) (GLfloat n, GLfloat f);
-typedef void (GL_APIENTRYP PFNGLDETACHSHADERPROC) (GLuint program, GLuint shader);
-typedef void (GL_APIENTRYP PFNGLDISABLEPROC) (GLenum cap);
-typedef void (GL_APIENTRYP PFNGLDISABLEVERTEXATTRIBARRAYPROC) (GLuint index);
-typedef void (GL_APIENTRYP PFNGLDRAWARRAYSPROC) (GLenum mode, GLint first, GLsizei count);
-typedef void (GL_APIENTRYP PFNGLDRAWELEMENTSPROC) (GLenum mode, GLsizei count, GLenum type, const void *indices);
-typedef void (GL_APIENTRYP PFNGLENABLEPROC) (GLenum cap);
-typedef void (GL_APIENTRYP PFNGLENABLEVERTEXATTRIBARRAYPROC) (GLuint index);
-typedef void (GL_APIENTRYP PFNGLFINISHPROC) (void);
-typedef void (GL_APIENTRYP PFNGLFLUSHPROC) (void);
-typedef void (GL_APIENTRYP PFNGLFRAMEBUFFERRENDERBUFFERPROC) (GLenum target, GLenum attachment, GLenum renderbuffertarget, GLuint renderbuffer);
-typedef void (GL_APIENTRYP PFNGLFRAMEBUFFERTEXTURE2DPROC) (GLenum target, GLenum attachment, GLenum textarget, GLuint texture, GLint level);
-typedef void (GL_APIENTRYP PFNGLFRONTFACEPROC) (GLenum mode);
-typedef void (GL_APIENTRYP PFNGLGENBUFFERSPROC) (GLsizei n, GLuint *buffers);
-typedef void (GL_APIENTRYP PFNGLGENERATEMIPMAPPROC) (GLenum target);
-typedef void (GL_APIENTRYP PFNGLGENFRAMEBUFFERSPROC) (GLsizei n, GLuint *framebuffers);
-typedef void (GL_APIENTRYP PFNGLGENRENDERBUFFERSPROC) (GLsizei n, GLuint *renderbuffers);
-typedef void (GL_APIENTRYP PFNGLGENTEXTURESPROC) (GLsizei n, GLuint *textures);
-typedef void (GL_APIENTRYP PFNGLGETACTIVEATTRIBPROC) (GLuint program, GLuint index, GLsizei bufSize, GLsizei *length, GLint *size, GLenum *type, GLchar *name);
-typedef void (GL_APIENTRYP PFNGLGETACTIVEUNIFORMPROC) (GLuint program, GLuint index, GLsizei bufSize, GLsizei *length, GLint *size, GLenum *type, GLchar *name);
-typedef void (GL_APIENTRYP PFNGLGETATTACHEDSHADERSPROC) (GLuint program, GLsizei maxCount, GLsizei *count, GLuint *shaders);
-typedef GLint (GL_APIENTRYP PFNGLGETATTRIBLOCATIONPROC) (GLuint program, const GLchar *name);
-typedef void (GL_APIENTRYP PFNGLGETBOOLEANVPROC) (GLenum pname, GLboolean *data);
-typedef void (GL_APIENTRYP PFNGLGETBUFFERPARAMETERIVPROC) (GLenum target, GLenum pname, GLint *params);
-typedef GLenum (GL_APIENTRYP PFNGLGETERRORPROC) (void);
-typedef void (GL_APIENTRYP PFNGLGETFLOATVPROC) (GLenum pname, GLfloat *data);
-typedef void (GL_APIENTRYP PFNGLGETFRAMEBUFFERATTACHMENTPARAMETERIVPROC) (GLenum target, GLenum attachment, GLenum pname, GLint *params);
-typedef void (GL_APIENTRYP PFNGLGETINTEGERVPROC) (GLenum pname, GLint *data);
-typedef void (GL_APIENTRYP PFNGLGETPROGRAMIVPROC) (GLuint program, GLenum pname, GLint *params);
-typedef void (GL_APIENTRYP PFNGLGETPROGRAMINFOLOGPROC) (GLuint program, GLsizei bufSize, GLsizei *length, GLchar *infoLog);
-typedef void (GL_APIENTRYP PFNGLGETRENDERBUFFERPARAMETERIVPROC) (GLenum target, GLenum pname, GLint *params);
-typedef void (GL_APIENTRYP PFNGLGETSHADERIVPROC) (GLuint shader, GLenum pname, GLint *params);
-typedef void (GL_APIENTRYP PFNGLGETSHADERINFOLOGPROC) (GLuint shader, GLsizei bufSize, GLsizei *length, GLchar *infoLog);
-typedef void (GL_APIENTRYP PFNGLGETSHADERPRECISIONFORMATPROC) (GLenum shadertype, GLenum precisiontype, GLint *range, GLint *precision);
-typedef void (GL_APIENTRYP PFNGLGETSHADERSOURCEPROC) (GLuint shader, GLsizei bufSize, GLsizei *length, GLchar *source);
-typedef const GLubyte *(GL_APIENTRYP PFNGLGETSTRINGPROC) (GLenum name);
-typedef void (GL_APIENTRYP PFNGLGETTEXPARAMETERFVPROC) (GLenum target, GLenum pname, GLfloat *params);
-typedef void (GL_APIENTRYP PFNGLGETTEXPARAMETERIVPROC) (GLenum target, GLenum pname, GLint *params);
-typedef void (GL_APIENTRYP PFNGLGETUNIFORMFVPROC) (GLuint program, GLint location, GLfloat *params);
-typedef void (GL_APIENTRYP PFNGLGETUNIFORMIVPROC) (GLuint program, GLint location, GLint *params);
-typedef GLint (GL_APIENTRYP PFNGLGETUNIFORMLOCATIONPROC) (GLuint program, const GLchar *name);
-typedef void (GL_APIENTRYP PFNGLGETVERTEXATTRIBFVPROC) (GLuint index, GLenum pname, GLfloat *params);
-typedef void (GL_APIENTRYP PFNGLGETVERTEXATTRIBIVPROC) (GLuint index, GLenum pname, GLint *params);
-typedef void (GL_APIENTRYP PFNGLGETVERTEXATTRIBPOINTERVPROC) (GLuint index, GLenum pname, void **pointer);
-typedef void (GL_APIENTRYP PFNGLHINTPROC) (GLenum target, GLenum mode);
-typedef GLboolean (GL_APIENTRYP PFNGLISBUFFERPROC) (GLuint buffer);
-typedef GLboolean (GL_APIENTRYP PFNGLISENABLEDPROC) (GLenum cap);
-typedef GLboolean (GL_APIENTRYP PFNGLISFRAMEBUFFERPROC) (GLuint framebuffer);
-typedef GLboolean (GL_APIENTRYP PFNGLISPROGRAMPROC) (GLuint program);
-typedef GLboolean (GL_APIENTRYP PFNGLISRENDERBUFFERPROC) (GLuint renderbuffer);
-typedef GLboolean (GL_APIENTRYP PFNGLISSHADERPROC) (GLuint shader);
-typedef GLboolean (GL_APIENTRYP PFNGLISTEXTUREPROC) (GLuint texture);
-typedef void (GL_APIENTRYP PFNGLLINEWIDTHPROC) (GLfloat width);
-typedef void (GL_APIENTRYP PFNGLLINKPROGRAMPROC) (GLuint program);
-typedef void (GL_APIENTRYP PFNGLPIXELSTOREIPROC) (GLenum pname, GLint param);
-typedef void (GL_APIENTRYP PFNGLPOLYGONOFFSETPROC) (GLfloat factor, GLfloat units);
-typedef void (GL_APIENTRYP PFNGLREADPIXELSPROC) (GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, void *pixels);
-typedef void (GL_APIENTRYP PFNGLRELEASESHADERCOMPILERPROC) (void);
-typedef void (GL_APIENTRYP PFNGLRENDERBUFFERSTORAGEPROC) (GLenum target, GLenum internalformat, GLsizei width, GLsizei height);
-typedef void (GL_APIENTRYP PFNGLSAMPLECOVERAGEPROC) (GLfloat value, GLboolean invert);
-typedef void (GL_APIENTRYP PFNGLSCISSORPROC) (GLint x, GLint y, GLsizei width, GLsizei height);
-typedef void (GL_APIENTRYP PFNGLSHADERBINARYPROC) (GLsizei count, const GLuint *shaders, GLenum binaryFormat, const void *binary, GLsizei length);
-typedef void (GL_APIENTRYP PFNGLSHADERSOURCEPROC) (GLuint shader, GLsizei count, const GLchar *const*string, const GLint *length);
-typedef void (GL_APIENTRYP PFNGLSTENCILFUNCPROC) (GLenum func, GLint ref, GLuint mask);
-typedef void (GL_APIENTRYP PFNGLSTENCILFUNCSEPARATEPROC) (GLenum face, GLenum func, GLint ref, GLuint mask);
-typedef void (GL_APIENTRYP PFNGLSTENCILMASKPROC) (GLuint mask);
-typedef void (GL_APIENTRYP PFNGLSTENCILMASKSEPARATEPROC) (GLenum face, GLuint mask);
-typedef void (GL_APIENTRYP PFNGLSTENCILOPPROC) (GLenum fail, GLenum zfail, GLenum zpass);
-typedef void (GL_APIENTRYP PFNGLSTENCILOPSEPARATEPROC) (GLenum face, GLenum sfail, GLenum dpfail, GLenum dppass);
-typedef void (GL_APIENTRYP PFNGLTEXIMAGE2DPROC) (GLenum target, GLint level, GLint internalformat, GLsizei width, GLsizei height, GLint border, GLenum format, GLenum type, const void *pixels);
-typedef void (GL_APIENTRYP PFNGLTEXPARAMETERFPROC) (GLenum target, GLenum pname, GLfloat param);
-typedef void (GL_APIENTRYP PFNGLTEXPARAMETERFVPROC) (GLenum target, GLenum pname, const GLfloat *params);
-typedef void (GL_APIENTRYP PFNGLTEXPARAMETERIPROC) (GLenum target, GLenum pname, GLint param);
-typedef void (GL_APIENTRYP PFNGLTEXPARAMETERIVPROC) (GLenum target, GLenum pname, const GLint *params);
-typedef void (GL_APIENTRYP PFNGLTEXSUBIMAGE2DPROC) (GLenum target, GLint level, GLint xoffset, GLint yoffset, GLsizei width, GLsizei height, GLenum format, GLenum type, const void *pixels);
-typedef void (GL_APIENTRYP PFNGLUNIFORM1FPROC) (GLint location, GLfloat v0);
-typedef void (GL_APIENTRYP PFNGLUNIFORM1FVPROC) (GLint location, GLsizei count, const GLfloat *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORM1IPROC) (GLint location, GLint v0);
-typedef void (GL_APIENTRYP PFNGLUNIFORM1IVPROC) (GLint location, GLsizei count, const GLint *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORM2FPROC) (GLint location, GLfloat v0, GLfloat v1);
-typedef void (GL_APIENTRYP PFNGLUNIFORM2FVPROC) (GLint location, GLsizei count, const GLfloat *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORM2IPROC) (GLint location, GLint v0, GLint v1);
-typedef void (GL_APIENTRYP PFNGLUNIFORM2IVPROC) (GLint location, GLsizei count, const GLint *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORM3FPROC) (GLint location, GLfloat v0, GLfloat v1, GLfloat v2);
-typedef void (GL_APIENTRYP PFNGLUNIFORM3FVPROC) (GLint location, GLsizei count, const GLfloat *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORM3IPROC) (GLint location, GLint v0, GLint v1, GLint v2);
-typedef void (GL_APIENTRYP PFNGLUNIFORM3IVPROC) (GLint location, GLsizei count, const GLint *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORM4FPROC) (GLint location, GLfloat v0, GLfloat v1, GLfloat v2, GLfloat v3);
-typedef void (GL_APIENTRYP PFNGLUNIFORM4FVPROC) (GLint location, GLsizei count, const GLfloat *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORM4IPROC) (GLint location, GLint v0, GLint v1, GLint v2, GLint v3);
-typedef void (GL_APIENTRYP PFNGLUNIFORM4IVPROC) (GLint location, GLsizei count, const GLint *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORMMATRIX2FVPROC) (GLint location, GLsizei count, GLboolean transpose, const GLfloat *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORMMATRIX3FVPROC) (GLint location, GLsizei count, GLboolean transpose, const GLfloat *value);
-typedef void (GL_APIENTRYP PFNGLUNIFORMMATRIX4FVPROC) (GLint location, GLsizei count, GLboolean transpose, const GLfloat *value);
-typedef void (GL_APIENTRYP PFNGLUSEPROGRAMPROC) (GLuint program);
-typedef void (GL_APIENTRYP PFNGLVALIDATEPROGRAMPROC) (GLuint program);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIB1FPROC) (GLuint index, GLfloat x);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIB1FVPROC) (GLuint index, const GLfloat *v);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIB2FPROC) (GLuint index, GLfloat x, GLfloat y);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIB2FVPROC) (GLuint index, const GLfloat *v);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIB3FPROC) (GLuint index, GLfloat x, GLfloat y, GLfloat z);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIB3FVPROC) (GLuint index, const GLfloat *v);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIB4FPROC) (GLuint index, GLfloat x, GLfloat y, GLfloat z, GLfloat w);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIB4FVPROC) (GLuint index, const GLfloat *v);
-typedef void (GL_APIENTRYP PFNGLVERTEXATTRIBPOINTERPROC) (GLuint index, GLint size, GLenum type, GLboolean normalized, GLsizei stride, const void *pointer);
-typedef void (GL_APIENTRYP PFNGLVIEWPORTPROC) (GLint x, GLint y, GLsizei width, GLsizei height);
-#if GL_GLES_PROTOTYPES
-GL_APICALL void GL_APIENTRY glActiveTexture (GLenum texture);
-GL_APICALL void GL_APIENTRY glAttachShader (GLuint program, GLuint shader);
-GL_APICALL void GL_APIENTRY glBindAttribLocation (GLuint program, GLuint index, const GLchar *name);
-GL_APICALL void GL_APIENTRY glBindBuffer (GLenum target, GLuint buffer);
-GL_APICALL void GL_APIENTRY glBindFramebuffer (GLenum target, GLuint framebuffer);
-GL_APICALL void GL_APIENTRY glBindRenderbuffer (GLenum target, GLuint renderbuffer);
-GL_APICALL void GL_APIENTRY glBindTexture (GLenum target, GLuint texture);
-GL_APICALL void GL_APIENTRY glBlendColor (GLfloat red, GLfloat green, GLfloat blue, GLfloat alpha);
-GL_APICALL void GL_APIENTRY glBlendEquation (GLenum mode);
-GL_APICALL void GL_APIENTRY glBlendEquationSeparate (GLenum modeRGB, GLenum modeAlpha);
-GL_APICALL void GL_APIENTRY glBlendFunc (GLenum sfactor, GLenum dfactor);
-GL_APICALL void GL_APIENTRY glBlendFuncSeparate (GLenum sfactorRGB, GLenum dfactorRGB, GLenum sfactorAlpha, GLenum dfactorAlpha);
-GL_APICALL void GL_APIENTRY glBufferData (GLenum target, GLsizeiptr size, const void *data, GLenum usage);
-GL_APICALL void GL_APIENTRY glBufferSubData (GLenum target, GLintptr offset, GLsizeiptr size, const void *data);
-GL_APICALL GLenum GL_APIENTRY glCheckFramebufferStatus (GLenum target);
-GL_APICALL void GL_APIENTRY glClear (GLbitfield mask);
-GL_APICALL void GL_APIENTRY glClearColor (GLfloat red, GLfloat green, GLfloat blue, GLfloat alpha);
-GL_APICALL void GL_APIENTRY glClearDepthf (GLfloat d);
-GL_APICALL void GL_APIENTRY glClearStencil (GLint s);
-GL_APICALL void GL_APIENTRY glColorMask (GLboolean red, GLboolean green, GLboolean blue, GLboolean alpha);
-GL_APICALL void GL_APIENTRY glCompileShader (GLuint shader);
-GL_APICALL void GL_APIENTRY glCompressedTexImage2D (GLenum target, GLint level, GLenum internalformat, GLsizei width, GLsizei height, GLint border, GLsizei imageSize, const void *data);
-GL_APICALL void GL_APIENTRY glCompressedTexSubImage2D (GLenum target, GLint level, GLint xoffset, GLint yoffset, GLsizei width, GLsizei height, GLenum format, GLsizei imageSize, const void *data);
-GL_APICALL void GL_APIENTRY glCopyTexImage2D (GLenum target, GLint level, GLenum internalformat, GLint x, GLint y, GLsizei width, GLsizei height, GLint border);
-GL_APICALL void GL_APIENTRY glCopyTexSubImage2D (GLenum target, GLint level, GLint xoffset, GLint yoffset, GLint x, GLint y, GLsizei width, GLsizei height);
-GL_APICALL GLuint GL_APIENTRY glCreateProgram (void);
-GL_APICALL GLuint GL_APIENTRY glCreateShader (GLenum type);
-GL_APICALL void GL_APIENTRY glCullFace (GLenum mode);
-GL_APICALL void GL_APIENTRY glDeleteBuffers (GLsizei n, const GLuint *buffers);
-GL_APICALL void GL_APIENTRY glDeleteFramebuffers (GLsizei n, const GLuint *framebuffers);
-GL_APICALL void GL_APIENTRY glDeleteProgram (GLuint program);
-GL_APICALL void GL_APIENTRY glDeleteRenderbuffers (GLsizei n, const GLuint *renderbuffers);
-GL_APICALL void GL_APIENTRY glDeleteShader (GLuint shader);
-GL_APICALL void GL_APIENTRY glDeleteTextures (GLsizei n, const GLuint *textures);
-GL_APICALL void GL_APIENTRY glDepthFunc (GLenum func);
-GL_APICALL void GL_APIENTRY glDepthMask (GLboolean flag);
-GL_APICALL void GL_APIENTRY glDepthRangef (GLfloat n, GLfloat f);
-GL_APICALL void GL_APIENTRY glDetachShader (GLuint program, GLuint shader);
-GL_APICALL void GL_APIENTRY glDisable (GLenum cap);
-GL_APICALL void GL_APIENTRY glDisableVertexAttribArray (GLuint index);
-GL_APICALL void GL_APIENTRY glDrawArrays (GLenum mode, GLint first, GLsizei count);
-GL_APICALL void GL_APIENTRY glDrawElements (GLenum mode, GLsizei count, GLenum type, const void *indices);
-GL_APICALL void GL_APIENTRY glEnable (GLenum cap);
-GL_APICALL void GL_APIENTRY glEnableVertexAttribArray (GLuint index);
-GL_APICALL void GL_APIENTRY glFinish (void);
-GL_APICALL void GL_APIENTRY glFlush (void);
-GL_APICALL void GL_APIENTRY glFramebufferRenderbuffer (GLenum target, GLenum attachment, GLenum renderbuffertarget, GLuint renderbuffer);
-GL_APICALL void GL_APIENTRY glFramebufferTexture2D (GLenum target, GLenum attachment, GLenum textarget, GLuint texture, GLint level);
-GL_APICALL void GL_APIENTRY glFrontFace (GLenum mode);
-GL_APICALL void GL_APIENTRY glGenBuffers (GLsizei n, GLuint *buffers);
-GL_APICALL void GL_APIENTRY glGenerateMipmap (GLenum target);
-GL_APICALL void GL_APIENTRY glGenFramebuffers (GLsizei n, GLuint *framebuffers);
-GL_APICALL void GL_APIENTRY glGenRenderbuffers (GLsizei n, GLuint *renderbuffers);
-GL_APICALL void GL_APIENTRY glGenTextures (GLsizei n, GLuint *textures);
-GL_APICALL void GL_APIENTRY glGetActiveAttrib (GLuint program, GLuint index, GLsizei bufSize, GLsizei *length, GLint *size, GLenum *type, GLchar *name);
-GL_APICALL void GL_APIENTRY glGetActiveUniform (GLuint program, GLuint index, GLsizei bufSize, GLsizei *length, GLint *size, GLenum *type, GLchar *name);
-GL_APICALL void GL_APIENTRY glGetAttachedShaders (GLuint program, GLsizei maxCount, GLsizei *count, GLuint *shaders);
-GL_APICALL GLint GL_APIENTRY glGetAttribLocation (GLuint program, const GLchar *name);
-GL_APICALL void GL_APIENTRY glGetBooleanv (GLenum pname, GLboolean *data);
-GL_APICALL void GL_APIENTRY glGetBufferParameteriv (GLenum target, GLenum pname, GLint *params);
-GL_APICALL GLenum GL_APIENTRY glGetError (void);
-GL_APICALL void GL_APIENTRY glGetFloatv (GLenum pname, GLfloat *data);
-GL_APICALL void GL_APIENTRY glGetFramebufferAttachmentParameteriv (GLenum target, GLenum attachment, GLenum pname, GLint *params);
-GL_APICALL void GL_APIENTRY glGetIntegerv (GLenum pname, GLint *data);
-GL_APICALL void GL_APIENTRY glGetProgramiv (GLuint program, GLenum pname, GLint *params);
-GL_APICALL void GL_APIENTRY glGetProgramInfoLog (GLuint program, GLsizei bufSize, GLsizei *length, GLchar *infoLog);
-GL_APICALL void GL_APIENTRY glGetRenderbufferParameteriv (GLenum target, GLenum pname, GLint *params);
-GL_APICALL void GL_APIENTRY glGetShaderiv (GLuint shader, GLenum pname, GLint *params);
-GL_APICALL void GL_APIENTRY glGetShaderInfoLog (GLuint shader, GLsizei bufSize, GLsizei *length, GLchar *infoLog);
-GL_APICALL void GL_APIENTRY glGetShaderPrecisionFormat (GLenum shadertype, GLenum precisiontype, GLint *range, GLint *precision);
-GL_APICALL void GL_APIENTRY glGetShaderSource (GLuint shader, GLsizei bufSize, GLsizei *length, GLchar *source);
-GL_APICALL const GLubyte *GL_APIENTRY glGetString (GLenum name);
-GL_APICALL void GL_APIENTRY glGetTexParameterfv (GLenum target, GLenum pname, GLfloat *params);
-GL_APICALL void GL_APIENTRY glGetTexParameteriv (GLenum target, GLenum pname, GLint *params);
-GL_APICALL void GL_APIENTRY glGetUniformfv (GLuint program, GLint location, GLfloat *params);
-GL_APICALL void GL_APIENTRY glGetUniformiv (GLuint program, GLint location, GLint *params);
-GL_APICALL GLint GL_APIENTRY glGetUniformLocation (GLuint program, const GLchar *name);
-GL_APICALL void GL_APIENTRY glGetVertexAttribfv (GLuint index, GLenum pname, GLfloat *params);
-GL_APICALL void GL_APIENTRY glGetVertexAttribiv (GLuint index, GLenum pname, GLint *params);
-GL_APICALL void GL_APIENTRY glGetVertexAttribPointerv (GLuint index, GLenum pname, void **pointer);
-GL_APICALL void GL_APIENTRY glHint (GLenum target, GLenum mode);
-GL_APICALL GLboolean GL_APIENTRY glIsBuffer (GLuint buffer);
-GL_APICALL GLboolean GL_APIENTRY glIsEnabled (GLenum cap);
-GL_APICALL GLboolean GL_APIENTRY glIsFramebuffer (GLuint framebuffer);
-GL_APICALL GLboolean GL_APIENTRY glIsProgram (GLuint program);
-GL_APICALL GLboolean GL_APIENTRY glIsRenderbuffer (GLuint renderbuffer);
-GL_APICALL GLboolean GL_APIENTRY glIsShader (GLuint shader);
-GL_APICALL GLboolean GL_APIENTRY glIsTexture (GLuint texture);
-GL_APICALL void GL_APIENTRY glLineWidth (GLfloat width);
-GL_APICALL void GL_APIENTRY glLinkProgram (GLuint program);
-GL_APICALL void GL_APIENTRY glPixelStorei (GLenum pname, GLint param);
-GL_APICALL void GL_APIENTRY glPolygonOffset (GLfloat factor, GLfloat units);
-GL_APICALL void GL_APIENTRY glReadPixels (GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, void *pixels);
-GL_APICALL void GL_APIENTRY glReleaseShaderCompiler (void);
-GL_APICALL void GL_APIENTRY glRenderbufferStorage (GLenum target, GLenum internalformat, GLsizei width, GLsizei height);
-GL_APICALL void GL_APIENTRY glSampleCoverage (GLfloat value, GLboolean invert);
-GL_APICALL void GL_APIENTRY glScissor (GLint x, GLint y, GLsizei width, GLsizei height);
-GL_APICALL void GL_APIENTRY glShaderBinary (GLsizei count, const GLuint *shaders, GLenum binaryFormat, const void *binary, GLsizei length);
-GL_APICALL void GL_APIENTRY glShaderSource (GLuint shader, GLsizei count, const GLchar *const*string, const GLint *length);
-GL_APICALL void GL_APIENTRY glStencilFunc (GLenum func, GLint ref, GLuint mask);
-GL_APICALL void GL_APIENTRY glStencilFuncSeparate (GLenum face, GLenum func, GLint ref, GLuint mask);
-GL_APICALL void GL_APIENTRY glStencilMask (GLuint mask);
-GL_APICALL void GL_APIENTRY glStencilMaskSeparate (GLenum face, GLuint mask);
-GL_APICALL void GL_APIENTRY glStencilOp (GLenum fail, GLenum zfail, GLenum zpass);
-GL_APICALL void GL_APIENTRY glStencilOpSeparate (GLenum face, GLenum sfail, GLenum dpfail, GLenum dppass);
-GL_APICALL void GL_APIENTRY glTexImage2D (GLenum target, GLint level, GLint internalformat, GLsizei width, GLsizei height, GLint border, GLenum format, GLenum type, const void *pixels);
-GL_APICALL void GL_APIENTRY glTexParameterf (GLenum target, GLenum pname, GLfloat param);
-GL_APICALL void GL_APIENTRY glTexParameterfv (GLenum target, GLenum pname, const GLfloat *params);
-GL_APICALL void GL_APIENTRY glTexParameteri (GLenum target, GLenum pname, GLint param);
-GL_APICALL void GL_APIENTRY glTexParameteriv (GLenum target, GLenum pname, const GLint *params);
-GL_APICALL void GL_APIENTRY glTexSubImage2D (GLenum target, GLint level, GLint xoffset, GLint yoffset, GLsizei width, GLsizei height, GLenum format, GLenum type, const void *pixels);
-GL_APICALL void GL_APIENTRY glUniform1f (GLint location, GLfloat v0);
-GL_APICALL void GL_APIENTRY glUniform1fv (GLint location, GLsizei count, const GLfloat *value);
-GL_APICALL void GL_APIENTRY glUniform1i (GLint location, GLint v0);
-GL_APICALL void GL_APIENTRY glUniform1iv (GLint location, GLsizei count, const GLint *value);
-GL_APICALL void GL_APIENTRY glUniform2f (GLint location, GLfloat v0, GLfloat v1);
-GL_APICALL void GL_APIENTRY glUniform2fv (GLint location, GLsizei count, const GLfloat *value);
-GL_APICALL void GL_APIENTRY glUniform2i (GLint location, GLint v0, GLint v1);
-GL_APICALL void GL_APIENTRY glUniform2iv (GLint location, GLsizei count, const GLint *value);
-GL_APICALL void GL_APIENTRY glUniform3f (GLint location, GLfloat v0, GLfloat v1, GLfloat v2);
-GL_APICALL void GL_APIENTRY glUniform3fv (GLint location, GLsizei count, const GLfloat *value);
-GL_APICALL void GL_APIENTRY glUniform3i (GLint location, GLint v0, GLint v1, GLint v2);
-GL_APICALL void GL_APIENTRY glUniform3iv (GLint location, GLsizei count, const GLint *value);
-GL_APICALL void GL_APIENTRY glUniform4f (GLint location, GLfloat v0, GLfloat v1, GLfloat v2, GLfloat v3);
-GL_APICALL void GL_APIENTRY glUniform4fv (GLint location, GLsizei count, const GLfloat *value);
-GL_APICALL void GL_APIENTRY glUniform4i (GLint location, GLint v0, GLint v1, GLint v2, GLint v3);
-GL_APICALL void GL_APIENTRY glUniform4iv (GLint location, GLsizei count, const GLint *value);
-GL_APICALL void GL_APIENTRY glUniformMatrix2fv (GLint location, GLsizei count, GLboolean transpose, const GLfloat *value);
-GL_APICALL void GL_APIENTRY glUniformMatrix3fv (GLint location, GLsizei count, GLboolean transpose, const GLfloat *value);
-GL_APICALL void GL_APIENTRY glUniformMatrix4fv (GLint location, GLsizei count, GLboolean transpose, const GLfloat *value);
-GL_APICALL void GL_APIENTRY glUseProgram (GLuint program);
-GL_APICALL void GL_APIENTRY glValidateProgram (GLuint program);
-GL_APICALL void GL_APIENTRY glVertexAttrib1f (GLuint index, GLfloat x);
-GL_APICALL void GL_APIENTRY glVertexAttrib1fv (GLuint index, const GLfloat *v);
-GL_APICALL void GL_APIENTRY glVertexAttrib2f (GLuint index, GLfloat x, GLfloat y);
-GL_APICALL void GL_APIENTRY glVertexAttrib2fv (GLuint index, const GLfloat *v);
-GL_APICALL void GL_APIENTRY glVertexAttrib3f (GLuint index, GLfloat x, GLfloat y, GLfloat z);
-GL_APICALL void GL_APIENTRY glVertexAttrib3fv (GLuint index, const GLfloat *v);
-GL_APICALL void GL_APIENTRY glVertexAttrib4f (GLuint index, GLfloat x, GLfloat y, GLfloat z, GLfloat w);
-GL_APICALL void GL_APIENTRY glVertexAttrib4fv (GLuint index, const GLfloat *v);
-GL_APICALL void GL_APIENTRY glVertexAttribPointer (GLuint index, GLint size, GLenum type, GLboolean normalized, GLsizei stride, const void *pointer);
-GL_APICALL void GL_APIENTRY glViewport (GLint x, GLint y, GLsizei width, GLsizei height);
-#endif
-#endif /* GL_ES_VERSION_2_0 */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_opengles2_gl2platform.h

@@ -1,27 +0,0 @@
-#ifndef __gl2platform_h_
-#define __gl2platform_h_
-
-/*
-** Copyright 2017-2020 The Khronos Group Inc.
-** SPDX-License-Identifier: Apache-2.0
-*/
-
-/* Platform-specific types and definitions for OpenGL ES 2.X  gl2.h
- *
- * Adopters may modify khrplatform.h and this file to suit their platform.
- * Please contribute modifications back to Khronos as pull requests on the
- * public github repository:
- *      https://github.com/KhronosGroup/OpenGL-Registry
- */
-
-/*#include <KHR/khrplatform.h>*/
-
-#ifndef GL_APICALL
-#define GL_APICALL  KHRONOS_APICALL
-#endif
-
-#ifndef GL_APIENTRY
-#define GL_APIENTRY KHRONOS_APIENTRY
-#endif
-
-#endif /* __gl2platform_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_opengles2_khrplatform.h

@@ -1,311 +0,0 @@
-#ifndef __khrplatform_h_
-#define __khrplatform_h_
-
-/*
-** Copyright (c) 2008-2018 The Khronos Group Inc.
-**
-** Permission is hereby granted, free of charge, to any person obtaining a
-** copy of this software and/or associated documentation files (the
-** "Materials"), to deal in the Materials without restriction, including
-** without limitation the rights to use, copy, modify, merge, publish,
-** distribute, sublicense, and/or sell copies of the Materials, and to
-** permit persons to whom the Materials are furnished to do so, subject to
-** the following conditions:
-**
-** The above copyright notice and this permission notice shall be included
-** in all copies or substantial portions of the Materials.
-**
-** THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-** MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-** CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-** TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-** MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
-*/
-
-/* Khronos platform-specific types and definitions.
- *
- * The master copy of khrplatform.h is maintained in the Khronos EGL
- * Registry repository at https://github.com/KhronosGroup/EGL-Registry
- * The last semantic modification to khrplatform.h was at commit ID:
- *      67a3e0864c2d75ea5287b9f3d2eb74a745936692
- *
- * Adopters may modify this file to suit their platform. Adopters are
- * encouraged to submit platform specific modifications to the Khronos
- * group so that they can be included in future versions of this file.
- * Please submit changes by filing pull requests or issues on
- * the EGL Registry repository linked above.
- *
- *
- * See the Implementer's Guidelines for information about where this file
- * should be located on your system and for more details of its use:
- *    http://www.khronos.org/registry/implementers_guide.pdf
- *
- * This file should be included as
- *        #include <KHR/khrplatform.h>
- * by Khronos client API header files that use its types and defines.
- *
- * The types in khrplatform.h should only be used to define API-specific types.
- *
- * Types defined in khrplatform.h:
- *    khronos_int8_t              signed   8  bit
- *    khronos_uint8_t             unsigned 8  bit
- *    khronos_int16_t             signed   16 bit
- *    khronos_uint16_t            unsigned 16 bit
- *    khronos_int32_t             signed   32 bit
- *    khronos_uint32_t            unsigned 32 bit
- *    khronos_int64_t             signed   64 bit
- *    khronos_uint64_t            unsigned 64 bit
- *    khronos_intptr_t            signed   same number of bits as a pointer
- *    khronos_uintptr_t           unsigned same number of bits as a pointer
- *    khronos_ssize_t             signed   size
- *    khronos_usize_t             unsigned size
- *    khronos_float_t             signed   32 bit floating point
- *    khronos_time_ns_t           unsigned 64 bit time in nanoseconds
- *    khronos_utime_nanoseconds_t unsigned time interval or absolute time in
- *                                         nanoseconds
- *    khronos_stime_nanoseconds_t signed time interval in nanoseconds
- *    khronos_boolean_enum_t      enumerated boolean type. This should
- *      only be used as a base type when a client API's boolean type is
- *      an enum. Client APIs which use an integer or other type for
- *      booleans cannot use this as the base type for their boolean.
- *
- * Tokens defined in khrplatform.h:
- *
- *    KHRONOS_FALSE, KHRONOS_TRUE Enumerated boolean false/true values.
- *
- *    KHRONOS_SUPPORT_INT64 is 1 if 64 bit integers are supported; otherwise 0.
- *    KHRONOS_SUPPORT_FLOAT is 1 if floats are supported; otherwise 0.
- *
- * Calling convention macros defined in this file:
- *    KHRONOS_APICALL
- *    KHRONOS_APIENTRY
- *    KHRONOS_APIATTRIBUTES
- *
- * These may be used in function prototypes as:
- *
- *      KHRONOS_APICALL void KHRONOS_APIENTRY funcname(
- *                                  int arg1,
- *                                  int arg2) KHRONOS_APIATTRIBUTES;
- */
-
-#if defined(__SCITECH_SNAP__) && !defined(KHRONOS_STATIC)
-#   define KHRONOS_STATIC 1
-#endif
-
-/*-------------------------------------------------------------------------
- * Definition of KHRONOS_APICALL
- *-------------------------------------------------------------------------
- * This precedes the return type of the function in the function prototype.
- */
-#if defined(KHRONOS_STATIC)
-    /* If the preprocessor constant KHRONOS_STATIC is defined, make the
-     * header compatible with static linking. */
-#   define KHRONOS_APICALL
-#elif defined(_WIN32)
-#   define KHRONOS_APICALL __declspec(dllimport)
-#elif defined (__SYMBIAN32__)
-#   define KHRONOS_APICALL IMPORT_C
-#elif defined(__ANDROID__)
-#   define KHRONOS_APICALL __attribute__((visibility("default")))
-#else
-#   define KHRONOS_APICALL
-#endif
-
-/*-------------------------------------------------------------------------
- * Definition of KHRONOS_APIENTRY
- *-------------------------------------------------------------------------
- * This follows the return type of the function  and precedes the function
- * name in the function prototype.
- */
-#if defined(_WIN32) && !defined(_WIN32_WCE) && !defined(__SCITECH_SNAP__)
-    /* Win32 but not WinCE */
-#   define KHRONOS_APIENTRY __stdcall
-#else
-#   define KHRONOS_APIENTRY
-#endif
-
-/*-------------------------------------------------------------------------
- * Definition of KHRONOS_APIATTRIBUTES
- *-------------------------------------------------------------------------
- * This follows the closing parenthesis of the function prototype arguments.
- */
-#if defined (__ARMCC_2__)
-#define KHRONOS_APIATTRIBUTES __softfp
-#else
-#define KHRONOS_APIATTRIBUTES
-#endif
-
-/*-------------------------------------------------------------------------
- * basic type definitions
- *-----------------------------------------------------------------------*/
-#if (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || defined(__GNUC__) || defined(__SCO__) || defined(__USLC__)
-
-
-/*
- * Using <stdint.h>
- */
-#include <stdint.h>
-typedef int32_t                 khronos_int32_t;
-typedef uint32_t                khronos_uint32_t;
-typedef int64_t                 khronos_int64_t;
-typedef uint64_t                khronos_uint64_t;
-#define KHRONOS_SUPPORT_INT64   1
-#define KHRONOS_SUPPORT_FLOAT   1
-/*
- * To support platform where unsigned long cannot be used interchangeably with
- * inptr_t (e.g. CHERI-extended ISAs), we can use the stdint.h intptr_t.
- * Ideally, we could just use (u)intptr_t everywhere, but this could result in
- * ABI breakage if khronos_uintptr_t is changed from unsigned long to
- * unsigned long long or similar (this results in different C++ name mangling).
- * To avoid changes for existing platforms, we restrict usage of intptr_t to
- * platforms where the size of a pointer is larger than the size of long.
- */
-#if defined(__SIZEOF_LONG__) && defined(__SIZEOF_POINTER__)
-#if __SIZEOF_POINTER__ > __SIZEOF_LONG__
-#define KHRONOS_USE_INTPTR_T
-#endif
-#endif
-
-#elif defined(__VMS ) || defined(__sgi)
-
-/*
- * Using <inttypes.h>
- */
-#include <inttypes.h>
-typedef int32_t                 khronos_int32_t;
-typedef uint32_t                khronos_uint32_t;
-typedef int64_t                 khronos_int64_t;
-typedef uint64_t                khronos_uint64_t;
-#define KHRONOS_SUPPORT_INT64   1
-#define KHRONOS_SUPPORT_FLOAT   1
-
-#elif defined(_WIN32) && !defined(__SCITECH_SNAP__)
-
-/*
- * Win32
- */
-typedef __int32                 khronos_int32_t;
-typedef unsigned __int32        khronos_uint32_t;
-typedef __int64                 khronos_int64_t;
-typedef unsigned __int64        khronos_uint64_t;
-#define KHRONOS_SUPPORT_INT64   1
-#define KHRONOS_SUPPORT_FLOAT   1
-
-#elif defined(__sun__) || defined(__digital__)
-
-/*
- * Sun or Digital
- */
-typedef int                     khronos_int32_t;
-typedef unsigned int            khronos_uint32_t;
-#if defined(__arch64__) || defined(_LP64)
-typedef long int                khronos_int64_t;
-typedef unsigned long int       khronos_uint64_t;
-#else
-typedef long long int           khronos_int64_t;
-typedef unsigned long long int  khronos_uint64_t;
-#endif /* __arch64__ */
-#define KHRONOS_SUPPORT_INT64   1
-#define KHRONOS_SUPPORT_FLOAT   1
-
-#elif 0
-
-/*
- * Hypothetical platform with no float or int64 support
- */
-typedef int                     khronos_int32_t;
-typedef unsigned int            khronos_uint32_t;
-#define KHRONOS_SUPPORT_INT64   0
-#define KHRONOS_SUPPORT_FLOAT   0
-
-#else
-
-/*
- * Generic fallback
- */
-#include <stdint.h>
-typedef int32_t                 khronos_int32_t;
-typedef uint32_t                khronos_uint32_t;
-typedef int64_t                 khronos_int64_t;
-typedef uint64_t                khronos_uint64_t;
-#define KHRONOS_SUPPORT_INT64   1
-#define KHRONOS_SUPPORT_FLOAT   1
-
-#endif
-
-
-/*
- * Types that are (so far) the same on all platforms
- */
-typedef signed   char          khronos_int8_t;
-typedef unsigned char          khronos_uint8_t;
-typedef signed   short int     khronos_int16_t;
-typedef unsigned short int     khronos_uint16_t;
-
-/*
- * Types that differ between LLP64 and LP64 architectures - in LLP64,
- * pointers are 64 bits, but 'long' is still 32 bits. Win64 appears
- * to be the only LLP64 architecture in current use.
- */
-#ifdef KHRONOS_USE_INTPTR_T
-typedef intptr_t               khronos_intptr_t;
-typedef uintptr_t              khronos_uintptr_t;
-#elif defined(_WIN64)
-typedef signed   long long int khronos_intptr_t;
-typedef unsigned long long int khronos_uintptr_t;
-#else
-typedef signed   long  int     khronos_intptr_t;
-typedef unsigned long  int     khronos_uintptr_t;
-#endif
-
-#if defined(_WIN64)
-typedef signed   long long int khronos_ssize_t;
-typedef unsigned long long int khronos_usize_t;
-#else
-typedef signed   long  int     khronos_ssize_t;
-typedef unsigned long  int     khronos_usize_t;
-#endif
-
-#if KHRONOS_SUPPORT_FLOAT
-/*
- * Float type
- */
-typedef          float         khronos_float_t;
-#endif
-
-#if KHRONOS_SUPPORT_INT64
-/* Time types
- *
- * These types can be used to represent a time interval in nanoseconds or
- * an absolute Unadjusted System Time.  Unadjusted System Time is the number
- * of nanoseconds since some arbitrary system event (e.g. since the last
- * time the system booted).  The Unadjusted System Time is an unsigned
- * 64 bit value that wraps back to 0 every 584 years.  Time intervals
- * may be either signed or unsigned.
- */
-typedef khronos_uint64_t       khronos_utime_nanoseconds_t;
-typedef khronos_int64_t        khronos_stime_nanoseconds_t;
-#endif
-
-/*
- * Dummy value used to pad enum types to 32 bits.
- */
-#ifndef KHRONOS_MAX_ENUM
-#define KHRONOS_MAX_ENUM 0x7FFFFFFF
-#endif
-
-/*
- * Enumerated boolean type
- *
- * Values other than zero should be considered to be true.  Therefore
- * comparisons should not be made against KHRONOS_TRUE.
- */
-typedef enum {
-    KHRONOS_FALSE = 0,
-    KHRONOS_TRUE  = 1,
-    KHRONOS_BOOLEAN_ENUM_FORCE_SIZE = KHRONOS_MAX_ENUM
-} khronos_boolean_enum_t;
-
-#endif /* __khrplatform_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_pen.h

@@ -1,127 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryPen
- *
- * SDL pen event handling.
- *
- * SDL provides an API for pressure-sensitive pen (stylus and/or eraser)
- * handling, e.g., for input and drawing tablets or suitably equipped mobile /
- * tablet devices.
- *
- * To get started with pens, simply handle SDL_EVENT_PEN_* events. When a pen
- * starts providing input, SDL will assign it a unique SDL_PenID, which will
- * remain for the life of the process, as long as the pen stays connected.
- *
- * Pens may provide more than simple touch input; they might have other axes,
- * such as pressure, tilt, rotation, etc.
- */
-
-#ifndef SDL_pen_h_
-#define SDL_pen_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_mouse.h>
-#include <SDL3/SDL_touch.h>
-
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * SDL pen instance IDs.
- *
- * Zero is used to signify an invalid/null device.
- *
- * These show up in pen events when SDL sees input from them. They remain
- * consistent as long as SDL can recognize a tool to be the same pen; but if a
- * pen physically leaves the area and returns, it might get a new ID.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_PenID;
-
-/**
- * The SDL_MouseID for mouse events simulated with pen input.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PEN_MOUSEID ((SDL_MouseID)-2)
-
-/**
- * The SDL_TouchID for touch events simulated with pen input.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PEN_TOUCHID ((SDL_TouchID)-2)
-
-
-/**
- * Pen input flags, as reported by various pen events' `pen_state` field.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_PenInputFlags;
-
-#define SDL_PEN_INPUT_DOWN       (1u << 0)  /**< pen is pressed down */
-#define SDL_PEN_INPUT_BUTTON_1   (1u << 1)  /**< button 1 is pressed */
-#define SDL_PEN_INPUT_BUTTON_2   (1u << 2)  /**< button 2 is pressed */
-#define SDL_PEN_INPUT_BUTTON_3   (1u << 3)  /**< button 3 is pressed */
-#define SDL_PEN_INPUT_BUTTON_4   (1u << 4)  /**< button 4 is pressed */
-#define SDL_PEN_INPUT_BUTTON_5   (1u << 5)  /**< button 5 is pressed */
-#define SDL_PEN_INPUT_ERASER_TIP (1u << 30) /**< eraser tip is used */
-
-/**
- * Pen axis indices.
- *
- * These are the valid values for the `axis` field in SDL_PenAxisEvent. All
- * axes are either normalised to 0..1 or report a (positive or negative) angle
- * in degrees, with 0.0 representing the centre. Not all pens/backends support
- * all axes: unsupported axes are always zero.
- *
- * To convert angles for tilt and rotation into vector representation, use
- * SDL_sinf on the XTILT, YTILT, or ROTATION component, for example:
- *
- * `SDL_sinf(xtilt * SDL_PI_F / 180.0)`.
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_PenAxis
-{
-    SDL_PEN_AXIS_PRESSURE,  /**< Pen pressure.  Unidirectional: 0 to 1.0 */
-    SDL_PEN_AXIS_XTILT,     /**< Pen horizontal tilt angle.  Bidirectional: -90.0 to 90.0 (left-to-right). */
-    SDL_PEN_AXIS_YTILT,     /**< Pen vertical tilt angle.  Bidirectional: -90.0 to 90.0 (top-to-down). */
-    SDL_PEN_AXIS_DISTANCE,  /**< Pen distance to drawing surface.  Unidirectional: 0.0 to 1.0 */
-    SDL_PEN_AXIS_ROTATION,  /**< Pen barrel rotation.  Bidirectional: -180 to 179.9 (clockwise, 0 is facing up, -180.0 is facing down). */
-    SDL_PEN_AXIS_SLIDER,    /**< Pen finger wheel or slider (e.g., Airbrush Pen).  Unidirectional: 0 to 1.0 */
-    SDL_PEN_AXIS_TANGENTIAL_PRESSURE,    /**< Pressure from squeezing the pen ("barrel pressure"). */
-    SDL_PEN_AXIS_COUNT       /**< Total known pen axis types in this version of SDL. This number may grow in future releases! */
-} SDL_PenAxis;
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* SDL_pen_h_ */
-

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_platform.h

@@ -1,64 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryPlatform
- *
- * SDL provides a means to identify the app's platform, both at compile time
- * and runtime.
- */
-
-#ifndef SDL_platform_h_
-#define SDL_platform_h_
-
-#include <SDL3/SDL_platform_defines.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * Get the name of the platform.
- *
- * Here are the names returned for some (but not all) supported platforms:
- *
- * - "Windows"
- * - "macOS"
- * - "Linux"
- * - "iOS"
- * - "Android"
- *
- * \returns the name of the platform. If the correct platform name is not
- *          available, returns a string beginning with the text "Unknown".
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetPlatform(void);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_platform_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_platform_defines.h

@@ -1,476 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: Platform */
-
-/*
- * SDL_platform_defines.h tries to get a standard set of platform defines.
- */
-
-#ifndef SDL_platform_defines_h_
-#define SDL_platform_defines_h_
-
-#ifdef _AIX
-
-/**
- * A preprocessor macro that is only defined if compiling for AIX.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_AIX 1
-#endif
-
-#ifdef __HAIKU__
-
-/**
- * A preprocessor macro that is only defined if compiling for Haiku OS.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_HAIKU 1
-#endif
-
-#if defined(bsdi) || defined(__bsdi) || defined(__bsdi__)
-
-/**
- * A preprocessor macro that is only defined if compiling for BSDi
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_BSDI 1
-#endif
-
-#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__) || defined(__DragonFly__)
-
-/**
- * A preprocessor macro that is only defined if compiling for FreeBSD.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_FREEBSD 1
-#endif
-
-#if defined(hpux) || defined(__hpux) || defined(__hpux__)
-
-/**
- * A preprocessor macro that is only defined if compiling for HP-UX.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_HPUX 1
-#endif
-
-#if defined(sgi) || defined(__sgi) || defined(__sgi__) || defined(_SGI_SOURCE)
-
-/**
- * A preprocessor macro that is only defined if compiling for IRIX.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_IRIX 1
-#endif
-
-#if (defined(linux) || defined(__linux) || defined(__linux__))
-
-/**
- * A preprocessor macro that is only defined if compiling for Linux.
- *
- * Note that Android, although ostensibly a Linux-based system, will not
- * define this. It defines SDL_PLATFORM_ANDROID instead.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_LINUX 1
-#endif
-
-#if defined(ANDROID) || defined(__ANDROID__)
-
-/**
- * A preprocessor macro that is only defined if compiling for Android.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_ANDROID 1
-#undef SDL_PLATFORM_LINUX
-#endif
-
-#if defined(__unix__) || defined(__unix) || defined(unix)
-
-/**
- * A preprocessor macro that is only defined if compiling for a Unix-like
- * system.
- *
- * Other platforms, like Linux, might define this in addition to their primary
- * define.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_UNIX 1
-#endif
-
-#ifdef __APPLE__
-
-/**
- * A preprocessor macro that is only defined if compiling for Apple platforms.
- *
- * iOS, macOS, etc will additionally define a more specific platform macro.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_PLATFORM_MACOS
- * \sa SDL_PLATFORM_IOS
- * \sa SDL_PLATFORM_TVOS
- * \sa SDL_PLATFORM_VISIONOS
- */
-#define SDL_PLATFORM_APPLE 1
-
-/* lets us know what version of macOS we're compiling on */
-#include <AvailabilityMacros.h>
-#ifndef __has_extension /* Older compilers don't support this */
-    #define __has_extension(x) 0
-    #include <TargetConditionals.h>
-    #undef __has_extension
-#else
-    #include <TargetConditionals.h>
-#endif
-
-/* Fix building with older SDKs that don't define these
-    See this for more information:
-    https://stackoverflow.com/questions/12132933/preprocessor-macro-for-os-x-targets
-*/
-#ifndef TARGET_OS_MACCATALYST
-    #define TARGET_OS_MACCATALYST 0
-#endif
-#ifndef TARGET_OS_IOS
-    #define TARGET_OS_IOS 0
-#endif
-#ifndef TARGET_OS_IPHONE
-    #define TARGET_OS_IPHONE 0
-#endif
-#ifndef TARGET_OS_TV
-    #define TARGET_OS_TV 0
-#endif
-#ifndef TARGET_OS_SIMULATOR
-    #define TARGET_OS_SIMULATOR 0
-#endif
-#ifndef TARGET_OS_VISION
-    #define TARGET_OS_VISION 0
-#endif
-
-#if TARGET_OS_TV
-
-/**
- * A preprocessor macro that is only defined if compiling for tvOS.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_PLATFORM_APPLE
- */
-#define SDL_PLATFORM_TVOS 1
-#endif
-
-#if TARGET_OS_VISION
-
-/**
- * A preprocessor macro that is only defined if compiling for VisionOS.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_PLATFORM_APPLE
- */
-#define SDL_PLATFORM_VISIONOS 1
-#endif
-
-#if TARGET_OS_IPHONE
-
-/**
- * A preprocessor macro that is only defined if compiling for iOS.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_PLATFORM_APPLE
- */
-#define SDL_PLATFORM_IOS 1
-
-#else
-
-/**
- * A preprocessor macro that is only defined if compiling for macOS.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_PLATFORM_APPLE
- */
-#define SDL_PLATFORM_MACOS 1
-
-#if MAC_OS_X_VERSION_MIN_REQUIRED < 1070
-    #error SDL for macOS only supports deploying on 10.7 and above.
-#endif /* MAC_OS_X_VERSION_MIN_REQUIRED < 1070 */
-#endif /* TARGET_OS_IPHONE */
-#endif /* defined(__APPLE__) */
-
-#ifdef __EMSCRIPTEN__
-
-/**
- * A preprocessor macro that is only defined if compiling for Emscripten.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_EMSCRIPTEN 1
-#endif
-
-#ifdef __NetBSD__
-
-/**
- * A preprocessor macro that is only defined if compiling for NetBSD.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_NETBSD 1
-#endif
-
-#ifdef __OpenBSD__
-
-/**
- * A preprocessor macro that is only defined if compiling for OpenBSD.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_OPENBSD 1
-#endif
-
-#if defined(__OS2__) || defined(__EMX__)
-
-/**
- * A preprocessor macro that is only defined if compiling for OS/2.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_OS2 1
-#endif
-
-#if defined(osf) || defined(__osf) || defined(__osf__) || defined(_OSF_SOURCE)
-
-/**
- * A preprocessor macro that is only defined if compiling for Tru64 (OSF/1).
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_OSF 1
-#endif
-
-#ifdef __QNXNTO__
-
-/**
- * A preprocessor macro that is only defined if compiling for QNX Neutrino.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_QNXNTO 1
-#endif
-
-#if defined(riscos) || defined(__riscos) || defined(__riscos__)
-
-/**
- * A preprocessor macro that is only defined if compiling for RISC OS.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_RISCOS 1
-#endif
-
-#if defined(__sun) && defined(__SVR4)
-
-/**
- * A preprocessor macro that is only defined if compiling for SunOS/Solaris.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_SOLARIS 1
-#endif
-
-#if defined(__CYGWIN__)
-
-/**
- * A preprocessor macro that is only defined if compiling for Cygwin.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_CYGWIN 1
-#endif
-
-#if defined(_WIN32) || defined(SDL_PLATFORM_CYGWIN)
-
-/**
- * A preprocessor macro that is only defined if compiling for Windows.
- *
- * This also covers several other platforms, like Microsoft GDK, Xbox, WinRT,
- * etc. Each will have their own more-specific platform macros, too.
- *
- * \since This macro is available since SDL 3.2.0.
- *
- * \sa SDL_PLATFORM_WIN32
- * \sa SDL_PLATFORM_XBOXONE
- * \sa SDL_PLATFORM_XBOXSERIES
- * \sa SDL_PLATFORM_WINGDK
- * \sa SDL_PLATFORM_GDK
- */
-#define SDL_PLATFORM_WINDOWS 1
-
-/* Try to find out if we're compiling for WinRT, GDK or non-WinRT/GDK */
-#if defined(_MSC_VER) && defined(__has_include)
-    #if __has_include(<winapifamily.h>)
-        #define HAVE_WINAPIFAMILY_H 1
-    #else
-        #define HAVE_WINAPIFAMILY_H 0
-    #endif
-
-    /* If _USING_V110_SDK71_ is defined it means we are using the Windows XP toolset. */
-#elif defined(_MSC_VER) && (_MSC_VER >= 1700 && !_USING_V110_SDK71_)    /* _MSC_VER == 1700 for Visual Studio 2012 */
-    #define HAVE_WINAPIFAMILY_H 1
-#else
-    #define HAVE_WINAPIFAMILY_H 0
-#endif
-
-#if HAVE_WINAPIFAMILY_H
-    #include <winapifamily.h>
-    #define WINAPI_FAMILY_WINRT (!WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP) && WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP))
-#else
-    #define WINAPI_FAMILY_WINRT 0
-#endif /* HAVE_WINAPIFAMILY_H */
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * A preprocessor macro that defined to 1 if compiling for Windows Phone.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_WINAPI_FAMILY_PHONE (WINAPI_FAMILY == WINAPI_FAMILY_PHONE_APP)
-
-#elif defined(HAVE_WINAPIFAMILY_H) && HAVE_WINAPIFAMILY_H
-    #define SDL_WINAPI_FAMILY_PHONE (WINAPI_FAMILY == WINAPI_FAMILY_PHONE_APP)
-#else
-    #define SDL_WINAPI_FAMILY_PHONE 0
-#endif
-
-#if WINAPI_FAMILY_WINRT
-#error Windows RT/UWP is no longer supported in SDL
-
-#elif defined(_GAMING_DESKTOP) /* GDK project configuration always defines _GAMING_XXX */
-
-/**
- * A preprocessor macro that is only defined if compiling for Microsoft GDK
- * for Windows.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_WINGDK 1
-
-#elif defined(_GAMING_XBOX_XBOXONE)
-
-/**
- * A preprocessor macro that is only defined if compiling for Xbox One.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_XBOXONE 1
-
-#elif defined(_GAMING_XBOX_SCARLETT)
-
-/**
- * A preprocessor macro that is only defined if compiling for Xbox Series.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_XBOXSERIES 1
-
-#else
-
-/**
- * A preprocessor macro that is only defined if compiling for desktop Windows.
- *
- * Despite the "32", this also covers 64-bit Windows; as an informal
- * convention, its system layer tends to still be referred to as "the Win32
- * API."
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_WIN32 1
-
-#endif
-#endif /* defined(_WIN32) || defined(SDL_PLATFORM_CYGWIN) */
-
-
-/* This is to support generic "any GDK" separate from a platform-specific GDK */
-#if defined(SDL_PLATFORM_WINGDK) || defined(SDL_PLATFORM_XBOXONE) || defined(SDL_PLATFORM_XBOXSERIES)
-
-/**
- * A preprocessor macro that is only defined if compiling for Microsoft GDK on
- * any platform.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_GDK 1
-#endif
-
-#if defined(__PSP__) || defined(__psp__)
-
-/**
- * A preprocessor macro that is only defined if compiling for Sony PSP.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_PSP 1
-#endif
-
-#if defined(__PS2__) || defined(PS2)
-
-/**
- * A preprocessor macro that is only defined if compiling for Sony PlayStation
- * 2.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_PS2 1
-#endif
-
-#if defined(__vita__) || defined(__psp2__)
-
-/**
- * A preprocessor macro that is only defined if compiling for Sony Vita.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_VITA 1
-#endif
-
-#ifdef __3DS__
-
-/**
- * A preprocessor macro that is only defined if compiling for Nintendo 3DS.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_PLATFORM_3DS 1
-#endif
-
-#endif /* SDL_platform_defines_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_power.h

@@ -1,106 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-#ifndef SDL_power_h_
-#define SDL_power_h_
-
-/**
- * # CategoryPower
- *
- * SDL power management routines.
- *
- * There is a single function in this category: SDL_GetPowerInfo().
- *
- * This function is useful for games on the go. This allows an app to know if
- * it's running on a draining battery, which can be useful if the app wants to
- * reduce processing, or perhaps framerate, to extend the duration of the
- * battery's charge. Perhaps the app just wants to show a battery meter when
- * fullscreen, or alert the user when the power is getting extremely low, so
- * they can save their game.
- */
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * The basic state for the system's power supply.
- *
- * These are results returned by SDL_GetPowerInfo().
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_PowerState
-{
-    SDL_POWERSTATE_ERROR = -1,   /**< error determining power status */
-    SDL_POWERSTATE_UNKNOWN,      /**< cannot determine power status */
-    SDL_POWERSTATE_ON_BATTERY,   /**< Not plugged in, running on the battery */
-    SDL_POWERSTATE_NO_BATTERY,   /**< Plugged in, no battery available */
-    SDL_POWERSTATE_CHARGING,     /**< Plugged in, charging battery */
-    SDL_POWERSTATE_CHARGED       /**< Plugged in, battery charged */
-} SDL_PowerState;
-
-/**
- * Get the current power supply details.
- *
- * You should never take a battery status as absolute truth. Batteries
- * (especially failing batteries) are delicate hardware, and the values
- * reported here are best estimates based on what that hardware reports. It's
- * not uncommon for older batteries to lose stored power much faster than it
- * reports, or completely drain when reporting it has 20 percent left, etc.
- *
- * Battery status can change at any time; if you are concerned with power
- * state, you should call this function frequently, and perhaps ignore changes
- * until they seem to be stable for a few seconds.
- *
- * It's possible a platform can only report battery percentage or time left
- * but not both.
- *
- * On some platforms, retrieving power supply details might be expensive. If
- * you want to display continuous status you could call this function every
- * minute or so.
- *
- * \param seconds a pointer filled in with the seconds of battery life left,
- *                or NULL to ignore. This will be filled in with -1 if we
- *                can't determine a value or there is no battery.
- * \param percent a pointer filled in with the percentage of battery life
- *                left, between 0 and 100, or NULL to ignore. This will be
- *                filled in with -1 we can't determine a value or there is no
- *                battery.
- * \returns the current battery state or `SDL_POWERSTATE_ERROR` on failure;
- *          call SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_PowerState SDLCALL SDL_GetPowerInfo(int *seconds, int *percent);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_power_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_process.h

@@ -1,430 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryProcess
- *
- * Process control support.
- *
- * These functions provide a cross-platform way to spawn and manage OS-level
- * processes.
- *
- * You can create a new subprocess with SDL_CreateProcess() and optionally
- * read and write to it using SDL_ReadProcess() or SDL_GetProcessInput() and
- * SDL_GetProcessOutput(). If more advanced functionality like chaining input
- * between processes is necessary, you can use
- * SDL_CreateProcessWithProperties().
- *
- * You can get the status of a created process with SDL_WaitProcess(), or
- * terminate the process with SDL_KillProcess().
- *
- * Don't forget to call SDL_DestroyProcess() to clean up, whether the process
- * process was killed, terminated on its own, or is still running!
- */
-
-#ifndef SDL_process_h_
-#define SDL_process_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_iostream.h>
-#include <SDL3/SDL_properties.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * An opaque handle representing a system process.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- */
-typedef struct SDL_Process SDL_Process;
-
-/**
- * Create a new process.
- *
- * The path to the executable is supplied in args[0]. args[1..N] are
- * additional arguments passed on the command line of the new process, and the
- * argument list should be terminated with a NULL, e.g.:
- *
- * ```c
- * const char *args[] = { "myprogram", "argument", NULL };
- * ```
- *
- * Setting pipe_stdio to true is equivalent to setting
- * `SDL_PROP_PROCESS_CREATE_STDIN_NUMBER` and
- * `SDL_PROP_PROCESS_CREATE_STDOUT_NUMBER` to `SDL_PROCESS_STDIO_APP`, and
- * will allow the use of SDL_ReadProcess() or SDL_GetProcessInput() and
- * SDL_GetProcessOutput().
- *
- * See SDL_CreateProcessWithProperties() for more details.
- *
- * \param args the path and arguments for the new process.
- * \param pipe_stdio true to create pipes to the process's standard input and
- *                   from the process's standard output, false for the process
- *                   to have no input and inherit the application's standard
- *                   output.
- * \returns the newly created and running process, or NULL if the process
- *          couldn't be created.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcessWithProperties
- * \sa SDL_GetProcessProperties
- * \sa SDL_ReadProcess
- * \sa SDL_GetProcessInput
- * \sa SDL_GetProcessOutput
- * \sa SDL_KillProcess
- * \sa SDL_WaitProcess
- * \sa SDL_DestroyProcess
- */
-extern SDL_DECLSPEC SDL_Process * SDLCALL SDL_CreateProcess(const char * const *args, bool pipe_stdio);
-
-/**
- * Description of where standard I/O should be directed when creating a
- * process.
- *
- * If a standard I/O stream is set to SDL_PROCESS_STDIO_INHERITED, it will go
- * to the same place as the application's I/O stream. This is the default for
- * standard output and standard error.
- *
- * If a standard I/O stream is set to SDL_PROCESS_STDIO_NULL, it is connected
- * to `NUL:` on Windows and `/dev/null` on POSIX systems. This is the default
- * for standard input.
- *
- * If a standard I/O stream is set to SDL_PROCESS_STDIO_APP, it is connected
- * to a new SDL_IOStream that is available to the application. Standard input
- * will be available as `SDL_PROP_PROCESS_STDIN_POINTER` and allows
- * SDL_GetProcessInput(), standard output will be available as
- * `SDL_PROP_PROCESS_STDOUT_POINTER` and allows SDL_ReadProcess() and
- * SDL_GetProcessOutput(), and standard error will be available as
- * `SDL_PROP_PROCESS_STDERR_POINTER` in the properties for the created
- * process.
- *
- * If a standard I/O stream is set to SDL_PROCESS_STDIO_REDIRECT, it is
- * connected to an existing SDL_IOStream provided by the application. Standard
- * input is provided using `SDL_PROP_PROCESS_CREATE_STDIN_POINTER`, standard
- * output is provided using `SDL_PROP_PROCESS_CREATE_STDOUT_POINTER`, and
- * standard error is provided using `SDL_PROP_PROCESS_CREATE_STDERR_POINTER`
- * in the creation properties. These existing streams should be closed by the
- * application once the new process is created.
- *
- * In order to use an SDL_IOStream with SDL_PROCESS_STDIO_REDIRECT, it must
- * have `SDL_PROP_IOSTREAM_WINDOWS_HANDLE_POINTER` or
- * `SDL_PROP_IOSTREAM_FILE_DESCRIPTOR_NUMBER` set. This is true for streams
- * representing files and process I/O.
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcessWithProperties
- * \sa SDL_GetProcessProperties
- * \sa SDL_ReadProcess
- * \sa SDL_GetProcessInput
- * \sa SDL_GetProcessOutput
- */
-typedef enum SDL_ProcessIO
-{
-    SDL_PROCESS_STDIO_INHERITED,    /**< The I/O stream is inherited from the application. */
-    SDL_PROCESS_STDIO_NULL,         /**< The I/O stream is ignored. */
-    SDL_PROCESS_STDIO_APP,          /**< The I/O stream is connected to a new SDL_IOStream that the application can read or write */
-    SDL_PROCESS_STDIO_REDIRECT      /**< The I/O stream is redirected to an existing SDL_IOStream. */
-} SDL_ProcessIO;
-
-/**
- * Create a new process with the specified properties.
- *
- * These are the supported properties:
- *
- * - `SDL_PROP_PROCESS_CREATE_ARGS_POINTER`: an array of strings containing
- *   the program to run, any arguments, and a NULL pointer, e.g. const char
- *   *args[] = { "myprogram", "argument", NULL }. This is a required property.
- * - `SDL_PROP_PROCESS_CREATE_ENVIRONMENT_POINTER`: an SDL_Environment
- *   pointer. If this property is set, it will be the entire environment for
- *   the process, otherwise the current environment is used.
- * - `SDL_PROP_PROCESS_CREATE_STDIN_NUMBER`: an SDL_ProcessIO value describing
- *   where standard input for the process comes from, defaults to
- *   `SDL_PROCESS_STDIO_NULL`.
- * - `SDL_PROP_PROCESS_CREATE_STDIN_POINTER`: an SDL_IOStream pointer used for
- *   standard input when `SDL_PROP_PROCESS_CREATE_STDIN_NUMBER` is set to
- *   `SDL_PROCESS_STDIO_REDIRECT`.
- * - `SDL_PROP_PROCESS_CREATE_STDOUT_NUMBER`: an SDL_ProcessIO value
- *   describing where standard output for the process goes to, defaults to
- *   `SDL_PROCESS_STDIO_INHERITED`.
- * - `SDL_PROP_PROCESS_CREATE_STDOUT_POINTER`: an SDL_IOStream pointer used
- *   for standard output when `SDL_PROP_PROCESS_CREATE_STDOUT_NUMBER` is set
- *   to `SDL_PROCESS_STDIO_REDIRECT`.
- * - `SDL_PROP_PROCESS_CREATE_STDERR_NUMBER`: an SDL_ProcessIO value
- *   describing where standard error for the process goes to, defaults to
- *   `SDL_PROCESS_STDIO_INHERITED`.
- * - `SDL_PROP_PROCESS_CREATE_STDERR_POINTER`: an SDL_IOStream pointer used
- *   for standard error when `SDL_PROP_PROCESS_CREATE_STDERR_NUMBER` is set to
- *   `SDL_PROCESS_STDIO_REDIRECT`.
- * - `SDL_PROP_PROCESS_CREATE_STDERR_TO_STDOUT_BOOLEAN`: true if the error
- *   output of the process should be redirected into the standard output of
- *   the process. This property has no effect if
- *   `SDL_PROP_PROCESS_CREATE_STDERR_NUMBER` is set.
- * - `SDL_PROP_PROCESS_CREATE_BACKGROUND_BOOLEAN`: true if the process should
- *   run in the background. In this case the default input and output is
- *   `SDL_PROCESS_STDIO_NULL` and the exitcode of the process is not
- *   available, and will always be 0.
- *
- * On POSIX platforms, wait() and waitpid(-1, ...) should not be called, and
- * SIGCHLD should not be ignored or handled because those would prevent SDL
- * from properly tracking the lifetime of the underlying process. You should
- * use SDL_WaitProcess() instead.
- *
- * \param props the properties to use.
- * \returns the newly created and running process, or NULL if the process
- *          couldn't be created.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- * \sa SDL_GetProcessProperties
- * \sa SDL_ReadProcess
- * \sa SDL_GetProcessInput
- * \sa SDL_GetProcessOutput
- * \sa SDL_KillProcess
- * \sa SDL_WaitProcess
- * \sa SDL_DestroyProcess
- */
-extern SDL_DECLSPEC SDL_Process * SDLCALL SDL_CreateProcessWithProperties(SDL_PropertiesID props);
-
-#define SDL_PROP_PROCESS_CREATE_ARGS_POINTER                "SDL.process.create.args"
-#define SDL_PROP_PROCESS_CREATE_ENVIRONMENT_POINTER         "SDL.process.create.environment"
-#define SDL_PROP_PROCESS_CREATE_STDIN_NUMBER                "SDL.process.create.stdin_option"
-#define SDL_PROP_PROCESS_CREATE_STDIN_POINTER               "SDL.process.create.stdin_source"
-#define SDL_PROP_PROCESS_CREATE_STDOUT_NUMBER               "SDL.process.create.stdout_option"
-#define SDL_PROP_PROCESS_CREATE_STDOUT_POINTER              "SDL.process.create.stdout_source"
-#define SDL_PROP_PROCESS_CREATE_STDERR_NUMBER               "SDL.process.create.stderr_option"
-#define SDL_PROP_PROCESS_CREATE_STDERR_POINTER              "SDL.process.create.stderr_source"
-#define SDL_PROP_PROCESS_CREATE_STDERR_TO_STDOUT_BOOLEAN    "SDL.process.create.stderr_to_stdout"
-#define SDL_PROP_PROCESS_CREATE_BACKGROUND_BOOLEAN          "SDL.process.create.background"
-
-/**
- * Get the properties associated with a process.
- *
- * The following read-only properties are provided by SDL:
- *
- * - `SDL_PROP_PROCESS_PID_NUMBER`: the process ID of the process.
- * - `SDL_PROP_PROCESS_STDIN_POINTER`: an SDL_IOStream that can be used to
- *   write input to the process, if it was created with
- *   `SDL_PROP_PROCESS_CREATE_STDIN_NUMBER` set to `SDL_PROCESS_STDIO_APP`.
- * - `SDL_PROP_PROCESS_STDOUT_POINTER`: a non-blocking SDL_IOStream that can
- *   be used to read output from the process, if it was created with
- *   `SDL_PROP_PROCESS_CREATE_STDOUT_NUMBER` set to `SDL_PROCESS_STDIO_APP`.
- * - `SDL_PROP_PROCESS_STDERR_POINTER`: a non-blocking SDL_IOStream that can
- *   be used to read error output from the process, if it was created with
- *   `SDL_PROP_PROCESS_CREATE_STDERR_NUMBER` set to `SDL_PROCESS_STDIO_APP`.
- * - `SDL_PROP_PROCESS_BACKGROUND_BOOLEAN`: true if the process is running in
- *   the background.
- *
- * \param process the process to query.
- * \returns a valid property ID on success or 0 on failure; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- * \sa SDL_CreateProcessWithProperties
- */
-extern SDL_DECLSPEC SDL_PropertiesID SDLCALL SDL_GetProcessProperties(SDL_Process *process);
-
-#define SDL_PROP_PROCESS_PID_NUMBER         "SDL.process.pid"
-#define SDL_PROP_PROCESS_STDIN_POINTER      "SDL.process.stdin"
-#define SDL_PROP_PROCESS_STDOUT_POINTER     "SDL.process.stdout"
-#define SDL_PROP_PROCESS_STDERR_POINTER     "SDL.process.stderr"
-#define SDL_PROP_PROCESS_BACKGROUND_BOOLEAN "SDL.process.background"
-
-/**
- * Read all the output from a process.
- *
- * If a process was created with I/O enabled, you can use this function to
- * read the output. This function blocks until the process is complete,
- * capturing all output, and providing the process exit code.
- *
- * The data is allocated with a zero byte at the end (null terminated) for
- * convenience. This extra byte is not included in the value reported via
- * `datasize`.
- *
- * The data should be freed with SDL_free().
- *
- * \param process The process to read.
- * \param datasize a pointer filled in with the number of bytes read, may be
- *                 NULL.
- * \param exitcode a pointer filled in with the process exit code if the
- *                 process has exited, may be NULL.
- * \returns the data or NULL on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- * \sa SDL_CreateProcessWithProperties
- * \sa SDL_DestroyProcess
- */
-extern SDL_DECLSPEC void * SDLCALL SDL_ReadProcess(SDL_Process *process, size_t *datasize, int *exitcode);
-
-/**
- * Get the SDL_IOStream associated with process standard input.
- *
- * The process must have been created with SDL_CreateProcess() and pipe_stdio
- * set to true, or with SDL_CreateProcessWithProperties() and
- * `SDL_PROP_PROCESS_CREATE_STDIN_NUMBER` set to `SDL_PROCESS_STDIO_APP`.
- *
- * Writing to this stream can return less data than expected if the process
- * hasn't read its input. It may be blocked waiting for its output to be read,
- * if so you may need to call SDL_GetProcessOutput() and read the output in
- * parallel with writing input.
- *
- * \param process The process to get the input stream for.
- * \returns the input stream or NULL on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- * \sa SDL_CreateProcessWithProperties
- * \sa SDL_GetProcessOutput
- */
-extern SDL_DECLSPEC SDL_IOStream * SDLCALL SDL_GetProcessInput(SDL_Process *process);
-
-/**
- * Get the SDL_IOStream associated with process standard output.
- *
- * The process must have been created with SDL_CreateProcess() and pipe_stdio
- * set to true, or with SDL_CreateProcessWithProperties() and
- * `SDL_PROP_PROCESS_CREATE_STDOUT_NUMBER` set to `SDL_PROCESS_STDIO_APP`.
- *
- * Reading from this stream can return 0 with SDL_GetIOStatus() returning
- * SDL_IO_STATUS_NOT_READY if no output is available yet.
- *
- * \param process The process to get the output stream for.
- * \returns the output stream or NULL on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- * \sa SDL_CreateProcessWithProperties
- * \sa SDL_GetProcessInput
- */
-extern SDL_DECLSPEC SDL_IOStream * SDLCALL SDL_GetProcessOutput(SDL_Process *process);
-
-/**
- * Stop a process.
- *
- * \param process The process to stop.
- * \param force true to terminate the process immediately, false to try to
- *              stop the process gracefully. In general you should try to stop
- *              the process gracefully first as terminating a process may
- *              leave it with half-written data or in some other unstable
- *              state.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- * \sa SDL_CreateProcessWithProperties
- * \sa SDL_WaitProcess
- * \sa SDL_DestroyProcess
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_KillProcess(SDL_Process *process, bool force);
-
-/**
- * Wait for a process to finish.
- *
- * This can be called multiple times to get the status of a process.
- *
- * The exit code will be the exit code of the process if it terminates
- * normally, a negative signal if it terminated due to a signal, or -255
- * otherwise. It will not be changed if the process is still running.
- *
- * If you create a process with standard output piped to the application
- * (`pipe_stdio` being true) then you should read all of the process output
- * before calling SDL_WaitProcess(). If you don't do this the process might be
- * blocked indefinitely waiting for output to be read and SDL_WaitProcess()
- * will never return true;
- *
- * \param process The process to wait for.
- * \param block If true, block until the process finishes; otherwise, report
- *              on the process' status.
- * \param exitcode a pointer filled in with the process exit code if the
- *                 process has exited, may be NULL.
- * \returns true if the process exited, false otherwise.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- * \sa SDL_CreateProcessWithProperties
- * \sa SDL_KillProcess
- * \sa SDL_DestroyProcess
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_WaitProcess(SDL_Process *process, bool block, int *exitcode);
-
-/**
- * Destroy a previously created process object.
- *
- * Note that this does not stop the process, just destroys the SDL object used
- * to track it. If you want to stop the process you should use
- * SDL_KillProcess().
- *
- * \param process The process object to destroy.
- *
- * \threadsafety This function is not thread safe.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProcess
- * \sa SDL_CreateProcessWithProperties
- * \sa SDL_KillProcess
- */
-extern SDL_DECLSPEC void SDLCALL SDL_DestroyProcess(SDL_Process *process);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_process_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_properties.h

@@ -1,543 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryProperties
- *
- * A property is a variable that can be created and retrieved by name at
- * runtime.
- *
- * All properties are part of a property group (SDL_PropertiesID). A property
- * group can be created with the SDL_CreateProperties function and destroyed
- * with the SDL_DestroyProperties function.
- *
- * Properties can be added to and retrieved from a property group through the
- * following functions:
- *
- * - SDL_SetPointerProperty and SDL_GetPointerProperty operate on `void*`
- *   pointer types.
- * - SDL_SetStringProperty and SDL_GetStringProperty operate on string types.
- * - SDL_SetNumberProperty and SDL_GetNumberProperty operate on signed 64-bit
- *   integer types.
- * - SDL_SetFloatProperty and SDL_GetFloatProperty operate on floating point
- *   types.
- * - SDL_SetBooleanProperty and SDL_GetBooleanProperty operate on boolean
- *   types.
- *
- * Properties can be removed from a group by using SDL_ClearProperty.
- */
-
-
-#ifndef SDL_properties_h_
-#define SDL_properties_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * SDL properties ID
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_PropertiesID;
-
-/**
- * SDL property type
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_PropertyType
-{
-    SDL_PROPERTY_TYPE_INVALID,
-    SDL_PROPERTY_TYPE_POINTER,
-    SDL_PROPERTY_TYPE_STRING,
-    SDL_PROPERTY_TYPE_NUMBER,
-    SDL_PROPERTY_TYPE_FLOAT,
-    SDL_PROPERTY_TYPE_BOOLEAN
-} SDL_PropertyType;
-
-/**
- * Get the global SDL properties.
- *
- * \returns a valid property ID on success or 0 on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_PropertiesID SDLCALL SDL_GetGlobalProperties(void);
-
-/**
- * Create a group of properties.
- *
- * All properties are automatically destroyed when SDL_Quit() is called.
- *
- * \returns an ID for a new group of properties, or 0 on failure; call
- *          SDL_GetError() for more information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_DestroyProperties
- */
-extern SDL_DECLSPEC SDL_PropertiesID SDLCALL SDL_CreateProperties(void);
-
-/**
- * Copy a group of properties.
- *
- * Copy all the properties from one group of properties to another, with the
- * exception of properties requiring cleanup (set using
- * SDL_SetPointerPropertyWithCleanup()), which will not be copied. Any
- * property that already exists on `dst` will be overwritten.
- *
- * \param src the properties to copy.
- * \param dst the destination properties.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CopyProperties(SDL_PropertiesID src, SDL_PropertiesID dst);
-
-/**
- * Lock a group of properties.
- *
- * Obtain a multi-threaded lock for these properties. Other threads will wait
- * while trying to lock these properties until they are unlocked. Properties
- * must be unlocked before they are destroyed.
- *
- * The lock is automatically taken when setting individual properties, this
- * function is only needed when you want to set several properties atomically
- * or want to guarantee that properties being queried aren't freed in another
- * thread.
- *
- * \param props the properties to lock.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_UnlockProperties
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_LockProperties(SDL_PropertiesID props);
-
-/**
- * Unlock a group of properties.
- *
- * \param props the properties to unlock.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_LockProperties
- */
-extern SDL_DECLSPEC void SDLCALL SDL_UnlockProperties(SDL_PropertiesID props);
-
-/**
- * A callback used to free resources when a property is deleted.
- *
- * This should release any resources associated with `value` that are no
- * longer needed.
- *
- * This callback is set per-property. Different properties in the same group
- * can have different cleanup callbacks.
- *
- * This callback will be called _during_ SDL_SetPointerPropertyWithCleanup if
- * the function fails for any reason.
- *
- * \param userdata an app-defined pointer passed to the callback.
- * \param value the pointer assigned to the property to clean up.
- *
- * \threadsafety This callback may fire without any locks held; if this is a
- *               concern, the app should provide its own locking.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_SetPointerPropertyWithCleanup
- */
-typedef void (SDLCALL *SDL_CleanupPropertyCallback)(void *userdata, void *value);
-
-/**
- * Set a pointer property in a group of properties with a cleanup function
- * that is called when the property is deleted.
- *
- * The cleanup function is also called if setting the property fails for any
- * reason.
- *
- * For simply setting basic data types, like numbers, bools, or strings, use
- * SDL_SetNumberProperty, SDL_SetBooleanProperty, or SDL_SetStringProperty
- * instead, as those functions will handle cleanup on your behalf. This
- * function is only for more complex, custom data.
- *
- * \param props the properties to modify.
- * \param name the name of the property to modify.
- * \param value the new value of the property, or NULL to delete the property.
- * \param cleanup the function to call when this property is deleted, or NULL
- *                if no cleanup is necessary.
- * \param userdata a pointer that is passed to the cleanup function.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPointerProperty
- * \sa SDL_SetPointerProperty
- * \sa SDL_CleanupPropertyCallback
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetPointerPropertyWithCleanup(SDL_PropertiesID props, const char *name, void *value, SDL_CleanupPropertyCallback cleanup, void *userdata);
-
-/**
- * Set a pointer property in a group of properties.
- *
- * \param props the properties to modify.
- * \param name the name of the property to modify.
- * \param value the new value of the property, or NULL to delete the property.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPointerProperty
- * \sa SDL_HasProperty
- * \sa SDL_SetBooleanProperty
- * \sa SDL_SetFloatProperty
- * \sa SDL_SetNumberProperty
- * \sa SDL_SetPointerPropertyWithCleanup
- * \sa SDL_SetStringProperty
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetPointerProperty(SDL_PropertiesID props, const char *name, void *value);
-
-/**
- * Set a string property in a group of properties.
- *
- * This function makes a copy of the string; the caller does not have to
- * preserve the data after this call completes.
- *
- * \param props the properties to modify.
- * \param name the name of the property to modify.
- * \param value the new value of the property, or NULL to delete the property.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetStringProperty
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetStringProperty(SDL_PropertiesID props, const char *name, const char *value);
-
-/**
- * Set an integer property in a group of properties.
- *
- * \param props the properties to modify.
- * \param name the name of the property to modify.
- * \param value the new value of the property.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetNumberProperty
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetNumberProperty(SDL_PropertiesID props, const char *name, Sint64 value);
-
-/**
- * Set a floating point property in a group of properties.
- *
- * \param props the properties to modify.
- * \param name the name of the property to modify.
- * \param value the new value of the property.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetFloatProperty
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetFloatProperty(SDL_PropertiesID props, const char *name, float value);
-
-/**
- * Set a boolean property in a group of properties.
- *
- * \param props the properties to modify.
- * \param name the name of the property to modify.
- * \param value the new value of the property.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetBooleanProperty
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_SetBooleanProperty(SDL_PropertiesID props, const char *name, bool value);
-
-/**
- * Return whether a property exists in a group of properties.
- *
- * \param props the properties to query.
- * \param name the name of the property to query.
- * \returns true if the property exists, or false if it doesn't.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPropertyType
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasProperty(SDL_PropertiesID props, const char *name);
-
-/**
- * Get the type of a property in a group of properties.
- *
- * \param props the properties to query.
- * \param name the name of the property to query.
- * \returns the type of the property, or SDL_PROPERTY_TYPE_INVALID if it is
- *          not set.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasProperty
- */
-extern SDL_DECLSPEC SDL_PropertyType SDLCALL SDL_GetPropertyType(SDL_PropertiesID props, const char *name);
-
-/**
- * Get a pointer property from a group of properties.
- *
- * By convention, the names of properties that SDL exposes on objects will
- * start with "SDL.", and properties that SDL uses internally will start with
- * "SDL.internal.". These should be considered read-only and should not be
- * modified by applications.
- *
- * \param props the properties to query.
- * \param name the name of the property to query.
- * \param default_value the default value of the property.
- * \returns the value of the property, or `default_value` if it is not set or
- *          not a pointer property.
- *
- * \threadsafety It is safe to call this function from any thread, although
- *               the data returned is not protected and could potentially be
- *               freed if you call SDL_SetPointerProperty() or
- *               SDL_ClearProperty() on these properties from another thread.
- *               If you need to avoid this, use SDL_LockProperties() and
- *               SDL_UnlockProperties().
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetBooleanProperty
- * \sa SDL_GetFloatProperty
- * \sa SDL_GetNumberProperty
- * \sa SDL_GetPropertyType
- * \sa SDL_GetStringProperty
- * \sa SDL_HasProperty
- * \sa SDL_SetPointerProperty
- */
-extern SDL_DECLSPEC void * SDLCALL SDL_GetPointerProperty(SDL_PropertiesID props, const char *name, void *default_value);
-
-/**
- * Get a string property from a group of properties.
- *
- * \param props the properties to query.
- * \param name the name of the property to query.
- * \param default_value the default value of the property.
- * \returns the value of the property, or `default_value` if it is not set or
- *          not a string property.
- *
- * \threadsafety It is safe to call this function from any thread, although
- *               the data returned is not protected and could potentially be
- *               freed if you call SDL_SetStringProperty() or
- *               SDL_ClearProperty() on these properties from another thread.
- *               If you need to avoid this, use SDL_LockProperties() and
- *               SDL_UnlockProperties().
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPropertyType
- * \sa SDL_HasProperty
- * \sa SDL_SetStringProperty
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetStringProperty(SDL_PropertiesID props, const char *name, const char *default_value);
-
-/**
- * Get a number property from a group of properties.
- *
- * You can use SDL_GetPropertyType() to query whether the property exists and
- * is a number property.
- *
- * \param props the properties to query.
- * \param name the name of the property to query.
- * \param default_value the default value of the property.
- * \returns the value of the property, or `default_value` if it is not set or
- *          not a number property.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPropertyType
- * \sa SDL_HasProperty
- * \sa SDL_SetNumberProperty
- */
-extern SDL_DECLSPEC Sint64 SDLCALL SDL_GetNumberProperty(SDL_PropertiesID props, const char *name, Sint64 default_value);
-
-/**
- * Get a floating point property from a group of properties.
- *
- * You can use SDL_GetPropertyType() to query whether the property exists and
- * is a floating point property.
- *
- * \param props the properties to query.
- * \param name the name of the property to query.
- * \param default_value the default value of the property.
- * \returns the value of the property, or `default_value` if it is not set or
- *          not a float property.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPropertyType
- * \sa SDL_HasProperty
- * \sa SDL_SetFloatProperty
- */
-extern SDL_DECLSPEC float SDLCALL SDL_GetFloatProperty(SDL_PropertiesID props, const char *name, float default_value);
-
-/**
- * Get a boolean property from a group of properties.
- *
- * You can use SDL_GetPropertyType() to query whether the property exists and
- * is a boolean property.
- *
- * \param props the properties to query.
- * \param name the name of the property to query.
- * \param default_value the default value of the property.
- * \returns the value of the property, or `default_value` if it is not set or
- *          not a boolean property.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetPropertyType
- * \sa SDL_HasProperty
- * \sa SDL_SetBooleanProperty
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetBooleanProperty(SDL_PropertiesID props, const char *name, bool default_value);
-
-/**
- * Clear a property from a group of properties.
- *
- * \param props the properties to modify.
- * \param name the name of the property to clear.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ClearProperty(SDL_PropertiesID props, const char *name);
-
-/**
- * A callback used to enumerate all the properties in a group of properties.
- *
- * This callback is called from SDL_EnumerateProperties(), and is called once
- * per property in the set.
- *
- * \param userdata an app-defined pointer passed to the callback.
- * \param props the SDL_PropertiesID that is being enumerated.
- * \param name the next property name in the enumeration.
- *
- * \threadsafety SDL_EnumerateProperties holds a lock on `props` during this
- *               callback.
- *
- * \since This datatype is available since SDL 3.2.0.
- *
- * \sa SDL_EnumerateProperties
- */
-typedef void (SDLCALL *SDL_EnumeratePropertiesCallback)(void *userdata, SDL_PropertiesID props, const char *name);
-
-/**
- * Enumerate the properties contained in a group of properties.
- *
- * The callback function is called for each property in the group of
- * properties. The properties are locked during enumeration.
- *
- * \param props the properties to query.
- * \param callback the function to call for each property.
- * \param userdata a pointer that is passed to `callback`.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_EnumerateProperties(SDL_PropertiesID props, SDL_EnumeratePropertiesCallback callback, void *userdata);
-
-/**
- * Destroy a group of properties.
- *
- * All properties are deleted and their cleanup functions will be called, if
- * any.
- *
- * \param props the properties to destroy.
- *
- * \threadsafety This function should not be called while these properties are
- *               locked or other threads might be setting or getting values
- *               from these properties.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CreateProperties
- */
-extern SDL_DECLSPEC void SDLCALL SDL_DestroyProperties(SDL_PropertiesID props);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_properties_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_rect.h

@@ -1,507 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryRect
- *
- * Some helper functions for managing rectangles and 2D points, in both
- * integer and floating point versions.
- */
-
-#ifndef SDL_rect_h_
-#define SDL_rect_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * The structure that defines a point (using integers).
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_GetRectEnclosingPoints
- * \sa SDL_PointInRect
- */
-typedef struct SDL_Point
-{
-    int x;
-    int y;
-} SDL_Point;
-
-/**
- * The structure that defines a point (using floating point values).
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_GetRectEnclosingPointsFloat
- * \sa SDL_PointInRectFloat
- */
-typedef struct SDL_FPoint
-{
-    float x;
-    float y;
-} SDL_FPoint;
-
-
-/**
- * A rectangle, with the origin at the upper left (using integers).
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_RectEmpty
- * \sa SDL_RectsEqual
- * \sa SDL_HasRectIntersection
- * \sa SDL_GetRectIntersection
- * \sa SDL_GetRectAndLineIntersection
- * \sa SDL_GetRectUnion
- * \sa SDL_GetRectEnclosingPoints
- */
-typedef struct SDL_Rect
-{
-    int x, y;
-    int w, h;
-} SDL_Rect;
-
-
-/**
- * A rectangle, with the origin at the upper left (using floating point
- * values).
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_RectEmptyFloat
- * \sa SDL_RectsEqualFloat
- * \sa SDL_RectsEqualEpsilon
- * \sa SDL_HasRectIntersectionFloat
- * \sa SDL_GetRectIntersectionFloat
- * \sa SDL_GetRectAndLineIntersectionFloat
- * \sa SDL_GetRectUnionFloat
- * \sa SDL_GetRectEnclosingPointsFloat
- * \sa SDL_PointInRectFloat
- */
-typedef struct SDL_FRect
-{
-    float x;
-    float y;
-    float w;
-    float h;
-} SDL_FRect;
-
-
-/**
- * Convert an SDL_Rect to SDL_FRect
- *
- * \param rect a pointer to an SDL_Rect.
- * \param frect a pointer filled in with the floating point representation of
- *              `rect`.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE void SDL_RectToFRect(const SDL_Rect *rect, SDL_FRect *frect)
-{
-    frect->x = SDL_static_cast(float, rect->x);
-    frect->y = SDL_static_cast(float, rect->y);
-    frect->w = SDL_static_cast(float, rect->w);
-    frect->h = SDL_static_cast(float, rect->h);
-}
-
-/**
- * Determine whether a point resides inside a rectangle.
- *
- * A point is considered part of a rectangle if both `p` and `r` are not NULL,
- * and `p`'s x and y coordinates are >= to the rectangle's top left corner,
- * and < the rectangle's x+w and y+h. So a 1x1 rectangle considers point (0,0)
- * as "inside" and (0,1) as not.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param p the point to test.
- * \param r the rectangle to test.
- * \returns true if `p` is contained by `r`, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE bool SDL_PointInRect(const SDL_Point *p, const SDL_Rect *r)
-{
-    return ( p && r && (p->x >= r->x) && (p->x < (r->x + r->w)) &&
-             (p->y >= r->y) && (p->y < (r->y + r->h)) ) ? true : false;
-}
-
-/**
- * Determine whether a rectangle has no area.
- *
- * A rectangle is considered "empty" for this function if `r` is NULL, or if
- * `r`'s width and/or height are <= 0.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param r the rectangle to test.
- * \returns true if the rectangle is "empty", false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE bool SDL_RectEmpty(const SDL_Rect *r)
-{
-    return ((!r) || (r->w <= 0) || (r->h <= 0)) ? true : false;
-}
-
-/**
- * Determine whether two rectangles are equal.
- *
- * Rectangles are considered equal if both are not NULL and each of their x,
- * y, width and height match.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param a the first rectangle to test.
- * \param b the second rectangle to test.
- * \returns true if the rectangles are equal, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE bool SDL_RectsEqual(const SDL_Rect *a, const SDL_Rect *b)
-{
-    return (a && b && (a->x == b->x) && (a->y == b->y) &&
-            (a->w == b->w) && (a->h == b->h)) ? true : false;
-}
-
-/**
- * Determine whether two rectangles intersect.
- *
- * If either pointer is NULL the function will return false.
- *
- * \param A an SDL_Rect structure representing the first rectangle.
- * \param B an SDL_Rect structure representing the second rectangle.
- * \returns true if there is an intersection, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetRectIntersection
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasRectIntersection(const SDL_Rect *A, const SDL_Rect *B);
-
-/**
- * Calculate the intersection of two rectangles.
- *
- * If `result` is NULL then this function will return false.
- *
- * \param A an SDL_Rect structure representing the first rectangle.
- * \param B an SDL_Rect structure representing the second rectangle.
- * \param result an SDL_Rect structure filled in with the intersection of
- *               rectangles `A` and `B`.
- * \returns true if there is an intersection, false otherwise.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasRectIntersection
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetRectIntersection(const SDL_Rect *A, const SDL_Rect *B, SDL_Rect *result);
-
-/**
- * Calculate the union of two rectangles.
- *
- * \param A an SDL_Rect structure representing the first rectangle.
- * \param B an SDL_Rect structure representing the second rectangle.
- * \param result an SDL_Rect structure filled in with the union of rectangles
- *               `A` and `B`.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetRectUnion(const SDL_Rect *A, const SDL_Rect *B, SDL_Rect *result);
-
-/**
- * Calculate a minimal rectangle enclosing a set of points.
- *
- * If `clip` is not NULL then only points inside of the clipping rectangle are
- * considered.
- *
- * \param points an array of SDL_Point structures representing points to be
- *               enclosed.
- * \param count the number of structures in the `points` array.
- * \param clip an SDL_Rect used for clipping or NULL to enclose all points.
- * \param result an SDL_Rect structure filled in with the minimal enclosing
- *               rectangle.
- * \returns true if any points were enclosed or false if all the points were
- *          outside of the clipping rectangle.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetRectEnclosingPoints(const SDL_Point *points, int count, const SDL_Rect *clip, SDL_Rect *result);
-
-/**
- * Calculate the intersection of a rectangle and line segment.
- *
- * This function is used to clip a line segment to a rectangle. A line segment
- * contained entirely within the rectangle or that does not intersect will
- * remain unchanged. A line segment that crosses the rectangle at either or
- * both ends will be clipped to the boundary of the rectangle and the new
- * coordinates saved in `X1`, `Y1`, `X2`, and/or `Y2` as necessary.
- *
- * \param rect an SDL_Rect structure representing the rectangle to intersect.
- * \param X1 a pointer to the starting X-coordinate of the line.
- * \param Y1 a pointer to the starting Y-coordinate of the line.
- * \param X2 a pointer to the ending X-coordinate of the line.
- * \param Y2 a pointer to the ending Y-coordinate of the line.
- * \returns true if there is an intersection, false otherwise.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetRectAndLineIntersection(const SDL_Rect *rect, int *X1, int *Y1, int *X2, int *Y2);
-
-
-/* SDL_FRect versions... */
-
-/**
- * Determine whether a point resides inside a floating point rectangle.
- *
- * A point is considered part of a rectangle if both `p` and `r` are not NULL,
- * and `p`'s x and y coordinates are >= to the rectangle's top left corner,
- * and <= the rectangle's x+w and y+h. So a 1x1 rectangle considers point
- * (0,0) and (0,1) as "inside" and (0,2) as not.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param p the point to test.
- * \param r the rectangle to test.
- * \returns true if `p` is contained by `r`, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE bool SDL_PointInRectFloat(const SDL_FPoint *p, const SDL_FRect *r)
-{
-    return ( p && r && (p->x >= r->x) && (p->x <= (r->x + r->w)) &&
-             (p->y >= r->y) && (p->y <= (r->y + r->h)) ) ? true : false;
-}
-
-/**
- * Determine whether a floating point rectangle can contain any point.
- *
- * A rectangle is considered "empty" for this function if `r` is NULL, or if
- * `r`'s width and/or height are < 0.0f.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param r the rectangle to test.
- * \returns true if the rectangle is "empty", false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- */
-SDL_FORCE_INLINE bool SDL_RectEmptyFloat(const SDL_FRect *r)
-{
-    return ((!r) || (r->w < 0.0f) || (r->h < 0.0f)) ? true : false;
-}
-
-/**
- * Determine whether two floating point rectangles are equal, within some
- * given epsilon.
- *
- * Rectangles are considered equal if both are not NULL and each of their x,
- * y, width and height are within `epsilon` of each other. If you don't know
- * what value to use for `epsilon`, you should call the SDL_RectsEqualFloat
- * function instead.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param a the first rectangle to test.
- * \param b the second rectangle to test.
- * \param epsilon the epsilon value for comparison.
- * \returns true if the rectangles are equal, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_RectsEqualFloat
- */
-SDL_FORCE_INLINE bool SDL_RectsEqualEpsilon(const SDL_FRect *a, const SDL_FRect *b, float epsilon)
-{
-    return (a && b && ((a == b) ||
-            ((SDL_fabsf(a->x - b->x) <= epsilon) &&
-            (SDL_fabsf(a->y - b->y) <= epsilon) &&
-            (SDL_fabsf(a->w - b->w) <= epsilon) &&
-            (SDL_fabsf(a->h - b->h) <= epsilon))))
-            ? true : false;
-}
-
-/**
- * Determine whether two floating point rectangles are equal, within a default
- * epsilon.
- *
- * Rectangles are considered equal if both are not NULL and each of their x,
- * y, width and height are within SDL_FLT_EPSILON of each other. This is often
- * a reasonable way to compare two floating point rectangles and deal with the
- * slight precision variations in floating point calculations that tend to pop
- * up.
- *
- * Note that this is a forced-inline function in a header, and not a public
- * API function available in the SDL library (which is to say, the code is
- * embedded in the calling program and the linker and dynamic loader will not
- * be able to find this function inside SDL itself).
- *
- * \param a the first rectangle to test.
- * \param b the second rectangle to test.
- * \returns true if the rectangles are equal, false otherwise.
- *
- * \threadsafety It is safe to call this function from any thread.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_RectsEqualEpsilon
- */
-SDL_FORCE_INLINE bool SDL_RectsEqualFloat(const SDL_FRect *a, const SDL_FRect *b)
-{
-    return SDL_RectsEqualEpsilon(a, b, SDL_FLT_EPSILON);
-}
-
-/**
- * Determine whether two rectangles intersect with float precision.
- *
- * If either pointer is NULL the function will return false.
- *
- * \param A an SDL_FRect structure representing the first rectangle.
- * \param B an SDL_FRect structure representing the second rectangle.
- * \returns true if there is an intersection, false otherwise.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetRectIntersection
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_HasRectIntersectionFloat(const SDL_FRect *A, const SDL_FRect *B);
-
-/**
- * Calculate the intersection of two rectangles with float precision.
- *
- * If `result` is NULL then this function will return false.
- *
- * \param A an SDL_FRect structure representing the first rectangle.
- * \param B an SDL_FRect structure representing the second rectangle.
- * \param result an SDL_FRect structure filled in with the intersection of
- *               rectangles `A` and `B`.
- * \returns true if there is an intersection, false otherwise.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_HasRectIntersectionFloat
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetRectIntersectionFloat(const SDL_FRect *A, const SDL_FRect *B, SDL_FRect *result);
-
-/**
- * Calculate the union of two rectangles with float precision.
- *
- * \param A an SDL_FRect structure representing the first rectangle.
- * \param B an SDL_FRect structure representing the second rectangle.
- * \param result an SDL_FRect structure filled in with the union of rectangles
- *               `A` and `B`.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetRectUnionFloat(const SDL_FRect *A, const SDL_FRect *B, SDL_FRect *result);
-
-/**
- * Calculate a minimal rectangle enclosing a set of points with float
- * precision.
- *
- * If `clip` is not NULL then only points inside of the clipping rectangle are
- * considered.
- *
- * \param points an array of SDL_FPoint structures representing points to be
- *               enclosed.
- * \param count the number of structures in the `points` array.
- * \param clip an SDL_FRect used for clipping or NULL to enclose all points.
- * \param result an SDL_FRect structure filled in with the minimal enclosing
- *               rectangle.
- * \returns true if any points were enclosed or false if all the points were
- *          outside of the clipping rectangle.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetRectEnclosingPointsFloat(const SDL_FPoint *points, int count, const SDL_FRect *clip, SDL_FRect *result);
-
-/**
- * Calculate the intersection of a rectangle and line segment with float
- * precision.
- *
- * This function is used to clip a line segment to a rectangle. A line segment
- * contained entirely within the rectangle or that does not intersect will
- * remain unchanged. A line segment that crosses the rectangle at either or
- * both ends will be clipped to the boundary of the rectangle and the new
- * coordinates saved in `X1`, `Y1`, `X2`, and/or `Y2` as necessary.
- *
- * \param rect an SDL_FRect structure representing the rectangle to intersect.
- * \param X1 a pointer to the starting X-coordinate of the line.
- * \param Y1 a pointer to the starting Y-coordinate of the line.
- * \param X2 a pointer to the ending X-coordinate of the line.
- * \param Y2 a pointer to the ending Y-coordinate of the line.
- * \returns true if there is an intersection, false otherwise.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetRectAndLineIntersectionFloat(const SDL_FRect *rect, float *X1, float *Y1, float *X2, float *Y2);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_rect_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_revision.h

@@ -1,56 +0,0 @@
-/*
- Simple DirectMedia Layer
- 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
- arising from the use of this software.
-
- Permission is granted to anyone to use this software for any purpose,
- including commercial applications, and to alter it and redistribute it
- freely, subject to the following restrictions:
-
- 1. The origin of this software must not be misrepresented; you must not
-    claim that you wrote the original software. If you use this software
-    in a product, an acknowledgment in the product documentation would be
-    appreciated but is not required.
- 2. Altered source versions must be plainly marked as such, and must not be
-    misrepresented as being the original software.
- 3. This notice may not be removed or altered from any source distribution.
-*/
-
-/* WIKI CATEGORY: Version */
-
-/*
- * SDL_revision.h contains the SDL revision, which might be defined on the
- * compiler command line, or generated right into the header itself by the
- * build system.
- */
-
-#ifndef SDL_revision_h_
-#define SDL_revision_h_
-
-#ifdef SDL_WIKI_DOCUMENTATION_SECTION
-
-/**
- * This macro is a string describing the source at a particular point in
- * development.
- *
- * This string is often generated from revision control's state at build time.
- *
- * This string can be quite complex and does not follow any standard. For
- * example, it might be something like "SDL-prerelease-3.1.1-47-gf687e0732".
- * It might also be user-defined at build time, so it's best to treat it as a
- * clue in debugging forensics and not something the app will parse in any
- * way.
- *
- * \since This macro is available since SDL 3.0.0.
- */
-#define SDL_REVISION "Some arbitrary string decided at SDL build time"
-#elif defined(SDL_VENDOR_INFO)
-#define SDL_REVISION "release-3.2.26-0-gbadbf8da4 (" SDL_VENDOR_INFO ")"
-#else
-#define SDL_REVISION "release-3.2.26-0-gbadbf8da4"
-#endif
-
-#endif /* SDL_revision_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_scancode.h

@@ -1,429 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryScancode
- *
- * Defines keyboard scancodes.
- *
- * Please refer to the Best Keyboard Practices document for details on what
- * this information means and how best to use it.
- *
- * https://wiki.libsdl.org/SDL3/BestKeyboardPractices
- */
-
-#ifndef SDL_scancode_h_
-#define SDL_scancode_h_
-
-#include <SDL3/SDL_stdinc.h>
-
-/**
- * The SDL keyboard scancode representation.
- *
- * An SDL scancode is the physical representation of a key on the keyboard,
- * independent of language and keyboard mapping.
- *
- * Values of this type are used to represent keyboard keys, among other places
- * in the `scancode` field of the SDL_KeyboardEvent structure.
- *
- * The values in this enumeration are based on the USB usage page standard:
- * https://usb.org/sites/default/files/hut1_5.pdf
- *
- * \since This enum is available since SDL 3.2.0.
- */
-typedef enum SDL_Scancode
-{
-    SDL_SCANCODE_UNKNOWN = 0,
-
-    /**
-     *  \name Usage page 0x07
-     *
-     *  These values are from usage page 0x07 (USB keyboard page).
-     */
-    /* @{ */
-
-    SDL_SCANCODE_A = 4,
-    SDL_SCANCODE_B = 5,
-    SDL_SCANCODE_C = 6,
-    SDL_SCANCODE_D = 7,
-    SDL_SCANCODE_E = 8,
-    SDL_SCANCODE_F = 9,
-    SDL_SCANCODE_G = 10,
-    SDL_SCANCODE_H = 11,
-    SDL_SCANCODE_I = 12,
-    SDL_SCANCODE_J = 13,
-    SDL_SCANCODE_K = 14,
-    SDL_SCANCODE_L = 15,
-    SDL_SCANCODE_M = 16,
-    SDL_SCANCODE_N = 17,
-    SDL_SCANCODE_O = 18,
-    SDL_SCANCODE_P = 19,
-    SDL_SCANCODE_Q = 20,
-    SDL_SCANCODE_R = 21,
-    SDL_SCANCODE_S = 22,
-    SDL_SCANCODE_T = 23,
-    SDL_SCANCODE_U = 24,
-    SDL_SCANCODE_V = 25,
-    SDL_SCANCODE_W = 26,
-    SDL_SCANCODE_X = 27,
-    SDL_SCANCODE_Y = 28,
-    SDL_SCANCODE_Z = 29,
-
-    SDL_SCANCODE_1 = 30,
-    SDL_SCANCODE_2 = 31,
-    SDL_SCANCODE_3 = 32,
-    SDL_SCANCODE_4 = 33,
-    SDL_SCANCODE_5 = 34,
-    SDL_SCANCODE_6 = 35,
-    SDL_SCANCODE_7 = 36,
-    SDL_SCANCODE_8 = 37,
-    SDL_SCANCODE_9 = 38,
-    SDL_SCANCODE_0 = 39,
-
-    SDL_SCANCODE_RETURN = 40,
-    SDL_SCANCODE_ESCAPE = 41,
-    SDL_SCANCODE_BACKSPACE = 42,
-    SDL_SCANCODE_TAB = 43,
-    SDL_SCANCODE_SPACE = 44,
-
-    SDL_SCANCODE_MINUS = 45,
-    SDL_SCANCODE_EQUALS = 46,
-    SDL_SCANCODE_LEFTBRACKET = 47,
-    SDL_SCANCODE_RIGHTBRACKET = 48,
-    SDL_SCANCODE_BACKSLASH = 49, /**< Located at the lower left of the return
-                                  *   key on ISO keyboards and at the right end
-                                  *   of the QWERTY row on ANSI keyboards.
-                                  *   Produces REVERSE SOLIDUS (backslash) and
-                                  *   VERTICAL LINE in a US layout, REVERSE
-                                  *   SOLIDUS and VERTICAL LINE in a UK Mac
-                                  *   layout, NUMBER SIGN and TILDE in a UK
-                                  *   Windows layout, DOLLAR SIGN and POUND SIGN
-                                  *   in a Swiss German layout, NUMBER SIGN and
-                                  *   APOSTROPHE in a German layout, GRAVE
-                                  *   ACCENT and POUND SIGN in a French Mac
-                                  *   layout, and ASTERISK and MICRO SIGN in a
-                                  *   French Windows layout.
-                                  */
-    SDL_SCANCODE_NONUSHASH = 50, /**< ISO USB keyboards actually use this code
-                                  *   instead of 49 for the same key, but all
-                                  *   OSes I've seen treat the two codes
-                                  *   identically. So, as an implementor, unless
-                                  *   your keyboard generates both of those
-                                  *   codes and your OS treats them differently,
-                                  *   you should generate SDL_SCANCODE_BACKSLASH
-                                  *   instead of this code. As a user, you
-                                  *   should not rely on this code because SDL
-                                  *   will never generate it with most (all?)
-                                  *   keyboards.
-                                  */
-    SDL_SCANCODE_SEMICOLON = 51,
-    SDL_SCANCODE_APOSTROPHE = 52,
-    SDL_SCANCODE_GRAVE = 53, /**< Located in the top left corner (on both ANSI
-                              *   and ISO keyboards). Produces GRAVE ACCENT and
-                              *   TILDE in a US Windows layout and in US and UK
-                              *   Mac layouts on ANSI keyboards, GRAVE ACCENT
-                              *   and NOT SIGN in a UK Windows layout, SECTION
-                              *   SIGN and PLUS-MINUS SIGN in US and UK Mac
-                              *   layouts on ISO keyboards, SECTION SIGN and
-                              *   DEGREE SIGN in a Swiss German layout (Mac:
-                              *   only on ISO keyboards), CIRCUMFLEX ACCENT and
-                              *   DEGREE SIGN in a German layout (Mac: only on
-                              *   ISO keyboards), SUPERSCRIPT TWO and TILDE in a
-                              *   French Windows layout, COMMERCIAL AT and
-                              *   NUMBER SIGN in a French Mac layout on ISO
-                              *   keyboards, and LESS-THAN SIGN and GREATER-THAN
-                              *   SIGN in a Swiss German, German, or French Mac
-                              *   layout on ANSI keyboards.
-                              */
-    SDL_SCANCODE_COMMA = 54,
-    SDL_SCANCODE_PERIOD = 55,
-    SDL_SCANCODE_SLASH = 56,
-
-    SDL_SCANCODE_CAPSLOCK = 57,
-
-    SDL_SCANCODE_F1 = 58,
-    SDL_SCANCODE_F2 = 59,
-    SDL_SCANCODE_F3 = 60,
-    SDL_SCANCODE_F4 = 61,
-    SDL_SCANCODE_F5 = 62,
-    SDL_SCANCODE_F6 = 63,
-    SDL_SCANCODE_F7 = 64,
-    SDL_SCANCODE_F8 = 65,
-    SDL_SCANCODE_F9 = 66,
-    SDL_SCANCODE_F10 = 67,
-    SDL_SCANCODE_F11 = 68,
-    SDL_SCANCODE_F12 = 69,
-
-    SDL_SCANCODE_PRINTSCREEN = 70,
-    SDL_SCANCODE_SCROLLLOCK = 71,
-    SDL_SCANCODE_PAUSE = 72,
-    SDL_SCANCODE_INSERT = 73, /**< insert on PC, help on some Mac keyboards (but
-                                   does send code 73, not 117) */
-    SDL_SCANCODE_HOME = 74,
-    SDL_SCANCODE_PAGEUP = 75,
-    SDL_SCANCODE_DELETE = 76,
-    SDL_SCANCODE_END = 77,
-    SDL_SCANCODE_PAGEDOWN = 78,
-    SDL_SCANCODE_RIGHT = 79,
-    SDL_SCANCODE_LEFT = 80,
-    SDL_SCANCODE_DOWN = 81,
-    SDL_SCANCODE_UP = 82,
-
-    SDL_SCANCODE_NUMLOCKCLEAR = 83, /**< num lock on PC, clear on Mac keyboards
-                                     */
-    SDL_SCANCODE_KP_DIVIDE = 84,
-    SDL_SCANCODE_KP_MULTIPLY = 85,
-    SDL_SCANCODE_KP_MINUS = 86,
-    SDL_SCANCODE_KP_PLUS = 87,
-    SDL_SCANCODE_KP_ENTER = 88,
-    SDL_SCANCODE_KP_1 = 89,
-    SDL_SCANCODE_KP_2 = 90,
-    SDL_SCANCODE_KP_3 = 91,
-    SDL_SCANCODE_KP_4 = 92,
-    SDL_SCANCODE_KP_5 = 93,
-    SDL_SCANCODE_KP_6 = 94,
-    SDL_SCANCODE_KP_7 = 95,
-    SDL_SCANCODE_KP_8 = 96,
-    SDL_SCANCODE_KP_9 = 97,
-    SDL_SCANCODE_KP_0 = 98,
-    SDL_SCANCODE_KP_PERIOD = 99,
-
-    SDL_SCANCODE_NONUSBACKSLASH = 100, /**< This is the additional key that ISO
-                                        *   keyboards have over ANSI ones,
-                                        *   located between left shift and Z.
-                                        *   Produces GRAVE ACCENT and TILDE in a
-                                        *   US or UK Mac layout, REVERSE SOLIDUS
-                                        *   (backslash) and VERTICAL LINE in a
-                                        *   US or UK Windows layout, and
-                                        *   LESS-THAN SIGN and GREATER-THAN SIGN
-                                        *   in a Swiss German, German, or French
-                                        *   layout. */
-    SDL_SCANCODE_APPLICATION = 101, /**< windows contextual menu, compose */
-    SDL_SCANCODE_POWER = 102, /**< The USB document says this is a status flag,
-                               *   not a physical key - but some Mac keyboards
-                               *   do have a power key. */
-    SDL_SCANCODE_KP_EQUALS = 103,
-    SDL_SCANCODE_F13 = 104,
-    SDL_SCANCODE_F14 = 105,
-    SDL_SCANCODE_F15 = 106,
-    SDL_SCANCODE_F16 = 107,
-    SDL_SCANCODE_F17 = 108,
-    SDL_SCANCODE_F18 = 109,
-    SDL_SCANCODE_F19 = 110,
-    SDL_SCANCODE_F20 = 111,
-    SDL_SCANCODE_F21 = 112,
-    SDL_SCANCODE_F22 = 113,
-    SDL_SCANCODE_F23 = 114,
-    SDL_SCANCODE_F24 = 115,
-    SDL_SCANCODE_EXECUTE = 116,
-    SDL_SCANCODE_HELP = 117,    /**< AL Integrated Help Center */
-    SDL_SCANCODE_MENU = 118,    /**< Menu (show menu) */
-    SDL_SCANCODE_SELECT = 119,
-    SDL_SCANCODE_STOP = 120,    /**< AC Stop */
-    SDL_SCANCODE_AGAIN = 121,   /**< AC Redo/Repeat */
-    SDL_SCANCODE_UNDO = 122,    /**< AC Undo */
-    SDL_SCANCODE_CUT = 123,     /**< AC Cut */
-    SDL_SCANCODE_COPY = 124,    /**< AC Copy */
-    SDL_SCANCODE_PASTE = 125,   /**< AC Paste */
-    SDL_SCANCODE_FIND = 126,    /**< AC Find */
-    SDL_SCANCODE_MUTE = 127,
-    SDL_SCANCODE_VOLUMEUP = 128,
-    SDL_SCANCODE_VOLUMEDOWN = 129,
-/* not sure whether there's a reason to enable these */
-/*     SDL_SCANCODE_LOCKINGCAPSLOCK = 130,  */
-/*     SDL_SCANCODE_LOCKINGNUMLOCK = 131, */
-/*     SDL_SCANCODE_LOCKINGSCROLLLOCK = 132, */
-    SDL_SCANCODE_KP_COMMA = 133,
-    SDL_SCANCODE_KP_EQUALSAS400 = 134,
-
-    SDL_SCANCODE_INTERNATIONAL1 = 135, /**< used on Asian keyboards, see
-                                            footnotes in USB doc */
-    SDL_SCANCODE_INTERNATIONAL2 = 136,
-    SDL_SCANCODE_INTERNATIONAL3 = 137, /**< Yen */
-    SDL_SCANCODE_INTERNATIONAL4 = 138,
-    SDL_SCANCODE_INTERNATIONAL5 = 139,
-    SDL_SCANCODE_INTERNATIONAL6 = 140,
-    SDL_SCANCODE_INTERNATIONAL7 = 141,
-    SDL_SCANCODE_INTERNATIONAL8 = 142,
-    SDL_SCANCODE_INTERNATIONAL9 = 143,
-    SDL_SCANCODE_LANG1 = 144, /**< Hangul/English toggle */
-    SDL_SCANCODE_LANG2 = 145, /**< Hanja conversion */
-    SDL_SCANCODE_LANG3 = 146, /**< Katakana */
-    SDL_SCANCODE_LANG4 = 147, /**< Hiragana */
-    SDL_SCANCODE_LANG5 = 148, /**< Zenkaku/Hankaku */
-    SDL_SCANCODE_LANG6 = 149, /**< reserved */
-    SDL_SCANCODE_LANG7 = 150, /**< reserved */
-    SDL_SCANCODE_LANG8 = 151, /**< reserved */
-    SDL_SCANCODE_LANG9 = 152, /**< reserved */
-
-    SDL_SCANCODE_ALTERASE = 153,    /**< Erase-Eaze */
-    SDL_SCANCODE_SYSREQ = 154,
-    SDL_SCANCODE_CANCEL = 155,      /**< AC Cancel */
-    SDL_SCANCODE_CLEAR = 156,
-    SDL_SCANCODE_PRIOR = 157,
-    SDL_SCANCODE_RETURN2 = 158,
-    SDL_SCANCODE_SEPARATOR = 159,
-    SDL_SCANCODE_OUT = 160,
-    SDL_SCANCODE_OPER = 161,
-    SDL_SCANCODE_CLEARAGAIN = 162,
-    SDL_SCANCODE_CRSEL = 163,
-    SDL_SCANCODE_EXSEL = 164,
-
-    SDL_SCANCODE_KP_00 = 176,
-    SDL_SCANCODE_KP_000 = 177,
-    SDL_SCANCODE_THOUSANDSSEPARATOR = 178,
-    SDL_SCANCODE_DECIMALSEPARATOR = 179,
-    SDL_SCANCODE_CURRENCYUNIT = 180,
-    SDL_SCANCODE_CURRENCYSUBUNIT = 181,
-    SDL_SCANCODE_KP_LEFTPAREN = 182,
-    SDL_SCANCODE_KP_RIGHTPAREN = 183,
-    SDL_SCANCODE_KP_LEFTBRACE = 184,
-    SDL_SCANCODE_KP_RIGHTBRACE = 185,
-    SDL_SCANCODE_KP_TAB = 186,
-    SDL_SCANCODE_KP_BACKSPACE = 187,
-    SDL_SCANCODE_KP_A = 188,
-    SDL_SCANCODE_KP_B = 189,
-    SDL_SCANCODE_KP_C = 190,
-    SDL_SCANCODE_KP_D = 191,
-    SDL_SCANCODE_KP_E = 192,
-    SDL_SCANCODE_KP_F = 193,
-    SDL_SCANCODE_KP_XOR = 194,
-    SDL_SCANCODE_KP_POWER = 195,
-    SDL_SCANCODE_KP_PERCENT = 196,
-    SDL_SCANCODE_KP_LESS = 197,
-    SDL_SCANCODE_KP_GREATER = 198,
-    SDL_SCANCODE_KP_AMPERSAND = 199,
-    SDL_SCANCODE_KP_DBLAMPERSAND = 200,
-    SDL_SCANCODE_KP_VERTICALBAR = 201,
-    SDL_SCANCODE_KP_DBLVERTICALBAR = 202,
-    SDL_SCANCODE_KP_COLON = 203,
-    SDL_SCANCODE_KP_HASH = 204,
-    SDL_SCANCODE_KP_SPACE = 205,
-    SDL_SCANCODE_KP_AT = 206,
-    SDL_SCANCODE_KP_EXCLAM = 207,
-    SDL_SCANCODE_KP_MEMSTORE = 208,
-    SDL_SCANCODE_KP_MEMRECALL = 209,
-    SDL_SCANCODE_KP_MEMCLEAR = 210,
-    SDL_SCANCODE_KP_MEMADD = 211,
-    SDL_SCANCODE_KP_MEMSUBTRACT = 212,
-    SDL_SCANCODE_KP_MEMMULTIPLY = 213,
-    SDL_SCANCODE_KP_MEMDIVIDE = 214,
-    SDL_SCANCODE_KP_PLUSMINUS = 215,
-    SDL_SCANCODE_KP_CLEAR = 216,
-    SDL_SCANCODE_KP_CLEARENTRY = 217,
-    SDL_SCANCODE_KP_BINARY = 218,
-    SDL_SCANCODE_KP_OCTAL = 219,
-    SDL_SCANCODE_KP_DECIMAL = 220,
-    SDL_SCANCODE_KP_HEXADECIMAL = 221,
-
-    SDL_SCANCODE_LCTRL = 224,
-    SDL_SCANCODE_LSHIFT = 225,
-    SDL_SCANCODE_LALT = 226, /**< alt, option */
-    SDL_SCANCODE_LGUI = 227, /**< windows, command (apple), meta */
-    SDL_SCANCODE_RCTRL = 228,
-    SDL_SCANCODE_RSHIFT = 229,
-    SDL_SCANCODE_RALT = 230, /**< alt gr, option */
-    SDL_SCANCODE_RGUI = 231, /**< windows, command (apple), meta */
-
-    SDL_SCANCODE_MODE = 257,    /**< I'm not sure if this is really not covered
-                                 *   by any of the above, but since there's a
-                                 *   special SDL_KMOD_MODE for it I'm adding it here
-                                 */
-
-    /* @} *//* Usage page 0x07 */
-
-    /**
-     *  \name Usage page 0x0C
-     *
-     *  These values are mapped from usage page 0x0C (USB consumer page).
-     *
-     *  There are way more keys in the spec than we can represent in the
-     *  current scancode range, so pick the ones that commonly come up in
-     *  real world usage.
-     */
-    /* @{ */
-
-    SDL_SCANCODE_SLEEP = 258,                   /**< Sleep */
-    SDL_SCANCODE_WAKE = 259,                    /**< Wake */
-
-    SDL_SCANCODE_CHANNEL_INCREMENT = 260,       /**< Channel Increment */
-    SDL_SCANCODE_CHANNEL_DECREMENT = 261,       /**< Channel Decrement */
-
-    SDL_SCANCODE_MEDIA_PLAY = 262,          /**< Play */
-    SDL_SCANCODE_MEDIA_PAUSE = 263,         /**< Pause */
-    SDL_SCANCODE_MEDIA_RECORD = 264,        /**< Record */
-    SDL_SCANCODE_MEDIA_FAST_FORWARD = 265,  /**< Fast Forward */
-    SDL_SCANCODE_MEDIA_REWIND = 266,        /**< Rewind */
-    SDL_SCANCODE_MEDIA_NEXT_TRACK = 267,    /**< Next Track */
-    SDL_SCANCODE_MEDIA_PREVIOUS_TRACK = 268, /**< Previous Track */
-    SDL_SCANCODE_MEDIA_STOP = 269,          /**< Stop */
-    SDL_SCANCODE_MEDIA_EJECT = 270,         /**< Eject */
-    SDL_SCANCODE_MEDIA_PLAY_PAUSE = 271,    /**< Play / Pause */
-    SDL_SCANCODE_MEDIA_SELECT = 272,        /* Media Select */
-
-    SDL_SCANCODE_AC_NEW = 273,              /**< AC New */
-    SDL_SCANCODE_AC_OPEN = 274,             /**< AC Open */
-    SDL_SCANCODE_AC_CLOSE = 275,            /**< AC Close */
-    SDL_SCANCODE_AC_EXIT = 276,             /**< AC Exit */
-    SDL_SCANCODE_AC_SAVE = 277,             /**< AC Save */
-    SDL_SCANCODE_AC_PRINT = 278,            /**< AC Print */
-    SDL_SCANCODE_AC_PROPERTIES = 279,       /**< AC Properties */
-
-    SDL_SCANCODE_AC_SEARCH = 280,           /**< AC Search */
-    SDL_SCANCODE_AC_HOME = 281,             /**< AC Home */
-    SDL_SCANCODE_AC_BACK = 282,             /**< AC Back */
-    SDL_SCANCODE_AC_FORWARD = 283,          /**< AC Forward */
-    SDL_SCANCODE_AC_STOP = 284,             /**< AC Stop */
-    SDL_SCANCODE_AC_REFRESH = 285,          /**< AC Refresh */
-    SDL_SCANCODE_AC_BOOKMARKS = 286,        /**< AC Bookmarks */
-
-    /* @} *//* Usage page 0x0C */
-
-
-    /**
-     *  \name Mobile keys
-     *
-     *  These are values that are often used on mobile phones.
-     */
-    /* @{ */
-
-    SDL_SCANCODE_SOFTLEFT = 287, /**< Usually situated below the display on phones and
-                                      used as a multi-function feature key for selecting
-                                      a software defined function shown on the bottom left
-                                      of the display. */
-    SDL_SCANCODE_SOFTRIGHT = 288, /**< Usually situated below the display on phones and
-                                       used as a multi-function feature key for selecting
-                                       a software defined function shown on the bottom right
-                                       of the display. */
-    SDL_SCANCODE_CALL = 289, /**< Used for accepting phone calls. */
-    SDL_SCANCODE_ENDCALL = 290, /**< Used for rejecting phone calls. */
-
-    /* @} *//* Mobile keys */
-
-    /* Add any other keys here. */
-
-    SDL_SCANCODE_RESERVED = 400,    /**< 400-500 reserved for dynamic keycodes */
-
-    SDL_SCANCODE_COUNT = 512 /**< not a key, just marks the number of scancodes for array bounds */
-
-} SDL_Scancode;
-
-#endif /* SDL_scancode_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_sensor.h

@@ -1,321 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategorySensor
- *
- * SDL sensor management.
- *
- * These APIs grant access to gyros and accelerometers on various platforms.
- *
- * In order to use these functions, SDL_Init() must have been called with the
- * SDL_INIT_SENSOR flag. This causes SDL to scan the system for sensors, and
- * load appropriate drivers.
- */
-
-#ifndef SDL_sensor_h_
-#define SDL_sensor_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_properties.h>
-
-#include <SDL3/SDL_begin_code.h>
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-/* *INDENT-OFF* */
-extern "C" {
-/* *INDENT-ON* */
-#endif
-
-/**
- * The opaque structure used to identify an opened SDL sensor.
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_Sensor SDL_Sensor;
-
-/**
- * This is a unique ID for a sensor for the time it is connected to the
- * system, and is never reused for the lifetime of the application.
- *
- * The value 0 is an invalid ID.
- *
- * \since This datatype is available since SDL 3.2.0.
- */
-typedef Uint32 SDL_SensorID;
-
-/**
- * A constant to represent standard gravity for accelerometer sensors.
- *
- * The accelerometer returns the current acceleration in SI meters per second
- * squared. This measurement includes the force of gravity, so a device at
- * rest will have an value of SDL_STANDARD_GRAVITY away from the center of the
- * earth, which is a positive Y value.
- *
- * \since This macro is available since SDL 3.2.0.
- */
-#define SDL_STANDARD_GRAVITY    9.80665f
-
-/**
- * The different sensors defined by SDL.
- *
- * Additional sensors may be available, using platform dependent semantics.
- *
- * Here are the additional Android sensors:
- *
- * https://developer.android.com/reference/android/hardware/SensorEvent.html#values
- *
- * Accelerometer sensor notes:
- *
- * The accelerometer returns the current acceleration in SI meters per second
- * squared. This measurement includes the force of gravity, so a device at
- * rest will have an value of SDL_STANDARD_GRAVITY away from the center of the
- * earth, which is a positive Y value.
- *
- * - `values[0]`: Acceleration on the x axis
- * - `values[1]`: Acceleration on the y axis
- * - `values[2]`: Acceleration on the z axis
- *
- * For phones and tablets held in natural orientation and game controllers
- * held in front of you, the axes are defined as follows:
- *
- * - -X ... +X : left ... right
- * - -Y ... +Y : bottom ... top
- * - -Z ... +Z : farther ... closer
- *
- * The accelerometer axis data is not changed when the device is rotated.
- *
- * Gyroscope sensor notes:
- *
- * The gyroscope returns the current rate of rotation in radians per second.
- * The rotation is positive in the counter-clockwise direction. That is, an
- * observer looking from a positive location on one of the axes would see
- * positive rotation on that axis when it appeared to be rotating
- * counter-clockwise.
- *
- * - `values[0]`: Angular speed around the x axis (pitch)
- * - `values[1]`: Angular speed around the y axis (yaw)
- * - `values[2]`: Angular speed around the z axis (roll)
- *
- * For phones and tablets held in natural orientation and game controllers
- * held in front of you, the axes are defined as follows:
- *
- * - -X ... +X : left ... right
- * - -Y ... +Y : bottom ... top
- * - -Z ... +Z : farther ... closer
- *
- * The gyroscope axis data is not changed when the device is rotated.
- *
- * \since This enum is available since SDL 3.2.0.
- *
- * \sa SDL_GetCurrentDisplayOrientation
- */
-typedef enum SDL_SensorType
-{
-    SDL_SENSOR_INVALID = -1,    /**< Returned for an invalid sensor */
-    SDL_SENSOR_UNKNOWN,         /**< Unknown sensor type */
-    SDL_SENSOR_ACCEL,           /**< Accelerometer */
-    SDL_SENSOR_GYRO,            /**< Gyroscope */
-    SDL_SENSOR_ACCEL_L,         /**< Accelerometer for left Joy-Con controller and Wii nunchuk */
-    SDL_SENSOR_GYRO_L,          /**< Gyroscope for left Joy-Con controller */
-    SDL_SENSOR_ACCEL_R,         /**< Accelerometer for right Joy-Con controller */
-    SDL_SENSOR_GYRO_R,          /**< Gyroscope for right Joy-Con controller */
-    SDL_SENSOR_COUNT
-} SDL_SensorType;
-
-
-/* Function prototypes */
-
-/**
- * Get a list of currently connected sensors.
- *
- * \param count a pointer filled in with the number of sensors returned, may
- *              be NULL.
- * \returns a 0 terminated array of sensor instance IDs or NULL on failure;
- *          call SDL_GetError() for more information. This should be freed
- *          with SDL_free() when it is no longer needed.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_SensorID * SDLCALL SDL_GetSensors(int *count);
-
-/**
- * Get the implementation dependent name of a sensor.
- *
- * This can be called before any sensors are opened.
- *
- * \param instance_id the sensor instance ID.
- * \returns the sensor name, or NULL if `instance_id` is not valid.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetSensorNameForID(SDL_SensorID instance_id);
-
-/**
- * Get the type of a sensor.
- *
- * This can be called before any sensors are opened.
- *
- * \param instance_id the sensor instance ID.
- * \returns the SDL_SensorType, or `SDL_SENSOR_INVALID` if `instance_id` is
- *          not valid.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_SensorType SDLCALL SDL_GetSensorTypeForID(SDL_SensorID instance_id);
-
-/**
- * Get the platform dependent type of a sensor.
- *
- * This can be called before any sensors are opened.
- *
- * \param instance_id the sensor instance ID.
- * \returns the sensor platform dependent type, or -1 if `instance_id` is not
- *          valid.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_GetSensorNonPortableTypeForID(SDL_SensorID instance_id);
-
-/**
- * Open a sensor for use.
- *
- * \param instance_id the sensor instance ID.
- * \returns an SDL_Sensor object or NULL on failure; call SDL_GetError() for
- *          more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_Sensor * SDLCALL SDL_OpenSensor(SDL_SensorID instance_id);
-
-/**
- * Return the SDL_Sensor associated with an instance ID.
- *
- * \param instance_id the sensor instance ID.
- * \returns an SDL_Sensor object or NULL on failure; call SDL_GetError() for
- *          more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_Sensor * SDLCALL SDL_GetSensorFromID(SDL_SensorID instance_id);
-
-/**
- * Get the properties associated with a sensor.
- *
- * \param sensor the SDL_Sensor object.
- * \returns a valid property ID on success or 0 on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_PropertiesID SDLCALL SDL_GetSensorProperties(SDL_Sensor *sensor);
-
-/**
- * Get the implementation dependent name of a sensor.
- *
- * \param sensor the SDL_Sensor object.
- * \returns the sensor name or NULL on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC const char * SDLCALL SDL_GetSensorName(SDL_Sensor *sensor);
-
-/**
- * Get the type of a sensor.
- *
- * \param sensor the SDL_Sensor object to inspect.
- * \returns the SDL_SensorType type, or `SDL_SENSOR_INVALID` if `sensor` is
- *          NULL.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_SensorType SDLCALL SDL_GetSensorType(SDL_Sensor *sensor);
-
-/**
- * Get the platform dependent type of a sensor.
- *
- * \param sensor the SDL_Sensor object to inspect.
- * \returns the sensor platform dependent type, or -1 if `sensor` is NULL.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC int SDLCALL SDL_GetSensorNonPortableType(SDL_Sensor *sensor);
-
-/**
- * Get the instance ID of a sensor.
- *
- * \param sensor the SDL_Sensor object to inspect.
- * \returns the sensor instance ID, or 0 on failure; call SDL_GetError() for
- *          more information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC SDL_SensorID SDLCALL SDL_GetSensorID(SDL_Sensor *sensor);
-
-/**
- * Get the current state of an opened sensor.
- *
- * The number of values and interpretation of the data is sensor dependent.
- *
- * \param sensor the SDL_Sensor object to query.
- * \param data a pointer filled with the current sensor state.
- * \param num_values the number of values to write to data.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetSensorData(SDL_Sensor *sensor, float *data, int num_values);
-
-/**
- * Close a sensor previously opened with SDL_OpenSensor().
- *
- * \param sensor the SDL_Sensor object to close.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC void SDLCALL SDL_CloseSensor(SDL_Sensor *sensor);
-
-/**
- * Update the current state of the open sensors.
- *
- * This is called automatically by the event loop if sensor events are
- * enabled.
- *
- * This needs to be called from the thread that initialized the sensor
- * subsystem.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC void SDLCALL SDL_UpdateSensors(void);
-
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-/* *INDENT-OFF* */
-}
-/* *INDENT-ON* */
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_sensor_h_ */

release/frameworks/SDL3.xcframework/ios-arm64_x86_64-simulator/SDL3.framework/Headers/SDL_storage.h

@@ -1,682 +0,0 @@
-/*
-  Simple DirectMedia Layer
-  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
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-  3. This notice may not be removed or altered from any source distribution.
-*/
-
-/**
- * # CategoryStorage
- *
- * The storage API is a high-level API designed to abstract away the
- * portability issues that come up when using something lower-level (in SDL's
- * case, this sits on top of the [Filesystem](CategoryFilesystem) and
- * [IOStream](CategoryIOStream) subsystems). It is significantly more
- * restrictive than a typical filesystem API, for a number of reasons:
- *
- * 1. **What to Access:** A common pitfall with existing filesystem APIs is
- * the assumption that all storage is monolithic. However, many other
- * platforms (game consoles in particular) are more strict about what _type_
- * of filesystem is being accessed; for example, game content and user data
- * are usually two separate storage devices with entirely different
- * characteristics (and possibly different low-level APIs altogether!).
- *
- * 2. **How to Access:** Another common mistake is applications assuming that
- * all storage is universally writeable - again, many platforms treat game
- * content and user data as two separate storage devices, and only user data
- * is writeable while game content is read-only.
- *
- * 3. **When to Access:** The most common portability issue with filesystem
- * access is _timing_ - you cannot always assume that the storage device is
- * always accessible all of the time, nor can you assume that there are no
- * limits to how long you have access to a particular device.
- *
- * Consider the following example:
- *
- * ```c
- * void ReadGameData(void)
- * {
- *     extern char** fileNames;
- *     extern size_t numFiles;
- *     for (size_t i = 0; i < numFiles; i += 1) {
- *         FILE *data = fopen(fileNames[i], "rwb");
- *         if (data == NULL) {
- *             // Something bad happened!
- *         } else {
- *             // A bunch of stuff happens here
- *             fclose(data);
- *         }
- *     }
- * }
- *
- * void ReadSave(void)
- * {
- *     FILE *save = fopen("saves/save0.sav", "rb");
- *     if (save == NULL) {
- *         // Something bad happened!
- *     } else {
- *         // A bunch of stuff happens here
- *         fclose(save);
- *     }
- * }
- *
- * void WriteSave(void)
- * {
- *     FILE *save = fopen("saves/save0.sav", "wb");
- *     if (save == NULL) {
- *         // Something bad happened!
- *     } else {
- *         // A bunch of stuff happens here
- *         fclose(save);
- *     }
- * }
- * ```
- *
- * Going over the bullet points again:
- *
- * 1. **What to Access:** This code accesses a global filesystem; game data
- * and saves are all presumed to be in the current working directory (which
- * may or may not be the game's installation folder!).
- *
- * 2. **How to Access:** This code assumes that content paths are writeable,
- * and that save data is also writeable despite being in the same location as
- * the game data.
- *
- * 3. **When to Access:** This code assumes that they can be called at any
- * time, since the filesystem is always accessible and has no limits on how
- * long the filesystem is being accessed.
- *
- * Due to these assumptions, the filesystem code is not portable and will fail
- * under these common scenarios:
- *
- * - The game is installed on a device that is read-only, both content loading
- *   and game saves will fail or crash outright
- * - Game/User storage is not implicitly mounted, so no files will be found
- *   for either scenario when a platform requires explicitly mounting
- *   filesystems
- * - Save data may not be safe since the I/O is not being flushed or
- *   validated, so an error occurring elsewhere in the program may result in
- *   missing/corrupted save data
- *
- * When using SDL_Storage, these types of problems are virtually impossible to
- * trip over:
- *
- * ```c
- * void ReadGameData(void)
- * {
- *     extern char** fileNames;
- *     extern size_t numFiles;
- *
- *     SDL_Storage *title = SDL_OpenTitleStorage(NULL, 0);
- *     if (title == NULL) {
- *         // Something bad happened!
- *     }
- *     while (!SDL_StorageReady(title)) {
- *         SDL_Delay(1);
- *     }
- *
- *     for (size_t i = 0; i < numFiles; i += 1) {
- *         void* dst;
- *         Uint64 dstLen = 0;
- *
- *         if (SDL_GetStorageFileSize(title, fileNames[i], &dstLen) && dstLen > 0) {
- *             dst = SDL_malloc(dstLen);
- *             if (SDL_ReadStorageFile(title, fileNames[i], dst, dstLen)) {
- *                 // A bunch of stuff happens here
- *             } else {
- *                 // Something bad happened!
- *             }
- *             SDL_free(dst);
- *         } else {
- *             // Something bad happened!
- *         }
- *     }
- *
- *     SDL_CloseStorage(title);
- * }
- *
- * void ReadSave(void)
- * {
- *     SDL_Storage *user = SDL_OpenUserStorage("libsdl", "Storage Example", 0);
- *     if (user == NULL) {
- *         // Something bad happened!
- *     }
- *     while (!SDL_StorageReady(user)) {
- *         SDL_Delay(1);
- *     }
- *
- *     Uint64 saveLen = 0;
- *     if (SDL_GetStorageFileSize(user, "save0.sav", &saveLen) && saveLen > 0) {
- *         void* dst = SDL_malloc(saveLen);
- *         if (SDL_ReadStorageFile(user, "save0.sav", dst, saveLen)) {
- *             // A bunch of stuff happens here
- *         } else {
- *             // Something bad happened!
- *         }
- *         SDL_free(dst);
- *     } else {
- *         // Something bad happened!
- *     }
- *
- *     SDL_CloseStorage(user);
- * }
- *
- * void WriteSave(void)
- * {
- *     SDL_Storage *user = SDL_OpenUserStorage("libsdl", "Storage Example", 0);
- *     if (user == NULL) {
- *         // Something bad happened!
- *     }
- *     while (!SDL_StorageReady(user)) {
- *         SDL_Delay(1);
- *     }
- *
- *     extern void *saveData; // A bunch of stuff happened here...
- *     extern Uint64 saveLen;
- *     if (!SDL_WriteStorageFile(user, "save0.sav", saveData, saveLen)) {
- *         // Something bad happened!
- *     }
- *
- *     SDL_CloseStorage(user);
- * }
- * ```
- *
- * Note the improvements that SDL_Storage makes:
- *
- * 1. **What to Access:** This code explicitly reads from a title or user
- * storage device based on the context of the function.
- *
- * 2. **How to Access:** This code explicitly uses either a read or write
- * function based on the context of the function.
- *
- * 3. **When to Access:** This code explicitly opens the device when it needs
- * to, and closes it when it is finished working with the filesystem.
- *
- * The result is an application that is significantly more robust against the
- * increasing demands of platforms and their filesystems!
- *
- * A publicly available example of an SDL_Storage backend is the
- * [Steam Cloud](https://partner.steamgames.com/doc/features/cloud)
- * backend - you can initialize Steamworks when starting the program, and then
- * SDL will recognize that Steamworks is initialized and automatically use
- * ISteamRemoteStorage when the application opens user storage. More
- * importantly, when you _open_ storage it knows to begin a "batch" of
- * filesystem operations, and when you _close_ storage it knows to end and
- * flush the batch. This is used by Steam to support
- * [Dynamic Cloud Sync](https://steamcommunity.com/groups/steamworks/announcements/detail/3142949576401813670)
- * ; users can save data on one PC, put the device to sleep, and then continue
- * playing on another PC (and vice versa) with the save data fully
- * synchronized across all devices, allowing for a seamless experience without
- * having to do full restarts of the program.
- *
- * ## Notes on valid paths
- *
- * All paths in the Storage API use Unix-style path separators ('/'). Using a
- * different path separator will not work, even if the underlying platform
- * would otherwise accept it. This is to keep code using the Storage API
- * portable between platforms and Storage implementations and simplify app
- * code.
- *
- * Paths with relative directories ("." and "..") are forbidden by the Storage
- * API.
- *
- * All valid UTF-8 strings (discounting the NULL terminator character and the
- * '/' path separator) are usable for filenames, however, an underlying
- * Storage implementation may not support particularly strange sequences and
- * refuse to create files with those names, etc.
- */
-
-#ifndef SDL_storage_h_
-#define SDL_storage_h_
-
-#include <SDL3/SDL_stdinc.h>
-#include <SDL3/SDL_error.h>
-#include <SDL3/SDL_filesystem.h>
-#include <SDL3/SDL_properties.h>
-
-#include <SDL3/SDL_begin_code.h>
-
-/* Set up for C function definitions, even when using C++ */
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * Function interface for SDL_Storage.
- *
- * Apps that want to supply a custom implementation of SDL_Storage will fill
- * in all the functions in this struct, and then pass it to SDL_OpenStorage to
- * create a custom SDL_Storage object.
- *
- * It is not usually necessary to do this; SDL provides standard
- * implementations for many things you might expect to do with an SDL_Storage.
- *
- * This structure should be initialized using SDL_INIT_INTERFACE()
- *
- * \since This struct is available since SDL 3.2.0.
- *
- * \sa SDL_INIT_INTERFACE
- */
-typedef struct SDL_StorageInterface
-{
-    /* The version of this interface */
-    Uint32 version;
-
-    /* Called when the storage is closed */
-    bool (SDLCALL *close)(void *userdata);
-
-    /* Optional, returns whether the storage is currently ready for access */
-    bool (SDLCALL *ready)(void *userdata);
-
-    /* Enumerate a directory, optional for write-only storage */
-    bool (SDLCALL *enumerate)(void *userdata, const char *path, SDL_EnumerateDirectoryCallback callback, void *callback_userdata);
-
-    /* Get path information, optional for write-only storage */
-    bool (SDLCALL *info)(void *userdata, const char *path, SDL_PathInfo *info);
-
-    /* Read a file from storage, optional for write-only storage */
-    bool (SDLCALL *read_file)(void *userdata, const char *path, void *destination, Uint64 length);
-
-    /* Write a file to storage, optional for read-only storage */
-    bool (SDLCALL *write_file)(void *userdata, const char *path, const void *source, Uint64 length);
-
-    /* Create a directory, optional for read-only storage */
-    bool (SDLCALL *mkdir)(void *userdata, const char *path);
-
-    /* Remove a file or empty directory, optional for read-only storage */
-    bool (SDLCALL *remove)(void *userdata, const char *path);
-
-    /* Rename a path, optional for read-only storage */
-    bool (SDLCALL *rename)(void *userdata, const char *oldpath, const char *newpath);
-
-    /* Copy a file, optional for read-only storage */
-    bool (SDLCALL *copy)(void *userdata, const char *oldpath, const char *newpath);
-
-    /* Get the space remaining, optional for read-only storage */
-    Uint64 (SDLCALL *space_remaining)(void *userdata);
-} SDL_StorageInterface;
-
-/* Check the size of SDL_StorageInterface
- *
- * If this assert fails, either the compiler is padding to an unexpected size,
- * or the interface has been updated and this should be updated to match and
- * the code using this interface should be updated to handle the old version.
- */
-SDL_COMPILE_TIME_ASSERT(SDL_StorageInterface_SIZE,
-    (sizeof(void *) == 4 && sizeof(SDL_StorageInterface) == 48) ||
-    (sizeof(void *) == 8 && sizeof(SDL_StorageInterface) == 96));
-
-/**
- * An abstract interface for filesystem access.
- *
- * This is an opaque datatype. One can create this object using standard SDL
- * functions like SDL_OpenTitleStorage or SDL_OpenUserStorage, etc, or create
- * an object with a custom implementation using SDL_OpenStorage.
- *
- * \since This struct is available since SDL 3.2.0.
- */
-typedef struct SDL_Storage SDL_Storage;
-
-/**
- * Opens up a read-only container for the application's filesystem.
- *
- * \param override a path to override the backend's default title root.
- * \param props a property list that may contain backend-specific information.
- * \returns a title storage container on success or NULL on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CloseStorage
- * \sa SDL_GetStorageFileSize
- * \sa SDL_OpenUserStorage
- * \sa SDL_ReadStorageFile
- */
-extern SDL_DECLSPEC SDL_Storage * SDLCALL SDL_OpenTitleStorage(const char *override, SDL_PropertiesID props);
-
-/**
- * Opens up a container for a user's unique read/write filesystem.
- *
- * While title storage can generally be kept open throughout runtime, user
- * storage should only be opened when the client is ready to read/write files.
- * This allows the backend to properly batch file operations and flush them
- * when the container has been closed; ensuring safe and optimal save I/O.
- *
- * \param org the name of your organization.
- * \param app the name of your application.
- * \param props a property list that may contain backend-specific information.
- * \returns a user storage container on success or NULL on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CloseStorage
- * \sa SDL_GetStorageFileSize
- * \sa SDL_GetStorageSpaceRemaining
- * \sa SDL_OpenTitleStorage
- * \sa SDL_ReadStorageFile
- * \sa SDL_StorageReady
- * \sa SDL_WriteStorageFile
- */
-extern SDL_DECLSPEC SDL_Storage * SDLCALL SDL_OpenUserStorage(const char *org, const char *app, SDL_PropertiesID props);
-
-/**
- * Opens up a container for local filesystem storage.
- *
- * This is provided for development and tools. Portable applications should
- * use SDL_OpenTitleStorage() for access to game data and
- * SDL_OpenUserStorage() for access to user data.
- *
- * \param path the base path prepended to all storage paths, or NULL for no
- *             base path.
- * \returns a filesystem storage container on success or NULL on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CloseStorage
- * \sa SDL_GetStorageFileSize
- * \sa SDL_GetStorageSpaceRemaining
- * \sa SDL_OpenTitleStorage
- * \sa SDL_OpenUserStorage
- * \sa SDL_ReadStorageFile
- * \sa SDL_WriteStorageFile
- */
-extern SDL_DECLSPEC SDL_Storage * SDLCALL SDL_OpenFileStorage(const char *path);
-
-/**
- * Opens up a container using a client-provided storage interface.
- *
- * Applications do not need to use this function unless they are providing
- * their own SDL_Storage implementation. If you just need an SDL_Storage, you
- * should use the built-in implementations in SDL, like SDL_OpenTitleStorage()
- * or SDL_OpenUserStorage().
- *
- * This function makes a copy of `iface` and the caller does not need to keep
- * it around after this call.
- *
- * \param iface the interface that implements this storage, initialized using
- *              SDL_INIT_INTERFACE().
- * \param userdata the pointer that will be passed to the interface functions.
- * \returns a storage container on success or NULL on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_CloseStorage
- * \sa SDL_GetStorageFileSize
- * \sa SDL_GetStorageSpaceRemaining
- * \sa SDL_INIT_INTERFACE
- * \sa SDL_ReadStorageFile
- * \sa SDL_StorageReady
- * \sa SDL_WriteStorageFile
- */
-extern SDL_DECLSPEC SDL_Storage * SDLCALL SDL_OpenStorage(const SDL_StorageInterface *iface, void *userdata);
-
-/**
- * Closes and frees a storage container.
- *
- * \param storage a storage container to close.
- * \returns true if the container was freed with no errors, false otherwise;
- *          call SDL_GetError() for more information. Even if the function
- *          returns an error, the container data will be freed; the error is
- *          only for informational purposes.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_OpenFileStorage
- * \sa SDL_OpenStorage
- * \sa SDL_OpenTitleStorage
- * \sa SDL_OpenUserStorage
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CloseStorage(SDL_Storage *storage);
-
-/**
- * Checks if the storage container is ready to use.
- *
- * This function should be called in regular intervals until it returns true -
- * however, it is not recommended to spinwait on this call, as the backend may
- * depend on a synchronous message loop. You might instead poll this in your
- * game's main loop while processing events and drawing a loading screen.
- *
- * \param storage a storage container to query.
- * \returns true if the container is ready, false otherwise.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_StorageReady(SDL_Storage *storage);
-
-/**
- * Query the size of a file within a storage container.
- *
- * \param storage a storage container to query.
- * \param path the relative path of the file to query.
- * \param length a pointer to be filled with the file's length.
- * \returns true if the file could be queried or false on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_ReadStorageFile
- * \sa SDL_StorageReady
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetStorageFileSize(SDL_Storage *storage, const char *path, Uint64 *length);
-
-/**
- * Synchronously read a file from a storage container into a client-provided
- * buffer.
- *
- * The value of `length` must match the length of the file exactly; call
- * SDL_GetStorageFileSize() to get this value. This behavior may be relaxed in
- * a future release.
- *
- * \param storage a storage container to read from.
- * \param path the relative path of the file to read.
- * \param destination a client-provided buffer to read the file into.
- * \param length the length of the destination buffer.
- * \returns true if the file was read or false on failure; call SDL_GetError()
- *          for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetStorageFileSize
- * \sa SDL_StorageReady
- * \sa SDL_WriteStorageFile
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_ReadStorageFile(SDL_Storage *storage, const char *path, void *destination, Uint64 length);
-
-/**
- * Synchronously write a file from client memory into a storage container.
- *
- * \param storage a storage container to write to.
- * \param path the relative path of the file to write.
- * \param source a client-provided buffer to write from.
- * \param length the length of the source buffer.
- * \returns true if the file was written or false on failure; call
- *          SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_GetStorageSpaceRemaining
- * \sa SDL_ReadStorageFile
- * \sa SDL_StorageReady
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_WriteStorageFile(SDL_Storage *storage, const char *path, const void *source, Uint64 length);
-
-/**
- * Create a directory in a writable storage container.
- *
- * \param storage a storage container.
- * \param path the path of the directory to create.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StorageReady
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CreateStorageDirectory(SDL_Storage *storage, const char *path);
-
-/**
- * Enumerate a directory in a storage container through a callback function.
- *
- * This function provides every directory entry through an app-provided
- * callback, called once for each directory entry, until all results have been
- * provided or the callback returns either SDL_ENUM_SUCCESS or
- * SDL_ENUM_FAILURE.
- *
- * This will return false if there was a system problem in general, or if a
- * callback returns SDL_ENUM_FAILURE. A successful return means a callback
- * returned SDL_ENUM_SUCCESS to halt enumeration, or all directory entries
- * were enumerated.
- *
- * If `path` is NULL, this is treated as a request to enumerate the root of
- * the storage container's tree. An empty string also works for this.
- *
- * \param storage a storage container.
- * \param path the path of the directory to enumerate, or NULL for the root.
- * \param callback a function that is called for each entry in the directory.
- * \param userdata a pointer that is passed to `callback`.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StorageReady
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_EnumerateStorageDirectory(SDL_Storage *storage, const char *path, SDL_EnumerateDirectoryCallback callback, void *userdata);
-
-/**
- * Remove a file or an empty directory in a writable storage container.
- *
- * \param storage a storage container.
- * \param path the path of the directory to enumerate.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StorageReady
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_RemoveStoragePath(SDL_Storage *storage, const char *path);
-
-/**
- * Rename a file or directory in a writable storage container.
- *
- * \param storage a storage container.
- * \param oldpath the old path.
- * \param newpath the new path.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StorageReady
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_RenameStoragePath(SDL_Storage *storage, const char *oldpath, const char *newpath);
-
-/**
- * Copy a file in a writable storage container.
- *
- * \param storage a storage container.
- * \param oldpath the old path.
- * \param newpath the new path.
- * \returns true on success or false on failure; call SDL_GetError() for more
- *          information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StorageReady
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_CopyStorageFile(SDL_Storage *storage, const char *oldpath, const char *newpath);
-
-/**
- * Get information about a filesystem path in a storage container.
- *
- * \param storage a storage container.
- * \param path the path to query.
- * \param info a pointer filled in with information about the path, or NULL to
- *             check for the existence of a file.
- * \returns true on success or false if the file doesn't exist, or another
- *          failure; call SDL_GetError() for more information.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StorageReady
- */
-extern SDL_DECLSPEC bool SDLCALL SDL_GetStoragePathInfo(SDL_Storage *storage, const char *path, SDL_PathInfo *info);
-
-/**
- * Queries the remaining space in a storage container.
- *
- * \param storage a storage container to query.
- * \returns the amount of remaining space, in bytes.
- *
- * \since This function is available since SDL 3.2.0.
- *
- * \sa SDL_StorageReady
- * \sa SDL_WriteStorageFile
- */
-extern SDL_DECLSPEC Uint64 SDLCALL SDL_GetStorageSpaceRemaining(SDL_Storage *storage);
-
-/**
- * Enumerate a directory tree, filtered by pattern, and return a list.
- *
- * Files are filtered out if they don't match the string in `pattern`, which
- * may contain wildcard characters `*` (match everything) and `?` (match one
- * character). If pattern is NULL, no filtering is done and all results are
- * returned. Subdirectories are permitted, and are specified with a path
- * separator of '/'. Wildcard characters `*` and `?` never match a path
- * separator.
- *
- * `flags` may be set to SDL_GLOB_CASEINSENSITIVE to make the pattern matching
- * case-insensitive.
- *
- * The returned array is always NULL-terminated, for your iterating
- * convenience, but if `count` is non-NULL, on return it will contain the
- * number of items in the array, not counting the NULL terminator.
- *
- * If `path` is NULL, this is treated as a request to enumerate the root of
- * the storage container's tree. An empty string also works for this.
- *
- * \param storage a storage container.
- * \param path the path of the directory to enumerate, or NULL for the root.
- * \param pattern the pattern that files in the directory must match. Can be
- *                NULL.
- * \param flags `SDL_GLOB_*` bitflags that affect this search.
- * \param count on return, will be set to the number of items in the returned
- *              array. Can be NULL.
- * \returns an array of strings on success or NULL on failure; call
- *          SDL_GetError() for more information. The caller should pass the
- *          returned pointer to SDL_free when done with it. This is a single
- *          allocation that should be freed with SDL_free() when it is no
- *          longer needed.
- *
- * \threadsafety It is safe to call this function from any thread, assuming
- *               the `storage` object is thread-safe.
- *
- * \since This function is available since SDL 3.2.0.
- */
-extern SDL_DECLSPEC char ** SDLCALL SDL_GlobStorageDirectory(SDL_Storage *storage, const char *path, const char *pattern, SDL_GlobFlags flags, int *count);
-
-/* Ends C function definitions when using C++ */
-#ifdef __cplusplus
-}
-#endif
-#include <SDL3/SDL_close_code.h>
-
-#endif /* SDL_storage_h_ */