TSdlCpu
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 HasSse and 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 properties still exist and will simply return False in these).
Definition
Unit: Neslib.Sdl3.Additional
Properties
| Name | Description |
|---|---|
| CacheLineSize | Determine the L1 cache line size of the CPU. |
| HasAltiVec | Whether the CPU has AltiVec features. |
| HasArmSimd | Determine whether the CPU has ARM SIMD (ARMv6) features. |
| HasAvx | Determine whether the CPU has AVX features. |
| HasAvx2 | Determine whether the CPU has AVX2 features. |
| HasAvx512F | Determine whether the CPU has AVX-512F (foundation) features. |
| HasLasx | Determine whether the CPU has LASX (LOONGARCH SIMD) features. |
| HasLsx | Determine whether the CPU has LSX (LOONGARCH SIMD) features. |
| HasMmx | Whether the CPU has MMX features. |
| HasNeon | Determine whether the CPU has NEON (ARM SIMD) features. |
| HasSse | Determine whether the CPU has SSE features. |
| HasSse2 | Determine whether the CPU has SSE2 features. |
| HasSse3 | Determine whether the CPU has SSE3 features. |
| HasSse41 | Determine whether the CPU has SSE4.1 features. |
| HasSse42 | Determine whether the CPU has SSE4.2 features. |
| NumLogicalCores | The number of logical CPU cores available. |
| SimdAlignment | Report the alignment this system needs for SIMD allocations. |
| SystemRamMiB | Get the amount of RAM configured in the system in MiB. |
Property Descriptions
CacheLineSize
Determine the L1 cache line size of the CPU.
This is useful for determining multi-threaded structure padding or SIMD prefetch sizes.
class property CacheLineSize: Integer read GetCacheLineSize
Type: Integer
Remarks
It is safe to use this property from any thread.
HasAltiVec
Whether the CPU has AltiVec features.
This always returns False on CPUs that aren't using PowerPC instruction sets.
class property HasAltiVec: Boolean read GetHasAltiVec
Type: Boolean
Remarks
It is safe to use this property from any thread.
HasArmSimd
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.
class property HasArmSimd: Boolean read GetHasArmSimd
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
HasAvx
Determine whether the CPU has AVX features.
This always returns False on CPUs that aren't using Intel instruction sets.
class property HasAvx: Boolean read GetHasAvx
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
HasAvx2
Determine whether the CPU has AVX2 features.
This always returns False on CPUs that aren't using Intel instruction sets.
class property HasAvx2: Boolean read GetHasAvx2
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
HasAvx512F
Determine whether the CPU has AVX-512F (foundation) features.
This always returns False on CPUs that aren't using Intel instruction sets.
class property HasAvx512F: Boolean read GetHasAvx512F
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
HasLasx
Determine whether the CPU has LASX (LOONGARCH SIMD) features.
This always returns False on CPUs that aren't using LOONGARCH instruction sets.
class property HasLasx: Boolean read GetHasLasx
Type: Boolean
Remarks
It is safe to use this property from any thread.
HasLsx
Determine whether the CPU has LSX (LOONGARCH SIMD) features.
This always returns False on CPUs that aren't using LOONGARCH instruction sets.
class property HasLsx: Boolean read GetHasLsx
Type: Boolean
Remarks
It is safe to use this property from any thread.
HasMmx
Whether the CPU has MMX features.
This always returns False on CPUs that aren't using Intel instruction sets.
class property HasMmx: Boolean read GetHasMmx
Type: Boolean
Remarks
It is safe to use this property from any thread.
HasNeon
Determine whether the CPU has NEON (ARM SIMD) features.
This always returns False on CPUs that aren't using ARM instruction sets.
class property HasNeon: Boolean read GetHasNeon
Type: Boolean
Remarks
It is safe to use this property from any thread.
HasSse
Determine whether the CPU has SSE features.
This always returns False on CPUs that aren't using Intel instruction sets.
class property HasSse: Boolean read GetHasSse
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
HasSse2
Determine whether the CPU has SSE2 features.
This always returns False on CPUs that aren't using Intel instruction sets.
class property HasSse2: Boolean read GetHasSse2
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
HasSse3
Determine whether the CPU has SSE3 features.
This always returns False on CPUs that aren't using Intel instruction sets.
class property HasSse3: Boolean read GetHasSse3
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
HasSse41
Determine whether the CPU has SSE4.1 features.
This always returns False on CPUs that aren't using Intel instruction sets.
class property HasSse41: Boolean read GetHasSse41
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
HasSse42
Determine whether the CPU has SSE4.2 features.
This always returns false on CPUs that aren't using Intel instruction sets.
class property HasSse42: Boolean read GetHasSse42
Type: Boolean
See Also
Remarks
It is safe to use this property from any thread.
NumLogicalCores
The number of logical CPU cores available.
On CPUs that include technologies such as hyperthreading, the number of logical cores may be more than the number of physical cores.
class property NumLogicalCores: Integer read GetNumLogicalCores
Type: Integer
Remarks
It is safe to use this property from any thread.
SimdAlignment
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 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.
class property SimdAlignment: Integer read GetSimdAlignment
Type: Integer
See Also
Remarks
It is safe to use this property from any thread.
SystemRamMiB
Get the amount of RAM configured in the system in MiB.
One MiB (Mebibyte) is 1,048,576 bytes.
class property SystemRamMiB: Integer read GetSystemRamMiB
Type: Integer
Remarks
It is safe to use this property from any thread.