CPU信息子系统（CategoryCPUInfo）

SDL 提供了一套 CPU 特性检测接口，主要用于判断系统是否支持各类 SIMD（单指令多数据）指令集，同时也能获取系统内存大小、逻辑 CPU 核心数等关键硬件信息。

CPU 指令集检测函数（如 SDL_HasSSE()、SDL_HasNEON()）在所有平台上均可用——即使某些指令集对当前架构无意义（例如 ARM 处理器永远不支持 SSE，x86 处理器永远不支持 NEON），这些函数仍会存在，只是返回 false。

函数

SDL_GetCPUCacheLineSize：获取 CPU 缓存行大小（字节），优化内存访问对齐时使用
SDL_GetNumLogicalCPUCores：获取系统逻辑 CPU 核心数（超线程会被计入，如 8 核 16 线程返回 16）
SDL_GetSIMDAlignment：获取 SIMD 指令集要求的内存对齐大小（字节），分配 SIMD 数据缓冲区时需满足该对齐
SDL_GetSystemPageSize：获取系统内存页大小（字节），内存分配/映射时的基础单位
SDL_GetSystemRAM：获取系统总物理内存大小（MB），用于判断硬件性能等级
SDL_HasAltiVec：检测 CPU 是否支持 PowerPC 架构的 AltiVec 指令集（返回非 0 表示支持）
SDL_HasARMSIMD：检测 CPU 是否支持 ARM 架构的基础 SIMD 指令集（返回非 0 表示支持）
SDL_HasAVX：检测 CPU 是否支持 x86 架构的 AVX 指令集（返回非 0 表示支持）
SDL_HasAVX2：检测 CPU 是否支持 x86 架构的 AVX2 指令集（返回非 0 表示支持）
SDL_HasAVX512F：检测 CPU 是否支持 x86 架构的 AVX-512F 基础指令集（返回非 0 表示支持）
SDL_HasLASX：检测 CPU 是否支持龙芯架构的 LASX 指令集（返回非 0 表示支持）
SDL_HasLSX：检测 CPU 是否支持龙芯架构的 LSX 指令集（返回非 0 表示支持）
SDL_HasMMX：检测 CPU 是否支持 x86 架构的 MMX 指令集（返回非 0 表示支持）
SDL_HasNEON：检测 CPU 是否支持 ARM 架构的 NEON 高级 SIMD 指令集（返回非 0 表示支持）
SDL_HasSSE：检测 CPU 是否支持 x86 架构的 SSE 指令集（返回非 0 表示支持）
SDL_HasSSE2：检测 CPU 是否支持 x86 架构的 SSE2 指令集（返回非 0 表示支持）
SDL_HasSSE3：检测 CPU 是否支持 x86 架构的 SSE3 指令集（返回非 0 表示支持）
SDL_HasSSE41：检测 CPU 是否支持 x86 架构的 SSE4.1 指令集（返回非 0 表示支持）
SDL_HasSSE42：检测 CPU 是否支持 x86 架构的 SSE4.2 指令集（返回非 0 表示支持）

数据类型

（无）

结构体

（无）

枚举

（无）

宏

SDL_CACHELINE_SIZE：编译期宏，定义默认的 CPU 缓存行大小（通常为 64 字节，实际硬件可能不同，建议运行时用 SDL_GetCPUCacheLineSize 获取）

FreeBASIC 示例代码

' 引入 SDL 相关声明（需确保 FreeBASIC 已链接 SDL3 库）
#Include "SDL.bi"

