vkd3d 1.16
The vkd3d 3D Graphics Library
Loading...
Searching...
No Matches
vkd3d_shader.h
Go to the documentation of this file.
1/*
2 * Copyright 2017-2019 Józef Kucia for CodeWeavers
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
17 */
18
19#ifndef __VKD3D_SHADER_H
20#define __VKD3D_SHADER_H
21
22#include <stdbool.h>
23#include <stdint.h>
24#include <stddef.h>
25#include <vkd3d_types.h>
26
27#ifdef __cplusplus
28extern "C" {
29#endif /* __cplusplus */
30
41
44{
45 VKD3D_SHADER_API_VERSION_1_0,
46 VKD3D_SHADER_API_VERSION_1_1,
47 VKD3D_SHADER_API_VERSION_1_2,
48 VKD3D_SHADER_API_VERSION_1_3,
49 VKD3D_SHADER_API_VERSION_1_4,
50 VKD3D_SHADER_API_VERSION_1_5,
51 VKD3D_SHADER_API_VERSION_1_6,
52 VKD3D_SHADER_API_VERSION_1_7,
53 VKD3D_SHADER_API_VERSION_1_8,
54 VKD3D_SHADER_API_VERSION_1_9,
55 VKD3D_SHADER_API_VERSION_1_10,
56 VKD3D_SHADER_API_VERSION_1_11,
57 VKD3D_SHADER_API_VERSION_1_12,
58 VKD3D_SHADER_API_VERSION_1_13,
59 VKD3D_SHADER_API_VERSION_1_14,
60 VKD3D_SHADER_API_VERSION_1_15,
61 VKD3D_SHADER_API_VERSION_1_16,
62
63 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_API_VERSION),
64};
65
125
141
158
160{
161 VKD3D_SHADER_COMPILE_OPTION_FORMATTING_NONE = 0x00000000,
162 VKD3D_SHADER_COMPILE_OPTION_FORMATTING_COLOUR = 0x00000001,
163 VKD3D_SHADER_COMPILE_OPTION_FORMATTING_INDENT = 0x00000002,
164 VKD3D_SHADER_COMPILE_OPTION_FORMATTING_OFFSETS = 0x00000004,
165 VKD3D_SHADER_COMPILE_OPTION_FORMATTING_HEADER = 0x00000008,
166 VKD3D_SHADER_COMPILE_OPTION_FORMATTING_RAW_IDS = 0x00000010,
173
174 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_COMPILE_OPTION_FORMATTING_FLAGS),
175};
176
179{
180 VKD3D_SHADER_COMPILE_OPTION_PACK_MATRIX_ROW_MAJOR = 0x00000001,
181 VKD3D_SHADER_COMPILE_OPTION_PACK_MATRIX_COLUMN_MAJOR = 0x00000002,
182
183 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_COMPILE_OPTION_PACK_MATRIX_ORDER),
184};
185
215
232
260
267{
271
272 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_PARSE_DXBC_FLAGS),
273};
274
375
391
413
416{
424 const void *code;
426 size_t size;
427};
428
455
461{
466 unsigned int set;
468 unsigned int binding;
474 unsigned int count;
475};
476
477enum vkd3d_shader_binding_flag
478{
479 VKD3D_SHADER_BINDING_FLAG_BUFFER = 0x00000001,
480 VKD3D_SHADER_BINDING_FLAG_IMAGE = 0x00000002,
481
482 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_BINDING_FLAG),
483};
484
502{
549
550 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_FOG_FRAGMENT_MODE),
551};
552
591
597{
598 VKD3D_SHADER_PARAMETER_TYPE_UNKNOWN,
613
614 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_PARAMETER_TYPE),
615};
616
622{
623 VKD3D_SHADER_PARAMETER_DATA_TYPE_UNKNOWN,
635
636 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_PARAMETER_DATA_TYPE),
637};
638
949
955{
956 union
957 {
962 uint32_t u32;
969 float f32;
970 } u;
971};
972
980{
981 union
982 {
987 uint32_t u32;
992 float f32;
999 float f32_vec4[4];
1000 void *_pointer_pad;
1001 uint32_t _pad[4];
1002 } u;
1003};
1004
1020
1026{
1031 unsigned int set;
1033 unsigned int binding;
1035 uint32_t offset;
1036};
1037
1051{
1054 enum vkd3d_shader_parameter_data_type data_type;
1055 union
1056 {
1057 struct vkd3d_shader_parameter_immediate_constant immediate_constant;
1058 struct vkd3d_shader_parameter_specialization_constant specialization_constant;
1059 } u;
1060};
1061
1111
1132
1174
1175#define VKD3D_SHADER_DUMMY_SAMPLER_INDEX ~0u
1176
1207
1229
1237{
1242 unsigned int register_space;
1244 unsigned int register_index;
1247
1249 unsigned int offset;
1251 unsigned int size;
1252};
1253
1297
1299{
1300 unsigned int stream_index;
1301 const char *semantic_name;
1302 unsigned int semantic_index;
1303 uint8_t component_index;
1304 uint8_t component_count;
1305 uint8_t output_slot;
1306};
1307
1308/* Extends vkd3d_shader_interface_info. */
1310{
1312 const void *next;
1313
1314 const struct vkd3d_shader_transform_feedback_element *elements;
1315 unsigned int element_count;
1316 const unsigned int *buffer_strides;
1317 unsigned int buffer_stride_count;
1318};
1319
1321{
1322 unsigned int static_offset;
1323 unsigned int dynamic_offset_index;
1324};
1325
1403
1437
1482
1502
1547
1549{
1550 VKD3D_SHADER_SPIRV_ENVIRONMENT_NONE,
1551 VKD3D_SHADER_SPIRV_ENVIRONMENT_OPENGL_4_5,
1552 VKD3D_SHADER_SPIRV_ENVIRONMENT_VULKAN_1_0, /* default target */
1555
1556 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SPIRV_ENVIRONMENT),
1557};
1558
1560{
1561 VKD3D_SHADER_SPIRV_EXTENSION_NONE,
1562 VKD3D_SHADER_SPIRV_EXTENSION_EXT_DEMOTE_TO_HELPER_INVOCATION,
1571
1572 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SPIRV_EXTENSION),
1573};
1574
1575/* Extends vkd3d_shader_compile_info. */
1577{
1579 const void *next;
1580
1581 const char *entry_point; /* "main" if NULL. */
1582
1583 enum vkd3d_shader_spirv_environment environment;
1584
1585 const enum vkd3d_shader_spirv_extension *extensions;
1586 unsigned int extension_count;
1587
1588 const struct vkd3d_shader_parameter *parameters;
1589 unsigned int parameter_count;
1590
1591 bool dual_source_blending;
1592 const unsigned int *output_swizzles;
1593 unsigned int output_swizzle_count;
1594};
1595
1596enum vkd3d_shader_tessellator_output_primitive
1597{
1598 VKD3D_SHADER_TESSELLATOR_OUTPUT_POINT = 0x1,
1599 VKD3D_SHADER_TESSELLATOR_OUTPUT_LINE = 0x2,
1600 VKD3D_SHADER_TESSELLATOR_OUTPUT_TRIANGLE_CW = 0x3,
1601 VKD3D_SHADER_TESSELLATOR_OUTPUT_TRIANGLE_CCW = 0x4,
1602
1603 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_TESSELLATOR_OUTPUT_PRIMITIVE),
1604};
1605
1606enum vkd3d_shader_tessellator_partitioning
1607{
1608 VKD3D_SHADER_TESSELLATOR_PARTITIONING_INTEGER = 0x1,
1609 VKD3D_SHADER_TESSELLATOR_PARTITIONING_POW2 = 0x2,
1610 VKD3D_SHADER_TESSELLATOR_PARTITIONING_FRACTIONAL_ODD = 0x3,
1611 VKD3D_SHADER_TESSELLATOR_PARTITIONING_FRACTIONAL_EVEN = 0x4,
1612
1613 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_TESSELLATOR_PARTITIONING),
1614};
1615
1616/* Extends vkd3d_shader_spirv_target_info. */
1618{
1620 const void *next;
1621
1622 enum vkd3d_shader_tessellator_output_primitive output_primitive;
1623 enum vkd3d_shader_tessellator_partitioning partitioning;
1624};
1625
1631{
1637 const char *name;
1643 const char *value;
1644};
1645
1674typedef int (*PFN_vkd3d_shader_open_include)(const char *filename, bool local,
1675 const char *parent_data, void *context, struct vkd3d_shader_code *out);
1690typedef void (*PFN_vkd3d_shader_close_include)(const struct vkd3d_shader_code *code, void *context);
1691
1751
1764{
1768 const void *next;
1769
1776 const char *entry_point;
1777 struct vkd3d_shader_code secondary_code;
1782 const char *profile;
1783};
1784
1785/* root signature 1.0 */
1786enum vkd3d_shader_filter
1787{
1788 VKD3D_SHADER_FILTER_MIN_MAG_MIP_POINT = 0x000,
1789 VKD3D_SHADER_FILTER_MIN_MAG_POINT_MIP_LINEAR = 0x001,
1790 VKD3D_SHADER_FILTER_MIN_POINT_MAG_LINEAR_MIP_POINT = 0x004,
1791 VKD3D_SHADER_FILTER_MIN_POINT_MAG_MIP_LINEAR = 0x005,
1792 VKD3D_SHADER_FILTER_MIN_LINEAR_MAG_MIP_POINT = 0x010,
1793 VKD3D_SHADER_FILTER_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x011,
1794 VKD3D_SHADER_FILTER_MIN_MAG_LINEAR_MIP_POINT = 0x014,
1795 VKD3D_SHADER_FILTER_MIN_MAG_MIP_LINEAR = 0x015,
1796 VKD3D_SHADER_FILTER_ANISOTROPIC = 0x055,
1797 VKD3D_SHADER_FILTER_COMPARISON_MIN_MAG_MIP_POINT = 0x080,
1798 VKD3D_SHADER_FILTER_COMPARISON_MIN_MAG_POINT_MIP_LINEAR = 0x081,
1799 VKD3D_SHADER_FILTER_COMPARISON_MIN_POINT_MAG_LINEAR_MIP_POINT = 0x084,
1800 VKD3D_SHADER_FILTER_COMPARISON_MIN_POINT_MAG_MIP_LINEAR = 0x085,
1801 VKD3D_SHADER_FILTER_COMPARISON_MIN_LINEAR_MAG_MIP_POINT = 0x090,
1802 VKD3D_SHADER_FILTER_COMPARISON_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x091,
1803 VKD3D_SHADER_FILTER_COMPARISON_MIN_MAG_LINEAR_MIP_POINT = 0x094,
1804 VKD3D_SHADER_FILTER_COMPARISON_MIN_MAG_MIP_LINEAR = 0x095,
1805 VKD3D_SHADER_FILTER_COMPARISON_ANISOTROPIC = 0x0d5,
1806 VKD3D_SHADER_FILTER_MINIMUM_MIN_MAG_MIP_POINT = 0x100,
1807 VKD3D_SHADER_FILTER_MINIMUM_MIN_MAG_POINT_MIP_LINEAR = 0x101,
1808 VKD3D_SHADER_FILTER_MINIMUM_MIN_POINT_MAG_LINEAR_MIP_POINT = 0x104,
1809 VKD3D_SHADER_FILTER_MINIMUM_MIN_POINT_MAG_MIP_LINEAR = 0x105,
1810 VKD3D_SHADER_FILTER_MINIMUM_MIN_LINEAR_MAG_MIP_POINT = 0x110,
1811 VKD3D_SHADER_FILTER_MINIMUM_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x111,
1812 VKD3D_SHADER_FILTER_MINIMUM_MIN_MAG_LINEAR_MIP_POINT = 0x114,
1813 VKD3D_SHADER_FILTER_MINIMUM_MIN_MAG_MIP_LINEAR = 0x115,
1814 VKD3D_SHADER_FILTER_MINIMUM_ANISOTROPIC = 0x155,
1815 VKD3D_SHADER_FILTER_MAXIMUM_MIN_MAG_MIP_POINT = 0x180,
1816 VKD3D_SHADER_FILTER_MAXIMUM_MIN_MAG_POINT_MIP_LINEAR = 0x181,
1817 VKD3D_SHADER_FILTER_MAXIMUM_MIN_POINT_MAG_LINEAR_MIP_POINT = 0x184,
1818 VKD3D_SHADER_FILTER_MAXIMUM_MIN_POINT_MAG_MIP_LINEAR = 0x185,
1819 VKD3D_SHADER_FILTER_MAXIMUM_MIN_LINEAR_MAG_MIP_POINT = 0x190,
1820 VKD3D_SHADER_FILTER_MAXIMUM_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x191,
1821 VKD3D_SHADER_FILTER_MAXIMUM_MIN_MAG_LINEAR_MIP_POINT = 0x194,
1822 VKD3D_SHADER_FILTER_MAXIMUM_MIN_MAG_MIP_LINEAR = 0x195,
1823 VKD3D_SHADER_FILTER_MAXIMUM_ANISOTROPIC = 0x1d5,
1824
1825 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_FILTER),
1826};
1827
1828enum vkd3d_shader_texture_address_mode
1829{
1830 VKD3D_SHADER_TEXTURE_ADDRESS_MODE_WRAP = 0x1,
1831 VKD3D_SHADER_TEXTURE_ADDRESS_MODE_MIRROR = 0x2,
1832 VKD3D_SHADER_TEXTURE_ADDRESS_MODE_CLAMP = 0x3,
1833 VKD3D_SHADER_TEXTURE_ADDRESS_MODE_BORDER = 0x4,
1834 VKD3D_SHADER_TEXTURE_ADDRESS_MODE_MIRROR_ONCE = 0x5,
1835
1836 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_TEXTURE_ADDRESS_MODE),
1837};
1838
1839enum vkd3d_shader_comparison_func
1840{
1841 VKD3D_SHADER_COMPARISON_FUNC_NEVER = 0x1,
1842 VKD3D_SHADER_COMPARISON_FUNC_LESS = 0x2,
1843 VKD3D_SHADER_COMPARISON_FUNC_EQUAL = 0x3,
1844 VKD3D_SHADER_COMPARISON_FUNC_LESS_EQUAL = 0x4,
1845 VKD3D_SHADER_COMPARISON_FUNC_GREATER = 0x5,
1846 VKD3D_SHADER_COMPARISON_FUNC_NOT_EQUAL = 0x6,
1847 VKD3D_SHADER_COMPARISON_FUNC_GREATER_EQUAL = 0x7,
1848 VKD3D_SHADER_COMPARISON_FUNC_ALWAYS = 0x8,
1849
1850 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_COMPARISON_FUNC),
1851};
1852
1853enum vkd3d_shader_static_border_colour
1854{
1855 VKD3D_SHADER_STATIC_BORDER_COLOUR_TRANSPARENT_BLACK = 0x0,
1856 VKD3D_SHADER_STATIC_BORDER_COLOUR_OPAQUE_BLACK = 0x1,
1857 VKD3D_SHADER_STATIC_BORDER_COLOUR_OPAQUE_WHITE = 0x2,
1858
1859 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_STATIC_BORDER_COLOUR),
1860};
1861
1863{
1864 enum vkd3d_shader_filter filter;
1865 enum vkd3d_shader_texture_address_mode address_u;
1866 enum vkd3d_shader_texture_address_mode address_v;
1867 enum vkd3d_shader_texture_address_mode address_w;
1868 float mip_lod_bias;
1869 unsigned int max_anisotropy;
1870 enum vkd3d_shader_comparison_func comparison_func;
1871 enum vkd3d_shader_static_border_colour border_colour;
1872 float min_lod;
1873 float max_lod;
1874 unsigned int shader_register;
1875 unsigned int register_space;
1876 enum vkd3d_shader_visibility shader_visibility;
1877};
1878
1880{
1881 enum vkd3d_shader_descriptor_type range_type;
1882 unsigned int descriptor_count;
1883 unsigned int base_shader_register;
1884 unsigned int register_space;
1885 unsigned int descriptor_table_offset;
1886};
1887
1889{
1890 unsigned int descriptor_range_count;
1891 const struct vkd3d_shader_descriptor_range *descriptor_ranges;
1892};
1893
1895{
1896 unsigned int shader_register;
1897 unsigned int register_space;
1898 unsigned int value_count;
1899};
1900
1902{
1903 unsigned int shader_register;
1904 unsigned int register_space;
1905};
1906
1907enum vkd3d_shader_root_parameter_type
1908{
1909 VKD3D_SHADER_ROOT_PARAMETER_TYPE_DESCRIPTOR_TABLE = 0x0,
1910 VKD3D_SHADER_ROOT_PARAMETER_TYPE_32BIT_CONSTANTS = 0x1,
1911 VKD3D_SHADER_ROOT_PARAMETER_TYPE_CBV = 0x2,
1912 VKD3D_SHADER_ROOT_PARAMETER_TYPE_SRV = 0x3,
1913 VKD3D_SHADER_ROOT_PARAMETER_TYPE_UAV = 0x4,
1914
1915 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_ROOT_PARAMETER_TYPE),
1916};
1917
1919{
1920 enum vkd3d_shader_root_parameter_type parameter_type;
1921 union
1922 {
1923 struct vkd3d_shader_root_descriptor_table descriptor_table;
1924 struct vkd3d_shader_root_constants constants;
1925 struct vkd3d_shader_root_descriptor descriptor;
1926 } u;
1927 enum vkd3d_shader_visibility shader_visibility;
1928};
1929
1930enum vkd3d_shader_root_signature_flags
1931{
1932 VKD3D_SHADER_ROOT_SIGNATURE_FLAG_NONE = 0x00,
1933 VKD3D_SHADER_ROOT_SIGNATURE_FLAG_ALLOW_INPUT_ASSEMBLER_INPUT_LAYOUT = 0x01,
1934 VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_VERTEX_SHADER_ROOT_ACCESS = 0x02,
1935 VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_HULL_SHADER_ROOT_ACCESS = 0x04,
1936 VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_DOMAIN_SHADER_ROOT_ACCESS = 0x08,
1937 VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_GEOMETRY_SHADER_ROOT_ACCESS = 0x10,
1938 VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_PIXEL_SHADER_ROOT_ACCESS = 0x20,
1939 VKD3D_SHADER_ROOT_SIGNATURE_FLAG_ALLOW_STREAM_OUTPUT = 0x40,
1940
1941 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_ROOT_SIGNATURE_FLAGS),
1942};
1943
1945{
1946 unsigned int parameter_count;
1947 const struct vkd3d_shader_root_parameter *parameters;
1948 unsigned int static_sampler_count;
1949 const struct vkd3d_shader_static_sampler_desc *static_samplers;
1950 enum vkd3d_shader_root_signature_flags flags;
1951};
1952
1953/* root signature 1.1 */
1954enum vkd3d_shader_root_descriptor_flags
1955{
1956 VKD3D_SHADER_ROOT_DESCRIPTOR_FLAG_NONE = 0x0,
1957 VKD3D_SHADER_ROOT_DESCRIPTOR_FLAG_DATA_VOLATILE = 0x2,
1958 VKD3D_SHADER_ROOT_DESCRIPTOR_FLAG_DATA_STATIC_WHILE_SET_AT_EXECUTE = 0x4,
1959 VKD3D_SHADER_ROOT_DESCRIPTOR_FLAG_DATA_STATIC = 0x8,
1960
1961 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_ROOT_DESCRIPTOR_FLAGS),
1962};
1963
1965{
1966 VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_NONE = 0x0,
1967 VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DESCRIPTORS_VOLATILE = 0x1,
1968 VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DATA_VOLATILE = 0x2,
1969 VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DATA_STATIC_WHILE_SET_AT_EXECUTE = 0x4,
1970 VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DATA_STATIC = 0x8,
1973
1974 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_DESCRIPTOR_RANGE_FLAGS),
1975};
1976
1978{
1979 enum vkd3d_shader_descriptor_type range_type;
1980 unsigned int descriptor_count;
1981 unsigned int base_shader_register;
1982 unsigned int register_space;
1984 unsigned int descriptor_table_offset;
1985};
1986
1988{
1989 unsigned int descriptor_range_count;
1990 const struct vkd3d_shader_descriptor_range1 *descriptor_ranges;
1991};
1992
1994{
1995 unsigned int shader_register;
1996 unsigned int register_space;
1997 enum vkd3d_shader_root_descriptor_flags flags;
1998};
1999
2001{
2002 enum vkd3d_shader_root_parameter_type parameter_type;
2003 union
2004 {
2005 struct vkd3d_shader_root_descriptor_table1 descriptor_table;
2006 struct vkd3d_shader_root_constants constants;
2007 struct vkd3d_shader_root_descriptor1 descriptor;
2008 } u;
2009 enum vkd3d_shader_visibility shader_visibility;
2010};
2011
2013{
2014 unsigned int parameter_count;
2015 const struct vkd3d_shader_root_parameter1 *parameters;
2016 unsigned int static_sampler_count;
2017 const struct vkd3d_shader_static_sampler_desc *static_samplers;
2018 enum vkd3d_shader_root_signature_flags flags;
2019};
2020
2021enum vkd3d_shader_root_signature_version
2022{
2023 VKD3D_SHADER_ROOT_SIGNATURE_VERSION_1_0 = 0x1,
2024 VKD3D_SHADER_ROOT_SIGNATURE_VERSION_1_1 = 0x2,
2025
2026 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_ROOT_SIGNATURE_VERSION),
2027};
2028
2030{
2031 enum vkd3d_shader_root_signature_version version;
2032 union
2033 {
2036 } u;
2037};
2038
2073
2108
2132
2163
2211
2219{
2220 unsigned int resource_space;
2221 unsigned int resource_index;
2222 unsigned int sampler_space;
2223 unsigned int sampler_index;
2224};
2225
2258
2267{
2271 const void *next;
2272
2274 enum vkd3d_shader_tessellator_output_primitive output_primitive;
2276 enum vkd3d_shader_tessellator_partitioning partitioning;
2277};
2278
2310
2313{
2336 VKD3D_SHADER_SV_TESS_FACTOR_QUADEDGE = 0x0b,
2337 VKD3D_SHADER_SV_TESS_FACTOR_QUADINT = 0x0c,
2338 VKD3D_SHADER_SV_TESS_FACTOR_TRIEDGE = 0x0d,
2339 VKD3D_SHADER_SV_TESS_FACTOR_TRIINT = 0x0e,
2340 VKD3D_SHADER_SV_TESS_FACTOR_LINEDET = 0x0f,
2341 VKD3D_SHADER_SV_TESS_FACTOR_LINEDEN = 0x10,
2360
2361 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SYSVAL_SEMANTIC),
2362};
2363
2369{
2370 VKD3D_SHADER_MINIMUM_PRECISION_NONE = 0,
2379
2380 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_MINIMUM_PRECISION),
2381};
2382
2418
2433
2436{
2437 VKD3D_SHADER_SWIZZLE_X = 0x0,
2438 VKD3D_SHADER_SWIZZLE_Y = 0x1,
2439 VKD3D_SHADER_SWIZZLE_Z = 0x2,
2440 VKD3D_SHADER_SWIZZLE_W = 0x3,
2441
2442 VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SWIZZLE_COMPONENT),
2443};
2444
2457
2464{
2469 uint32_t tag;
2471 uint32_t checksum[4];
2476 unsigned int version;
2478 size_t size;
2483};
2484
2489#define VKD3D_SHADER_SWIZZLE_MASK (0xffu)
2491#define VKD3D_SHADER_SWIZZLE_SHIFT(idx) (8u * (idx))
2492
2502#define VKD3D_SHADER_SWIZZLE(x, y, z, w) \
2503 (VKD3D_SHADER_SWIZZLE_ ## x << VKD3D_SHADER_SWIZZLE_SHIFT(0) \
2504 | VKD3D_SHADER_SWIZZLE_ ## y << VKD3D_SHADER_SWIZZLE_SHIFT(1) \
2505 | VKD3D_SHADER_SWIZZLE_ ## z << VKD3D_SHADER_SWIZZLE_SHIFT(2) \
2506 | VKD3D_SHADER_SWIZZLE_ ## w << VKD3D_SHADER_SWIZZLE_SHIFT(3))
2507
2509#define VKD3D_SHADER_NO_SWIZZLE VKD3D_SHADER_SWIZZLE(X, Y, Z, W)
2510
2521
2579
2587{
2598 unsigned int input_mask;
2599};
2600
2647
2685
2686#ifdef LIBVKD3D_SHADER_SOURCE
2687# define VKD3D_SHADER_API VKD3D_EXPORT
2688#else
2689# define VKD3D_SHADER_API VKD3D_IMPORT
2690#endif
2691
2692#ifndef VKD3D_SHADER_NO_PROTOTYPES
2693
2705VKD3D_SHADER_API const char *vkd3d_shader_get_version(unsigned int *major, unsigned int *minor);
2721VKD3D_SHADER_API const enum vkd3d_shader_source_type *vkd3d_shader_get_supported_source_types(unsigned int *count);
2737 enum vkd3d_shader_source_type source_type, unsigned int *count);
2738
2810VKD3D_SHADER_API int vkd3d_shader_compile(const struct vkd3d_shader_compile_info *compile_info,
2811 struct vkd3d_shader_code *out, char **messages);
2819VKD3D_SHADER_API void vkd3d_shader_free_messages(char *messages);
2829VKD3D_SHADER_API void vkd3d_shader_free_shader_code(struct vkd3d_shader_code *code);
2830
2866VKD3D_SHADER_API int vkd3d_shader_parse_root_signature(const struct vkd3d_shader_code *dxbc,
2867 struct vkd3d_shader_versioned_root_signature_desc *root_signature, char **messages);
2879 struct vkd3d_shader_versioned_root_signature_desc *root_signature);
2880
2910 const struct vkd3d_shader_versioned_root_signature_desc *root_signature,
2911 struct vkd3d_shader_code *dxbc, char **messages);
2933 enum vkd3d_shader_root_signature_version version, const struct vkd3d_shader_versioned_root_signature_desc *src);
2934
2993VKD3D_SHADER_API int vkd3d_shader_scan(const struct vkd3d_shader_compile_info *compile_info, char **messages);
3004 struct vkd3d_shader_scan_descriptor_info *scan_descriptor_info);
3005
3045VKD3D_SHADER_API int vkd3d_shader_parse_input_signature(const struct vkd3d_shader_code *dxbc,
3046 struct vkd3d_shader_signature *signature, char **messages);
3067 const struct vkd3d_shader_signature *signature, const char *semantic_name,
3068 unsigned int semantic_index, unsigned int stream_index);
3078VKD3D_SHADER_API void vkd3d_shader_free_shader_signature(struct vkd3d_shader_signature *signature);
3079
3080/* 1.3 */
3081
3115VKD3D_SHADER_API int vkd3d_shader_preprocess(const struct vkd3d_shader_compile_info *compile_info,
3116 struct vkd3d_shader_code *out, char **messages);
3117
3128VKD3D_SHADER_API void vkd3d_shader_set_log_callback(PFN_vkd3d_log callback);
3129
3141VKD3D_SHADER_API void vkd3d_shader_free_dxbc(struct vkd3d_shader_dxbc_desc *dxbc);
3142
3172VKD3D_SHADER_API int vkd3d_shader_parse_dxbc(const struct vkd3d_shader_code *dxbc,
3173 uint32_t flags, struct vkd3d_shader_dxbc_desc *desc, char **messages);
3174
3205VKD3D_SHADER_API int vkd3d_shader_serialize_dxbc(size_t section_count,
3206 const struct vkd3d_shader_dxbc_section_desc *sections, struct vkd3d_shader_code *dxbc, char **messages);
3207
3220
3246VKD3D_SHADER_API void vkd3d_shader_build_varying_map(const struct vkd3d_shader_signature *output_signature,
3247 const struct vkd3d_shader_signature *input_signature,
3248 unsigned int *count, struct vkd3d_shader_varying_map *varyings);
3249
3264
3265#endif /* VKD3D_SHADER_NO_PROTOTYPES */
3266
3268typedef const char *(*PFN_vkd3d_shader_get_version)(unsigned int *major, unsigned int *minor);
3270typedef const enum vkd3d_shader_source_type *(*PFN_vkd3d_shader_get_supported_source_types)(unsigned int *count);
3272typedef const enum vkd3d_shader_target_type *(*PFN_vkd3d_shader_get_supported_target_types)(
3273 enum vkd3d_shader_source_type source_type, unsigned int *count);
3274
3276typedef int (*PFN_vkd3d_shader_compile)(const struct vkd3d_shader_compile_info *compile_info,
3277 struct vkd3d_shader_code *out, char **messages);
3279typedef void (*PFN_vkd3d_shader_free_messages)(char *messages);
3282
3285 struct vkd3d_shader_versioned_root_signature_desc *root_signature, char **messages);
3288
3291 const struct vkd3d_shader_versioned_root_signature_desc *root_signature,
3292 struct vkd3d_shader_code *dxbc, char **messages);
3293
3296 enum vkd3d_shader_root_signature_version version, const struct vkd3d_shader_versioned_root_signature_desc *src);
3297
3299typedef int (*PFN_vkd3d_shader_scan)(const struct vkd3d_shader_compile_info *compile_info, char **messages);
3302 struct vkd3d_shader_scan_descriptor_info *scan_descriptor_info);
3303
3306 struct vkd3d_shader_signature *signature, char **messages);
3308typedef struct vkd3d_shader_signature_element * (*PFN_vkd3d_shader_find_signature_element)(
3309 const struct vkd3d_shader_signature *signature, const char *semantic_name,
3310 unsigned int semantic_index, unsigned int stream_index);
3313
3315typedef void (*PFN_vkd3d_shader_preprocess)(struct vkd3d_shader_compile_info *compile_info,
3316 struct vkd3d_shader_code *out, char **messages);
3317
3319typedef void (*PFN_vkd3d_shader_set_log_callback)(PFN_vkd3d_log callback);
3320
3324typedef int (*PFN_vkd3d_shader_parse_dxbc)(const struct vkd3d_shader_code *dxbc,
3325 uint32_t flags, struct vkd3d_shader_dxbc_desc *desc, char **messages);
3328 const struct vkd3d_shader_dxbc_section_desc *sections, struct vkd3d_shader_code *dxbc, char **messages);
3329
3331typedef void (*PFN_vkd3d_shader_build_varying_map)(const struct vkd3d_shader_signature *output_signature,
3332 const struct vkd3d_shader_signature *input_signature,
3333 unsigned int *count, struct vkd3d_shader_varying_map *varyings);
3336
3340
3341#ifdef __cplusplus
3342}
3343#endif /* __cplusplus */
3344
3345#endif /* __VKD3D_SHADER_H */
A generic structure containing a GPU shader, in text or byte-code format.
Definition vkd3d_shader.h:416
const void * code
Pointer to the code.
Definition vkd3d_shader.h:424
size_t size
Size of code, in bytes.
Definition vkd3d_shader.h:426
This structure describes a single resource-sampler pair.
Definition vkd3d_shader.h:2219
Describes the mapping of a Direct3D resource-sampler pair to a combined sampler (i....
Definition vkd3d_shader.h:1184
struct vkd3d_shader_descriptor_binding binding
The binding in the target environment.
Definition vkd3d_shader.h:1205
unsigned int resource_index
Register index of the Direct3D resource.
Definition vkd3d_shader.h:1191
unsigned int sampler_index
Register index of the Direct3D sampler.
Definition vkd3d_shader.h:1198
unsigned int sampler_space
Register space of the Direct3D sampler.
Definition vkd3d_shader.h:1196
unsigned int resource_space
Register space of the Direct3D resource.
Definition vkd3d_shader.h:1189
unsigned int flags
A combination of zero or more elements of vkd3d_shader_binding_flag.
Definition vkd3d_shader.h:1202
enum vkd3d_shader_visibility shader_visibility
Shader stage(s) to which the resource is visible.
Definition vkd3d_shader.h:1200
A chained structure containing compilation parameters.
Definition vkd3d_shader.h:1507
const struct vkd3d_shader_compile_option * options
Pointer to an array of compilation options.
Definition vkd3d_shader.h:1535
struct vkd3d_shader_code source
Input source code or byte code.
Definition vkd3d_shader.h:1518
enum vkd3d_shader_log_level log_level
Minimum severity of messages returned from the shader function.
Definition vkd3d_shader.h:1540
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_COMPILE_INFO.
Definition vkd3d_shader.h:1509
const char * source_name
Name of the initial source file, which may be used in error messages or debug information.
Definition vkd3d_shader.h:1545
unsigned int option_count
Size, in elements, of options.
Definition vkd3d_shader.h:1537
enum vkd3d_shader_source_type source_type
Format of the input code passed in source.
Definition vkd3d_shader.h:1521
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:1515
enum vkd3d_shader_target_type target_type
Desired output format.
Definition vkd3d_shader.h:1523
Various settings which may affect shader compilation or scanning, passed as part of struct vkd3d_shad...
Definition vkd3d_shader.h:382
unsigned int value
A value associated with the option.
Definition vkd3d_shader.h:389
enum vkd3d_shader_compile_option_name name
Name of the option.
Definition vkd3d_shader.h:384
A common structure describing the bind point of a descriptor or descriptor array in the target enviro...
Definition vkd3d_shader.h:461
unsigned int binding
The binding index of the descriptor.
Definition vkd3d_shader.h:468
unsigned int count
The size of this descriptor array.
Definition vkd3d_shader.h:474
unsigned int set
The set of the descriptor.
Definition vkd3d_shader.h:466
Describes a single shader descriptor; returned as part of struct vkd3d_shader_scan_descriptor_info.
Definition vkd3d_shader.h:2138
enum vkd3d_shader_resource_type resource_type
Resource type, if applicable, including its dimension.
Definition vkd3d_shader.h:2149
unsigned int register_index
Register index of the descriptor.
Definition vkd3d_shader.h:2147
enum vkd3d_shader_resource_data_type resource_data_type
Data type contained in the resource (for example, float or integer).
Definition vkd3d_shader.h:2151
enum vkd3d_shader_descriptor_type type
Type of the descriptor (for example, SRV, CBV, UAV, or sampler).
Definition vkd3d_shader.h:2140
unsigned int count
Size of this descriptor array, or 1 if a single descriptor.
Definition vkd3d_shader.h:2161
unsigned int flags
Bitwise combination of zero or more members of vkd3d_shader_descriptor_info_flag.
Definition vkd3d_shader.h:2156
unsigned int register_space
Register space of the resource, or 0 if the shader does not support multiple register spaces.
Definition vkd3d_shader.h:2145
A chained structure containing descriptor offsets.
Definition vkd3d_shader.h:1338
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:1342
const struct vkd3d_shader_descriptor_offset * uav_counter_offsets
Pointer to an array of offsets into the descriptor arrays referenced by the 'uav_counters' array in s...
Definition vkd3d_shader.h:1401
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_DESCRIPTOR_OFFSET_INFO.
Definition vkd3d_shader.h:1340
unsigned int descriptor_table_offset
Byte offset within the push constants of an array of 32-bit descriptor array offsets.
Definition vkd3d_shader.h:1349
unsigned int descriptor_table_count
Size, in elements, of the descriptor table push constant array.
Definition vkd3d_shader.h:1351
const struct vkd3d_shader_descriptor_offset * binding_offsets
Pointer to an array of struct vkd3d_shader_descriptor_offset objects.
Definition vkd3d_shader.h:1394
Definition vkd3d_shader.h:1321
Definition vkd3d_shader.h:1978
Definition vkd3d_shader.h:1880
A description of a DXBC blob, as returned by vkd3d_shader_parse_dxbc().
Definition vkd3d_shader.h:2464
size_t section_count
The number of sections contained in the DXBC.
Definition vkd3d_shader.h:2480
struct vkd3d_shader_dxbc_section_desc * sections
Descriptions of the sections contained in the DXBC.
Definition vkd3d_shader.h:2482
uint32_t tag
The DXBC tag.
Definition vkd3d_shader.h:2469
size_t size
The total size of the DXBC blob.
Definition vkd3d_shader.h:2478
uint32_t checksum[4]
A checksum of the DXBC contents.
Definition vkd3d_shader.h:2471
unsigned int version
The DXBC version.
Definition vkd3d_shader.h:2476
A description of a DXBC section.
Definition vkd3d_shader.h:2451
uint32_t tag
The section tag.
Definition vkd3d_shader.h:2453
struct vkd3d_shader_code data
The contents of the section.
Definition vkd3d_shader.h:2455
A chained structure containing HLSL compilation parameters.
Definition vkd3d_shader.h:1764
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_HLSL_SOURCE_INFO.
Definition vkd3d_shader.h:1766
const char * profile
Pointer to a null-terminated string containing the target shader profile.
Definition vkd3d_shader.h:1782
const char * entry_point
Optional pointer to a null-terminated string containing the shader entry point.
Definition vkd3d_shader.h:1776
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:1768
A chained structure describing the interface between a compiled shader and the target environment.
Definition vkd3d_shader.h:1271
unsigned int combined_sampler_count
Size, in elements, of combined_samplers.
Definition vkd3d_shader.h:1290
const struct vkd3d_shader_resource_binding * bindings
Pointer to an array of bindings for shader resource descriptors.
Definition vkd3d_shader.h:1278
const struct vkd3d_shader_push_constant_buffer * push_constant_buffers
Pointer to an array of bindings for push constant buffers.
Definition vkd3d_shader.h:1283
const struct vkd3d_shader_uav_counter_binding * uav_counters
Pointer to an array of bindings for UAV counters.
Definition vkd3d_shader.h:1293
unsigned int binding_count
Size, in elements, of bindings.
Definition vkd3d_shader.h:1280
unsigned int push_constant_buffer_count
Size, in elements, of push_constant_buffers.
Definition vkd3d_shader.h:1285
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:1275
const struct vkd3d_shader_combined_resource_sampler * combined_samplers
Pointer to an array of bindings for combined samplers.
Definition vkd3d_shader.h:1288
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_INTERFACE_INFO.
Definition vkd3d_shader.h:1273
unsigned int uav_counter_count
Size, in elements, of uav_counters.
Definition vkd3d_shader.h:1295
A single preprocessor macro, passed as part of struct vkd3d_shader_preprocess_info.
Definition vkd3d_shader.h:1631
const char * name
Pointer to a null-terminated string containing the name of a macro.
Definition vkd3d_shader.h:1637
const char * value
Optional pointer to a null-terminated string containing the expansion of the macro.
Definition vkd3d_shader.h:1643
An individual shader parameter.
Definition vkd3d_shader.h:1080
enum vkd3d_shader_parameter_type type
How the parameter will be provided to the shader.
Definition vkd3d_shader.h:1084
struct vkd3d_shader_parameter_immediate_constant1 immediate_constant
Additional information if type is VKD3D_SHADER_PARAMETER_TYPE_IMMEDIATE_CONSTANT.
Definition vkd3d_shader.h:1096
struct vkd3d_shader_parameter_specialization_constant specialization_constant
Additional information if type is VKD3D_SHADER_PARAMETER_TYPE_SPECIALIZATION_CONSTANT.
Definition vkd3d_shader.h:1101
enum vkd3d_shader_parameter_data_type data_type
The data type of the supplied parameter, which determines how it is to be interpreted.
Definition vkd3d_shader.h:1089
struct vkd3d_shader_parameter_buffer buffer
Additional information if type is VKD3D_SHADER_PARAMETER_TYPE_BUFFER.
Definition vkd3d_shader.h:1106
enum vkd3d_shader_parameter_name name
The builtin parameter to be mapped.
Definition vkd3d_shader.h:1082
The linkage of a parameter specified through a uniform buffer, used in struct vkd3d_shader_parameter1...
Definition vkd3d_shader.h:1026
uint32_t offset
The byte offset of the parameter within the buffer.
Definition vkd3d_shader.h:1035
unsigned int set
The set of the uniform buffer descriptor.
Definition vkd3d_shader.h:1031
unsigned int binding
The binding index of the uniform buffer descriptor.
Definition vkd3d_shader.h:1033
The value of an immediate constant parameter, used in struct vkd3d_shader_parameter1.
Definition vkd3d_shader.h:980
float f32_vec4[4]
A pointer to the value if the parameter's data type is VKD3D_SHADER_PARAMETER_DATA_TYPE_FLOAT32_VEC4.
Definition vkd3d_shader.h:999
uint32_t u32
The value if the parameter's data type is VKD3D_SHADER_PARAMETER_DATA_TYPE_UINT32.
Definition vkd3d_shader.h:987
float f32
The value if the parameter's data type is VKD3D_SHADER_PARAMETER_DATA_TYPE_FLOAT32.
Definition vkd3d_shader.h:992
The value of an immediate constant parameter, used in struct vkd3d_shader_parameter.
Definition vkd3d_shader.h:955
float f32
The value if the parameter's data type is VKD3D_SHADER_PARAMETER_DATA_TYPE_FLOAT32.
Definition vkd3d_shader.h:969
uint32_t u32
The value if the parameter's data type is VKD3D_SHADER_PARAMETER_DATA_TYPE_UINT32.
Definition vkd3d_shader.h:962
Interface information regarding a builtin shader parameter.
Definition vkd3d_shader.h:2674
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_PARAMETER_INFO.
Definition vkd3d_shader.h:2676
unsigned int parameter_count
Size, in elements, of parameters.
Definition vkd3d_shader.h:2683
const struct vkd3d_shader_parameter1 * parameters
Pointer to an array of dynamic parameters for this shader instance.
Definition vkd3d_shader.h:2681
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:2678
The linkage of a specialization constant parameter, used in struct vkd3d_shader_parameter and struct ...
Definition vkd3d_shader.h:1010
uint32_t id
The ID of the specialization constant.
Definition vkd3d_shader.h:1018
An individual shader parameter.
Definition vkd3d_shader.h:1051
A chained structure containing preprocessing parameters.
Definition vkd3d_shader.h:1704
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_PREPROCESS_INFO.
Definition vkd3d_shader.h:1706
const struct vkd3d_shader_macro * macros
Pointer to an array of predefined macros.
Definition vkd3d_shader.h:1718
void * include_context
User-defined pointer which will be passed unmodified to the pfn_open_include and pfn_close_include ca...
Definition vkd3d_shader.h:1749
unsigned int macro_count
Size, in elements, of macros.
Definition vkd3d_shader.h:1720
PFN_vkd3d_shader_open_include pfn_open_include
Optional pointer to a callback function, which will be called in order to evaluate #include directive...
Definition vkd3d_shader.h:1734
PFN_vkd3d_shader_close_include pfn_close_include
Optional pointer to a callback function, which will be called whenever an included file is closed.
Definition vkd3d_shader.h:1744
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:1708
Describes the mapping of a Direct3D constant buffer to a range of push constants in the target enviro...
Definition vkd3d_shader.h:1237
unsigned int register_index
Register index of the Direct3D resource.
Definition vkd3d_shader.h:1244
unsigned int size
Size, in bytes, of the target push constants.
Definition vkd3d_shader.h:1251
unsigned int register_space
Register space of the Direct3D resource.
Definition vkd3d_shader.h:1242
enum vkd3d_shader_visibility shader_visibility
Shader stage(s) to which the resource is visible.
Definition vkd3d_shader.h:1246
unsigned int offset
Offset, in bytes, of the target push constants.
Definition vkd3d_shader.h:1249
Describes the mapping of a single resource or resource array to its binding point in the target envir...
Definition vkd3d_shader.h:1149
struct vkd3d_shader_descriptor_binding binding
The binding in the target environment.
Definition vkd3d_shader.h:1172
unsigned int register_space
Register space of the Direct3D resource.
Definition vkd3d_shader.h:1156
enum vkd3d_shader_descriptor_type type
The type of this descriptor.
Definition vkd3d_shader.h:1151
unsigned int flags
A combination of zero or more elements of vkd3d_shader_binding_flag.
Definition vkd3d_shader.h:1169
unsigned int register_index
Register index of the Direct3D resource.
Definition vkd3d_shader.h:1165
enum vkd3d_shader_visibility shader_visibility
Shader stage(s) to which the resource is visible.
Definition vkd3d_shader.h:1167
Definition vkd3d_shader.h:1895
Definition vkd3d_shader.h:1994
Definition vkd3d_shader.h:1988
Definition vkd3d_shader.h:1889
Definition vkd3d_shader.h:1902
Definition vkd3d_shader.h:2001
Definition vkd3d_shader.h:1919
Definition vkd3d_shader.h:2013
Definition vkd3d_shader.h:1945
A chained structure describing the resource-sampler pairs used by a shader.
Definition vkd3d_shader.h:2247
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_SCAN_COMBINED_RESOURCE_SAMPLER_INFO.
Definition vkd3d_shader.h:2249
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:2251
unsigned int combined_sampler_count
The number of resource-sampler pairs in combined_samplers.
Definition vkd3d_shader.h:2256
struct vkd3d_shader_combined_resource_sampler_info * combined_samplers
Pointer to an array of resource-sampler pairs.
Definition vkd3d_shader.h:2254
A chained structure enumerating the descriptors declared by a shader.
Definition vkd3d_shader.h:2198
enum vkd3d_shader_structure_type type
Input; must be set to VKD3D_SHADER_STRUCTURE_TYPE_SCAN_DESCRIPTOR_INFO.
Definition vkd3d_shader.h:2202
const void * next
Input; optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:2204
unsigned int descriptor_count
Output; size, in elements, of descriptors.
Definition vkd3d_shader.h:2209
struct vkd3d_shader_descriptor_info * descriptors
Output; returns a pointer to an array of descriptors.
Definition vkd3d_shader.h:2207
A chained structure describing the tessellation information in a hull shader.
Definition vkd3d_shader.h:2267
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:2271
enum vkd3d_shader_tessellator_output_primitive output_primitive
The tessellation output primitive.
Definition vkd3d_shader.h:2274
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_SCAN_HULL_SHADER_TESSELLATION_INFO.
Definition vkd3d_shader.h:2269
enum vkd3d_shader_tessellator_partitioning partitioning
The tessellation partitioning mode.
Definition vkd3d_shader.h:2276
A chained structure containing descriptions of shader inputs and outputs.
Definition vkd3d_shader.h:2564
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:2568
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_SCAN_SIGNATURE_INFO.
Definition vkd3d_shader.h:2566
struct vkd3d_shader_signature patch_constant
The shader patch constant varyings.
Definition vkd3d_shader.h:2577
struct vkd3d_shader_signature output
The shader output varyings.
Definition vkd3d_shader.h:2574
struct vkd3d_shader_signature input
The shader input varyings.
Definition vkd3d_shader.h:2571
A single shader varying, returned as part of struct vkd3d_shader_signature.
Definition vkd3d_shader.h:2387
unsigned int semantic_index
Semantic index, or 0 if the semantic is not indexed.
Definition vkd3d_shader.h:2391
enum vkd3d_shader_sysval_semantic sysval_semantic
System value semantic.
Definition vkd3d_shader.h:2401
unsigned int stream_index
Stream index of a geometry shader output semantic.
Definition vkd3d_shader.h:2396
unsigned int used_mask
Subset of mask which the shader reads from or writes to.
Definition vkd3d_shader.h:2414
enum vkd3d_shader_component_type component_type
Data type.
Definition vkd3d_shader.h:2403
enum vkd3d_shader_minimum_precision min_precision
Minimum interpolation precision.
Definition vkd3d_shader.h:2416
unsigned int register_index
Register index.
Definition vkd3d_shader.h:2405
unsigned int mask
Mask of the register components allocated to this varying.
Definition vkd3d_shader.h:2407
const char * semantic_name
Semantic name.
Definition vkd3d_shader.h:2389
Description of a shader input or output signature.
Definition vkd3d_shader.h:2427
struct vkd3d_shader_signature_element * elements
Pointer to an array of varyings.
Definition vkd3d_shader.h:2429
unsigned int element_count
Size, in elements, of elements.
Definition vkd3d_shader.h:2431
Definition vkd3d_shader.h:1618
Definition vkd3d_shader.h:1577
Definition vkd3d_shader.h:1863
Definition vkd3d_shader.h:1299
Definition vkd3d_shader.h:1310
Describes the mapping of a single Direct3D UAV counter.
Definition vkd3d_shader.h:1214
enum vkd3d_shader_visibility shader_visibility
Shader stage(s) to which the UAV counter is visible.
Definition vkd3d_shader.h:1223
unsigned int register_space
Register space of the Direct3D UAV descriptor.
Definition vkd3d_shader.h:1219
struct vkd3d_shader_descriptor_binding binding
The binding in the target environment.
Definition vkd3d_shader.h:1226
unsigned int register_index
Register index of the Direct3D UAV descriptor.
Definition vkd3d_shader.h:1221
A chained structure which describes how output varyings in this shader stage should be mapped to inpu...
Definition vkd3d_shader.h:2626
unsigned int varying_count
The number of registers provided in varying_map.
Definition vkd3d_shader.h:2645
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_VARYING_MAP_INFO.
Definition vkd3d_shader.h:2628
const void * next
Optional pointer to a structure containing further parameters.
Definition vkd3d_shader.h:2630
const struct vkd3d_shader_varying_map * varying_map
A mapping of output varyings in this shader stage to input varyings in the next shader stage.
Definition vkd3d_shader.h:2643
Describes the mapping of a output varying register in a shader stage, to an input varying register in...
Definition vkd3d_shader.h:2587
unsigned int input_register_index
The register index of the input varying to map this register to.
Definition vkd3d_shader.h:2596
unsigned int input_mask
The mask consumed by the destination register.
Definition vkd3d_shader.h:2598
unsigned int output_signature_index
The signature index (in the output signature) of the output varying.
Definition vkd3d_shader.h:2594
Definition vkd3d_shader.h:2030
VKD3D_SHADER_API struct vkd3d_shader_signature_element * vkd3d_shader_find_signature_element(const struct vkd3d_shader_signature *signature, const char *semantic_name, unsigned int semantic_index, unsigned int stream_index)
Find a single element of a parsed input signature.
vkd3d_shader_d3dbc_constant_register
Symbolic register indices for mapping uniform constant register sets in legacy Direct3D bytecode to c...
Definition vkd3d_shader.h:1122
@ VKD3D_SHADER_D3DBC_BOOL_CONSTANT_REGISTER
The boolean constant register set, b# in Direct3D assembly.
Definition vkd3d_shader.h:1128
@ VKD3D_SHADER_D3DBC_FLOAT_CONSTANT_REGISTER
The float constant register set, c# in Direct3D assembly.
Definition vkd3d_shader.h:1124
@ VKD3D_SHADER_D3DBC_INT_CONSTANT_REGISTER
The integer constant register set, i# in Direct3D assembly.
Definition vkd3d_shader.h:1126
vkd3d_shader_compile_option_name
Definition vkd3d_shader.h:276
@ VKD3D_SHADER_COMPILE_OPTION_WARN_IMPLICIT_TRUNCATION
If value is nonzero, emit a compile warning warn when vectors or matrices are truncated in an implici...
Definition vkd3d_shader.h:363
@ VKD3D_SHADER_COMPILE_OPTION_TYPED_UAV
value is a member of enum vkd3d_shader_compile_option_typed_uav.
Definition vkd3d_shader.h:292
@ VKD3D_SHADER_COMPILE_OPTION_BACKWARD_COMPATIBILITY
This option is used to enable various backward compatibility features.
Definition vkd3d_shader.h:321
@ VKD3D_SHADER_COMPILE_OPTION_PACK_MATRIX_ORDER
This option specifies default matrix packing order for HLSL sources.
Definition vkd3d_shader.h:313
@ VKD3D_SHADER_COMPILE_OPTION_CHILD_EFFECT
If value is non-zero compilation will produce a child effect using shared object descriptions,...
Definition vkd3d_shader.h:352
@ VKD3D_SHADER_COMPILE_OPTION_API_VERSION
value is a member of enum vkd3d_shader_api_version.
Definition vkd3d_shader.h:290
@ VKD3D_SHADER_COMPILE_OPTION_WRITE_TESS_GEOM_POINT_SIZE
If value is nonzero, write the point size for Vulkan tessellation and geometry shaders.
Definition vkd3d_shader.h:304
@ VKD3D_SHADER_COMPILE_OPTION_BUFFER_UAV
value is a member of enum vkd3d_shader_compile_option_buffer_uav.
Definition vkd3d_shader.h:286
@ VKD3D_SHADER_COMPILE_OPTION_FRAGMENT_COORDINATE_ORIGIN
This option specifies the origin of fragment coordinates for SPIR-V targets.
Definition vkd3d_shader.h:331
@ VKD3D_SHADER_COMPILE_OPTION_FEATURE
This option specifies the shader features available in the target environment.
Definition vkd3d_shader.h:341
@ VKD3D_SHADER_COMPILE_OPTION_STRIP_DEBUG
If value is nonzero, do not include debug information in the compiled shader.
Definition vkd3d_shader.h:284
@ VKD3D_SHADER_COMPILE_OPTION_INCLUDE_EMPTY_BUFFERS_IN_EFFECTS
If value is nonzero, empty constant buffers descriptions are written out in the output effect binary.
Definition vkd3d_shader.h:371
@ VKD3D_SHADER_COMPILE_OPTION_FORMATTING
value is a member of enum vkd3d_shader_compile_option_formatting_flags.
Definition vkd3d_shader.h:288
static uint32_t vkd3d_shader_create_swizzle(enum vkd3d_shader_swizzle_component x, enum vkd3d_shader_swizzle_component y, enum vkd3d_shader_swizzle_component z, enum vkd3d_shader_swizzle_component w)
Build a vkd3d-shader swizzle with the given components.
Definition vkd3d_shader.h:2512
vkd3d_shader_compile_option_formatting_flags
Definition vkd3d_shader.h:160
@ VKD3D_SHADER_COMPILE_OPTION_FORMATTING_IO_SIGNATURES
Emit the signatures when disassembling a shader.
Definition vkd3d_shader.h:172
void(* PFN_vkd3d_shader_free_dxbc)(struct vkd3d_shader_dxbc_desc *dxbc)
Type of vkd3d_shader_free_dxbc().
Definition vkd3d_shader.h:3322
int(* PFN_vkd3d_shader_convert_root_signature)(struct vkd3d_shader_versioned_root_signature_desc *dst, enum vkd3d_shader_root_signature_version version, const struct vkd3d_shader_versioned_root_signature_desc *src)
Type of vkd3d_shader_convert_root_signature().
Definition vkd3d_shader.h:3295
void(* PFN_vkd3d_shader_build_varying_map)(const struct vkd3d_shader_signature *output_signature, const struct vkd3d_shader_signature *input_signature, unsigned int *count, struct vkd3d_shader_varying_map *varyings)
Type of vkd3d_shader_build_varying_map().
Definition vkd3d_shader.h:3331
vkd3d_shader_resource_data_type
The type of the data contained in a shader resource, returned as part of struct vkd3d_shader_descript...
Definition vkd3d_shader.h:2079
@ VKD3D_SHADER_RESOURCE_DATA_NONE
The descriptor has no relevant data type.
Definition vkd3d_shader.h:2084
@ VKD3D_SHADER_RESOURCE_DATA_DOUBLE
IEEE double-precision floating-point.
Definition vkd3d_shader.h:2098
@ VKD3D_SHADER_RESOURCE_DATA_MIXED
Undefined/type-less.
Definition vkd3d_shader.h:2096
@ VKD3D_SHADER_RESOURCE_DATA_SNORM
Signed normalized integer.
Definition vkd3d_shader.h:2088
@ VKD3D_SHADER_RESOURCE_DATA_CONTINUED
Continuation of the previous component.
Definition vkd3d_shader.h:2104
@ VKD3D_SHADER_RESOURCE_DATA_UINT
Unsigned integer.
Definition vkd3d_shader.h:2092
@ VKD3D_SHADER_RESOURCE_DATA_FLOAT
IEEE single-precision floating-point.
Definition vkd3d_shader.h:2094
@ VKD3D_SHADER_RESOURCE_DATA_UNORM
Unsigned normalized integer.
Definition vkd3d_shader.h:2086
@ VKD3D_SHADER_RESOURCE_DATA_INT
Signed integer.
Definition vkd3d_shader.h:2090
VKD3D_SHADER_API const char * vkd3d_shader_get_version(unsigned int *major, unsigned int *minor)
Returns the current version of this library.
vkd3d_shader_parameter_type
The manner in which a parameter value is provided to the shader, used in struct vkd3d_shader_paramete...
Definition vkd3d_shader.h:597
@ VKD3D_SHADER_PARAMETER_TYPE_BUFFER
The parameter value is provided to the shader as part of a uniform buffer.
Definition vkd3d_shader.h:612
@ VKD3D_SHADER_PARAMETER_TYPE_SPECIALIZATION_CONSTANT
The parameter value is provided to the shader via specialization constants.
Definition vkd3d_shader.h:605
@ VKD3D_SHADER_PARAMETER_TYPE_IMMEDIATE_CONSTANT
The parameter value is embedded directly in the shader.
Definition vkd3d_shader.h:600
int(* PFN_vkd3d_shader_open_include)(const char *filename, bool local, const char *parent_data, void *context, struct vkd3d_shader_code *out)
Type of a callback function which will be used to open preprocessor includes.
Definition vkd3d_shader.h:1674
vkd3d_shader_compile_option_fragment_coordinate_origin
Determines the origin of fragment coordinates.
Definition vkd3d_shader.h:222
@ VKD3D_SHADER_COMPILE_OPTION_FRAGMENT_COORDINATE_ORIGIN_LOWER_LEFT
Fragment coordinates originate from the lower-left.
Definition vkd3d_shader.h:228
@ VKD3D_SHADER_COMPILE_OPTION_FRAGMENT_COORDINATE_ORIGIN_UPPER_LEFT
Fragment coordinates originate from the upper-left.
Definition vkd3d_shader.h:225
VKD3D_SHADER_API void vkd3d_shader_free_shader_code(struct vkd3d_shader_code *code)
Free shader code allocated by another vkd3d-shader function, such as vkd3d_shader_compile().
vkd3d_shader_fog_source
The source of the fog varying output by a pre-rasterization shader.
Definition vkd3d_shader.h:564
@ VKD3D_SHADER_FOG_SOURCE_FOG
The source shader is not modified.
Definition vkd3d_shader.h:569
@ VKD3D_SHADER_FOG_SOURCE_FOG_OR_SPECULAR_W
If the source shader has a fog varying, it is not modified.
Definition vkd3d_shader.h:577
@ VKD3D_SHADER_FOG_SOURCE_W
The fog source is the W component of the position output by the vertex shader.
Definition vkd3d_shader.h:587
@ VKD3D_SHADER_FOG_SOURCE_Z
The fog source is the Z component of the position output by the vertex shader.
Definition vkd3d_shader.h:582
vkd3d_shader_parameter_data_type
The format of data provided to the shader, used in struct vkd3d_shader_parameter and struct vkd3d_sha...
Definition vkd3d_shader.h:622
@ VKD3D_SHADER_PARAMETER_DATA_TYPE_FLOAT32_VEC4
The parameter is provided as a 4-dimensional vector of 32-bit floats.
Definition vkd3d_shader.h:634
@ VKD3D_SHADER_PARAMETER_DATA_TYPE_UINT32
The parameter is provided as a 32-bit unsigned integer.
Definition vkd3d_shader.h:625
@ VKD3D_SHADER_PARAMETER_DATA_TYPE_FLOAT32
The parameter is provided as a 32-bit float.
Definition vkd3d_shader.h:627
VKD3D_SHADER_API void vkd3d_shader_build_varying_map(const struct vkd3d_shader_signature *output_signature, const struct vkd3d_shader_signature *input_signature, unsigned int *count, struct vkd3d_shader_varying_map *varyings)
Build a mapping of output varyings in a shader stage to input varyings in the following shader stage.
int(* PFN_vkd3d_shader_serialize_dxbc)(size_t section_count, const struct vkd3d_shader_dxbc_section_desc *sections, struct vkd3d_shader_code *dxbc, char **messages)
Type of vkd3d_shader_serialize_dxbc().
Definition vkd3d_shader.h:3327
void(* PFN_vkd3d_shader_close_include)(const struct vkd3d_shader_code *code, void *context)
Type of a callback function which will be used to close preprocessor includes.
Definition vkd3d_shader.h:1690
vkd3d_shader_descriptor_info_flag
Additional flags describing a shader descriptor, returned as part of struct vkd3d_shader_descriptor_i...
Definition vkd3d_shader.h:2114
@ VKD3D_SHADER_DESCRIPTOR_INFO_FLAG_RAW_BUFFER
The descriptor is a raw (byte-addressed) buffer.
Definition vkd3d_shader.h:2128
@ VKD3D_SHADER_DESCRIPTOR_INFO_FLAG_UAV_READ
The descriptor is a UAV resource, which is read from by the shader.
Definition vkd3d_shader.h:2121
@ VKD3D_SHADER_DESCRIPTOR_INFO_FLAG_UAV_ATOMICS
The descriptor is a UAV resource, on which the shader performs atomic ops.
Definition vkd3d_shader.h:2126
@ VKD3D_SHADER_DESCRIPTOR_INFO_FLAG_UAV_COUNTER
The descriptor is a UAV resource, whose counter is read from or written to by the shader.
Definition vkd3d_shader.h:2119
@ VKD3D_SHADER_DESCRIPTOR_INFO_FLAG_SAMPLER_COMPARISON_MODE
The descriptor is a comparison sampler.
Definition vkd3d_shader.h:2123
VKD3D_SHADER_API int vkd3d_shader_serialize_root_signature(const struct vkd3d_shader_versioned_root_signature_desc *root_signature, struct vkd3d_shader_code *dxbc, char **messages)
Convert a structural description of a shader root signature to a byte code format capable of being re...
VKD3D_SHADER_API int vkd3d_shader_parse_input_signature(const struct vkd3d_shader_code *dxbc, struct vkd3d_shader_signature *signature, char **messages)
Read the input signature of a compiled DXBC shader, returning a structural description which can be e...
vkd3d_shader_compile_option_backward_compatibility
Individual options to enable various backward compatibility features.
Definition vkd3d_shader.h:188
@ VKD3D_SHADER_COMPILE_OPTION_BACKCOMPAT_MAP_SEMANTIC_NAMES
Causes compiler to convert SM1-3 semantics to corresponding System Value semantics,...
Definition vkd3d_shader.h:200
@ VKD3D_SHADER_COMPILE_OPTION_DOUBLE_AS_FLOAT_ALIAS
Causes 'double' to behave as an alias for 'float'.
Definition vkd3d_shader.h:211
void(* PFN_vkd3d_shader_free_shader_signature)(struct vkd3d_shader_signature *signature)
Type of vkd3d_shader_free_shader_signature().
Definition vkd3d_shader.h:3312
int(* PFN_vkd3d_shader_scan)(const struct vkd3d_shader_compile_info *compile_info, char **messages)
Type of vkd3d_shader_scan().
Definition vkd3d_shader.h:3299
VKD3D_SHADER_API int vkd3d_shader_parse_root_signature(const struct vkd3d_shader_code *dxbc, struct vkd3d_shader_versioned_root_signature_desc *root_signature, char **messages)
Convert a byte code description of a shader root signature to a structural description which can be e...
void(* PFN_vkd3d_shader_free_root_signature)(struct vkd3d_shader_versioned_root_signature_desc *root_signature)
Type of vkd3d_shader_free_root_signature().
Definition vkd3d_shader.h:3287
vkd3d_shader_sysval_semantic
System value semantic, returned as part of struct vkd3d_shader_signature.
Definition vkd3d_shader.h:2313
@ VKD3D_SHADER_SV_VERTEX_ID
Vertex ID; SV_VertexID in Direct3D.
Definition vkd3d_shader.h:2327
@ VKD3D_SHADER_SV_RENDER_TARGET_ARRAY_INDEX
Render target layer; SV_RenderTargetArrayIndex in Direct3D.
Definition vkd3d_shader.h:2323
@ VKD3D_SHADER_SV_DEPTH_LESS_EQUAL
Depth, which is guaranteed to be less than or equal to the current depth; SV_DepthLessEqual in Direct...
Definition vkd3d_shader.h:2357
@ VKD3D_SHADER_SV_PRIMITIVE_ID
Primitive ID; SV_PrimitiveID in Direct3D.
Definition vkd3d_shader.h:2329
@ VKD3D_SHADER_SV_COVERAGE
Sample mask; SV_Coverage in Direct3D.
Definition vkd3d_shader.h:2347
@ VKD3D_SHADER_SV_CULL_DISTANCE
Cull distance; SV_CullDistance in Direct3D.
Definition vkd3d_shader.h:2321
@ VKD3D_SHADER_SV_DEPTH
Depth; SV_Depth in Direct3D.
Definition vkd3d_shader.h:2345
@ VKD3D_SHADER_SV_TARGET
Render target; SV_Target in Direct3D.
Definition vkd3d_shader.h:2343
@ VKD3D_SHADER_SV_NONE
No system value.
Definition vkd3d_shader.h:2315
@ VKD3D_SHADER_SV_IS_FRONT_FACE
Whether the triangle is front-facing; SV_IsFrontFace in Direct3D.
Definition vkd3d_shader.h:2333
@ VKD3D_SHADER_SV_VIEWPORT_ARRAY_INDEX
Viewport index; SV_ViewportArrayIndex in Direct3D.
Definition vkd3d_shader.h:2325
@ VKD3D_SHADER_SV_DEPTH_GREATER_EQUAL
Depth, which is guaranteed to be greater than or equal to the current depth; SV_DepthGreaterEqual in ...
Definition vkd3d_shader.h:2352
@ VKD3D_SHADER_SV_INSTANCE_ID
Instance ID; SV_InstanceID in Direct3D.
Definition vkd3d_shader.h:2331
@ VKD3D_SHADER_SV_CLIP_DISTANCE
Clip distance; SV_ClipDistance in Direct3D.
Definition vkd3d_shader.h:2319
@ VKD3D_SHADER_SV_SAMPLE_INDEX
Sample index; SV_SampleIndex in Direct3D.
Definition vkd3d_shader.h:2335
@ VKD3D_SHADER_SV_STENCIL_REF
Stencil reference; SV_StencilRef in Direct3D.
Definition vkd3d_shader.h:2359
@ VKD3D_SHADER_SV_POSITION
Vertex position; SV_Position in Direct3D.
Definition vkd3d_shader.h:2317
vkd3d_shader_source_type
The format of a shader to be compiled or scanned.
Definition vkd3d_shader.h:1406
@ VKD3D_SHADER_SOURCE_DXBC_DXIL
A 'DirectX Intermediate Language' shader embedded in a DXBC container.
Definition vkd3d_shader.h:1428
@ VKD3D_SHADER_SOURCE_D3D_BYTECODE
Legacy Direct3D byte-code.
Definition vkd3d_shader.h:1423
@ VKD3D_SHADER_SOURCE_HLSL
High-Level Shader Language source code.
Definition vkd3d_shader.h:1418
@ VKD3D_SHADER_SOURCE_FX
Binary format used by Direct3D 9/10.x/11 effects.
Definition vkd3d_shader.h:1433
@ VKD3D_SHADER_SOURCE_DXBC_TPF
A 'Tokenized Program Format' shader embedded in a DXBC container.
Definition vkd3d_shader.h:1416
@ VKD3D_SHADER_SOURCE_NONE
The shader has no type or is to be ignored.
Definition vkd3d_shader.h:1411
VKD3D_SHADER_API void vkd3d_shader_free_shader_signature(struct vkd3d_shader_signature *signature)
Free a structural representation of a shader input signature allocated by vkd3d_shader_parse_input_si...
vkd3d_shader_parse_dxbc_flags
Flags for vkd3d_shader_parse_dxbc().
Definition vkd3d_shader.h:267
@ VKD3D_SHADER_PARSE_DXBC_IGNORE_CHECKSUM
Ignore the checksum and continue parsing even if it is incorrect.
Definition vkd3d_shader.h:270
VKD3D_SHADER_API int vkd3d_shader_serialize_dxbc(size_t section_count, const struct vkd3d_shader_dxbc_section_desc *sections, struct vkd3d_shader_code *dxbc, char **messages)
Serialize a DXBC description into a blob stored in a vkd3d_shader_code structure.
vkd3d_shader_log_level
Describes the minimum severity of compilation messages returned by vkd3d_shader_compile() and similar...
Definition vkd3d_shader.h:1488
@ VKD3D_SHADER_LOG_NONE
No messages will be returned.
Definition vkd3d_shader.h:1490
@ VKD3D_SHADER_LOG_ERROR
Only fatal errors which prevent successful compilation will be returned.
Definition vkd3d_shader.h:1492
@ VKD3D_SHADER_LOG_WARNING
Non-fatal warnings and fatal errors will be returned.
Definition vkd3d_shader.h:1494
@ VKD3D_SHADER_LOG_INFO
All messages, including general informational messages, will be returned.
Definition vkd3d_shader.h:1498
VKD3D_SHADER_API int vkd3d_shader_scan(const struct vkd3d_shader_compile_info *compile_info, char **messages)
Parse shader source code or byte code, returning various types of requested information.
vkd3d_shader_fog_fragment_mode
The factor used to interpolate the fragment output colour with fog.
Definition vkd3d_shader.h:502
@ VKD3D_SHADER_FOG_FRAGMENT_EXP2
The fog interpolation factor is 2^-((k * c)²).
Definition vkd3d_shader.h:534
@ VKD3D_SHADER_FOG_FRAGMENT_NONE
No fog interpolation is applied; the output colour is passed through unmodified.
Definition vkd3d_shader.h:508
@ VKD3D_SHADER_FOG_FRAGMENT_EXP
The fog interpolation factor is 2^-(k * c).
Definition vkd3d_shader.h:521
@ VKD3D_SHADER_FOG_FRAGMENT_LINEAR
The fog interpolation factor is (E - c) * k.
Definition vkd3d_shader.h:548
vkd3d_shader_structure_type
The type of a chained structure.
Definition vkd3d_shader.h:68
@ VKD3D_SHADER_STRUCTURE_TYPE_TRANSFORM_FEEDBACK_INFO
The structure is a vkd3d_shader_transform_feedback_info structure.
Definition vkd3d_shader.h:80
@ VKD3D_SHADER_STRUCTURE_TYPE_SCAN_COMBINED_RESOURCE_SAMPLER_INFO
The structure is a vkd3d_shader_scan_combined_resource_sampler_info structure.
Definition vkd3d_shader.h:111
@ VKD3D_SHADER_STRUCTURE_TYPE_COMPILE_INFO
The structure is a vkd3d_shader_compile_info structure.
Definition vkd3d_shader.h:70
@ VKD3D_SHADER_STRUCTURE_TYPE_PARAMETER_INFO
The structure is a vkd3d_shader_parameter_info structure.
Definition vkd3d_shader.h:116
@ VKD3D_SHADER_STRUCTURE_TYPE_SCAN_DESCRIPTOR_INFO
The structure is a vkd3d_shader_scan_descriptor_info structure.
Definition vkd3d_shader.h:74
@ VKD3D_SHADER_STRUCTURE_TYPE_SPIRV_DOMAIN_SHADER_TARGET_INFO
The structure is a vkd3d_shader_spirv_domain_shader_target_info structure.
Definition vkd3d_shader.h:76
@ VKD3D_SHADER_STRUCTURE_TYPE_DESCRIPTOR_OFFSET_INFO
The structure is a vkd3d_shader_descriptor_offset_info structure.
Definition vkd3d_shader.h:96
@ VKD3D_SHADER_STRUCTURE_TYPE_SCAN_SIGNATURE_INFO
The structure is a vkd3d_shader_scan_signature_info structure.
Definition vkd3d_shader.h:101
@ VKD3D_SHADER_STRUCTURE_TYPE_PREPROCESS_INFO
The structure is a vkd3d_shader_preprocess_info structure.
Definition vkd3d_shader.h:91
@ VKD3D_SHADER_STRUCTURE_TYPE_INTERFACE_INFO
The structure is a vkd3d_shader_interface_info structure.
Definition vkd3d_shader.h:72
@ VKD3D_SHADER_STRUCTURE_TYPE_SCAN_HULL_SHADER_TESSELLATION_INFO
The structure is a vkd3d_shader_scan_hull_shader_tessellation_info structure.
Definition vkd3d_shader.h:121
@ VKD3D_SHADER_STRUCTURE_TYPE_VARYING_MAP_INFO
The structure is a vkd3d_shader_varying_map_info structure.
Definition vkd3d_shader.h:106
@ VKD3D_SHADER_STRUCTURE_TYPE_SPIRV_TARGET_INFO
The structure is a vkd3d_shader_spirv_target_info structure.
Definition vkd3d_shader.h:78
@ VKD3D_SHADER_STRUCTURE_TYPE_HLSL_SOURCE_INFO
The structure is a vkd3d_shader_hlsl_source_info structure.
Definition vkd3d_shader.h:86
vkd3d_shader_visibility
Describes which shader stages a resource is visible to.
Definition vkd3d_shader.h:394
@ VKD3D_SHADER_VISIBILITY_DOMAIN
The resource is visible only to the domain shader.
Definition vkd3d_shader.h:402
@ VKD3D_SHADER_VISIBILITY_COMPUTE
The resource is visible only to the compute shader.
Definition vkd3d_shader.h:409
@ VKD3D_SHADER_VISIBILITY_PIXEL
The resource is visible only to the pixel shader.
Definition vkd3d_shader.h:406
@ VKD3D_SHADER_VISIBILITY_ALL
The resource is visible to all shader stages.
Definition vkd3d_shader.h:396
@ VKD3D_SHADER_VISIBILITY_GEOMETRY
The resource is visible only to the geometry shader.
Definition vkd3d_shader.h:404
@ VKD3D_SHADER_VISIBILITY_VERTEX
The resource is visible only to the vertex shader.
Definition vkd3d_shader.h:398
@ VKD3D_SHADER_VISIBILITY_HULL
The resource is visible only to the hull shader.
Definition vkd3d_shader.h:400
VKD3D_SHADER_API void vkd3d_shader_free_scan_combined_resource_sampler_info(struct vkd3d_shader_scan_combined_resource_sampler_info *info)
Free members of struct vkd3d_shader_scan_combined_resource_sampler_info allocated by vkd3d_shader_sca...
vkd3d_shader_spirv_extension
Definition vkd3d_shader.h:1560
@ VKD3D_SHADER_SPIRV_EXTENSION_EXT_FRAGMENT_SHADER_INTERLOCK
Definition vkd3d_shader.h:1570
@ VKD3D_SHADER_SPIRV_EXTENSION_EXT_STENCIL_EXPORT
Definition vkd3d_shader.h:1566
@ VKD3D_SHADER_SPIRV_EXTENSION_EXT_VIEWPORT_INDEX_LAYER
Definition vkd3d_shader.h:1568
@ VKD3D_SHADER_SPIRV_EXTENSION_EXT_DESCRIPTOR_INDEXING
Definition vkd3d_shader.h:1564
vkd3d_shader_api_version
Definition vkd3d_shader.h:44
vkd3d_shader_component_type
Data type of a shader varying, returned as part of struct vkd3d_shader_signature_element.
Definition vkd3d_shader.h:2284
@ VKD3D_SHADER_COMPONENT_INT
32-bit signed integer.
Definition vkd3d_shader.h:2290
@ VKD3D_SHADER_COMPONENT_UINT
32-bit unsigned integer.
Definition vkd3d_shader.h:2288
@ VKD3D_SHADER_COMPONENT_FLOAT16
16-bit IEEE floating-point.
Definition vkd3d_shader.h:2302
@ VKD3D_SHADER_COMPONENT_UINT16
16-bit unsigned integer.
Definition vkd3d_shader.h:2304
@ VKD3D_SHADER_COMPONENT_INT16
16-bit signed integer.
Definition vkd3d_shader.h:2306
@ VKD3D_SHADER_COMPONENT_DOUBLE
64-bit IEEE floating-point.
Definition vkd3d_shader.h:2296
@ VKD3D_SHADER_COMPONENT_UINT64
64-bit unsigned integer.
Definition vkd3d_shader.h:2298
@ VKD3D_SHADER_COMPONENT_FLOAT
32-bit IEEE floating-point.
Definition vkd3d_shader.h:2292
@ VKD3D_SHADER_COMPONENT_VOID
The varying has no type.
Definition vkd3d_shader.h:2286
@ VKD3D_SHADER_COMPONENT_INT64
64-bit signed integer.
Definition vkd3d_shader.h:2300
@ VKD3D_SHADER_COMPONENT_BOOL
Boolean.
Definition vkd3d_shader.h:2294
vkd3d_shader_descriptor_type
The type of a shader resource descriptor.
Definition vkd3d_shader.h:431
@ VKD3D_SHADER_DESCRIPTOR_TYPE_UAV
The descriptor is an unordered access view.
Definition vkd3d_shader.h:441
@ VKD3D_SHADER_DESCRIPTOR_TYPE_CBV
The descriptor is a constant buffer view.
Definition vkd3d_shader.h:446
@ VKD3D_SHADER_DESCRIPTOR_TYPE_SAMPLER
The descriptor is a sampler.
Definition vkd3d_shader.h:451
@ VKD3D_SHADER_DESCRIPTOR_TYPE_SRV
The descriptor is a shader resource view.
Definition vkd3d_shader.h:436
#define VKD3D_SHADER_SWIZZLE_MASK
A mask selecting one component from a vkd3d-shader swizzle.
Definition vkd3d_shader.h:2489
vkd3d_shader_resource_type
The type of a shader resource, returned as part of struct vkd3d_shader_descriptor_info.
Definition vkd3d_shader.h:2044
@ VKD3D_SHADER_RESOURCE_NONE
The type is invalid or not applicable for this descriptor.
Definition vkd3d_shader.h:2049
@ VKD3D_SHADER_RESOURCE_TEXTURE_2DARRAY
2-dimensional array texture.
Definition vkd3d_shader.h:2065
@ VKD3D_SHADER_RESOURCE_TEXTURE_2DMS
Multisampled 2-dimensional texture.
Definition vkd3d_shader.h:2057
@ VKD3D_SHADER_RESOURCE_TEXTURE_3D
3-dimensional texture.
Definition vkd3d_shader.h:2059
@ VKD3D_SHADER_RESOURCE_TEXTURE_1DARRAY
1-dimensional array texture.
Definition vkd3d_shader.h:2063
@ VKD3D_SHADER_RESOURCE_BUFFER
Dimensionless buffer.
Definition vkd3d_shader.h:2051
@ VKD3D_SHADER_RESOURCE_TEXTURE_CUBE
Cubemap texture.
Definition vkd3d_shader.h:2061
@ VKD3D_SHADER_RESOURCE_TEXTURE_1D
1-dimensional texture.
Definition vkd3d_shader.h:2053
@ VKD3D_SHADER_RESOURCE_TEXTURE_CUBEARRAY
Cubemap array texture.
Definition vkd3d_shader.h:2069
@ VKD3D_SHADER_RESOURCE_TEXTURE_2DMSARRAY
Multisampled 2-dimensional array texture.
Definition vkd3d_shader.h:2067
@ VKD3D_SHADER_RESOURCE_TEXTURE_2D
2-dimensional texture.
Definition vkd3d_shader.h:2055
VKD3D_SHADER_API void vkd3d_shader_free_dxbc(struct vkd3d_shader_dxbc_desc *dxbc)
Free the contents of a vkd3d_shader_dxbc_desc structure allocated by another vkd3d-shader function,...
VKD3D_SHADER_API enum vkd3d_shader_source_type * vkd3d_shader_get_supported_source_types(unsigned int *count)
Returns the source types supported, with any target type, by vkd3d_shader_compile().
VKD3D_SHADER_API void vkd3d_shader_set_log_callback(PFN_vkd3d_log callback)
Set a callback to be called when vkd3d-shader outputs debug logging.
int(* PFN_vkd3d_shader_parse_root_signature)(const struct vkd3d_shader_code *dxbc, struct vkd3d_shader_versioned_root_signature_desc *root_signature, char **messages)
Type of vkd3d_shader_parse_root_signature().
Definition vkd3d_shader.h:3284
VKD3D_SHADER_API void vkd3d_shader_free_scan_signature_info(struct vkd3d_shader_scan_signature_info *info)
Free members of struct vkd3d_shader_scan_signature_info allocated by vkd3d_shader_scan().
int(* PFN_vkd3d_shader_serialize_root_signature)(const struct vkd3d_shader_versioned_root_signature_desc *root_signature, struct vkd3d_shader_code *dxbc, char **messages)
Type of vkd3d_shader_serialize_root_signature().
Definition vkd3d_shader.h:3290
vkd3d_shader_compile_option_typed_uav
Determines how typed UAVs are declared.
Definition vkd3d_shader.h:147
@ VKD3D_SHADER_COMPILE_OPTION_TYPED_UAV_READ_FORMAT_UNKNOWN
Use Unknown format for UAVs which are read from.
Definition vkd3d_shader.h:154
@ VKD3D_SHADER_COMPILE_OPTION_TYPED_UAV_READ_FORMAT_R32
Use R32(u)i/R32f format for UAVs which are read from.
Definition vkd3d_shader.h:149
int(* PFN_vkd3d_shader_parse_dxbc)(const struct vkd3d_shader_code *dxbc, uint32_t flags, struct vkd3d_shader_dxbc_desc *desc, char **messages)
Type of vkd3d_shader_parse_dxbc().
Definition vkd3d_shader.h:3324
VKD3D_SHADER_API int vkd3d_shader_parse_dxbc(const struct vkd3d_shader_code *dxbc, uint32_t flags, struct vkd3d_shader_dxbc_desc *desc, char **messages)
Parse a DXBC blob contained in a vkd3d_shader_code structure.
vkd3d_shader_swizzle_component
Possible values for a single component of a vkd3d-shader swizzle.
Definition vkd3d_shader.h:2436
VKD3D_SHADER_API int vkd3d_shader_compile(const struct vkd3d_shader_compile_info *compile_info, struct vkd3d_shader_code *out, char **messages)
Transform a form of GPU shader source code or byte code into another form of source code or byte code...
VKD3D_SHADER_API int vkd3d_shader_convert_root_signature(struct vkd3d_shader_versioned_root_signature_desc *dst, enum vkd3d_shader_root_signature_version version, const struct vkd3d_shader_versioned_root_signature_desc *src)
Convert a structural representation of a root signature to a different version of structural represen...
int(* PFN_vkd3d_shader_compile)(const struct vkd3d_shader_compile_info *compile_info, struct vkd3d_shader_code *out, char **messages)
Type of vkd3d_shader_compile().
Definition vkd3d_shader.h:3276
void(* PFN_vkd3d_shader_free_scan_descriptor_info)(struct vkd3d_shader_scan_descriptor_info *scan_descriptor_info)
Type of vkd3d_shader_free_scan_descriptor_info().
Definition vkd3d_shader.h:3301
vkd3d_shader_descriptor_range_flags
Definition vkd3d_shader.h:1965
@ VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DESCRIPTORS_STATIC_KEEPING_BUFFER_BOUNDS_CHECKS
Definition vkd3d_shader.h:1972
VKD3D_SHADER_API int vkd3d_shader_preprocess(const struct vkd3d_shader_compile_info *compile_info, struct vkd3d_shader_code *out, char **messages)
Preprocess the given source code.
#define VKD3D_SHADER_SWIZZLE_SHIFT(idx)
The offset, in bits, of the nth parameter of a vkd3d-shader swizzle.
Definition vkd3d_shader.h:2491
void(* PFN_vkd3d_shader_free_messages)(char *messages)
Type of vkd3d_shader_free_messages().
Definition vkd3d_shader.h:3279
VKD3D_SHADER_API enum vkd3d_shader_target_type * vkd3d_shader_get_supported_target_types(enum vkd3d_shader_source_type source_type, unsigned int *count)
Returns the target types supported, with the given source type, by vkd3d_shader_compile().
vkd3d_shader_minimum_precision
Minimum interpolation precision of a shader varying, returned as part of struct vkd3d_shader_signatur...
Definition vkd3d_shader.h:2369
@ VKD3D_SHADER_MINIMUM_PRECISION_UINT_16
16-bit unsigned integer.
Definition vkd3d_shader.h:2378
@ VKD3D_SHADER_MINIMUM_PRECISION_FIXED_8_2
10-bit fixed point (2 integer and 8 fractional bits).
Definition vkd3d_shader.h:2374
@ VKD3D_SHADER_MINIMUM_PRECISION_FLOAT_16
16-bit floating-point.
Definition vkd3d_shader.h:2372
@ VKD3D_SHADER_MINIMUM_PRECISION_INT_16
16-bit signed integer.
Definition vkd3d_shader.h:2376
void(* PFN_vkd3d_shader_free_scan_signature_info)(struct vkd3d_shader_scan_signature_info *info)
Type of vkd3d_shader_free_scan_signature_info().
Definition vkd3d_shader.h:3335
int(* PFN_vkd3d_shader_parse_input_signature)(const struct vkd3d_shader_code *dxbc, struct vkd3d_shader_signature *signature, char **messages)
Type of vkd3d_shader_parse_input_signature().
Definition vkd3d_shader.h:3305
VKD3D_SHADER_API void vkd3d_shader_free_scan_descriptor_info(struct vkd3d_shader_scan_descriptor_info *scan_descriptor_info)
Free members of struct vkd3d_shader_scan_descriptor_info() allocated by vkd3d_shader_scan().
void(* PFN_vkd3d_shader_preprocess)(struct vkd3d_shader_compile_info *compile_info, struct vkd3d_shader_code *out, char **messages)
Type of vkd3d_shader_preprocess().
Definition vkd3d_shader.h:3315
vkd3d_shader_target_type
The output format of a compiled shader.
Definition vkd3d_shader.h:1440
@ VKD3D_SHADER_TARGET_SPIRV_BINARY
A SPIR-V shader in binary form.
Definition vkd3d_shader.h:1450
@ VKD3D_SHADER_TARGET_D3D_ASM
Direct3D shader assembly.
Definition vkd3d_shader.h:1455
@ VKD3D_SHADER_TARGET_NONE
The shader has no type or is to be ignored.
Definition vkd3d_shader.h:1445
@ VKD3D_SHADER_TARGET_DXBC_TPF
A 'Tokenized Program Format' shader embedded in a DXBC container.
Definition vkd3d_shader.h:1465
@ VKD3D_SHADER_TARGET_GLSL
An 'OpenGL Shading Language' shader.
Definition vkd3d_shader.h:1469
@ VKD3D_SHADER_TARGET_MSL
A 'Metal Shading Language' shader.
Definition vkd3d_shader.h:1478
@ VKD3D_SHADER_TARGET_D3D_BYTECODE
Legacy Direct3D byte-code.
Definition vkd3d_shader.h:1460
@ VKD3D_SHADER_TARGET_FX
Binary format used by Direct3D 9/10.x/11 effects profiles.
Definition vkd3d_shader.h:1474
void(* PFN_vkd3d_shader_free_shader_code)(struct vkd3d_shader_code *code)
Type of vkd3d_shader_free_shader_code().
Definition vkd3d_shader.h:3281
vkd3d_shader_compile_option_pack_matrix_order
Determines how matrices are stored.
Definition vkd3d_shader.h:179
vkd3d_shader_spirv_environment
Definition vkd3d_shader.h:1549
@ VKD3D_SHADER_SPIRV_ENVIRONMENT_VULKAN_1_1
Definition vkd3d_shader.h:1554
vkd3d_shader_compile_option_feature_flags
Advertises feature availability.
Definition vkd3d_shader.h:235
@ VKD3D_SHADER_COMPILE_OPTION_FEATURE_WAVE_OPS
The SPIR-V target environment supports wave operations.
Definition vkd3d_shader.h:252
@ VKD3D_SHADER_COMPILE_OPTION_FEATURE_INT64
The SPIR-V target environment supports 64-bit integer types.
Definition vkd3d_shader.h:239
@ VKD3D_SHADER_COMPILE_OPTION_FEATURE_FLOAT64
The SPIR-V target environment supports 64-bit floating-point types.
Definition vkd3d_shader.h:243
@ VKD3D_SHADER_COMPILE_OPTION_FEATURE_ZERO_INITIALIZE_WORKGROUP_MEMORY
The SPIR-V target environment supports zero-initializing workgroup memory.
Definition vkd3d_shader.h:256
void(* PFN_vkd3d_shader_set_log_callback)(PFN_vkd3d_log callback)
Type of vkd3d_shader_set_log_callback().
Definition vkd3d_shader.h:3319
vkd3d_shader_parameter_name
Names a specific shader parameter, used in struct vkd3d_shader_parameter and struct vkd3d_shader_para...
Definition vkd3d_shader.h:644
@ VKD3D_SHADER_PARAMETER_NAME_POINT_SPRITE
Whether texture coordinate inputs should take their values from the point coordinate.
Definition vkd3d_shader.h:854
@ VKD3D_SHADER_PARAMETER_NAME_FOG_SOURCE
Fog source.
Definition vkd3d_shader.h:945
@ VKD3D_SHADER_PARAMETER_NAME_RASTERIZER_SAMPLE_COUNT
The sample count of the framebuffer, as returned by the HLSL function GetRenderTargetSampleCount() or...
Definition vkd3d_shader.h:658
@ VKD3D_SHADER_PARAMETER_NAME_ALPHA_TEST_FUNC
Alpha test comparison function.
Definition vkd3d_shader.h:683
@ VKD3D_SHADER_PARAMETER_NAME_FOG_SCALE
Scale value for fog.
Definition vkd3d_shader.h:921
@ VKD3D_SHADER_PARAMETER_NAME_ALPHA_TEST_REF
Alpha test reference value.
Definition vkd3d_shader.h:693
@ VKD3D_SHADER_PARAMETER_NAME_FOG_END
End coordinate for linear fog.
Definition vkd3d_shader.h:908
@ VKD3D_SHADER_PARAMETER_NAME_POINT_SIZE_MAX
Maximum point size.
Definition vkd3d_shader.h:821
@ VKD3D_SHADER_PARAMETER_NAME_FOG_FRAGMENT_MODE
Fog mode used in fragment shaders.
Definition vkd3d_shader.h:882
@ VKD3D_SHADER_PARAMETER_NAME_POINT_SIZE_MIN
Minimum point size.
Definition vkd3d_shader.h:811
@ VKD3D_SHADER_PARAMETER_NAME_POINT_SIZE
Point size.
Definition vkd3d_shader.h:788
@ VKD3D_SHADER_PARAMETER_NAME_CLIP_PLANE_0
Clip plane values.
Definition vkd3d_shader.h:762
@ VKD3D_SHADER_PARAMETER_NAME_FLAT_INTERPOLATION
Whether to use flat interpolation for fragment shader colour inputs.
Definition vkd3d_shader.h:717
@ VKD3D_SHADER_PARAMETER_NAME_CLIP_PLANE_MASK
A mask of enabled clip planes.
Definition vkd3d_shader.h:745
@ VKD3D_SHADER_PARAMETER_NAME_FOG_COLOUR
Fog colour.
Definition vkd3d_shader.h:895
VKD3D_SHADER_API void vkd3d_shader_free_messages(char *messages)
Free shader messages allocated by another vkd3d-shader function, such as vkd3d_shader_compile().
void(* PFN_vkd3d_shader_free_scan_combined_resource_sampler_info)(struct vkd3d_shader_scan_combined_resource_sampler_info *info)
Type of vkd3d_shader_free_scan_combined_resource_sampler_info().
Definition vkd3d_shader.h:3338
VKD3D_SHADER_API void vkd3d_shader_free_root_signature(struct vkd3d_shader_versioned_root_signature_desc *root_signature)
Free a structural representation of a shader root signature allocated by vkd3d_shader_convert_root_si...
vkd3d_shader_compile_option_buffer_uav
Determines how buffer UAVs are stored.
Definition vkd3d_shader.h:133
@ VKD3D_SHADER_COMPILE_OPTION_BUFFER_UAV_STORAGE_TEXEL_BUFFER
Use buffer textures for buffer UAVs.
Definition vkd3d_shader.h:135
@ VKD3D_SHADER_COMPILE_OPTION_BUFFER_UAV_STORAGE_BUFFER
Use storage buffers for buffer UAVs.
Definition vkd3d_shader.h:137
This file contains definitions for basic types used by vkd3d libraries.