xref: /aosp_15_r20/external/mesa3d/src/gallium/drivers/zink/zink_descriptors.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /*
2  * Copyright © 2020 Mike Blumenkrantz
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice (including the next
12  * paragraph) shall be included in all copies or substantial portions of the
13  * Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21  * IN THE SOFTWARE.
22  *
23  * Authors:
24  *    Mike Blumenkrantz <[email protected]>
25  */
26 
27 #ifndef ZINK_DESCRIPTOR_H
28 # define  ZINK_DESCRIPTOR_H
29 
30 #include "zink_types.h"
31 #ifdef __cplusplus
32 extern "C" {
33 #endif
34 
35 #define ZINK_DESCRIPTOR_COMPACT 2
36 
37 
38 #define ZINK_BINDLESS_IS_BUFFER(HANDLE) (HANDLE >= ZINK_MAX_BINDLESS_HANDLES)
39 
40 static inline enum zink_descriptor_size_index
zink_vktype_to_size_idx(VkDescriptorType type)41 zink_vktype_to_size_idx(VkDescriptorType type)
42 {
43    switch (type) {
44    case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER:
45    case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC:
46       return ZDS_INDEX_UBO;
47    case VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE:
48    case VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER:
49       return ZDS_INDEX_COMBINED_SAMPLER;
50    case VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER:
51       return ZDS_INDEX_UNIFORM_TEXELS;
52    case VK_DESCRIPTOR_TYPE_SAMPLER:
53       return ZDS_INDEX_SAMPLER;
54    case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER:
55       return ZDS_INDEX_STORAGE_BUFFER;
56    case VK_DESCRIPTOR_TYPE_STORAGE_IMAGE:
57       return ZDS_INDEX_STORAGE_IMAGE;
58    case VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER:
59       return ZDS_INDEX_STORAGE_TEXELS;
60    default: break;
61    }
62    unreachable("unknown type");
63 }
64 
65 static inline enum zink_descriptor_size_index_compact
zink_vktype_to_size_idx_comp(VkDescriptorType type)66 zink_vktype_to_size_idx_comp(VkDescriptorType type)
67 {
68    switch (type) {
69    case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER:
70    case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC:
71       return ZDS_INDEX_COMP_UBO;
72    case VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE:
73    case VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER:
74       return ZDS_INDEX_COMP_COMBINED_SAMPLER;
75    case VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER:
76       return ZDS_INDEX_COMP_UNIFORM_TEXELS;
77    case VK_DESCRIPTOR_TYPE_SAMPLER:
78       return ZDS_INDEX_COMP_SAMPLER;
79    case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER:
80       return ZDS_INDEX_COMP_STORAGE_BUFFER;
81    case VK_DESCRIPTOR_TYPE_STORAGE_IMAGE:
82       return ZDS_INDEX_COMP_STORAGE_IMAGE;
83    case VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER:
84       return ZDS_INDEX_COMP_STORAGE_TEXELS;
85    default: break;
86    }
87    unreachable("unknown type");
88 }
89 
90 static inline enum zink_descriptor_size_index
zink_descriptor_type_to_size_idx(enum zink_descriptor_type type)91 zink_descriptor_type_to_size_idx(enum zink_descriptor_type type)
92 {
93    switch (type) {
94    case ZINK_DESCRIPTOR_TYPE_UBO:
95       return ZDS_INDEX_UBO;
96    case ZINK_DESCRIPTOR_TYPE_SAMPLER_VIEW:
97       return ZDS_INDEX_COMBINED_SAMPLER;
98    case ZINK_DESCRIPTOR_TYPE_SSBO:
99       return ZDS_INDEX_STORAGE_BUFFER;
100    case ZINK_DESCRIPTOR_TYPE_IMAGE:
101       return ZDS_INDEX_STORAGE_IMAGE;
102    default: break;
103    }
104    unreachable("unknown type");
105 }
106 
107 static inline enum zink_descriptor_size_index_compact
zink_descriptor_type_to_size_idx_comp(enum zink_descriptor_type type)108 zink_descriptor_type_to_size_idx_comp(enum zink_descriptor_type type)
109 {
110    switch (type) {
111    case ZINK_DESCRIPTOR_TYPE_UBO:
112       return ZDS_INDEX_COMP_UBO;
113    case ZINK_DESCRIPTOR_TYPE_SAMPLER_VIEW:
114       return ZDS_INDEX_COMP_COMBINED_SAMPLER;
115    case ZINK_DESCRIPTOR_TYPE_SSBO:
116    case ZINK_DESCRIPTOR_TYPE_IMAGE:
117    default: break;
118    }
119    unreachable("unknown type");
120 }
121 
122 /* bindless descriptor bindings have their own struct indexing */
123 ALWAYS_INLINE static VkDescriptorType
zink_descriptor_type_from_bindless_index(unsigned idx)124 zink_descriptor_type_from_bindless_index(unsigned idx)
125 {
126    switch (idx) {
127    case 0: return VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER;
128    case 1: return VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER;
129    case 2: return VK_DESCRIPTOR_TYPE_STORAGE_IMAGE;
130    case 3: return VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER;
131    default:
132       unreachable("unknown index");
133    }
134 }
135 
136 bool
137 zink_descriptor_layouts_init(struct zink_screen *screen);
138 
139 void
140 zink_descriptor_layouts_deinit(struct zink_screen *screen);
141 
142 bool
143 zink_descriptor_util_alloc_sets(struct zink_screen *screen, VkDescriptorSetLayout dsl, VkDescriptorPool pool, VkDescriptorSet *sets, unsigned num_sets);
144 void
145 zink_descriptor_util_init_fbfetch(struct zink_context *ctx);
146 bool
147 zink_descriptor_util_push_layouts_get(struct zink_context *ctx, struct zink_descriptor_layout **dsls, struct zink_descriptor_layout_key **layout_keys);
148 VkImageLayout
149 zink_descriptor_util_image_layout_eval(const struct zink_context *ctx, const struct zink_resource *res, bool is_compute);
150 void
151 zink_descriptors_init_bindless(struct zink_context *ctx);
152 void
153 zink_descriptors_deinit_bindless(struct zink_context *ctx);
154 void
155 zink_descriptors_update_bindless(struct zink_context *ctx);
156 
157 void
158 zink_descriptor_shader_get_binding_offsets(const struct zink_shader *shader, unsigned *offsets);
159 void
160 zink_descriptor_shader_init(struct zink_screen *screen, struct zink_shader *shader);
161 void
162 zink_descriptor_shader_deinit(struct zink_screen *screen, struct zink_shader *shader);
163 
164 bool
165 zink_descriptor_program_init(struct zink_context *ctx, struct zink_program *pg);
166 
167 void
168 zink_descriptor_program_deinit(struct zink_screen *screen, struct zink_program *pg);
169 
170 void
171 zink_descriptors_update(struct zink_context *ctx, bool is_compute);
172 
173 
174 void
175 zink_context_invalidate_descriptor_state(struct zink_context *ctx, gl_shader_stage shader, enum zink_descriptor_type type, unsigned, unsigned);
176 void
177 zink_context_invalidate_descriptor_state_compact(struct zink_context *ctx, gl_shader_stage shader, enum zink_descriptor_type type, unsigned, unsigned);
178 
179 void
180 zink_batch_descriptor_deinit(struct zink_screen *screen, struct zink_batch_state *bs);
181 void
182 zink_batch_descriptor_reset(struct zink_screen *screen, struct zink_batch_state *bs);
183 bool
184 zink_batch_descriptor_init(struct zink_screen *screen, struct zink_batch_state *bs);
185 
186 bool
187 zink_descriptors_init(struct zink_context *ctx);
188 
189 void
190 zink_descriptors_deinit(struct zink_context *ctx);
191 
192 void
193 zink_descriptors_update_masked(struct zink_context *ctx, bool is_compute, uint8_t changed_sets, uint8_t bind_sets);
194 #ifdef __cplusplus
195 }
196 #endif
197 
198 #endif
199