wine/vkd3d
0
0
Fork 0
mirror of https://gitlab.winehq.org/wine/vkd3d.git synced 2024-11-21 16:46:41 -08:00
Code Issues Packages Projects Releases Wiki Activity

vkd3d-shader: Introduce documented semantics for the target type and other data passed to vkd3d_shader_scan().

Browse Source 
Passing VKD3D_SHADER_TARGET_NONE was actually already allowed.
This commit is contained in:
Zebediah Figura 2023-06-25 13:20:53 -05:00 committed by Alexandre Julliard
parent 5e88ab22aa
commit 7b9eb8d189
Notes: Alexandre Julliard 2023-06-27 23:33:23 +02:00 
Approved-by: Giovanni Mascellani (@giomasce)
Approved-by: Henri Verbeet (@hverbeet)
Approved-by: Alexandre Julliard (@julliard)
Merge-Request: https://gitlab.winehq.org/wine/vkd3d/-/merge_requests/200
1 changed files with 21 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
include/vkd3d_shader.h
View File

@ -620,7 +620,7 @@ enum vkd3d_shader_target_type
{
/**
* The shader has no type or is to be ignored. This is not a valid value
* for vkd3d_shader_compile() or vkd3d_shader_scan().
* for vkd3d_shader_compile().
*/
VKD3D_SHADER_TARGET_NONE,
/**
@ -1784,6 +1784,26 @@ VKD3D_SHADER_API int vkd3d_shader_convert_root_signature(struct vkd3d_shader_ver
* Parse shader source code or byte code, returning various types of requested
* information.
*
* The \a source_type member of \a compile_info must be set to the type of the
* shader.
*
* The \a target_type member may be set to VKD3D_SHADER_TARGET_NONE, in which
* case vkd3d_shader_scan() will return information about the shader in
* isolation. Alternatively, it may be set to a valid compilation target for the
* shader, in which case vkd3d_shader_scan() will return information that
* reflects the interface for a shader as it will be compiled to that target.
* In this case other chained structures may be appended to \a compile_info as
* they would be passed to vkd3d_shader_compile(), and interpreted accordingly,
* such as vkd3d_shader_spirv_target_info.
*
* (For a hypothetical example, suppose the source shader distinguishes float
* and integer texture data, but the target environment does not support integer
* textures. In this case vkd3d_shader_compile() might translate integer
* operations to float. Accordingly using VKD3D_SHADER_TARGET_NONE would
* accurately report whether the texture expects integer or float data, but
* using the relevant specific target type would report
* VKD3D_SHADER_RESOURCE_DATA_FLOAT.)
*
* Currently this function supports the following code types:
* - VKD3D_SHADER_SOURCE_DXBC_TPF
*