vkd3d  1.2
The vkd3d 3D Graphics Library
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 <vkd3d_types.h>
25 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif /* __cplusplus */
29 
43 {
56 
57  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_STRUCTURE_TYPE),
58 };
59 
67 {
72 
73  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_COMPILE_OPTION_BUFFER_UAV),
74 };
75 
76 enum vkd3d_shader_compile_option_formatting_flags
77 {
78  VKD3D_SHADER_COMPILE_OPTION_FORMATTING_NONE = 0x00000000,
79  VKD3D_SHADER_COMPILE_OPTION_FORMATTING_COLOUR = 0x00000001,
80  VKD3D_SHADER_COMPILE_OPTION_FORMATTING_INDENT = 0x00000002,
81  VKD3D_SHADER_COMPILE_OPTION_FORMATTING_OFFSETS = 0x00000004,
82  VKD3D_SHADER_COMPILE_OPTION_FORMATTING_HEADER = 0x00000008,
83  VKD3D_SHADER_COMPILE_OPTION_FORMATTING_RAW_IDS = 0x00000010,
84 
85  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_COMPILE_OPTION_FORMATTING_FLAGS),
86 };
87 
89 {
102 
103  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_COMPILE_OPTION_NAME),
104 };
105 
112 {
119  unsigned int value;
120 };
121 
124 {
137 
140 
141  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_VISIBILITY),
142 };
143 
146 {
148  const void *code;
150  size_t size;
151 };
152 
155 {
176 
177  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_DESCRIPTOR_TYPE),
178 };
179 
185 {
190  unsigned int set;
192  unsigned int binding;
197  unsigned int count;
198 };
199 
200 enum vkd3d_shader_binding_flag
201 {
202  VKD3D_SHADER_BINDING_FLAG_BUFFER = 0x00000001,
203  VKD3D_SHADER_BINDING_FLAG_IMAGE = 0x00000002,
204 
205  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_BINDING_FLAG),
206 };
207 
208 enum vkd3d_shader_parameter_type
209 {
210  VKD3D_SHADER_PARAMETER_TYPE_UNKNOWN,
211  VKD3D_SHADER_PARAMETER_TYPE_IMMEDIATE_CONSTANT,
212  VKD3D_SHADER_PARAMETER_TYPE_SPECIALIZATION_CONSTANT,
213 
214  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_PARAMETER_TYPE),
215 };
216 
217 enum vkd3d_shader_parameter_data_type
218 {
219  VKD3D_SHADER_PARAMETER_DATA_TYPE_UNKNOWN,
220  VKD3D_SHADER_PARAMETER_DATA_TYPE_UINT32,
221 
222  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_PARAMETER_DATA_TYPE),
223 };
224 
225 enum vkd3d_shader_parameter_name
226 {
227  VKD3D_SHADER_PARAMETER_NAME_UNKNOWN,
228  VKD3D_SHADER_PARAMETER_NAME_RASTERIZER_SAMPLE_COUNT,
229 
230  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_PARAMETER_NAME),
231 };
232 
234 {
235  union
236  {
237  uint32_t u32;
238  } u;
239 };
240 
242 {
243  uint32_t id;
244 };
245 
247 {
248  enum vkd3d_shader_parameter_name name;
249  enum vkd3d_shader_parameter_type type;
250  enum vkd3d_shader_parameter_data_type data_type;
251  union
252  {
253  struct vkd3d_shader_parameter_immediate_constant immediate_constant;
254  struct vkd3d_shader_parameter_specialization_constant specialization_constant;
255  } u;
256 };
257 
274 {
281  unsigned int register_space;
283  unsigned int register_index;
287  unsigned int flags;
288 
291 };
292 
293 #define VKD3D_SHADER_DUMMY_SAMPLER_INDEX ~0u
294 
302 {
307  unsigned int resource_space;
309  unsigned int resource_index;
314  unsigned int sampler_space;
316  unsigned int sampler_index;
320  unsigned int flags;
321 
324 };
325 
332 {
337  unsigned int register_space;
339  unsigned int register_index;
342 
345  unsigned int offset;
346 };
347 
355 {
360  unsigned int register_space;
362  unsigned int register_index;
365 
367  unsigned int offset;
369  unsigned int size;
370 };
371 
389 {
393  const void *next;
394 
398  unsigned int binding_count;
399 
404 
409 
413  unsigned int uav_counter_count;
414 };
415 
417 {
418  unsigned int stream_index;
419  const char *semantic_name;
420  unsigned int semantic_index;
421  uint8_t component_index;
422  uint8_t component_count;
423  uint8_t output_slot;
424 };
425 
426 /* Extends vkd3d_shader_interface_info. */
428 {
429  enum vkd3d_shader_structure_type type;
430  const void *next;
431 
432  const struct vkd3d_shader_transform_feedback_element *elements;
433  unsigned int element_count;
434  const unsigned int *buffer_strides;
435  unsigned int buffer_stride_count;
436 };
437 
440 {
451 
452  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SOURCE_TYPE),
453 };
454 
457 {
468  VKD3D_SHADER_TARGET_SPIRV_TEXT,
469 
470  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_TARGET_TYPE),
471 };
472 
478 {
489 
490  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_LOG_LEVEL),
491 };
492 
497 {
505  const void *next;
506 
508  struct vkd3d_shader_code source;
509 
514 
527  unsigned int option_count;
528 
535  const char *source_name;
536 };
537 
538 enum vkd3d_shader_spirv_environment
539 {
540  VKD3D_SHADER_SPIRV_ENVIRONMENT_NONE,
541  VKD3D_SHADER_SPIRV_ENVIRONMENT_OPENGL_4_5,
542  VKD3D_SHADER_SPIRV_ENVIRONMENT_VULKAN_1_0, /* default target */
543 
544  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SPIRV_ENVIRONMENT),
545 };
546 
547 enum vkd3d_shader_spirv_extension
548 {
549  VKD3D_SHADER_SPIRV_EXTENSION_NONE,
550  VKD3D_SHADER_SPIRV_EXTENSION_EXT_DEMOTE_TO_HELPER_INVOCATION,
551 
552  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SPIRV_EXTENSION),
553 };
554 
555 /* Extends vkd3d_shader_compile_info. */
557 {
558  enum vkd3d_shader_structure_type type;
559  const void *next;
560 
561  const char *entry_point; /* "main" if NULL. */
562 
563  enum vkd3d_shader_spirv_environment environment;
564 
565  const enum vkd3d_shader_spirv_extension *extensions;
566  unsigned int extension_count;
567 
568  const struct vkd3d_shader_parameter *parameters;
569  unsigned int parameter_count;
570 
571  bool dual_source_blending;
572  const unsigned int *output_swizzles;
573  unsigned int output_swizzle_count;
574 };
575 
576 enum vkd3d_shader_tessellator_output_primitive
577 {
578  VKD3D_SHADER_TESSELLATOR_OUTPUT_POINT = 0x1,
579  VKD3D_SHADER_TESSELLATOR_OUTPUT_LINE = 0x2,
580  VKD3D_SHADER_TESSELLATOR_OUTPUT_TRIANGLE_CW = 0x3,
581  VKD3D_SHADER_TESSELLATOR_OUTPUT_TRIANGLE_CCW = 0x4,
582 
583  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_TESSELLATOR_OUTPUT_PRIMITIVE),
584 };
585 
586 enum vkd3d_shader_tessellator_partitioning
587 {
588  VKD3D_SHADER_TESSELLATOR_PARTITIONING_INTEGER = 0x1,
589  VKD3D_SHADER_TESSELLATOR_PARTITIONING_POW2 = 0x2,
590  VKD3D_SHADER_TESSELLATOR_PARTITIONING_FRACTIONAL_ODD = 0x3,
591  VKD3D_SHADER_TESSELLATOR_PARTITIONING_FRACTIONAL_EVEN = 0x4,
592 
593  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_TESSELLATOR_PARTITIONING),
594 };
595 
596 /* Extends vkd3d_shader_spirv_target_info. */
598 {
599  enum vkd3d_shader_structure_type type;
600  const void *next;
601 
602  enum vkd3d_shader_tessellator_output_primitive output_primitive;
603  enum vkd3d_shader_tessellator_partitioning partitioning;
604 };
605 
606 /* root signature 1.0 */
607 enum vkd3d_shader_filter
608 {
609  VKD3D_SHADER_FILTER_MIN_MAG_MIP_POINT = 0x000,
610  VKD3D_SHADER_FILTER_MIN_MAG_POINT_MIP_LINEAR = 0x001,
611  VKD3D_SHADER_FILTER_MIN_POINT_MAG_LINEAR_MIP_POINT = 0x004,
612  VKD3D_SHADER_FILTER_MIN_POINT_MAG_MIP_LINEAR = 0x005,
613  VKD3D_SHADER_FILTER_MIN_LINEAR_MAG_MIP_POINT = 0x010,
614  VKD3D_SHADER_FILTER_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x011,
615  VKD3D_SHADER_FILTER_MIN_MAG_LINEAR_MIP_POINT = 0x014,
616  VKD3D_SHADER_FILTER_MIN_MAG_MIP_LINEAR = 0x015,
617  VKD3D_SHADER_FILTER_ANISOTROPIC = 0x055,
618  VKD3D_SHADER_FILTER_COMPARISON_MIN_MAG_MIP_POINT = 0x080,
619  VKD3D_SHADER_FILTER_COMPARISON_MIN_MAG_POINT_MIP_LINEAR = 0x081,
620  VKD3D_SHADER_FILTER_COMPARISON_MIN_POINT_MAG_LINEAR_MIP_POINT = 0x084,
621  VKD3D_SHADER_FILTER_COMPARISON_MIN_POINT_MAG_MIP_LINEAR = 0x085,
622  VKD3D_SHADER_FILTER_COMPARISON_MIN_LINEAR_MAG_MIP_POINT = 0x090,
623  VKD3D_SHADER_FILTER_COMPARISON_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x091,
624  VKD3D_SHADER_FILTER_COMPARISON_MIN_MAG_LINEAR_MIP_POINT = 0x094,
625  VKD3D_SHADER_FILTER_COMPARISON_MIN_MAG_MIP_LINEAR = 0x095,
626  VKD3D_SHADER_FILTER_COMPARISON_ANISOTROPIC = 0x0d5,
627  VKD3D_SHADER_FILTER_MINIMUM_MIN_MAG_MIP_POINT = 0x100,
628  VKD3D_SHADER_FILTER_MINIMUM_MIN_MAG_POINT_MIP_LINEAR = 0x101,
629  VKD3D_SHADER_FILTER_MINIMUM_MIN_POINT_MAG_LINEAR_MIP_POINT = 0x104,
630  VKD3D_SHADER_FILTER_MINIMUM_MIN_POINT_MAG_MIP_LINEAR = 0x105,
631  VKD3D_SHADER_FILTER_MINIMUM_MIN_LINEAR_MAG_MIP_POINT = 0x110,
632  VKD3D_SHADER_FILTER_MINIMUM_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x111,
633  VKD3D_SHADER_FILTER_MINIMUM_MIN_MAG_LINEAR_MIP_POINT = 0x114,
634  VKD3D_SHADER_FILTER_MINIMUM_MIN_MAG_MIP_LINEAR = 0x115,
635  VKD3D_SHADER_FILTER_MINIMUM_ANISOTROPIC = 0x155,
636  VKD3D_SHADER_FILTER_MAXIMUM_MIN_MAG_MIP_POINT = 0x180,
637  VKD3D_SHADER_FILTER_MAXIMUM_MIN_MAG_POINT_MIP_LINEAR = 0x181,
638  VKD3D_SHADER_FILTER_MAXIMUM_MIN_POINT_MAG_LINEAR_MIP_POINT = 0x184,
639  VKD3D_SHADER_FILTER_MAXIMUM_MIN_POINT_MAG_MIP_LINEAR = 0x185,
640  VKD3D_SHADER_FILTER_MAXIMUM_MIN_LINEAR_MAG_MIP_POINT = 0x190,
641  VKD3D_SHADER_FILTER_MAXIMUM_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 0x191,
642  VKD3D_SHADER_FILTER_MAXIMUM_MIN_MAG_LINEAR_MIP_POINT = 0x194,
643  VKD3D_SHADER_FILTER_MAXIMUM_MIN_MAG_MIP_LINEAR = 0x195,
644  VKD3D_SHADER_FILTER_MAXIMUM_ANISOTROPIC = 0x1d5,
645 
646  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_FILTER),
647 };
648 
649 enum vkd3d_shader_texture_address_mode
650 {
651  VKD3D_SHADER_TEXTURE_ADDRESS_MODE_WRAP = 0x1,
652  VKD3D_SHADER_TEXTURE_ADDRESS_MODE_MIRROR = 0x2,
653  VKD3D_SHADER_TEXTURE_ADDRESS_MODE_CLAMP = 0x3,
654  VKD3D_SHADER_TEXTURE_ADDRESS_MODE_BORDER = 0x4,
655  VKD3D_SHADER_TEXTURE_ADDRESS_MODE_MIRROR_ONCE = 0x5,
656 
657  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_TEXTURE_ADDRESS_MODE),
658 };
659 
660 enum vkd3d_shader_comparison_func
661 {
662  VKD3D_SHADER_COMPARISON_FUNC_NEVER = 0x1,
663  VKD3D_SHADER_COMPARISON_FUNC_LESS = 0x2,
664  VKD3D_SHADER_COMPARISON_FUNC_EQUAL = 0x3,
665  VKD3D_SHADER_COMPARISON_FUNC_LESS_EQUAL = 0x4,
666  VKD3D_SHADER_COMPARISON_FUNC_GREATER = 0x5,
667  VKD3D_SHADER_COMPARISON_FUNC_NOT_EQUAL = 0x6,
668  VKD3D_SHADER_COMPARISON_FUNC_GREATER_EQUAL = 0x7,
669  VKD3D_SHADER_COMPARISON_FUNC_ALWAYS = 0x8,
670 
671  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_COMPARISON_FUNC),
672 };
673 
674 enum vkd3d_shader_static_border_colour
675 {
676  VKD3D_SHADER_STATIC_BORDER_COLOUR_TRANSPARENT_BLACK = 0x0,
677  VKD3D_SHADER_STATIC_BORDER_COLOUR_OPAQUE_BLACK = 0x1,
678  VKD3D_SHADER_STATIC_BORDER_COLOUR_OPAQUE_WHITE = 0x2,
679 
680  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_STATIC_BORDER_COLOUR),
681 };
682 
684 {
685  enum vkd3d_shader_filter filter;
686  enum vkd3d_shader_texture_address_mode address_u;
687  enum vkd3d_shader_texture_address_mode address_v;
688  enum vkd3d_shader_texture_address_mode address_w;
689  float mip_lod_bias;
690  unsigned int max_anisotropy;
691  enum vkd3d_shader_comparison_func comparison_func;
692  enum vkd3d_shader_static_border_colour border_colour;
693  float min_lod;
694  float max_lod;
695  unsigned int shader_register;
696  unsigned int register_space;
697  enum vkd3d_shader_visibility shader_visibility;
698 };
699 
701 {
702  enum vkd3d_shader_descriptor_type range_type;
703  unsigned int descriptor_count;
704  unsigned int base_shader_register;
705  unsigned int register_space;
706  unsigned int descriptor_table_offset;
707 };
708 
710 {
711  unsigned int descriptor_range_count;
712  const struct vkd3d_shader_descriptor_range *descriptor_ranges;
713 };
714 
716 {
717  unsigned int shader_register;
718  unsigned int register_space;
719  unsigned int value_count;
720 };
721 
723 {
724  unsigned int shader_register;
725  unsigned int register_space;
726 };
727 
728 enum vkd3d_shader_root_parameter_type
729 {
730  VKD3D_SHADER_ROOT_PARAMETER_TYPE_DESCRIPTOR_TABLE = 0x0,
731  VKD3D_SHADER_ROOT_PARAMETER_TYPE_32BIT_CONSTANTS = 0x1,
732  VKD3D_SHADER_ROOT_PARAMETER_TYPE_CBV = 0x2,
733  VKD3D_SHADER_ROOT_PARAMETER_TYPE_SRV = 0x3,
734  VKD3D_SHADER_ROOT_PARAMETER_TYPE_UAV = 0x4,
735 
736  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_ROOT_PARAMETER_TYPE),
737 };
738 
740 {
741  enum vkd3d_shader_root_parameter_type parameter_type;
742  union
743  {
744  struct vkd3d_shader_root_descriptor_table descriptor_table;
745  struct vkd3d_shader_root_constants constants;
746  struct vkd3d_shader_root_descriptor descriptor;
747  } u;
748  enum vkd3d_shader_visibility shader_visibility;
749 };
750 
751 enum vkd3d_shader_root_signature_flags
752 {
753  VKD3D_SHADER_ROOT_SIGNATURE_FLAG_NONE = 0x00,
754  VKD3D_SHADER_ROOT_SIGNATURE_FLAG_ALLOW_INPUT_ASSEMBLER_INPUT_LAYOUT = 0x01,
755  VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_VERTEX_SHADER_ROOT_ACCESS = 0x02,
756  VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_HULL_SHADER_ROOT_ACCESS = 0x04,
757  VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_DOMAIN_SHADER_ROOT_ACCESS = 0x08,
758  VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_GEOMETRY_SHADER_ROOT_ACCESS = 0x10,
759  VKD3D_SHADER_ROOT_SIGNATURE_FLAG_DENY_PIXEL_SHADER_ROOT_ACCESS = 0x20,
760  VKD3D_SHADER_ROOT_SIGNATURE_FLAG_ALLOW_STREAM_OUTPUT = 0x40,
761 
762  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_ROOT_SIGNATURE_FLAGS),
763 };
764 
766 {
767  unsigned int parameter_count;
768  const struct vkd3d_shader_root_parameter *parameters;
769  unsigned int static_sampler_count;
770  const struct vkd3d_shader_static_sampler_desc *static_samplers;
771  enum vkd3d_shader_root_signature_flags flags;
772 };
773 
774 /* root signature 1.1 */
775 enum vkd3d_shader_root_descriptor_flags
776 {
777  VKD3D_SHADER_ROOT_DESCRIPTOR_FLAG_NONE = 0x0,
778  VKD3D_SHADER_ROOT_DESCRIPTOR_FLAG_DATA_VOLATILE = 0x2,
779  VKD3D_SHADER_ROOT_DESCRIPTOR_FLAG_DATA_STATIC_WHILE_SET_AT_EXECUTE = 0x4,
780  VKD3D_SHADER_ROOT_DESCRIPTOR_FLAG_DATA_STATIC = 0x8,
781 
782  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_ROOT_DESCRIPTOR_FLAGS),
783 };
784 
785 enum vkd3d_shader_descriptor_range_flags
786 {
787  VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_NONE = 0x0,
788  VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DESCRIPTORS_VOLATILE = 0x1,
789  VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DATA_VOLATILE = 0x2,
790  VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DATA_STATIC_WHILE_SET_AT_EXECUTE = 0x4,
791  VKD3D_SHADER_DESCRIPTOR_RANGE_FLAG_DATA_STATIC = 0x8,
792 
793  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_DESCRIPTOR_RANGE_FLAGS),
794 };
795 
797 {
798  enum vkd3d_shader_descriptor_type range_type;
799  unsigned int descriptor_count;
800  unsigned int base_shader_register;
801  unsigned int register_space;
802  enum vkd3d_shader_descriptor_range_flags flags;
803  unsigned int descriptor_table_offset;
804 };
805 
807 {
808  unsigned int descriptor_range_count;
809  const struct vkd3d_shader_descriptor_range1 *descriptor_ranges;
810 };
811 
813 {
814  unsigned int shader_register;
815  unsigned int register_space;
816  enum vkd3d_shader_root_descriptor_flags flags;
817 };
818 
820 {
821  enum vkd3d_shader_root_parameter_type parameter_type;
822  union
823  {
824  struct vkd3d_shader_root_descriptor_table1 descriptor_table;
825  struct vkd3d_shader_root_constants constants;
826  struct vkd3d_shader_root_descriptor1 descriptor;
827  } u;
828  enum vkd3d_shader_visibility shader_visibility;
829 };
830 
832 {
833  unsigned int parameter_count;
834  const struct vkd3d_shader_root_parameter1 *parameters;
835  unsigned int static_sampler_count;
836  const struct vkd3d_shader_static_sampler_desc *static_samplers;
837  enum vkd3d_shader_root_signature_flags flags;
838 };
839 
840 enum vkd3d_shader_root_signature_version
841 {
842  VKD3D_SHADER_ROOT_SIGNATURE_VERSION_1_0 = 0x1,
843  VKD3D_SHADER_ROOT_SIGNATURE_VERSION_1_1 = 0x2,
844 
845  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_ROOT_SIGNATURE_VERSION),
846 };
847 
849 {
850  enum vkd3d_shader_root_signature_version version;
851  union
852  {
855  } u;
856 };
857 
863 {
889 
890  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_RESOURCE_TYPE),
891 };
892 
898 {
909 
910  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_RESOURCE_DATA_TYPE),
911 };
912 
918 {
928 
929  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_DESCRIPTOR_INFO_FLAG),
930 };
931 
937 {
944  unsigned int register_space;
946  unsigned int register_index;
955  unsigned int flags;
957  unsigned int count;
958 };
959 
966 {
972  const void *next;
973 
977  unsigned int descriptor_count;
978 };
979 
985 {
996 
997  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_COMPONENT_TYPE),
998 };
999 
1002 {
1025  VKD3D_SHADER_SV_TESS_FACTOR_QUADEDGE = 0x0b,
1026  VKD3D_SHADER_SV_TESS_FACTOR_QUADINT = 0x0c,
1027  VKD3D_SHADER_SV_TESS_FACTOR_TRIEDGE = 0x0d,
1028  VKD3D_SHADER_SV_TESS_FACTOR_TRIINT = 0x0e,
1029  VKD3D_SHADER_SV_TESS_FACTOR_LINEDET = 0x0f,
1030  VKD3D_SHADER_SV_TESS_FACTOR_LINEDEN = 0x10,
1031 
1032  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SYSVAL_SEMANTIC),
1033 };
1034 
1040 {
1041  VKD3D_SHADER_MINIMUM_PRECISION_NONE = 0,
1050 
1051  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_MINIMUM_PRECISION),
1052 };
1053 
1058 {
1060  const char *semantic_name;
1062  unsigned int semantic_index;
1067  unsigned int stream_index;
1076  unsigned int register_index;
1078  unsigned int mask;
1085  unsigned int used_mask;
1088 };
1089 
1098 {
1102  unsigned int element_count;
1103 };
1104 
1107 {
1108  VKD3D_SHADER_SWIZZLE_X = 0x0,
1109  VKD3D_SHADER_SWIZZLE_Y = 0x1,
1110  VKD3D_SHADER_SWIZZLE_Z = 0x2,
1111  VKD3D_SHADER_SWIZZLE_W = 0x3,
1112 
1113  VKD3D_FORCE_32_BIT_ENUM(VKD3D_SHADER_SWIZZLE_COMPONENT),
1114 };
1115 
1120 #define VKD3D_SHADER_SWIZZLE_MASK (0xffu)
1122 #define VKD3D_SHADER_SWIZZLE_SHIFT(idx) (8u * (idx))
1123 
1133 #define VKD3D_SHADER_SWIZZLE(x, y, z, w) \
1134  vkd3d_shader_create_swizzle(VKD3D_SHADER_SWIZZLE_ ## x, \
1135  VKD3D_SHADER_SWIZZLE_ ## y, \
1136  VKD3D_SHADER_SWIZZLE_ ## z, \
1137  VKD3D_SHADER_SWIZZLE_ ## w)
1138 
1140 #define VKD3D_SHADER_NO_SWIZZLE VKD3D_SHADER_SWIZZLE(X, Y, Z, W)
1141 
1146 {
1151 }
1152 
1153 #ifndef VKD3D_SHADER_NO_PROTOTYPES
1154 
1166 const char *vkd3d_shader_get_version(unsigned int *major, unsigned int *minor);
1196  enum vkd3d_shader_source_type source_type, unsigned int *count);
1197 
1241 int vkd3d_shader_compile(const struct vkd3d_shader_compile_info *compile_info,
1242  struct vkd3d_shader_code *out, char **messages);
1250 void vkd3d_shader_free_messages(char *messages);
1261 
1293  struct vkd3d_shader_versioned_root_signature_desc *root_signature, char **messages);
1305 
1330  struct vkd3d_shader_code *dxbc, char **messages);
1352  enum vkd3d_shader_root_signature_version version, const struct vkd3d_shader_versioned_root_signature_desc *src);
1353 
1378 int vkd3d_shader_scan(const struct vkd3d_shader_compile_info *compile_info, char **messages);
1389 
1415  struct vkd3d_shader_signature *signature, char **messages);
1436  const struct vkd3d_shader_signature *signature, const char *semantic_name,
1437  unsigned int semantic_index, unsigned int stream_index);
1448 
1449 #endif /* VKD3D_SHADER_NO_PROTOTYPES */
1450 
1452 typedef const char *(*PFN_vkd3d_shader_get_version)(unsigned int *major, unsigned int *minor);
1454 typedef const enum vkd3d_shader_source_type *(*PFN_vkd3d_shader_get_supported_source_types)(unsigned int *count);
1456 typedef const enum vkd3d_shader_target_type *(*PFN_vkd3d_shader_get_supported_target_types)(
1457  enum vkd3d_shader_source_type source_type, unsigned int *count);
1458 
1460 typedef int (*PFN_vkd3d_shader_compile)(const struct vkd3d_shader_compile_info *compile_info,
1461  struct vkd3d_shader_code *out, char **messages);
1463 typedef void (*PFN_vkd3d_shader_free_messages)(char *messages);
1466 
1469  struct vkd3d_shader_versioned_root_signature_desc *root_signature, char **messages);
1472 
1475  const struct vkd3d_shader_versioned_root_signature_desc *root_signature,
1476  struct vkd3d_shader_code *dxbc, char **messages);
1477 
1480  enum vkd3d_shader_root_signature_version version, const struct vkd3d_shader_versioned_root_signature_desc *src);
1481 
1483 typedef int (*PFN_vkd3d_shader_scan)(const struct vkd3d_shader_compile_info *compile_info, char **messages);
1486  struct vkd3d_shader_scan_descriptor_info *scan_descriptor_info);
1487 
1490  struct vkd3d_shader_signature *signature, char **messages);
1492 typedef struct vkd3d_shader_signature_element * (*PFN_vkd3d_shader_find_signature_element)(
1493  const struct vkd3d_shader_signature *signature, const char *semantic_name,
1494  unsigned int semantic_index, unsigned int stream_index);
1497 
1498 #ifdef __cplusplus
1499 }
1500 #endif /* __cplusplus */
1501 
1502 #endif /* __VKD3D_SHADER_H */
A generic structure containing a GPU shader, in text or byte-code format.
Definition: vkd3d_shader.h:146
const void * code
Pointer to the code.
Definition: vkd3d_shader.h:148
size_t size
Size of code, in bytes.
Definition: vkd3d_shader.h:150
Describes the mapping of a Direct3D resource-sampler pair to a combined sampler (i....
Definition: vkd3d_shader.h:302
struct vkd3d_shader_descriptor_binding binding
The binding in the target environment.
Definition: vkd3d_shader.h:323
unsigned int resource_index
Register index of the Direct3D resource.
Definition: vkd3d_shader.h:309
unsigned int sampler_index
Register index of the Direct3D sampler.
Definition: vkd3d_shader.h:316
unsigned int sampler_space
Register space of the Direct3D sampler.
Definition: vkd3d_shader.h:314
unsigned int resource_space
Register space of the Direct3D resource.
Definition: vkd3d_shader.h:307
unsigned int flags
A combination of zero or more elements of vkd3d_shader_binding_flag.
Definition: vkd3d_shader.h:320
enum vkd3d_shader_visibility shader_visibility
Shader stage(s) to which the resource is visible.
Definition: vkd3d_shader.h:318
A chained structure containing compilation parameters.
Definition: vkd3d_shader.h:497
const struct vkd3d_shader_compile_option * options
Pointer to an array of compilation options.
Definition: vkd3d_shader.h:525
struct vkd3d_shader_code source
Input source code or byte code.
Definition: vkd3d_shader.h:508
enum vkd3d_shader_log_level log_level
Minimum severity of messages returned from the shader function.
Definition: vkd3d_shader.h:530
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_COMPILE_INFO.
Definition: vkd3d_shader.h:499
const char * source_name
Name of the initial source file, which may be used in error messages or debug information.
Definition: vkd3d_shader.h:535
unsigned int option_count
Size, in elements, of options.
Definition: vkd3d_shader.h:527
enum vkd3d_shader_source_type source_type
Format of the input code passed in source.
Definition: vkd3d_shader.h:511
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d_shader.h:505
enum vkd3d_shader_target_type target_type
Desired output format.
Definition: vkd3d_shader.h:513
Various settings which may affect shader compilation or scanning, passed as part of struct vkd3d_shad...
Definition: vkd3d_shader.h:112
unsigned int value
A value associated with the option.
Definition: vkd3d_shader.h:119
enum vkd3d_shader_compile_option_name name
Name of the option.
Definition: vkd3d_shader.h:114
A common structure describing the bind point of a descriptor or descriptor array in the target enviro...
Definition: vkd3d_shader.h:185
unsigned int binding
The binding index of the descriptor.
Definition: vkd3d_shader.h:192
unsigned int count
The size of this descriptor array.
Definition: vkd3d_shader.h:197
unsigned int set
The set of the descriptor.
Definition: vkd3d_shader.h:190
Describes a single shader descriptor; returned as part of struct vkd3d_shader_scan_descriptor_info.
Definition: vkd3d_shader.h:937
enum vkd3d_shader_resource_type resource_type
Resource type, if applicable, including its dimension.
Definition: vkd3d_shader.h:948
unsigned int register_index
Register index of the descriptor.
Definition: vkd3d_shader.h:946
enum vkd3d_shader_resource_data_type resource_data_type
Data type contained in the resource (for example, float or integer).
Definition: vkd3d_shader.h:950
enum vkd3d_shader_descriptor_type type
Type of the descriptor (for example, SRV, CBV, UAV, or sampler).
Definition: vkd3d_shader.h:939
unsigned int count
Size of this descriptor array, or 1 if a single descriptor.
Definition: vkd3d_shader.h:957
unsigned int flags
Bitwise combination of zero or more members of vkd3d_shader_descriptor_info_flag.
Definition: vkd3d_shader.h:955
unsigned int register_space
Register space of the resource, or 0 if the shader does not support multiple register spaces.
Definition: vkd3d_shader.h:944
Definition: vkd3d_shader.h:797
Definition: vkd3d_shader.h:701
A chained structure describing the interface between a compiled shader and the target environment.
Definition: vkd3d_shader.h:389
unsigned int combined_sampler_count
Size, in elements, of combined_samplers.
Definition: vkd3d_shader.h:408
const struct vkd3d_shader_resource_binding * bindings
Pointer to an array of bindings for shader resource descriptors.
Definition: vkd3d_shader.h:396
const struct vkd3d_shader_push_constant_buffer * push_constant_buffers
Pointer to an array of bindings for push constant buffers.
Definition: vkd3d_shader.h:401
const struct vkd3d_shader_uav_counter_binding * uav_counters
Pointer to an array of bindings for UAV counters.
Definition: vkd3d_shader.h:411
unsigned int binding_count
Size, in elements, of bindings.
Definition: vkd3d_shader.h:398
unsigned int push_constant_buffer_count
Size, in elements, of push_constant_buffers.
Definition: vkd3d_shader.h:403
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d_shader.h:393
const struct vkd3d_shader_combined_resource_sampler * combined_samplers
Pointer to an array of bindings for combined samplers.
Definition: vkd3d_shader.h:406
enum vkd3d_shader_structure_type type
Must be set to VKD3D_SHADER_STRUCTURE_TYPE_INTERFACE_INFO.
Definition: vkd3d_shader.h:391
unsigned int uav_counter_count
Size, in elements, of uav_counters.
Definition: vkd3d_shader.h:413
Definition: vkd3d_shader.h:234
Definition: vkd3d_shader.h:247
Describes the mapping of a Direct3D constant buffer to a range of push constants in the target enviro...
Definition: vkd3d_shader.h:355
unsigned int register_index
Register index of the Direct3D resource.
Definition: vkd3d_shader.h:362
unsigned int size
Size, in bytes, of the target push constants.
Definition: vkd3d_shader.h:369
unsigned int register_space
Register space of the Direct3D resource.
Definition: vkd3d_shader.h:360
enum vkd3d_shader_visibility shader_visibility
Shader stage(s) to which the resource is visible.
Definition: vkd3d_shader.h:364
unsigned int offset
Offset, in bytes, of the target push constants.
Definition: vkd3d_shader.h:367
Describes the mapping of a single resource or resource array to its binding point in the target envir...
Definition: vkd3d_shader.h:274
struct vkd3d_shader_descriptor_binding binding
The binding in the target environment.
Definition: vkd3d_shader.h:290
unsigned int register_space
Register space of the Direct3D resource.
Definition: vkd3d_shader.h:281
enum vkd3d_shader_descriptor_type type
The type of this descriptor.
Definition: vkd3d_shader.h:276
unsigned int flags
A combination of zero or more elements of vkd3d_shader_binding_flag.
Definition: vkd3d_shader.h:287
unsigned int register_index
Register index of the DXBC resource.
Definition: vkd3d_shader.h:283
enum vkd3d_shader_visibility shader_visibility
Shader stage(s) to which the resource is visible.
Definition: vkd3d_shader.h:285
Definition: vkd3d_shader.h:716
Definition: vkd3d_shader.h:813
Definition: vkd3d_shader.h:807
Definition: vkd3d_shader.h:710
Definition: vkd3d_shader.h:723
Definition: vkd3d_shader.h:820
Definition: vkd3d_shader.h:740
Definition: vkd3d_shader.h:832
Definition: vkd3d_shader.h:766
A chained structure enumerating the descriptors declared by a shader.
Definition: vkd3d_shader.h:966
enum vkd3d_shader_structure_type type
Input; must be set to VKD3D_SHADER_STRUCTURE_TYPE_SCAN_DESCRIPTOR_INFO.
Definition: vkd3d_shader.h:970
const void * next
Input; optional pointer to a structure containing further parameters.
Definition: vkd3d_shader.h:972
unsigned int descriptor_count
Output; size, in elements, of descriptors.
Definition: vkd3d_shader.h:977
struct vkd3d_shader_descriptor_info * descriptors
Output; returns a pointer to an array of descriptors.
Definition: vkd3d_shader.h:975
A single shader varying, returned as part of struct vkd3d_shader_signature.
Definition: vkd3d_shader.h:1058
unsigned int semantic_index
Semantic index, or 0 if the semantic is not indexed.
Definition: vkd3d_shader.h:1062
enum vkd3d_shader_sysval_semantic sysval_semantic
System value semantic.
Definition: vkd3d_shader.h:1072
unsigned int stream_index
Stream index of a geometry shader output semantic.
Definition: vkd3d_shader.h:1067
unsigned int used_mask
Subset of mask which the shader reads from or writes to.
Definition: vkd3d_shader.h:1085
enum vkd3d_shader_component_type component_type
Data type.
Definition: vkd3d_shader.h:1074
enum vkd3d_shader_minimum_precision min_precision
Minimum interpolation precision.
Definition: vkd3d_shader.h:1087
unsigned int register_index
Register index.
Definition: vkd3d_shader.h:1076
unsigned int mask
Mask of the register components allocated to this varying.
Definition: vkd3d_shader.h:1078
const char * semantic_name
Semantic name.
Definition: vkd3d_shader.h:1060
Description of a shader input or output signature.
Definition: vkd3d_shader.h:1098
struct vkd3d_shader_signature_element * elements
Pointer to an array of varyings.
Definition: vkd3d_shader.h:1100
unsigned int element_count
Size, in elements, of elements.
Definition: vkd3d_shader.h:1102
Definition: vkd3d_shader.h:598
Definition: vkd3d_shader.h:557
Definition: vkd3d_shader.h:684
Definition: vkd3d_shader.h:417
Definition: vkd3d_shader.h:428
Describes the mapping of a single Direct3D UAV counter.
Definition: vkd3d_shader.h:332
enum vkd3d_shader_visibility shader_visibility
Shader stage(s) to which the UAV counter is visible.
Definition: vkd3d_shader.h:341
unsigned int register_space
Register space of the Direct3D UAV descriptor.
Definition: vkd3d_shader.h:337
struct vkd3d_shader_descriptor_binding binding
The binding in the target environment.
Definition: vkd3d_shader.h:344
unsigned int register_index
Register index of the Direct3D UAV descriptor.
Definition: vkd3d_shader.h:339
Definition: vkd3d_shader.h:849
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().
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...
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_compile_option_name
Definition: vkd3d_shader.h:89
@ VKD3D_SHADER_COMPILE_OPTION_BUFFER_UAV
value is a member of enum vkd3d_shader_compile_option_buffer_uav.
Definition: vkd3d_shader.h:99
@ VKD3D_SHADER_COMPILE_OPTION_STRIP_DEBUG
If value is nonzero, do not include debug information in the compiled shader.
Definition: vkd3d_shader.h:97
@ VKD3D_SHADER_COMPILE_OPTION_FORMATTING
value is a member of enum vkd3d_shader_compile_option_formatting_flags.
Definition: vkd3d_shader.h:101
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:1143
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:1479
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:898
@ VKD3D_SHADER_RESOURCE_DATA_SNORM
Signed normalized integer.
Definition: vkd3d_shader.h:902
@ VKD3D_SHADER_RESOURCE_DATA_UINT
Unsigned integer.
Definition: vkd3d_shader.h:906
@ VKD3D_SHADER_RESOURCE_DATA_FLOAT
IEEE floating-point.
Definition: vkd3d_shader.h:908
@ VKD3D_SHADER_RESOURCE_DATA_UNORM
Unsigned normalized integer.
Definition: vkd3d_shader.h:900
@ VKD3D_SHADER_RESOURCE_DATA_INT
Signed integer.
Definition: vkd3d_shader.h:904
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...
vkd3d_shader_descriptor_info_flag
Additional flags describing a shader descriptor, returned as part of struct vkd3d_shader_descriptor_i...
Definition: vkd3d_shader.h:918
@ VKD3D_SHADER_DESCRIPTOR_INFO_FLAG_UAV_READ
The descriptor is a UAV resource, which is read from by the shader.
Definition: vkd3d_shader.h:925
@ 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:923
@ VKD3D_SHADER_DESCRIPTOR_INFO_FLAG_SAMPLER_COMPARISON_MODE
The descriptor is a comparison sampler.
Definition: vkd3d_shader.h:927
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...
void(* PFN_vkd3d_shader_free_shader_signature)(struct vkd3d_shader_signature *signature)
Type of vkd3d_shader_free_shader_signature().
Definition: vkd3d_shader.h:1496
int(* PFN_vkd3d_shader_scan)(const struct vkd3d_shader_compile_info *compile_info, char **messages)
Type of vkd3d_shader_scan().
Definition: vkd3d_shader.h:1483
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:1471
vkd3d_shader_sysval_semantic
System value semantic, returned as part of struct vkd3d_shader_signature.
Definition: vkd3d_shader.h:1002
@ VKD3D_SHADER_SV_VERTEX_ID
Vertex ID; SV_VertexID in Direct3D.
Definition: vkd3d_shader.h:1016
@ VKD3D_SHADER_SV_RENDER_TARGET_ARRAY_INDEX
Render target layer; SV_RenderTargetArrayIndex in Direct3D.
Definition: vkd3d_shader.h:1012
@ VKD3D_SHADER_SV_PRIMITIVE_ID
Primtive ID; SV_PrimitiveID in Direct3D.
Definition: vkd3d_shader.h:1018
@ VKD3D_SHADER_SV_CULL_DISTANCE
Cull distance; SV_CullDistance in Direct3D.
Definition: vkd3d_shader.h:1010
@ VKD3D_SHADER_SV_NONE
No system value.
Definition: vkd3d_shader.h:1004
@ VKD3D_SHADER_SV_IS_FRONT_FACE
Whether the triangle is front-facing; SV_IsFrontFace in Direct3D.
Definition: vkd3d_shader.h:1022
@ VKD3D_SHADER_SV_VIEWPORT_ARRAY_INDEX
Viewport index; SV_ViewportArrayIndex in Direct3D.
Definition: vkd3d_shader.h:1014
@ VKD3D_SHADER_SV_INSTANCE_ID
Instance ID; SV_InstanceID in Direct3D.
Definition: vkd3d_shader.h:1020
@ VKD3D_SHADER_SV_CLIP_DISTANCE
Clip distance; SV_ClipDistance in Direct3D.
Definition: vkd3d_shader.h:1008
@ VKD3D_SHADER_SV_SAMPLE_INDEX
Sample index; SV_SampleIndex in Direct3D.
Definition: vkd3d_shader.h:1024
@ VKD3D_SHADER_SV_POSITION
Vertex position; SV_Position in Direct3D.
Definition: vkd3d_shader.h:1006
vkd3d_shader_source_type
The format of a shader to be compiled or scanned.
Definition: vkd3d_shader.h:440
@ VKD3D_SHADER_SOURCE_DXBC_TPF
A 'Tokenized Program Format' shader embedded in a DXBC container.
Definition: vkd3d_shader.h:450
@ VKD3D_SHADER_SOURCE_NONE
The shader has no type or is to be ignored.
Definition: vkd3d_shader.h:445
vkd3d_shader_log_level
Describes the minimum severity of compilation messages returned by vkd3d_shader_compile() and similar...
Definition: vkd3d_shader.h:478
@ VKD3D_SHADER_LOG_NONE
No messages will be returned.
Definition: vkd3d_shader.h:480
@ VKD3D_SHADER_LOG_ERROR
Only fatal errors which prevent successful compilation will be returned.
Definition: vkd3d_shader.h:482
@ VKD3D_SHADER_LOG_WARNING
Non-fatal warnings and fatal errors will be returned.
Definition: vkd3d_shader.h:484
@ VKD3D_SHADER_LOG_INFO
All messages, including general informational messages, will be returned.
Definition: vkd3d_shader.h:488
vkd3d_shader_structure_type
The type of a chained structure.
Definition: vkd3d_shader.h:43
@ VKD3D_SHADER_STRUCTURE_TYPE_TRANSFORM_FEEDBACK_INFO
The structure is a vkd3d_shader_transform_feedback_info structure.
Definition: vkd3d_shader.h:55
@ VKD3D_SHADER_STRUCTURE_TYPE_COMPILE_INFO
The structure is a vkd3d_shader_compile_info structure.
Definition: vkd3d_shader.h:45
@ VKD3D_SHADER_STRUCTURE_TYPE_SCAN_DESCRIPTOR_INFO
The structure is a vkd3d_shader_scan_descriptor_info structure.
Definition: vkd3d_shader.h:49
@ 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:51
@ VKD3D_SHADER_STRUCTURE_TYPE_INTERFACE_INFO
The structure is a vkd3d_shader_interface_info structure.
Definition: vkd3d_shader.h:47
@ VKD3D_SHADER_STRUCTURE_TYPE_SPIRV_TARGET_INFO
The structure is a vkd3d_shader_spirv_target_info structure.
Definition: vkd3d_shader.h:53
vkd3d_shader_visibility
Describes which shader stages a resource is visible to.
Definition: vkd3d_shader.h:124
@ VKD3D_SHADER_VISIBILITY_DOMAIN
The resource is visible only to the domain shader.
Definition: vkd3d_shader.h:132
@ VKD3D_SHADER_VISIBILITY_COMPUTE
The resource is visible only to the compute shader.
Definition: vkd3d_shader.h:139
@ VKD3D_SHADER_VISIBILITY_PIXEL
The resource is visible only to the pixel shader.
Definition: vkd3d_shader.h:136
@ VKD3D_SHADER_VISIBILITY_ALL
The resource is visible to all shader stages.
Definition: vkd3d_shader.h:126
@ VKD3D_SHADER_VISIBILITY_GEOMETRY
The resource is visible only to the geometry shader.
Definition: vkd3d_shader.h:134
@ VKD3D_SHADER_VISIBILITY_VERTEX
The resource is visible only to the vertex shader.
Definition: vkd3d_shader.h:128
@ VKD3D_SHADER_VISIBILITY_HULL
The resource is visible only to the hull shader.
Definition: vkd3d_shader.h:130
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...
const char * vkd3d_shader_get_version(unsigned int *major, unsigned int *minor)
Returns the current version of this library.
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...
vkd3d_shader_component_type
Data type of a shader varying, returned as part of struct vkd3d_shader_signature_element.
Definition: vkd3d_shader.h:985
@ VKD3D_SHADER_COMPONENT_INT
32-bit signed integer.
Definition: vkd3d_shader.h:991
@ VKD3D_SHADER_COMPONENT_UINT
32-bit unsigned integer.
Definition: vkd3d_shader.h:989
@ VKD3D_SHADER_COMPONENT_FLOAT
32-bit IEEE floating-point.
Definition: vkd3d_shader.h:993
@ VKD3D_SHADER_COMPONENT_VOID
The varying has no type.
Definition: vkd3d_shader.h:987
@ VKD3D_SHADER_COMPONENT_BOOL
Boolean.
Definition: vkd3d_shader.h:995
vkd3d_shader_descriptor_type
The type of a shader resource descriptor.
Definition: vkd3d_shader.h:155
@ VKD3D_SHADER_DESCRIPTOR_TYPE_UAV
The descriptor is an unordered access view.
Definition: vkd3d_shader.h:165
@ VKD3D_SHADER_DESCRIPTOR_TYPE_CBV
The descriptor is a constant buffer view.
Definition: vkd3d_shader.h:170
@ VKD3D_SHADER_DESCRIPTOR_TYPE_SAMPLER
The descriptor is a sampler.
Definition: vkd3d_shader.h:175
@ VKD3D_SHADER_DESCRIPTOR_TYPE_SRV
The descriptor is a shader resource view.
Definition: vkd3d_shader.h:160
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.
#define VKD3D_SHADER_SWIZZLE_MASK
A mask selecting one component from a vkd3d-shader swizzle.
Definition: vkd3d_shader.h:1120
vkd3d_shader_resource_type
The type of a shader resource, returned as part of struct vkd3d_shader_descriptor_info.
Definition: vkd3d_shader.h:863
@ VKD3D_SHADER_RESOURCE_NONE
The type is invalid or not applicable for this descriptor.
Definition: vkd3d_shader.h:868
@ VKD3D_SHADER_RESOURCE_TEXTURE_2DARRAY
2-dimensional array texture.
Definition: vkd3d_shader.h:884
@ VKD3D_SHADER_RESOURCE_TEXTURE_2DMS
Multisampled 2-dimensional texture.
Definition: vkd3d_shader.h:876
@ VKD3D_SHADER_RESOURCE_TEXTURE_3D
3-dimensional texture.
Definition: vkd3d_shader.h:878
@ VKD3D_SHADER_RESOURCE_TEXTURE_1DARRAY
1-dimensional array texture.
Definition: vkd3d_shader.h:882
@ VKD3D_SHADER_RESOURCE_BUFFER
Dimensionless buffer.
Definition: vkd3d_shader.h:870
@ VKD3D_SHADER_RESOURCE_TEXTURE_CUBE
Cubemap texture.
Definition: vkd3d_shader.h:880
@ VKD3D_SHADER_RESOURCE_TEXTURE_1D
1-dimensional texture.
Definition: vkd3d_shader.h:872
@ VKD3D_SHADER_RESOURCE_TEXTURE_CUBEARRAY
Cubemap array texture.
Definition: vkd3d_shader.h:888
@ VKD3D_SHADER_RESOURCE_TEXTURE_2DMSARRAY
Multisampled 2-dimensional array texture.
Definition: vkd3d_shader.h:886
@ VKD3D_SHADER_RESOURCE_TEXTURE_2D
2-dimensional texture.
Definition: vkd3d_shader.h:874
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...
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.
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:1468
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:1474
vkd3d_shader_swizzle_component
Possible values for a single component of a vkd3d-shader swizzle.
Definition: vkd3d_shader.h:1107
void vkd3d_shader_free_messages(char *messages)
Free shader messages allocated by another vkd3d-shader function, such as vkd3d_shader_compile().
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:1460
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:1485
#define VKD3D_SHADER_SWIZZLE_SHIFT(idx)
The offset, in bits, of the nth parameter of a vkd3d-shader swizzle.
Definition: vkd3d_shader.h:1122
void(* PFN_vkd3d_shader_free_messages)(char *messages)
Type of vkd3d_shader_free_messages().
Definition: vkd3d_shader.h:1463
vkd3d_shader_minimum_precision
Minimum interpolation precision of a shader varying, returned as part of struct vkd3d_shader_signatur...
Definition: vkd3d_shader.h:1040
@ VKD3D_SHADER_MINIMUM_PRECISION_UINT_16
16-bit unsigned integer.
Definition: vkd3d_shader.h:1049
@ VKD3D_SHADER_MINIMUM_PRECISION_FIXED_8_2
10-bit fixed point (2 integer and 8 fractional bits).
Definition: vkd3d_shader.h:1045
@ VKD3D_SHADER_MINIMUM_PRECISION_FLOAT_16
16-bit floating-point.
Definition: vkd3d_shader.h:1043
@ VKD3D_SHADER_MINIMUM_PRECISION_INT_16
16-bit signed integer.
Definition: vkd3d_shader.h:1047
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:1489
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_target_type
The output format of a compiled shader.
Definition: vkd3d_shader.h:457
@ VKD3D_SHADER_TARGET_SPIRV_BINARY
A SPIR-V shader in binary form.
Definition: vkd3d_shader.h:467
@ VKD3D_SHADER_TARGET_NONE
The shader has no type or is to be ignored.
Definition: vkd3d_shader.h:462
void(* PFN_vkd3d_shader_free_shader_code)(struct vkd3d_shader_code *code)
Type of vkd3d_shader_free_shader_code().
Definition: vkd3d_shader.h:1465
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().
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 shader, returning a structural description which can be easily...
vkd3d_shader_compile_option_buffer_uav
Determines how buffer UAVs are stored.
Definition: vkd3d_shader.h:67
@ VKD3D_SHADER_COMPILE_OPTION_BUFFER_UAV_STORAGE_TEXEL_BUFFER
Use buffer textures for buffer UAVs.
Definition: vkd3d_shader.h:69
@ VKD3D_SHADER_COMPILE_OPTION_BUFFER_UAV_STORAGE_BUFFER
Use storage buffers for buffer UAVs.
Definition: vkd3d_shader.h:71
This file contains definitions for basic types used by vkd3d libraries.