mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2025-09-06 03:18:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

GPU: Add remarks about point topology

Browse Source
This commit is contained in:
cosmonaut
2025-01-17 14:25:14 -08:00
parent 59ea078ee2
commit d4d22dd8de
1 changed files with 7 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
include/SDL3/SDL_gpu.h
View File

@@ -515,6 +515,13 @@ typedef struct SDL_GPUFence SDL_GPUFence;
/** /**
* Specifies the primitive topology of a graphics pipeline. * Specifies the primitive topology of a graphics pipeline.
* *
* If you are using POINTLIST you must include a point size output in the vertex shader.
* For HLSL compiling to SPIRV you must decorate a float output with [[vk::builtin("PointSize")]].
* FOR GLSL you must set the gl_PointSize builtin.
* For MSL you must include a float output with the [[point_size]] decorator.
* Note that sized point topology is totally unsupported on D3D12. Any size other than 1 will be ignored.
* In general, you should avoid using point topology for both compatibility and performance reasons. You WILL regret using it.
*
* \since This enum is available since SDL 3.1.3 * \since This enum is available since SDL 3.1.3
* *
* \sa SDL_CreateGPUGraphicsPipeline * \sa SDL_CreateGPUGraphicsPipeline