Sync SDL3 wiki -> header

[ci skip]
This commit is contained in:
SDL Wiki Bot
2025-09-29 19:44:11 +00:00
parent f61e271e11
commit da6fa5e65f

View File

@@ -230,7 +230,9 @@
* - `drawIndirectFirstInstance` * - `drawIndirectFirstInstance`
* - `sampleRateShading` * - `sampleRateShading`
* *
* You can remove some of these requirements to increase compatibility with Android devices by using these properties when creating the GPU device with SDL_CreateGPUDeviceWithProperties(): * You can remove some of these requirements to increase compatibility with
* Android devices by using these properties when creating the GPU device with
* SDL_CreateGPUDeviceWithProperties():
* *
* - SDL_PROP_GPU_DEVICE_CREATE_FEATURE_CLIP_DISTANCE_BOOLEAN * - SDL_PROP_GPU_DEVICE_CREATE_FEATURE_CLIP_DISTANCE_BOOLEAN
* - SDL_PROP_GPU_DEVICE_CREATE_FEATURE_DEPTH_CLAMPING_BOOLEAN * - SDL_PROP_GPU_DEVICE_CREATE_FEATURE_DEPTH_CLAMPING_BOOLEAN
@@ -245,7 +247,9 @@
* (GDK). Requires a GPU that supports DirectX 12 Feature Level 11_0 and * (GDK). Requires a GPU that supports DirectX 12 Feature Level 11_0 and
* Resource Binding Tier 2 or above. * Resource Binding Tier 2 or above.
* *
* You can remove the Tier 2 resource binding requirement to support Intel Haswell and Broadwell GPUs by using this property when creating the GPU device with SDL_CreateGPUDeviceWithProperties(): * You can remove the Tier 2 resource binding requirement to support Intel
* Haswell and Broadwell GPUs by using this property when creating the GPU
* device with SDL_CreateGPUDeviceWithProperties():
* *
* - SDL_PROP_GPU_DEVICE_CREATE_D3D12_ALLOW_FEWER_RESOURCE_SLOTS_BOOLEAN * - SDL_PROP_GPU_DEVICE_CREATE_D3D12_ALLOW_FEWER_RESOURCE_SLOTS_BOOLEAN
* *
@@ -2253,22 +2257,27 @@ extern SDL_DECLSPEC SDL_GPUDevice * SDLCALL SDL_CreateGPUDevice(
* useful debug information on device creation, defaults to true. * useful debug information on device creation, defaults to true.
* - `SDL_PROP_GPU_DEVICE_CREATE_NAME_STRING`: the name of the GPU driver to * - `SDL_PROP_GPU_DEVICE_CREATE_NAME_STRING`: the name of the GPU driver to
* use, if a specific one is desired. * use, if a specific one is desired.
* - `SDL_PROP_GPU_DEVICE_CREATE_FEATURE_CLIP_DISTANCE_BOOLEAN`: Enable * - `SDL_PROP_GPU_DEVICE_CREATE_FEATURE_CLIP_DISTANCE_BOOLEAN`: Enable Vulkan
* Vulkan device feature shaderClipDistance. If disabled, clip distances are not * device feature shaderClipDistance. If disabled, clip distances are not
* supported in shader code: gl_ClipDistance[] built-ins of GLSL, * supported in shader code: gl_ClipDistance[] built-ins of GLSL,
* SV_ClipDistance0/1 semantics of HLSL and [[clip_distance]] attribute of * SV_ClipDistance0/1 semantics of HLSL and [[clip_distance]] attribute of
* Metal. Disabling optional features allows the application to run on some older Android devices. Defaults to true. * Metal. Disabling optional features allows the application to run on some
* - `SDL_PROP_GPU_DEVICE_CREATE_FEATURE_DEPTH_CLAMPING_BOOLEAN`: Enable Vulkan device * older Android devices. Defaults to true.
* feature depthClamp. If disabled, there is no depth clamp support and * - `SDL_PROP_GPU_DEVICE_CREATE_FEATURE_DEPTH_CLAMPING_BOOLEAN`: Enable
* enable_depth_clip in SDL_GPURasterizerState must always be set to true. * Vulkan device feature depthClamp. If disabled, there is no depth clamp
* Disabling optional features allows the application to run on some older Android devices. Defaults to true. * support and enable_depth_clip in SDL_GPURasterizerState must always be
* - `SDL_PROP_GPU_DEVICE_CREATE_FEATURE_INDIRECT_DRAW_FIRST_INSTANCE_BOOLEAN`: Enable * set to true. Disabling optional features allows the application to run on
* Vulkan device feature drawIndirectFirstInstance. If disabled, the argument * some older Android devices. Defaults to true.
* first_instance of SDL_GPUIndirectDrawCommand must be set to zero. * - `SDL_PROP_GPU_DEVICE_CREATE_FEATURE_INDIRECT_DRAW_FIRST_INSTANCE_BOOLEAN`:
* Disabling optional features allows the application to run on some older Android devices. Defaults to true. * Enable Vulkan device feature drawIndirectFirstInstance. If disabled, the
* - `SDL_PROP_GPU_DEVICE_CREATE_FEATURE_ANISOTROPY_BOOLEAN`: Enable * argument first_instance of SDL_GPUIndirectDrawCommand must be set to
* Vulkan device feature samplerAnisotropy. If disabled, enable_anisotropy of * zero. Disabling optional features allows the application to run on some
* SDL_GPUSamplerCreateInfo must be set to false. Disabling optional features allows the application to run on some older Android devices. Defaults to true. * older Android devices. Defaults to true.
* - `SDL_PROP_GPU_DEVICE_CREATE_FEATURE_ANISOTROPY_BOOLEAN`: Enable Vulkan
* device feature samplerAnisotropy. If disabled, enable_anisotropy of
* SDL_GPUSamplerCreateInfo must be set to false. Disabling optional
* features allows the application to run on some older Android devices.
* Defaults to true.
* *
* These are the current shader format properties: * These are the current shader format properties:
* *