' 补充函数声明（FreeBASIC 绑定可能缺失）
Declare Function SDL_GetCPUCacheLineSize CDecl () As Integer
Declare Function SDL_GetNumLogicalCPUCores CDecl () As Integer
Declare Function SDL_GetSIMDAlignment CDecl () As Integer
Declare Function SDL_GetSystemPageSize CDecl () As Integer
Declare Function SDL_GetSystemRAM CDecl () As Integer
Declare Function SDL_HasAltiVec CDecl () As Integer
Declare Function SDL_HasARMSIMD CDecl () As Integer
Declare Function SDL_HasAVX CDecl () As Integer
Declare Function SDL_HasAVX2 CDecl () As Integer
Declare Function SDL_HasAVX512F CDecl () As Integer
Declare Function SDL_HasLASX CDecl () As Integer
Declare Function SDL_HasLSX CDecl () As Integer
Declare Function SDL_HasMMX CDecl () As Integer
Declare Function SDL_HasNEON CDecl () As Integer
Declare Function SDL_HasSSE CDecl () As Integer
Declare Function SDL_HasSSE2 CDecl () As Integer
Declare Function SDL_HasSSE3 CDecl () As Integer
Declare Function SDL_HasSSE41 CDecl () As Integer
Declare Function SDL_HasSSE42 CDecl () As Integer

' 打印SIMD指令集支持情况
Sub PrintSIMDSupport()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "【SIMD 指令集支持情况】")

    ' x86 架构指令集
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "MMX:    %s", IIf(SDL_HasMMX(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "SSE:    %s", IIf(SDL_HasSSE(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "SSE2:   %s", IIf(SDL_HasSSE2(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "SSE3:   %s", IIf(SDL_HasSSE3(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "SSE4.1: %s", IIf(SDL_HasSSE41(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "SSE4.2: %s", IIf(SDL_HasSSE42(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "AVX:    %s", IIf(SDL_HasAVX(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "AVX2:   %s", IIf(SDL_HasAVX2(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "AVX512F:%s", IIf(SDL_HasAVX512F(), "支持", "不支持"))

    ' ARM 架构指令集
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "ARM SIMD: %s", IIf(SDL_HasARMSIMD(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "NEON:     %s", IIf(SDL_HasNEON(), "支持", "不支持"))

    ' 其他架构指令集
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "AltiVec:  %s", IIf(SDL_HasAltiVec(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "LSX:      %s", IIf(SDL_HasLSX(), "支持", "不支持"))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "LASX:     %s", IIf(SDL_HasLASX(), "支持", "不支持"))
End Sub

' 打印系统/CPU硬件信息
Sub PrintSystemInfo()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "【系统/CPU 硬件信息】")

    ' CPU 核心数
    Dim As Integer coreCount = SDL_GetNumLogicalCPUCores()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "逻辑CPU核心数：%d", coreCount)

    ' 系统内存
    Dim As Integer ramSize = SDL_GetSystemRAM()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "总物理内存：%d MB (%.2f GB)", ramSize, ramSize / 1024.0)

    ' 缓存行大小
    Dim As Integer cacheLineSize = SDL_GetCPUCacheLineSize()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "CPU缓存行大小：%d 字节 (编译期默认：%d 字节)", cacheLineSize, SDL_CACHELINE_SIZE)

    ' SIMD对齐要求
    Dim As Integer simdAlign = SDL_GetSIMDAlignment()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "SIMD内存对齐要求：%d 字节", simdAlign)

    ' 系统页大小
    Dim As Integer pageSize = SDL_GetSystemPageSize()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "系统内存页大小：%d 字节", pageSize)
End Sub

' 根据硬件特性调整程序配置
Sub AdjustAppConfig()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, vbCrLf & "【根据硬件特性调整配置】")

    ' 根据内存大小设置纹理质量
    Dim As Integer ramSize = SDL_GetSystemRAM()
    If (ramSize >= 16384) Then ' 16GB 及以上
        SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "内存充足，启用4K纹理质量")
    ElseIf (ramSize >= 8192) Then ' 8GB 及以上
        SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "内存中等，启用2K纹理质量")
    Else
        SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "内存较少，启用1080P纹理质量")
    End If

    ' 根据CPU核心数设置线程池大小
    Dim As Integer coreCount = SDL_GetNumLogicalCPUCores()
    Dim As Integer threadCount = IIf(coreCount > 4, coreCount - 1, coreCount)
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "设置线程池大小：%d 线程", threadCount)

    ' 根据SIMD指令集启用优化
    If (SDL_HasAVX2() Or SDL_HasNEON()) Then
        SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "启用高级SIMD优化（图形渲染/数据处理）")
    ElseIf (SDL_HasSSE42()) Then
        SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "启用基础SIMD优化（数据处理）")
    Else
        SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "使用通用CPU指令集（无SIMD优化）")
    End If
End Sub

' 主程序
Sub Main()
    ' 初始化 SDL
    If (SDL_Init(0) < 0) Then
        SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "SDL 初始化失败：%s", SDL_GetError())
        Exit Sub
    End If

    ' 打印硬件信息
    PrintSystemInfo()
    PrintSIMDSupport()

    ' 根据硬件调整配置
    AdjustAppConfig()

    ' 清理 SDL
    SDL_Quit()

    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, vbCrLf & "程序正常退出")
