eden-emu/SDL
15
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2025-05-30 00:17:40 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Sync SDL3 wiki -> header

Browse source 
[ci skip]
This commit is contained in:
SDL Wiki Bot 2025-04-04 14:35:40 +00:00
parent 906c6c7516
commit 0c9eccd0ea
1 changed files with 44 additions and 71 deletions
Download patch file Download diff file Expand all files Collapse all files

115
include/SDL3/SDL_gpu.h
View file

@ -2270,88 +2270,59 @@ extern SDL_DECLSPEC SDL_GPUShaderFormat SDLCALL SDL_GetGPUShaderFormats(SDL_GPUD
* *
* - `SDL_PROP_GPU_DEVICE_NAME_STRING`: * - `SDL_PROP_GPU_DEVICE_NAME_STRING`:
* *
* > Contains the name of the underlying device as reported by the system * > Contains the name of the underlying device as reported by the system >
* > driver. This string has no standardized format, is highly inconsistent * driver. This string has no standardized format, is highly inconsistent >
* > between hardware devices and drivers, and is able to change at any time. Do * between hardware devices and drivers, and is able to change at any time. Do
* > not attempt to parse this string as it is bound to fail at some point in * > not attempt to parse this string as it is bound to fail at some point in
* > the future when system drivers are updated, new hardware devices are * > the future when system drivers are updated, new hardware devices are >
* > introduced, or when SDL adds new GPU backends or modifies existing ones. * introduced, or when SDL adds new GPU backends or modifies existing ones. >
* > * > Strings that have been found in the wild include: > > - GTX 970 > -
* > Strings that have been found in the wild include: * GeForce GTX 970 > - NVIDIA GeForce GTX 970 > - Microsoft Direct3D12 (NVIDIA
* > * GeForce GTX 970) > - NVIDIA Graphics Device > - GeForce GPU > - P106-100 >
* > - GTX 970 * - AMD 15D8:C9 > - AMD Custom GPU 0405 > - AMD Radeon (TM) Graphics > - ASUS
* > - GeForce GTX 970 * Radeon RX 470 Series > - Intel(R) Arc(tm) A380 Graphics (DG2) > -
* > - NVIDIA GeForce GTX 970 * Virtio-GPU Venus (NVIDIA TITAN V) > - SwiftShader Device (LLVM 16.0.0) > -
* > - Microsoft Direct3D12 (NVIDIA GeForce GTX 970) * llvmpipe (LLVM 15.0.4, 256 bits) > - Microsoft Basic Render Driver > -
* > - NVIDIA Graphics Device * unknown device > > The above list shows that the same device can have
* > - GeForce GPU * different formats, the > vendor name may or may not appear in the string,
* > - P106-100 * the included vendor name > may not be the vendor of the chipset on the
* > - AMD 15D8:C9 * device, some manufacturers > include pseudo-legal marks while others don't,
* > - AMD Custom GPU 0405 * some devices may not use a > marketing name in the string, the device
* > - AMD Radeon (TM) Graphics * string may be wrapped by the name > of a translation interface, the device
* > - ASUS Radeon RX 470 Series * may be emulated in software, or the > string may contain generic text that
* > - Intel(R) Arc(tm) A380 Graphics (DG2) * does not identify the device at all.
* > - Virtio-GPU Venus (NVIDIA TITAN V)
* > - SwiftShader Device (LLVM 16.0.0)
* > - llvmpipe (LLVM 15.0.4, 256 bits)
* > - Microsoft Basic Render Driver
* > - unknown device
* >
* > The above list shows that the same device can have different formats, the
* > vendor name may or may not appear in the string, the included vendor name
* > may not be the vendor of the chipset on the device, some manufacturers
* > include pseudo-legal marks while others don't, some devices may not use a
* > marketing name in the string, the device string may be wrapped by the name
* > of a translation interface, the device may be emulated in software, or the
* > string may contain generic text that does not identify the device at all.
* *
* - `SDL_PROP_GPU_DEVICE_DRIVER_NAME_STRING`: * - `SDL_PROP_GPU_DEVICE_DRIVER_NAME_STRING`:
* *
* > Contains the self-reported name of the underlying system driver. * > Contains the self-reported name of the underlying system driver. > >
* > * Strings that have been found in the wild include: > > - Intel Corporation >
* > Strings that have been found in the wild include: * - Intel open-source Mesa driver > - Qualcomm Technologies Inc. Adreno
* > * Vulkan Driver > - MoltenVK > - Mali-G715 > - venus
* > - Intel Corporation
* > - Intel open-source Mesa driver
* > - Qualcomm Technologies Inc. Adreno Vulkan Driver
* > - MoltenVK
* > - Mali-G715
* > - venus
* *
* - `SDL_PROP_GPU_DEVICE_DRIVER_VERSION_STRING`: * - `SDL_PROP_GPU_DEVICE_DRIVER_VERSION_STRING`:
* *
* > Contains the self-reported version of the underlying system driver. This is * > Contains the self-reported version of the underlying system driver. This
* > a relatively short version string in an unspecified format. If * is > a relatively short version string in an unspecified format. If >
* > SDL_PROP_GPU_DEVICE_DRIVER_INFO_STRING is available then that * SDL_PROP_GPU_DEVICE_DRIVER_INFO_STRING is available then that > property
* > property should be preferred over this one as it may contain additional * should be preferred over this one as it may contain additional >
* > information that is useful for identifying the exact driver version used. * information that is useful for identifying the exact driver version used. >
* > * > Strings that have been found in the wild include: > > - 53.0.0 > -
* > Strings that have been found in the wild include: * 0.405.2463 > - 32.0.15.6614
* >
* > - 53.0.0
* > - 0.405.2463
* > - 32.0.15.6614
* *
* - `SDL_PROP_GPU_DEVICE_DRIVER_INFO_STRING`: * - `SDL_PROP_GPU_DEVICE_DRIVER_INFO_STRING`:
* *
* > Contains the detailed version information of the underlying system driver * > Contains the detailed version information of the underlying system driver
* > as reported by the driver. This is an arbitrary string with no standardized * > as reported by the driver. This is an arbitrary string with no
* > format and it may contain newlines. This property should be preferred over * standardized > format and it may contain newlines. This property should be
* > SDL_PROP_GPU_DEVICE_DRIVER_VERSION_STRING if it is available as it * preferred over > SDL_PROP_GPU_DEVICE_DRIVER_VERSION_STRING if it is
* > usually contains the same information but in a format that is easier to * available as it > usually contains the same information but in a format
* > read. * that is easier to > read. > > Strings that have been found in the wild
* > * include: > > - 101.6559 > - 1.2.11 > - Mesa 21.2.2 (LLVM 12.0.1) > - Mesa
* > Strings that have been found in the wild include: * 22.2.0-devel (git-f226222 2022-04-14 impish-oibaf-ppa) > -
* > * v1.r53p0-00eac0.824c4f31403fb1fbf8ee1042422c2129 > > As well as the
* > - 101.6559 * multiline string (which has a trailing newline): > > >
* > - 1.2.11 *
* > - Mesa 21.2.2 (LLVM 12.0.1) * ```
* > - Mesa 22.2.0-devel (git-f226222 2022-04-14 impish-oibaf-ppa)
* > - v1.r53p0-00eac0.824c4f31403fb1fbf8ee1042422c2129
* >
* > As well as the multiline string (which has a trailing newline):
* >
* > > ```
* > > Driver Build: 85da404, I46ff5fc46f, 1606794520 * > > Driver Build: 85da404, I46ff5fc46f, 1606794520
* > > Date: 11/30/20 * > > Date: 11/30/20
* > > Compiler Version: EV031.31.04.01 * > > Compiler Version: EV031.31.04.01
@ -4332,3 +4303,5 @@ extern SDL_DECLSPEC void SDLCALL SDL_GDKResumeGPU(SDL_GPUDevice *device);
#include <SDL3/SDL_close_code.h> #include <SDL3/SDL_close_code.h>
#endif /* SDL_gpu_h_ */ #endif /* SDL_gpu_h_ */