From 83cbf7f81183a21b2f3b11cf9e92db4b052e99c5 Mon Sep 17 00:00:00 2001
From: SDL Wiki Bot <[EMAIL REDACTED]>
Date: Wed, 14 May 2025 00:29:20 +0000
Subject: [PATCH] Sync SDL3 wiki -> header
[ci skip]
---
include/SDL3/SDL_gpu.h | 29 ++++++++++++++++-------------
1 file changed, 16 insertions(+), 13 deletions(-)
diff --git a/include/SDL3/SDL_gpu.h b/include/SDL3/SDL_gpu.h
index c627b268e03fb..a99822aba2bfe 100644
--- a/include/SDL3/SDL_gpu.h
+++ b/include/SDL3/SDL_gpu.h
@@ -2256,19 +2256,22 @@ extern SDL_DECLSPEC SDL_GPUDevice * SDLCALL SDL_CreateGPUDevice(
*
* With the Vulkan renderer:
*
- * - `SDL_PROP_GPU_DEVICE_CREATE_VULKAN_SHADERCLIPDISTANCE_BOOL`: Enable device feature
- * shaderClipDistance. If disabled, clip distances are not supported in shader code:
- * gl_ClipDistance[] built-ins of GLSL, SV_ClipDistance0/1 semantics of HLSL and
- * [[clip_distance]] attribute of Metal. Defaults to true.
- * - `SDL_PROP_GPU_DEVICE_CREATE_VULKAN_DEPTHCLAMP_BOOL`: Enable device feature
- * depthClamp. If disabled, there is no depth clamp support and enable_depth_clip in
- * SDL_GPURasterizerState must always be set to true. Defaults to true.
- * - `SDL_PROP_GPU_DEVICE_CREATE_VULKAN_DRAWINDIRECTFIRST_BOOL`: Enable device feature
- * drawIndirectFirstInstance. If disabled, the argument first_instance of
- * SDL_GPUIndirectDrawCommand must be set to zero. Defaults to true.
- * - `SDL_PROP_GPU_DEVICE_CREATE_VULKAN_SAMPLERANISOTROPY_BOOL`: Enable device feature
- * samplerAnisotropy. If disabled, enable_anisotropy of SDL_GPUSamplerCreateInfo must
- * be set to false. Defaults to true.
+ * - `SDL_PROP_GPU_DEVICE_CREATE_VULKAN_SHADERCLIPDISTANCE_BOOL`: Enable
+ * device feature shaderClipDistance. If disabled, clip distances are not
+ * supported in shader code: gl_ClipDistance[] built-ins of GLSL,
+ * SV_ClipDistance0/1 semantics of HLSL and [[clip_distance]] attribute of
+ * Metal. Defaults to true.
+ * - `SDL_PROP_GPU_DEVICE_CREATE_VULKAN_DEPTHCLAMP_BOOL`: Enable device
+ * feature depthClamp. If disabled, there is no depth clamp support and
+ * enable_depth_clip in SDL_GPURasterizerState must always be set to true.
+ * Defaults to true.
+ * - `SDL_PROP_GPU_DEVICE_CREATE_VULKAN_DRAWINDIRECTFIRST_BOOL`: Enable device
+ * feature drawIndirectFirstInstance. If disabled, the argument
+ * first_instance of SDL_GPUIndirectDrawCommand must be set to zero.
+ * Defaults to true.
+ * - `SDL_PROP_GPU_DEVICE_CREATE_VULKAN_SAMPLERANISOTROPY_BOOL`: Enable device
+ * feature samplerAnisotropy. If disabled, enable_anisotropy of
+ * SDL_GPUSamplerCreateInfo must be set to false. Defaults to true.
*
* \param props the properties to use.
* \returns a GPU context on success or NULL on failure; call SDL_GetError()