End Sub

' 运行主程序
Main()

核心知识点补充

SIMD 指令集检测规则：
- 所有指令集检测函数返回 非 0 表示支持，0 表示不支持；
- 跨架构检测时（如 x86 上检测 NEON），函数仍会返回 0，不会报错；
- 建议运行时动态检测，而非编译期判断——同一编译产物可能运行在不同指令集的 CPU 上。
内存对齐关键要点：
- SDL_GetSIMDAlignment() 返回的是当前 CPU SIMD 指令集要求的最小对齐大小（如 AVX2 要求 32 字节，NEON 要求 16 字节）；
- 分配 SIMD 数据缓冲区时，需满足该对齐要求，否则可能导致程序崩溃或性能下降；
- SDL 提供 SDL_aligned_alloc/SDL_aligned_free 函数，可便捷分配对齐内存。

硬件信息的应用场景：	函数	典型应用场景
SDL_GetNumLogicalCPUCores	设置线程池大小、任务并行数
SDL_GetSystemRAM	调整内存占用、纹理/贴图质量等级
SDL_GetCPUCacheLineSize	优化内存访问模式（避免缓存行颠簸）
SDL_GetSystemPageSize	内存映射（mmap）、大内存块分配

SDL_CACHELINE_SIZE 宏说明：
- 编译期默认值通常为 64 字节（主流 CPU 的缓存行大小）；
- 实际硬件的缓存行大小可能不同（如部分嵌入式 CPU 为 32 字节），建议运行时用 SDL_GetCPUCacheLineSize 获取真实值。

总结

核心优势：
- 统一的跨平台硬件检测接口，无需适配不同架构的原生检测方法；
- 完整覆盖主流 SIMD 指令集（x86/ARM/龙芯/PowerPC），满足多架构优化需求；
- 硬件信息获取函数返回值直观，无需解析复杂的系统信息结构体；
- 所有函数均为纯查询操作，无副作用，调用成本极低。
使用建议：
- 游戏/高性能应用中，根据 SIMD 指令集动态启用优化代码路径（如 AVX2 优化的图形渲染、NEON 优化的音频处理）；
- 根据 CPU 核心数动态调整线程池大小，避免过度并行导致的线程竞争；
- 根据系统内存大小分级调整资源加载策略（如大内存加载高清纹理，小内存加载压缩纹理）；
- 分配 SIMD 数据缓冲区时，务必遵循 SDL_GetSIMDAlignment() 返回的对齐要求。
关键点回顾：
- SIMD 指令集检测函数跨平台可用，非目标架构返回 false，无需额外判空；
- SDL_GetSIMDAlignment() 是 SIMD 内存分配的关键，需满足对齐要求；
- 硬件信息可用于动态调整程序配置，实现「低配能跑、高配优化」的自适应效果。