blob: 9f3b239d83facc8aafe64de980a801716f6bb70d [file] [log] [blame]
Tobin Ehlis0a43bde2016-05-03 08:31:08 -06001/* Copyright (c) 2015-2016 The Khronos Group Inc.
2 * Copyright (c) 2015-2016 Valve Corporation
3 * Copyright (c) 2015-2016 LunarG, Inc.
4 * Copyright (C) 2015-2016 Google Inc.
5 *
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
9 *
10 * http://www.apache.org/licenses/LICENSE-2.0
11 *
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
17 *
18 * Author: Tobin Ehlis <tobine@google.com>
19 */
20
21#include "descriptor_sets.h"
22#include "vk_enum_string_helper.h"
23#include "vk_safe_struct.h"
24#include <sstream>
25
26// Construct DescriptorSetLayout instance from given create info
27cvdescriptorset::DescriptorSetLayout::DescriptorSetLayout(debug_report_data *report_data,
28 const VkDescriptorSetLayoutCreateInfo *p_create_info,
29 const VkDescriptorSetLayout layout)
30 : layout_(layout), binding_count_(p_create_info->bindingCount), descriptor_count_(0), dynamic_descriptor_count_(0) {
31 uint32_t global_index = 0;
32 for (uint32_t i = 0; i < binding_count_; ++i) {
33 descriptor_count_ += p_create_info->pBindings[i].descriptorCount;
34 if (!binding_to_index_map_.emplace(p_create_info->pBindings[i].binding, i).second) {
35 log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_LAYOUT_EXT,
36 reinterpret_cast<uint64_t &>(layout_), __LINE__, DRAWSTATE_INVALID_LAYOUT, "DS",
37 "duplicated binding number in "
38 "VkDescriptorSetLayoutBinding");
39 }
40 binding_to_global_start_index_map_[p_create_info->pBindings[i].binding] = global_index;
41 global_index += p_create_info->pBindings[i].descriptorCount ? p_create_info->pBindings[i].descriptorCount - 1 : 0;
42 binding_to_global_end_index_map_[p_create_info->pBindings[i].binding] = global_index;
43 global_index++;
Tobin Ehlis664e6012016-05-05 11:04:44 -060044 bindings_.push_back(safe_VkDescriptorSetLayoutBinding(&p_create_info->pBindings[i]));
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060045 // In cases where we should ignore pImmutableSamplers make sure it's NULL
46 if ((p_create_info->pBindings[i].pImmutableSamplers) &&
47 ((p_create_info->pBindings[i].descriptorType != VK_DESCRIPTOR_TYPE_SAMPLER) &&
48 (p_create_info->pBindings[i].descriptorType != VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER))) {
Tobin Ehlis664e6012016-05-05 11:04:44 -060049 bindings_.back().pImmutableSamplers = nullptr;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060050 }
51 if (p_create_info->pBindings[i].descriptorType == VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC ||
52 p_create_info->pBindings[i].descriptorType == VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC) {
Tobin Ehlisef0de162016-06-20 13:07:34 -060053 dynamic_descriptor_count_ += p_create_info->pBindings[i].descriptorCount;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060054 }
55 }
56}
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060057// put all bindings into the given set
58void cvdescriptorset::DescriptorSetLayout::FillBindingSet(std::unordered_set<uint32_t> *binding_set) const {
59 for (auto binding_index_pair : binding_to_index_map_)
60 binding_set->insert(binding_index_pair.first);
61}
Tobin Ehlis56a30942016-05-19 08:00:00 -060062
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060063VkDescriptorSetLayoutBinding const *
64cvdescriptorset::DescriptorSetLayout::GetDescriptorSetLayoutBindingPtrFromBinding(const uint32_t binding) const {
Tobin Ehlis0bc30632016-05-05 10:16:02 -060065 const auto &bi_itr = binding_to_index_map_.find(binding);
66 if (bi_itr != binding_to_index_map_.end()) {
Tobin Ehlis664e6012016-05-05 11:04:44 -060067 return bindings_[bi_itr->second].ptr();
Tobin Ehlis0bc30632016-05-05 10:16:02 -060068 }
69 return nullptr;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060070}
71VkDescriptorSetLayoutBinding const *
72cvdescriptorset::DescriptorSetLayout::GetDescriptorSetLayoutBindingPtrFromIndex(const uint32_t index) const {
73 if (index >= bindings_.size())
74 return nullptr;
Tobin Ehlis664e6012016-05-05 11:04:44 -060075 return bindings_[index].ptr();
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060076}
77// Return descriptorCount for given binding, 0 if index is unavailable
78uint32_t cvdescriptorset::DescriptorSetLayout::GetDescriptorCountFromBinding(const uint32_t binding) const {
Tobin Ehlis0bc30632016-05-05 10:16:02 -060079 const auto &bi_itr = binding_to_index_map_.find(binding);
80 if (bi_itr != binding_to_index_map_.end()) {
Tobin Ehlis664e6012016-05-05 11:04:44 -060081 return bindings_[bi_itr->second].descriptorCount;
Tobin Ehlis0bc30632016-05-05 10:16:02 -060082 }
83 return 0;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060084}
85// Return descriptorCount for given index, 0 if index is unavailable
86uint32_t cvdescriptorset::DescriptorSetLayout::GetDescriptorCountFromIndex(const uint32_t index) const {
87 if (index >= bindings_.size())
88 return 0;
Tobin Ehlis664e6012016-05-05 11:04:44 -060089 return bindings_[index].descriptorCount;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060090}
91// For the given binding, return descriptorType
92VkDescriptorType cvdescriptorset::DescriptorSetLayout::GetTypeFromBinding(const uint32_t binding) const {
93 assert(binding_to_index_map_.count(binding));
Tobin Ehlis0bc30632016-05-05 10:16:02 -060094 const auto &bi_itr = binding_to_index_map_.find(binding);
95 if (bi_itr != binding_to_index_map_.end()) {
Tobin Ehlis664e6012016-05-05 11:04:44 -060096 return bindings_[bi_itr->second].descriptorType;
Tobin Ehlis0bc30632016-05-05 10:16:02 -060097 }
98 return VK_DESCRIPTOR_TYPE_MAX_ENUM;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -060099}
100// For the given index, return descriptorType
101VkDescriptorType cvdescriptorset::DescriptorSetLayout::GetTypeFromIndex(const uint32_t index) const {
102 assert(index < bindings_.size());
Tobin Ehlis664e6012016-05-05 11:04:44 -0600103 return bindings_[index].descriptorType;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600104}
105// For the given global index, return descriptorType
106// Currently just counting up through bindings_, may improve this in future
107VkDescriptorType cvdescriptorset::DescriptorSetLayout::GetTypeFromGlobalIndex(const uint32_t index) const {
108 uint32_t global_offset = 0;
109 for (auto binding : bindings_) {
Tobin Ehlis664e6012016-05-05 11:04:44 -0600110 global_offset += binding.descriptorCount;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600111 if (index < global_offset)
Tobin Ehlis664e6012016-05-05 11:04:44 -0600112 return binding.descriptorType;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600113 }
114 assert(0); // requested global index is out of bounds
115 return VK_DESCRIPTOR_TYPE_MAX_ENUM;
116}
117// For the given binding, return stageFlags
118VkShaderStageFlags cvdescriptorset::DescriptorSetLayout::GetStageFlagsFromBinding(const uint32_t binding) const {
119 assert(binding_to_index_map_.count(binding));
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600120 const auto &bi_itr = binding_to_index_map_.find(binding);
121 if (bi_itr != binding_to_index_map_.end()) {
Tobin Ehlis664e6012016-05-05 11:04:44 -0600122 return bindings_[bi_itr->second].stageFlags;
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600123 }
124 return VkShaderStageFlags(0);
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600125}
126// For the given binding, return start index
127uint32_t cvdescriptorset::DescriptorSetLayout::GetGlobalStartIndexFromBinding(const uint32_t binding) const {
128 assert(binding_to_global_start_index_map_.count(binding));
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600129 const auto &btgsi_itr = binding_to_global_start_index_map_.find(binding);
130 if (btgsi_itr != binding_to_global_start_index_map_.end()) {
131 return btgsi_itr->second;
132 }
133 // In error case max uint32_t so index is out of bounds to break ASAP
134 return 0xFFFFFFFF;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600135}
136// For the given binding, return end index
137uint32_t cvdescriptorset::DescriptorSetLayout::GetGlobalEndIndexFromBinding(const uint32_t binding) const {
138 assert(binding_to_global_end_index_map_.count(binding));
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600139 const auto &btgei_itr = binding_to_global_end_index_map_.find(binding);
140 if (btgei_itr != binding_to_global_end_index_map_.end()) {
141 return btgei_itr->second;
142 }
143 // In error case max uint32_t so index is out of bounds to break ASAP
144 return 0xFFFFFFFF;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600145}
146// For given binding, return ptr to ImmutableSampler array
147VkSampler const *cvdescriptorset::DescriptorSetLayout::GetImmutableSamplerPtrFromBinding(const uint32_t binding) const {
148 assert(binding_to_index_map_.count(binding));
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600149 const auto &bi_itr = binding_to_index_map_.find(binding);
150 if (bi_itr != binding_to_index_map_.end()) {
Tobin Ehlis664e6012016-05-05 11:04:44 -0600151 return bindings_[bi_itr->second].pImmutableSamplers;
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600152 }
153 return nullptr;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600154}
155// For given index, return ptr to ImmutableSampler array
156VkSampler const *cvdescriptorset::DescriptorSetLayout::GetImmutableSamplerPtrFromIndex(const uint32_t index) const {
157 assert(index < bindings_.size());
Tobin Ehlis664e6012016-05-05 11:04:44 -0600158 return bindings_[index].pImmutableSamplers;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600159}
160// If our layout is compatible with rh_ds_layout, return true,
161// else return false and fill in error_msg will description of what causes incompatibility
162bool cvdescriptorset::DescriptorSetLayout::IsCompatible(const DescriptorSetLayout *rh_ds_layout, std::string *error_msg) const {
163 // Trivial case
164 if (layout_ == rh_ds_layout->GetDescriptorSetLayout())
165 return true;
166 if (descriptor_count_ != rh_ds_layout->descriptor_count_) {
167 std::stringstream error_str;
168 error_str << "DescriptorSetLayout " << layout_ << " has " << descriptor_count_ << " descriptors, but DescriptorSetLayout "
169 << rh_ds_layout->GetDescriptorSetLayout() << " has " << rh_ds_layout->descriptor_count_ << " descriptors.";
170 *error_msg = error_str.str();
171 return false; // trivial fail case
172 }
173 // Descriptor counts match so need to go through bindings one-by-one
174 // and verify that type and stageFlags match
175 for (auto binding : bindings_) {
176 // TODO : Do we also need to check immutable samplers?
177 // VkDescriptorSetLayoutBinding *rh_binding;
Tobin Ehlis664e6012016-05-05 11:04:44 -0600178 if (binding.descriptorCount != rh_ds_layout->GetDescriptorCountFromBinding(binding.binding)) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600179 std::stringstream error_str;
Tobin Ehlis664e6012016-05-05 11:04:44 -0600180 error_str << "Binding " << binding.binding << " for DescriptorSetLayout " << layout_ << " has a descriptorCount of "
181 << binding.descriptorCount << " but binding " << binding.binding << " for DescriptorSetLayout "
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600182 << rh_ds_layout->GetDescriptorSetLayout() << " has a descriptorCount of "
Tobin Ehlis664e6012016-05-05 11:04:44 -0600183 << rh_ds_layout->GetDescriptorCountFromBinding(binding.binding);
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600184 *error_msg = error_str.str();
185 return false;
Tobin Ehlis664e6012016-05-05 11:04:44 -0600186 } else if (binding.descriptorType != rh_ds_layout->GetTypeFromBinding(binding.binding)) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600187 std::stringstream error_str;
Tobin Ehlis664e6012016-05-05 11:04:44 -0600188 error_str << "Binding " << binding.binding << " for DescriptorSetLayout " << layout_ << " is type '"
189 << string_VkDescriptorType(binding.descriptorType) << "' but binding " << binding.binding
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600190 << " for DescriptorSetLayout " << rh_ds_layout->GetDescriptorSetLayout() << " is type '"
Tobin Ehlis664e6012016-05-05 11:04:44 -0600191 << string_VkDescriptorType(rh_ds_layout->GetTypeFromBinding(binding.binding)) << "'";
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600192 *error_msg = error_str.str();
193 return false;
Tobin Ehlis664e6012016-05-05 11:04:44 -0600194 } else if (binding.stageFlags != rh_ds_layout->GetStageFlagsFromBinding(binding.binding)) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600195 std::stringstream error_str;
Tobin Ehlis664e6012016-05-05 11:04:44 -0600196 error_str << "Binding " << binding.binding << " for DescriptorSetLayout " << layout_ << " has stageFlags "
197 << binding.stageFlags << " but binding " << binding.binding << " for DescriptorSetLayout "
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600198 << rh_ds_layout->GetDescriptorSetLayout() << " has stageFlags "
Tobin Ehlis664e6012016-05-05 11:04:44 -0600199 << rh_ds_layout->GetStageFlagsFromBinding(binding.binding);
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600200 *error_msg = error_str.str();
201 return false;
202 }
203 }
204 return true;
205}
206
207bool cvdescriptorset::DescriptorSetLayout::IsNextBindingConsistent(const uint32_t binding) const {
208 if (!binding_to_index_map_.count(binding + 1))
209 return false;
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600210 auto const &bi_itr = binding_to_index_map_.find(binding);
211 if (bi_itr != binding_to_index_map_.end()) {
212 const auto &next_bi_itr = binding_to_index_map_.find(binding + 1);
213 if (next_bi_itr != binding_to_index_map_.end()) {
Tobin Ehlis664e6012016-05-05 11:04:44 -0600214 auto type = bindings_[bi_itr->second].descriptorType;
215 auto stage_flags = bindings_[bi_itr->second].stageFlags;
216 auto immut_samp = bindings_[bi_itr->second].pImmutableSamplers ? true : false;
217 if ((type != bindings_[next_bi_itr->second].descriptorType) ||
218 (stage_flags != bindings_[next_bi_itr->second].stageFlags) ||
219 (immut_samp != (bindings_[next_bi_itr->second].pImmutableSamplers ? true : false))) {
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600220 return false;
221 }
222 return true;
223 }
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600224 }
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600225 return false;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600226}
Tobin Ehlis1f946f82016-05-05 12:03:44 -0600227// Starting at offset descriptor of given binding, parse over update_count
228// descriptor updates and verify that for any binding boundaries that are crossed, the next binding(s) are all consistent
229// Consistency means that their type, stage flags, and whether or not they use immutable samplers matches
230// If so, return true. If not, fill in error_msg and return false
231bool cvdescriptorset::DescriptorSetLayout::VerifyUpdateConsistency(uint32_t current_binding, uint32_t offset, uint32_t update_count,
232 const char *type, const VkDescriptorSet set,
233 std::string *error_msg) const {
234 // Verify consecutive bindings match (if needed)
235 auto orig_binding = current_binding;
236 // Track count of descriptors in the current_bindings that are remaining to be updated
237 auto binding_remaining = GetDescriptorCountFromBinding(current_binding);
238 // First, it's legal to offset beyond your own binding so handle that case
239 // Really this is just searching for the binding in which the update begins and adjusting offset accordingly
240 while (offset >= binding_remaining) {
241 // Advance to next binding, decrement offset by binding size
242 offset -= binding_remaining;
243 binding_remaining = GetDescriptorCountFromBinding(++current_binding);
244 }
245 binding_remaining -= offset;
246 while (update_count > binding_remaining) { // While our updates overstep current binding
247 // Verify next consecutive binding matches type, stage flags & immutable sampler use
248 if (!IsNextBindingConsistent(current_binding++)) {
249 std::stringstream error_str;
250 error_str << "Attempting " << type << " descriptor set " << set << " binding #" << orig_binding << " with #"
251 << update_count << " descriptors being updated but this update oversteps the bounds of this binding and the "
252 "next binding is not consistent with current binding so this update is invalid.";
253 *error_msg = error_str.str();
254 return false;
255 }
256 // For sake of this check consider the bindings updated and grab count for next binding
257 update_count -= binding_remaining;
258 binding_remaining = GetDescriptorCountFromBinding(current_binding);
259 }
260 return true;
261}
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600262
Tobin Ehlis68d0adf2016-06-01 11:33:50 -0600263cvdescriptorset::AllocateDescriptorSetsData::AllocateDescriptorSetsData(uint32_t count)
264 : required_descriptors_by_type{}, layout_nodes(count, nullptr) {}
265
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600266cvdescriptorset::DescriptorSet::DescriptorSet(const VkDescriptorSet set, const DescriptorSetLayout *layout,
Tobin Ehlis4e380592016-06-02 12:41:47 -0600267 const core_validation::layer_data *dev_data)
268 : some_update_(false), set_(set), p_layout_(layout), device_data_(dev_data) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600269 // Foreach binding, create default descriptors of given type
270 for (uint32_t i = 0; i < p_layout_->GetBindingCount(); ++i) {
271 auto type = p_layout_->GetTypeFromIndex(i);
272 switch (type) {
273 case VK_DESCRIPTOR_TYPE_SAMPLER: {
274 auto immut_sampler = p_layout_->GetImmutableSamplerPtrFromIndex(i);
275 for (uint32_t di = 0; di < p_layout_->GetDescriptorCountFromIndex(i); ++di) {
276 if (immut_sampler)
Chris Forbescb621ea2016-05-30 11:47:31 +1200277 descriptors_.emplace_back(new SamplerDescriptor(immut_sampler + di));
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600278 else
Chris Forbescb621ea2016-05-30 11:47:31 +1200279 descriptors_.emplace_back(new SamplerDescriptor());
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600280 }
281 break;
282 }
283 case VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER: {
284 auto immut = p_layout_->GetImmutableSamplerPtrFromIndex(i);
285 for (uint32_t di = 0; di < p_layout_->GetDescriptorCountFromIndex(i); ++di) {
286 if (immut)
Chris Forbescb621ea2016-05-30 11:47:31 +1200287 descriptors_.emplace_back(new ImageSamplerDescriptor(immut + di));
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600288 else
Chris Forbescb621ea2016-05-30 11:47:31 +1200289 descriptors_.emplace_back(new ImageSamplerDescriptor());
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600290 }
291 break;
292 }
293 // ImageDescriptors
294 case VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE:
295 case VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT:
296 case VK_DESCRIPTOR_TYPE_STORAGE_IMAGE:
297 for (uint32_t di = 0; di < p_layout_->GetDescriptorCountFromIndex(i); ++di)
Chris Forbescb621ea2016-05-30 11:47:31 +1200298 descriptors_.emplace_back(new ImageDescriptor(type));
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600299 break;
300 case VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER:
301 case VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER:
302 for (uint32_t di = 0; di < p_layout_->GetDescriptorCountFromIndex(i); ++di)
Chris Forbescb621ea2016-05-30 11:47:31 +1200303 descriptors_.emplace_back(new TexelDescriptor(type));
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600304 break;
305 case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER:
306 case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC:
307 case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER:
308 case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC:
309 for (uint32_t di = 0; di < p_layout_->GetDescriptorCountFromIndex(i); ++di)
Chris Forbescb621ea2016-05-30 11:47:31 +1200310 descriptors_.emplace_back(new BufferDescriptor(type));
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600311 break;
312 default:
Tobin Ehlis81f17852016-05-05 09:04:33 -0600313 assert(0); // Bad descriptor type specified
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600314 break;
315 }
316 }
317}
Tobin Ehlis56a30942016-05-19 08:00:00 -0600318
Tobin Ehlis9906d9d2016-05-17 14:23:46 -0600319cvdescriptorset::DescriptorSet::~DescriptorSet() {
320 InvalidateBoundCmdBuffers();
321 // Remove link to any cmd buffers
322 for (auto cb : bound_cmd_buffers_) {
323 for (uint32_t i=0; i<VK_PIPELINE_BIND_POINT_RANGE_SIZE; ++i) {
324 cb->lastBound[i].uniqueBoundSets.erase(this);
325 }
326 }
327}
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600328// Is this sets underlying layout compatible with passed in layout according to "Pipeline Layout Compatibility" in spec?
329bool cvdescriptorset::DescriptorSet::IsCompatible(const DescriptorSetLayout *layout, std::string *error) const {
330 return layout->IsCompatible(p_layout_, error);
331}
332// Validate that the state of this set is appropriate for the given bindings and dynami_offsets at Draw time
333// This includes validating that all descriptors in the given bindings are updated,
334// that any update buffers are valid, and that any dynamic offsets are within the bounds of their buffers.
335// Return true if state is acceptable, or false and write an error message into error string
336bool cvdescriptorset::DescriptorSet::ValidateDrawState(const std::unordered_set<uint32_t> &bindings,
337 const std::vector<uint32_t> &dynamic_offsets, std::string *error) const {
iostrows5eb97652016-06-02 15:56:26 +0200338 auto dyn_offset_index = 0;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600339 for (auto binding : bindings) {
340 auto start_idx = p_layout_->GetGlobalStartIndexFromBinding(binding);
Tobin Ehlis81f17852016-05-05 09:04:33 -0600341 if (descriptors_[start_idx]->IsImmutableSampler()) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600342 // Nothing to do for strictly immutable sampler
343 } else {
344 auto end_idx = p_layout_->GetGlobalEndIndexFromBinding(binding);
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600345 for (uint32_t i = start_idx; i <= end_idx; ++i) {
Tobin Ehlis81f17852016-05-05 09:04:33 -0600346 if (!descriptors_[i]->updated) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600347 std::stringstream error_str;
348 error_str << "Descriptor in binding #" << binding << " at global descriptor index " << i
349 << " is being used in draw but has not been updated.";
350 *error = error_str.str();
351 return false;
352 } else {
Tobin Ehlis81f17852016-05-05 09:04:33 -0600353 if (GeneralBuffer == descriptors_[i]->GetClass()) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600354 // Verify that buffers are valid
Tobin Ehlis81f17852016-05-05 09:04:33 -0600355 auto buffer = static_cast<BufferDescriptor *>(descriptors_[i].get())->GetBuffer();
Tobin Ehlis94bc5d22016-06-02 07:46:52 -0600356 auto buffer_node = getBufferNode(device_data_, buffer);
357 if (!buffer_node) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600358 std::stringstream error_str;
359 error_str << "Descriptor in binding #" << binding << " at global descriptor index " << i
360 << " references invalid buffer " << buffer << ".";
361 *error = error_str.str();
362 return false;
363 } else {
Tobin Ehlis997b2582016-06-02 08:43:37 -0600364 auto mem_entry = getMemObjInfo(device_data_, buffer_node->mem);
365 if (!mem_entry) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600366 std::stringstream error_str;
367 error_str << "Descriptor in binding #" << binding << " at global descriptor index " << i
Tobin Ehlis94bc5d22016-06-02 07:46:52 -0600368 << " uses buffer " << buffer << " that references invalid memory " << buffer_node->mem
369 << ".";
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600370 *error = error_str.str();
371 return false;
372 }
373 }
Tobin Ehlis81f17852016-05-05 09:04:33 -0600374 if (descriptors_[i]->IsDynamic()) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600375 // Validate that dynamic offsets are within the buffer
Tobin Ehlis94bc5d22016-06-02 07:46:52 -0600376 auto buffer_size = buffer_node->createInfo.size;
Tobin Ehlis81f17852016-05-05 09:04:33 -0600377 auto range = static_cast<BufferDescriptor *>(descriptors_[i].get())->GetRange();
378 auto desc_offset = static_cast<BufferDescriptor *>(descriptors_[i].get())->GetOffset();
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600379 auto dyn_offset = dynamic_offsets[dyn_offset_index++];
380 if (VK_WHOLE_SIZE == range) {
381 if ((dyn_offset + desc_offset) > buffer_size) {
382 std::stringstream error_str;
383 error_str << "Dynamic descriptor in binding #" << binding << " at global descriptor index " << i
384 << " uses buffer " << buffer
385 << " with update range of VK_WHOLE_SIZE has dynamic offset " << dyn_offset
386 << " combined with offset " << desc_offset << " that oversteps the buffer size of "
387 << buffer_size << ".";
388 *error = error_str.str();
389 return false;
390 }
391 } else {
392 if ((dyn_offset + desc_offset + range) > buffer_size) {
393 std::stringstream error_str;
394 error_str << "Dynamic descriptor in binding #" << binding << " at global descriptor index " << i
395 << " uses buffer " << buffer << " with dynamic offset " << dyn_offset
396 << " combined with offset " << desc_offset << " and range " << range
397 << " that oversteps the buffer size of " << buffer_size << ".";
398 *error = error_str.str();
399 return false;
400 }
401 }
402 }
403 }
404 }
405 }
406 }
407 }
408 return true;
409}
410// For given bindings, place any update buffers or images into the passed-in unordered_sets
411uint32_t cvdescriptorset::DescriptorSet::GetStorageUpdates(const std::unordered_set<uint32_t> &bindings,
412 std::unordered_set<VkBuffer> *buffer_set,
413 std::unordered_set<VkImageView> *image_set) const {
414 auto num_updates = 0;
415 for (auto binding : bindings) {
416 auto start_idx = p_layout_->GetGlobalStartIndexFromBinding(binding);
Tobin Ehlis81f17852016-05-05 09:04:33 -0600417 if (descriptors_[start_idx]->IsStorage()) {
418 if (Image == descriptors_[start_idx]->descriptor_class) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600419 for (uint32_t i = 0; i < p_layout_->GetDescriptorCountFromBinding(binding); ++i) {
Tobin Ehlis81f17852016-05-05 09:04:33 -0600420 if (descriptors_[start_idx + i]->updated) {
421 image_set->insert(static_cast<ImageDescriptor *>(descriptors_[start_idx + i].get())->GetImageView());
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600422 num_updates++;
423 }
424 }
Tobin Ehlis81f17852016-05-05 09:04:33 -0600425 } else if (TexelBuffer == descriptors_[start_idx]->descriptor_class) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600426 for (uint32_t i = 0; i < p_layout_->GetDescriptorCountFromBinding(binding); ++i) {
Tobin Ehlis81f17852016-05-05 09:04:33 -0600427 if (descriptors_[start_idx + i]->updated) {
428 auto bufferview = static_cast<TexelDescriptor *>(descriptors_[start_idx + i].get())->GetBufferView();
Tobin Ehlis424859c2016-06-02 09:43:11 -0600429 auto bv_info = getBufferViewInfo(device_data_, bufferview);
430 if (bv_info) {
431 buffer_set->insert(bv_info->buffer);
Tobin Ehlis0bc30632016-05-05 10:16:02 -0600432 num_updates++;
433 }
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600434 }
435 }
Tobin Ehlis81f17852016-05-05 09:04:33 -0600436 } else if (GeneralBuffer == descriptors_[start_idx]->descriptor_class) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600437 for (uint32_t i = 0; i < p_layout_->GetDescriptorCountFromBinding(binding); ++i) {
Tobin Ehlis81f17852016-05-05 09:04:33 -0600438 if (descriptors_[start_idx + i]->updated) {
439 buffer_set->insert(static_cast<BufferDescriptor *>(descriptors_[start_idx + i].get())->GetBuffer());
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600440 num_updates++;
441 }
442 }
443 }
444 }
445 }
446 return num_updates;
447}
Tobin Ehlis9906d9d2016-05-17 14:23:46 -0600448// Set is being deleted or updates so invalidate all bound cmd buffers
449void cvdescriptorset::DescriptorSet::InvalidateBoundCmdBuffers() {
450 for (auto cb_node : bound_cmd_buffers_) {
451 cb_node->state = CB_INVALID;
452 }
453}
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600454// Perform write update in given update struct
Tobin Ehlis300888c2016-05-18 13:43:26 -0600455void cvdescriptorset::DescriptorSet::PerformWriteUpdate(const VkWriteDescriptorSet *update) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600456 auto start_idx = p_layout_->GetGlobalStartIndexFromBinding(update->dstBinding) + update->dstArrayElement;
457 // perform update
458 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
459 descriptors_[start_idx + di]->WriteUpdate(update, di);
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600460 }
Tobin Ehlis56a30942016-05-19 08:00:00 -0600461 if (update->descriptorCount)
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600462 some_update_ = true;
Tobin Ehlis56a30942016-05-19 08:00:00 -0600463
Tobin Ehlis9906d9d2016-05-17 14:23:46 -0600464 InvalidateBoundCmdBuffers();
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600465}
Tobin Ehlis300888c2016-05-18 13:43:26 -0600466// Validate Copy update
467bool cvdescriptorset::DescriptorSet::ValidateCopyUpdate(const debug_report_data *report_data, const VkCopyDescriptorSet *update,
468 const DescriptorSet *src_set, std::string *error) {
Tobin Ehlis03d61de2016-05-17 08:31:46 -0600469 // Verify idle ds
470 if (in_use.load()) {
471 std::stringstream error_str;
472 error_str << "Cannot call vkUpdateDescriptorSets() to perform copy update on descriptor set " << set_
473 << " that is in use by a command buffer.";
474 *error = error_str.str();
475 return false;
476 }
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600477 if (!p_layout_->HasBinding(update->dstBinding)) {
478 std::stringstream error_str;
479 error_str << "DescriptorSet " << set_ << " does not have copy update dest binding of " << update->dstBinding << ".";
480 *error = error_str.str();
481 return false;
482 }
483 if (!src_set->HasBinding(update->srcBinding)) {
484 std::stringstream error_str;
485 error_str << "DescriptorSet " << set_ << " does not have copy update src binding of " << update->srcBinding << ".";
486 *error = error_str.str();
487 return false;
488 }
489 // src & dst set bindings are valid
490 // Check bounds of src & dst
491 auto src_start_idx = src_set->GetGlobalStartIndexFromBinding(update->srcBinding) + update->srcArrayElement;
492 if ((src_start_idx + update->descriptorCount) > src_set->GetTotalDescriptorCount()) {
493 // SRC update out of bounds
494 std::stringstream error_str;
495 error_str << "Attempting copy update from descriptorSet " << update->srcSet << " binding#" << update->srcBinding
496 << " with offset index of " << src_set->GetGlobalStartIndexFromBinding(update->srcBinding)
497 << " plus update array offset of " << update->srcArrayElement << " and update of " << update->descriptorCount
498 << " descriptors oversteps total number of descriptors in set: " << src_set->GetTotalDescriptorCount() << ".";
499 *error = error_str.str();
500 return false;
501 }
502 auto dst_start_idx = p_layout_->GetGlobalStartIndexFromBinding(update->dstBinding) + update->dstArrayElement;
503 if ((dst_start_idx + update->descriptorCount) > p_layout_->GetTotalDescriptorCount()) {
504 // DST update out of bounds
505 std::stringstream error_str;
506 error_str << "Attempting copy update to descriptorSet " << set_ << " binding#" << update->dstBinding
507 << " with offset index of " << p_layout_->GetGlobalStartIndexFromBinding(update->dstBinding)
508 << " plus update array offset of " << update->dstArrayElement << " and update of " << update->descriptorCount
509 << " descriptors oversteps total number of descriptors in set: " << p_layout_->GetTotalDescriptorCount() << ".";
510 *error = error_str.str();
511 return false;
512 }
513 // Check that types match
514 auto src_type = src_set->GetTypeFromBinding(update->srcBinding);
515 auto dst_type = p_layout_->GetTypeFromBinding(update->dstBinding);
516 if (src_type != dst_type) {
517 std::stringstream error_str;
518 error_str << "Attempting copy update to descriptorSet " << set_ << " binding #" << update->dstBinding << " with type "
519 << string_VkDescriptorType(dst_type) << " from descriptorSet " << src_set->GetSet() << " binding #"
520 << update->srcBinding << " with type " << string_VkDescriptorType(src_type) << ". Types do not match.";
521 *error = error_str.str();
522 return false;
523 }
524 // Verify consistency of src & dst bindings if update crosses binding boundaries
Tobin Ehlis1f946f82016-05-05 12:03:44 -0600525 if ((!src_set->GetLayout()->VerifyUpdateConsistency(update->srcBinding, update->srcArrayElement, update->descriptorCount,
526 "copy update from", src_set->GetSet(), error)) ||
527 (!p_layout_->VerifyUpdateConsistency(update->dstBinding, update->dstArrayElement, update->descriptorCount, "copy update to",
528 set_, error))) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600529 return false;
530 }
Tobin Ehlisd41e7b62016-05-19 07:56:18 -0600531 // First make sure source descriptors are updated
532 for (uint32_t i = 0; i < update->descriptorCount; ++i) {
533 if (!src_set->descriptors_[src_start_idx + i]) {
534 std::stringstream error_str;
535 error_str << "Attempting copy update from descriptorSet " << src_set << " binding #" << update->srcBinding << " but descriptor at array offset "
536 << update->srcArrayElement + i << " has not been updated.";
537 *error = error_str.str();
538 return false;
539 }
540 }
541 // Update parameters all look good and descriptor updated so verify update contents
Tobin Ehliscbcf2342016-05-24 13:07:12 -0600542 if (!VerifyCopyUpdateContents(update, src_set, src_type, src_start_idx, error))
Tobin Ehlis300888c2016-05-18 13:43:26 -0600543 return false;
544
545 // All checks passed so update is good
546 return true;
547}
548// Perform Copy update
549void cvdescriptorset::DescriptorSet::PerformCopyUpdate(const VkCopyDescriptorSet *update, const DescriptorSet *src_set) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600550 auto src_start_idx = src_set->GetGlobalStartIndexFromBinding(update->srcBinding) + update->srcArrayElement;
551 auto dst_start_idx = p_layout_->GetGlobalStartIndexFromBinding(update->dstBinding) + update->dstArrayElement;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600552 // Update parameters all look good so perform update
553 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600554 descriptors_[dst_start_idx + di]->CopyUpdate(src_set->descriptors_[src_start_idx + di].get());
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600555 }
Tobin Ehlis56a30942016-05-19 08:00:00 -0600556 if (update->descriptorCount)
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600557 some_update_ = true;
Tobin Ehlis56a30942016-05-19 08:00:00 -0600558
Tobin Ehlis9906d9d2016-05-17 14:23:46 -0600559 InvalidateBoundCmdBuffers();
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600560}
Tobin Ehlis56a30942016-05-19 08:00:00 -0600561
Tobin Ehlis300888c2016-05-18 13:43:26 -0600562cvdescriptorset::SamplerDescriptor::SamplerDescriptor() : sampler_(VK_NULL_HANDLE), immutable_(false) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600563 updated = false;
564 descriptor_class = PlainSampler;
565};
566
Tobin Ehlis300888c2016-05-18 13:43:26 -0600567cvdescriptorset::SamplerDescriptor::SamplerDescriptor(const VkSampler *immut) : sampler_(VK_NULL_HANDLE), immutable_(false) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600568 updated = false;
569 descriptor_class = PlainSampler;
570 if (immut) {
571 sampler_ = *immut;
572 immutable_ = true;
573 updated = true;
574 }
575}
Tobin Ehlise2f80292016-06-02 10:08:53 -0600576// Validate given sampler. Currently this only checks to make sure it exists in the samplerMap
577bool cvdescriptorset::ValidateSampler(const VkSampler sampler, const core_validation::layer_data *dev_data) {
578 return (getSamplerNode(dev_data, sampler) != nullptr);
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600579}
Tobin Ehlis56a30942016-05-19 08:00:00 -0600580
Tobin Ehlis554bf382016-05-24 11:14:43 -0600581bool cvdescriptorset::ValidateImageUpdate(VkImageView image_view, VkImageLayout image_layout, VkDescriptorType type,
Tobin Ehlisd5fb09e2016-06-02 10:54:09 -0600582 const core_validation::layer_data *dev_data,
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600583 std::string *error) {
Tobin Ehlisd5fb09e2016-06-02 10:54:09 -0600584 auto iv_data = getImageViewData(dev_data, image_view);
585 if (!iv_data) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600586 std::stringstream error_str;
587 error_str << "Invalid VkImageView: " << image_view;
588 *error = error_str.str();
589 return false;
Tobin Ehlis1809f912016-05-25 09:24:36 -0600590 }
591 // Validate that imageLayout is compatible with aspect_mask and image format
592 // and validate that image usage bits are correct for given usage
Tobin Ehlisd5fb09e2016-06-02 10:54:09 -0600593 VkImageAspectFlags aspect_mask = iv_data->subresourceRange.aspectMask;
594 VkImage image = iv_data->image;
Tobin Ehlis1809f912016-05-25 09:24:36 -0600595 VkFormat format = VK_FORMAT_MAX_ENUM;
596 VkImageUsageFlags usage = 0;
Tobin Ehlis1c9c55f2016-06-02 11:49:22 -0600597 auto image_node = getImageNode(dev_data, image);
598 if (image_node) {
599 format = image_node->createInfo.format;
600 usage = image_node->createInfo.usage;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600601 } else {
Tobin Ehlis1809f912016-05-25 09:24:36 -0600602 // Also need to check the swapchains.
Tobin Ehlis969a5262016-06-02 12:13:32 -0600603 auto swapchain = getSwapchainFromImage(dev_data, image);
604 if (swapchain) {
Tobin Ehlis4e380592016-06-02 12:41:47 -0600605 auto swapchain_node = getSwapchainNode(dev_data, swapchain);
606 if (swapchain_node) {
607 format = swapchain_node->createInfo.imageFormat;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600608 }
609 }
Tobin Ehlis1809f912016-05-25 09:24:36 -0600610 }
611 // First validate that format and layout are compatible
612 if (format == VK_FORMAT_MAX_ENUM) {
613 std::stringstream error_str;
614 error_str << "Invalid image (" << image << ") in imageView (" << image_view << ").";
615 *error = error_str.str();
616 return false;
617 }
618 bool ds = vk_format_is_depth_or_stencil(format);
619 switch (image_layout) {
620 case VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL:
621 // Only Color bit must be set
622 if ((aspect_mask & VK_IMAGE_ASPECT_COLOR_BIT) != VK_IMAGE_ASPECT_COLOR_BIT) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600623 std::stringstream error_str;
Tobin Ehlis1809f912016-05-25 09:24:36 -0600624 error_str << "ImageView (" << image_view << ") uses layout VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL but does "
625 "not have VK_IMAGE_ASPECT_COLOR_BIT set.";
Tobin Ehlis554bf382016-05-24 11:14:43 -0600626 *error = error_str.str();
627 return false;
628 }
Tobin Ehlis1809f912016-05-25 09:24:36 -0600629 // format must NOT be DS
630 if (ds) {
631 std::stringstream error_str;
632 error_str << "ImageView (" << image_view
633 << ") uses layout VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL but the image format is "
634 << string_VkFormat(format) << " which is not a color format.";
635 *error = error_str.str();
636 return false;
637 }
638 break;
639 case VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL:
640 case VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL:
641 // Depth or stencil bit must be set, but both must NOT be set
642 if (aspect_mask & VK_IMAGE_ASPECT_DEPTH_BIT) {
643 if (aspect_mask & VK_IMAGE_ASPECT_STENCIL_BIT) {
644 // both must NOT be set
645 std::stringstream error_str;
646 error_str << "ImageView (" << image_view << ") has both STENCIL and DEPTH aspects set";
647 *error = error_str.str();
648 return false;
649 }
650 } else if (!(aspect_mask & VK_IMAGE_ASPECT_STENCIL_BIT)) {
651 // Neither were set
652 std::stringstream error_str;
653 error_str << "ImageView (" << image_view << ") has layout " << string_VkImageLayout(image_layout)
654 << " but does not have STENCIL or DEPTH aspects set";
655 *error = error_str.str();
656 return false;
657 }
658 // format must be DS
659 if (!ds) {
660 std::stringstream error_str;
661 error_str << "ImageView (" << image_view << ") has layout " << string_VkImageLayout(image_layout)
662 << " but the image format is " << string_VkFormat(format) << " which is not a depth/stencil format.";
663 *error = error_str.str();
664 return false;
665 }
666 break;
667 default:
Tobin Ehlisbbf3f912016-06-15 13:03:58 -0600668 // For other layouts if the source is ds image, both aspect bits must not be set
669 if (ds) {
670 if (aspect_mask & VK_IMAGE_ASPECT_DEPTH_BIT) {
671 if (aspect_mask & VK_IMAGE_ASPECT_STENCIL_BIT) {
672 // both must NOT be set
673 std::stringstream error_str;
674 error_str << "ImageView (" << image_view << ") has layout " << string_VkImageLayout(image_layout)
675 << " and is using depth/stencil image of format " << string_VkFormat(format)
676 << " but it has both STENCIL and DEPTH aspects set, which is illegal. When using a depth/stencil "
677 "image in a descriptor set, please only set either VK_IMAGE_ASPECT_DEPTH_BIT or "
678 "VK_IMAGE_ASPECT_STENCIL_BIT depending on whether it will be used for depth reads or stencil "
679 "reads respectively.";
680 *error = error_str.str();
681 return false;
682 }
683 }
684 }
Tobin Ehlis1809f912016-05-25 09:24:36 -0600685 break;
686 }
687 // Now validate that usage flags are correctly set for given type of update
688 std::string error_usage_bit;
689 switch (type) {
690 case VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE:
691 case VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER: {
692 if (!(usage & VK_IMAGE_USAGE_SAMPLED_BIT)) {
693 error_usage_bit = "VK_IMAGE_USAGE_SAMPLED_BIT";
694 }
695 break;
696 }
697 case VK_DESCRIPTOR_TYPE_STORAGE_IMAGE: {
698 if (!(usage & VK_IMAGE_USAGE_STORAGE_BIT)) {
699 error_usage_bit = "VK_IMAGE_USAGE_STORAGE_BIT";
700 }
701 break;
702 }
703 case VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT: {
704 if (!(usage & VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT)) {
705 error_usage_bit = "VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT";
706 }
707 break;
708 }
709 default:
710 break;
711 }
712 if (!error_usage_bit.empty()) {
713 std::stringstream error_str;
714 error_str << "ImageView (" << image_view << ") with usage mask 0x" << usage
715 << " being used for a descriptor update of type " << string_VkDescriptorType(type) << " does not have "
716 << error_usage_bit << " set.";
717 *error = error_str.str();
718 return false;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600719 }
720 return true;
721}
Tobin Ehlis56a30942016-05-19 08:00:00 -0600722
Tobin Ehlis300888c2016-05-18 13:43:26 -0600723void cvdescriptorset::SamplerDescriptor::WriteUpdate(const VkWriteDescriptorSet *update, const uint32_t index) {
724 sampler_ = update->pImageInfo[index].sampler;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600725 updated = true;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600726}
727
Tobin Ehlis300888c2016-05-18 13:43:26 -0600728void cvdescriptorset::SamplerDescriptor::CopyUpdate(const Descriptor *src) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600729 if (!immutable_) {
730 auto update_sampler = static_cast<const SamplerDescriptor *>(src)->sampler_;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600731 sampler_ = update_sampler;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600732 }
733 updated = true;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600734}
Tobin Ehlis56a30942016-05-19 08:00:00 -0600735
Tobin Ehlis300888c2016-05-18 13:43:26 -0600736cvdescriptorset::ImageSamplerDescriptor::ImageSamplerDescriptor()
737 : sampler_(VK_NULL_HANDLE), immutable_(false), image_view_(VK_NULL_HANDLE), image_layout_(VK_IMAGE_LAYOUT_UNDEFINED) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600738 updated = false;
739 descriptor_class = ImageSampler;
740}
741
Tobin Ehlis300888c2016-05-18 13:43:26 -0600742cvdescriptorset::ImageSamplerDescriptor::ImageSamplerDescriptor(const VkSampler *immut)
743 : sampler_(VK_NULL_HANDLE), immutable_(true), image_view_(VK_NULL_HANDLE), image_layout_(VK_IMAGE_LAYOUT_UNDEFINED) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600744 updated = false;
745 descriptor_class = ImageSampler;
746 if (immut) {
747 sampler_ = *immut;
748 immutable_ = true;
749 updated = true;
750 }
751}
Tobin Ehlis56a30942016-05-19 08:00:00 -0600752
Tobin Ehlis300888c2016-05-18 13:43:26 -0600753void cvdescriptorset::ImageSamplerDescriptor::WriteUpdate(const VkWriteDescriptorSet *update, const uint32_t index) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600754 updated = true;
Tobin Ehlis56a30942016-05-19 08:00:00 -0600755 const auto &image_info = update->pImageInfo[index];
Tobin Ehlis300888c2016-05-18 13:43:26 -0600756 sampler_ = image_info.sampler;
757 image_view_ = image_info.imageView;
758 image_layout_ = image_info.imageLayout;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600759}
760
Tobin Ehlis300888c2016-05-18 13:43:26 -0600761void cvdescriptorset::ImageSamplerDescriptor::CopyUpdate(const Descriptor *src) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600762 if (!immutable_) {
763 auto update_sampler = static_cast<const ImageSamplerDescriptor *>(src)->sampler_;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600764 sampler_ = update_sampler;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600765 }
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600766 auto image_view = static_cast<const ImageSamplerDescriptor *>(src)->image_view_;
767 auto image_layout = static_cast<const ImageSamplerDescriptor *>(src)->image_layout_;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600768 updated = true;
769 image_view_ = image_view;
770 image_layout_ = image_layout;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600771}
772
Tobin Ehlis300888c2016-05-18 13:43:26 -0600773cvdescriptorset::ImageDescriptor::ImageDescriptor(const VkDescriptorType type)
774 : storage_(false), image_view_(VK_NULL_HANDLE), image_layout_(VK_IMAGE_LAYOUT_UNDEFINED) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600775 updated = false;
776 descriptor_class = Image;
777 if (VK_DESCRIPTOR_TYPE_STORAGE_IMAGE == type)
778 storage_ = true;
779};
780
Tobin Ehlis300888c2016-05-18 13:43:26 -0600781void cvdescriptorset::ImageDescriptor::WriteUpdate(const VkWriteDescriptorSet *update, const uint32_t index) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600782 updated = true;
Tobin Ehlis56a30942016-05-19 08:00:00 -0600783 const auto &image_info = update->pImageInfo[index];
Tobin Ehlis300888c2016-05-18 13:43:26 -0600784 image_view_ = image_info.imageView;
785 image_layout_ = image_info.imageLayout;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600786}
787
Tobin Ehlis300888c2016-05-18 13:43:26 -0600788void cvdescriptorset::ImageDescriptor::CopyUpdate(const Descriptor *src) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600789 auto image_view = static_cast<const ImageDescriptor *>(src)->image_view_;
790 auto image_layout = static_cast<const ImageDescriptor *>(src)->image_layout_;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600791 updated = true;
792 image_view_ = image_view;
793 image_layout_ = image_layout;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600794}
795
Tobin Ehlis300888c2016-05-18 13:43:26 -0600796cvdescriptorset::BufferDescriptor::BufferDescriptor(const VkDescriptorType type)
797 : storage_(false), dynamic_(false), buffer_(VK_NULL_HANDLE), offset_(0), range_(0) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600798 updated = false;
799 descriptor_class = GeneralBuffer;
800 if (VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC == type) {
801 dynamic_ = true;
802 } else if (VK_DESCRIPTOR_TYPE_STORAGE_BUFFER == type) {
803 storage_ = true;
804 } else if (VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC == type) {
805 dynamic_ = true;
806 storage_ = true;
807 }
808}
Tobin Ehlis300888c2016-05-18 13:43:26 -0600809void cvdescriptorset::BufferDescriptor::WriteUpdate(const VkWriteDescriptorSet *update, const uint32_t index) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600810 updated = true;
Tobin Ehlis56a30942016-05-19 08:00:00 -0600811 const auto &buffer_info = update->pBufferInfo[index];
Tobin Ehlis300888c2016-05-18 13:43:26 -0600812 buffer_ = buffer_info.buffer;
813 offset_ = buffer_info.offset;
814 range_ = buffer_info.range;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600815}
816
Tobin Ehlis300888c2016-05-18 13:43:26 -0600817void cvdescriptorset::BufferDescriptor::CopyUpdate(const Descriptor *src) {
818 auto buff_desc = static_cast<const BufferDescriptor *>(src);
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600819 updated = true;
Tobin Ehlis300888c2016-05-18 13:43:26 -0600820 buffer_ = buff_desc->buffer_;
821 offset_ = buff_desc->offset_;
822 range_ = buff_desc->range_;
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600823}
824
Tobin Ehlis300888c2016-05-18 13:43:26 -0600825cvdescriptorset::TexelDescriptor::TexelDescriptor(const VkDescriptorType type) : buffer_view_(VK_NULL_HANDLE), storage_(false) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600826 updated = false;
827 descriptor_class = TexelBuffer;
828 if (VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER == type)
829 storage_ = true;
830};
Tobin Ehlis56a30942016-05-19 08:00:00 -0600831
Tobin Ehlis300888c2016-05-18 13:43:26 -0600832void cvdescriptorset::TexelDescriptor::WriteUpdate(const VkWriteDescriptorSet *update, const uint32_t index) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600833 updated = true;
Tobin Ehlis300888c2016-05-18 13:43:26 -0600834 buffer_view_ = update->pTexelBufferView[index];
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600835}
836
Tobin Ehlis300888c2016-05-18 13:43:26 -0600837void cvdescriptorset::TexelDescriptor::CopyUpdate(const Descriptor *src) {
838 updated = true;
839 buffer_view_ = static_cast<const TexelDescriptor *>(src)->buffer_view_;
840}
841// This is a helper function that iterates over a set of Write and Copy updates, pulls the DescriptorSet* for updated
842// sets, and then calls their respective Validate[Write|Copy]Update functions.
843// If the update hits an issue for which the callback returns "true", meaning that the call down the chain should
844// be skipped, then true is returned.
845// If there is no issue with the update, then false is returned.
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600846bool cvdescriptorset::ValidateUpdateDescriptorSets(const debug_report_data *report_data,
847 const core_validation::layer_data *dev_data, uint32_t write_count,
848 const VkWriteDescriptorSet *p_wds, uint32_t copy_count,
849 const VkCopyDescriptorSet *p_cds) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600850 bool skip_call = false;
851 // Validate Write updates
Tobin Ehlis56a30942016-05-19 08:00:00 -0600852 for (uint32_t i = 0; i < write_count; i++) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600853 auto dest_set = p_wds[i].dstSet;
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600854 auto set_node = core_validation::getSetNode(dev_data, dest_set);
855 if (!set_node) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600856 skip_call |=
857 log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT,
Tobin Ehlis56a30942016-05-19 08:00:00 -0600858 reinterpret_cast<uint64_t &>(dest_set), __LINE__, DRAWSTATE_INVALID_DESCRIPTOR_SET, "DS",
Tobin Ehlis300888c2016-05-18 13:43:26 -0600859 "Cannot call vkUpdateDescriptorSets() on descriptor set 0x%" PRIxLEAST64 " that has not been allocated.",
860 reinterpret_cast<uint64_t &>(dest_set));
861 } else {
862 std::string error_str;
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600863 if (!set_node->ValidateWriteUpdate(report_data, &p_wds[i], &error_str)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600864 skip_call |= log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT,
865 reinterpret_cast<uint64_t &>(dest_set), __LINE__, DRAWSTATE_INVALID_UPDATE_INDEX, "DS",
866 "vkUpdateDescriptorsSets() failed write update validation for Descriptor Set 0x%" PRIx64
867 " with error: %s",
868 reinterpret_cast<uint64_t &>(dest_set), error_str.c_str());
869 }
870 }
871 }
872 // Now validate copy updates
Tobin Ehlis56a30942016-05-19 08:00:00 -0600873 for (uint32_t i = 0; i < copy_count; ++i) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600874 auto dst_set = p_cds[i].dstSet;
875 auto src_set = p_cds[i].srcSet;
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600876 auto src_node = core_validation::getSetNode(dev_data, src_set);
877 auto dst_node = core_validation::getSetNode(dev_data, dst_set);
878 if (!src_node) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600879 skip_call |= log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT,
Tobin Ehlis56a30942016-05-19 08:00:00 -0600880 reinterpret_cast<uint64_t &>(src_set), __LINE__, DRAWSTATE_INVALID_DESCRIPTOR_SET, "DS",
Tobin Ehlis300888c2016-05-18 13:43:26 -0600881 "Cannot call vkUpdateDescriptorSets() to copy from descriptor set 0x%" PRIxLEAST64
882 " that has not been allocated.",
883 reinterpret_cast<uint64_t &>(src_set));
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600884 } else if (!dst_node) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600885 skip_call |= log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT,
Tobin Ehlis56a30942016-05-19 08:00:00 -0600886 reinterpret_cast<uint64_t &>(dst_set), __LINE__, DRAWSTATE_INVALID_DESCRIPTOR_SET, "DS",
Tobin Ehlis300888c2016-05-18 13:43:26 -0600887 "Cannot call vkUpdateDescriptorSets() to copy to descriptor set 0x%" PRIxLEAST64
888 " that has not been allocated.",
889 reinterpret_cast<uint64_t &>(dst_set));
890 } else {
891 std::string error_str;
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600892 if (!dst_node->ValidateCopyUpdate(report_data, &p_cds[i], src_node, &error_str)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600893 skip_call |=
894 log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT,
895 reinterpret_cast<uint64_t &>(dst_set), __LINE__, DRAWSTATE_INVALID_UPDATE_INDEX, "DS",
896 "vkUpdateDescriptorsSets() failed copy update from Descriptor Set 0x%" PRIx64
897 " to Descriptor Set 0x%" PRIx64 " with error: %s",
898 reinterpret_cast<uint64_t &>(src_set), reinterpret_cast<uint64_t &>(dst_set), error_str.c_str());
899 }
900 }
901 }
902 return skip_call;
903}
904// This is a helper function that iterates over a set of Write and Copy updates, pulls the DescriptorSet* for updated
905// sets, and then calls their respective Perform[Write|Copy]Update functions.
906// Prerequisite : ValidateUpdateDescriptorSets() should be called and return "false" prior to calling PerformUpdateDescriptorSets()
907// with the same set of updates.
908// This is split from the validate code to allow validation prior to calling down the chain, and then update after
909// calling down the chain.
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600910void cvdescriptorset::PerformUpdateDescriptorSets(const core_validation::layer_data *dev_data, uint32_t write_count,
911 const VkWriteDescriptorSet *p_wds, uint32_t copy_count,
912 const VkCopyDescriptorSet *p_cds) {
Tobin Ehlis300888c2016-05-18 13:43:26 -0600913 // Write updates first
914 uint32_t i = 0;
915 for (i = 0; i < write_count; ++i) {
916 auto dest_set = p_wds[i].dstSet;
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600917 auto set_node = core_validation::getSetNode(dev_data, dest_set);
918 if (set_node) {
919 set_node->PerformWriteUpdate(&p_wds[i]);
Tobin Ehlis300888c2016-05-18 13:43:26 -0600920 }
921 }
922 // Now copy updates
923 for (i = 0; i < copy_count; ++i) {
924 auto dst_set = p_cds[i].dstSet;
925 auto src_set = p_cds[i].srcSet;
Tobin Ehlis6a72dc72016-06-01 16:41:17 -0600926 auto src_node = core_validation::getSetNode(dev_data, src_set);
927 auto dst_node = core_validation::getSetNode(dev_data, dst_set);
928 if (src_node && dst_node) {
929 dst_node->PerformCopyUpdate(&p_cds[i], src_node);
Tobin Ehlis300888c2016-05-18 13:43:26 -0600930 }
931 }
932}
933// Validate the state for a given write update but don't actually perform the update
934// If an error would occur for this update, return false and fill in details in error_msg string
935bool cvdescriptorset::DescriptorSet::ValidateWriteUpdate(const debug_report_data *report_data, const VkWriteDescriptorSet *update,
936 std::string *error_msg) {
937 // Verify idle ds
938 if (in_use.load()) {
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600939 std::stringstream error_str;
Tobin Ehlis300888c2016-05-18 13:43:26 -0600940 error_str << "Cannot call vkUpdateDescriptorSets() to perform write update on descriptor set " << set_
941 << " that is in use by a command buffer.";
942 *error_msg = error_str.str();
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600943 return false;
944 }
Tobin Ehlis300888c2016-05-18 13:43:26 -0600945 // Verify dst binding exists
946 if (!p_layout_->HasBinding(update->dstBinding)) {
947 std::stringstream error_str;
948 error_str << "DescriptorSet " << set_ << " does not have binding " << update->dstBinding << ".";
949 *error_msg = error_str.str();
950 return false;
Tobin Ehlis57ae28f2016-05-24 12:35:57 -0600951 }
952 // We know that binding is valid, verify update and do update on each descriptor
953 auto start_idx = p_layout_->GetGlobalStartIndexFromBinding(update->dstBinding) + update->dstArrayElement;
954 auto type = p_layout_->GetTypeFromBinding(update->dstBinding);
955 if (type != update->descriptorType) {
956 std::stringstream error_str;
957 error_str << "Attempting write update to descriptor set " << set_ << " binding #" << update->dstBinding << " with type "
958 << string_VkDescriptorType(type) << " but update type is " << string_VkDescriptorType(update->descriptorType);
959 *error_msg = error_str.str();
960 return false;
961 }
962 if ((start_idx + update->descriptorCount) > p_layout_->GetTotalDescriptorCount()) {
963 std::stringstream error_str;
964 error_str << "Attempting write update to descriptor set " << set_ << " binding #" << update->dstBinding << " with "
965 << p_layout_->GetTotalDescriptorCount() << " total descriptors but update of " << update->descriptorCount
966 << " descriptors starting at binding offset of " << p_layout_->GetGlobalStartIndexFromBinding(update->dstBinding)
967 << " combined with update array element offset of " << update->dstArrayElement
968 << " oversteps the size of this descriptor set.";
969 *error_msg = error_str.str();
970 return false;
971 }
972 // Verify consecutive bindings match (if needed)
973 if (!p_layout_->VerifyUpdateConsistency(update->dstBinding, update->dstArrayElement, update->descriptorCount, "write update to",
974 set_, error_msg))
975 return false;
976 // Update is within bounds and consistent so last step is to validate update contents
977 if (!VerifyWriteUpdateContents(update, start_idx, error_msg)) {
978 std::stringstream error_str;
979 error_str << "Write update to descriptor in set " << set_ << " binding #" << update->dstBinding
980 << " failed with error message: " << error_msg->c_str();
981 *error_msg = error_str.str();
982 return false;
Tobin Ehlis300888c2016-05-18 13:43:26 -0600983 }
984 // All checks passed, update is clean
Tobin Ehlis0a43bde2016-05-03 08:31:08 -0600985 return true;
Tobin Ehlis03d61de2016-05-17 08:31:46 -0600986}
Tobin Ehlis6bd2b982016-05-24 12:33:42 -0600987// For the given buffer, verify that its creation parameters are appropriate for the given type
988// If there's an error, update the error string with details and return false, else return true
989bool cvdescriptorset::DescriptorSet::ValidateBufferUpdate(VkBuffer buffer, VkDescriptorType type, std::string *error) const {
990 // First make sure that buffer is valid
Tobin Ehlis94bc5d22016-06-02 07:46:52 -0600991 auto buffer_node = getBufferNode(device_data_, buffer);
992 if (!buffer_node) {
Tobin Ehlis6bd2b982016-05-24 12:33:42 -0600993 std::stringstream error_str;
994 error_str << "Invalid VkBuffer: " << buffer;
995 *error = error_str.str();
996 return false;
997 }
998 // Verify that usage bits set correctly for given type
Tobin Ehlis94bc5d22016-06-02 07:46:52 -0600999 auto usage = buffer_node->createInfo.usage;
Tobin Ehlis6bd2b982016-05-24 12:33:42 -06001000 std::string error_usage_bit;
1001 switch (type) {
1002 case VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER:
1003 if (!(usage & VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT)) {
1004 error_usage_bit = "VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT";
1005 }
1006 break;
1007 case VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER:
1008 if (!(usage & VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT)) {
1009 error_usage_bit = "VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT";
1010 }
1011 break;
1012 case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER:
1013 case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC:
1014 if (!(usage & VK_BUFFER_USAGE_UNIFORM_BUFFER_BIT)) {
1015 error_usage_bit = "VK_BUFFER_USAGE_UNIFORM_BUFFER_BIT";
1016 }
1017 break;
1018 case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER:
1019 case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC:
1020 if (!(usage & VK_BUFFER_USAGE_STORAGE_BUFFER_BIT)) {
1021 error_usage_bit = "VK_BUFFER_USAGE_STORAGE_BUFFER_BIT";
1022 }
1023 break;
1024 default:
1025 break;
1026 }
1027 if (!error_usage_bit.empty()) {
1028 std::stringstream error_str;
1029 error_str << "Buffer (" << buffer << ") with usage mask 0x" << usage << " being used for a descriptor update of type "
1030 << string_VkDescriptorType(type) << " does not have " << error_usage_bit << " set.";
1031 *error = error_str.str();
1032 return false;
1033 }
1034 return true;
1035}
Tobin Ehlis300888c2016-05-18 13:43:26 -06001036// Verify that the contents of the update are ok, but don't perform actual update
1037bool cvdescriptorset::DescriptorSet::VerifyWriteUpdateContents(const VkWriteDescriptorSet *update, const uint32_t index,
1038 std::string *error) const {
1039 switch (update->descriptorType) {
1040 case VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER: {
1041 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1042 // Validate image
1043 auto image_view = update->pImageInfo[di].imageView;
1044 auto image_layout = update->pImageInfo[di].imageLayout;
Tobin Ehlis4e380592016-06-02 12:41:47 -06001045 if (!ValidateImageUpdate(image_view, image_layout, update->descriptorType, device_data_, error)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001046 std::stringstream error_str;
1047 error_str << "Attempted write update to combined image sampler descriptor failed due to: " << error->c_str();
1048 *error = error_str.str();
1049 return false;
1050 }
1051 }
1052 // Intentional fall-through to validate sampler
1053 }
1054 case VK_DESCRIPTOR_TYPE_SAMPLER: {
1055 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1056 if (!descriptors_[index + di].get()->IsImmutableSampler()) {
Tobin Ehlise2f80292016-06-02 10:08:53 -06001057 if (!ValidateSampler(update->pImageInfo[di].sampler, device_data_)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001058 std::stringstream error_str;
1059 error_str << "Attempted write update to sampler descriptor with invalid sampler: "
1060 << update->pImageInfo[di].sampler << ".";
1061 *error = error_str.str();
1062 return false;
1063 }
1064 } else {
1065 // TODO : Warn here
1066 }
1067 }
1068 break;
1069 }
1070 case VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE:
1071 case VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT:
1072 case VK_DESCRIPTOR_TYPE_STORAGE_IMAGE: {
1073 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1074 auto image_view = update->pImageInfo[di].imageView;
1075 auto image_layout = update->pImageInfo[di].imageLayout;
Tobin Ehlis4e380592016-06-02 12:41:47 -06001076 if (!ValidateImageUpdate(image_view, image_layout, update->descriptorType, device_data_, error)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001077 std::stringstream error_str;
1078 error_str << "Attempted write update to image descriptor failed due to: " << error->c_str();
1079 *error = error_str.str();
1080 return false;
1081 }
1082 }
1083 break;
1084 }
1085 case VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER:
1086 case VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER: {
1087 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1088 auto buffer_view = update->pTexelBufferView[di];
Tobin Ehlis424859c2016-06-02 09:43:11 -06001089 auto bv_info = getBufferViewInfo(device_data_, buffer_view);
1090 if (!bv_info) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001091 std::stringstream error_str;
1092 error_str << "Attempted write update to texel buffer descriptor with invalid buffer view: " << buffer_view;
1093 *error = error_str.str();
1094 return false;
1095 }
Tobin Ehlis424859c2016-06-02 09:43:11 -06001096 auto buffer = bv_info->buffer;
Tobin Ehlis6bd2b982016-05-24 12:33:42 -06001097 if (!ValidateBufferUpdate(buffer, update->descriptorType, error)) {
1098 std::stringstream error_str;
1099 error_str << "Attempted write update to texel buffer descriptor failed due to: " << error->c_str();
1100 *error = error_str.str();
1101 return false;
1102 }
Tobin Ehlis300888c2016-05-18 13:43:26 -06001103 }
1104 break;
1105 }
1106 case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER:
1107 case VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC:
1108 case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER:
1109 case VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC: {
1110 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1111 auto buffer = update->pBufferInfo[di].buffer;
Tobin Ehlis6bd2b982016-05-24 12:33:42 -06001112 if (!ValidateBufferUpdate(buffer, update->descriptorType, error)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001113 std::stringstream error_str;
Tobin Ehlis6bd2b982016-05-24 12:33:42 -06001114 error_str << "Attempted write update to buffer descriptor failed due to: " << error->c_str();
Tobin Ehlis300888c2016-05-18 13:43:26 -06001115 *error = error_str.str();
1116 return false;
1117 }
1118 }
1119 break;
1120 }
1121 default:
1122 assert(0); // We've already verified update type so should never get here
1123 break;
1124 }
1125 // All checks passed so update contents are good
1126 return true;
1127}
1128// Verify that the contents of the update are ok, but don't perform actual update
1129bool cvdescriptorset::DescriptorSet::VerifyCopyUpdateContents(const VkCopyDescriptorSet *update, const DescriptorSet *src_set,
Tobin Ehliscbcf2342016-05-24 13:07:12 -06001130 VkDescriptorType type, uint32_t index, std::string *error) const {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001131 switch (src_set->descriptors_[index]->descriptor_class) {
1132 case PlainSampler: {
1133 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1134 if (!src_set->descriptors_[index + di]->IsImmutableSampler()) {
1135 auto update_sampler = static_cast<SamplerDescriptor *>(src_set->descriptors_[index + di].get())->GetSampler();
Tobin Ehlise2f80292016-06-02 10:08:53 -06001136 if (!ValidateSampler(update_sampler, device_data_)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001137 std::stringstream error_str;
1138 error_str << "Attempted copy update to sampler descriptor with invalid sampler: " << update_sampler << ".";
1139 *error = error_str.str();
1140 return false;
1141 }
1142 } else {
1143 // TODO : Warn here
1144 }
1145 }
1146 break;
1147 }
1148 case ImageSampler: {
1149 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1150 auto img_samp_desc = static_cast<const ImageSamplerDescriptor *>(src_set->descriptors_[index + di].get());
1151 // First validate sampler
1152 if (!img_samp_desc->IsImmutableSampler()) {
1153 auto update_sampler = img_samp_desc->GetSampler();
Tobin Ehlise2f80292016-06-02 10:08:53 -06001154 if (!ValidateSampler(update_sampler, device_data_)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001155 std::stringstream error_str;
1156 error_str << "Attempted copy update to sampler descriptor with invalid sampler: " << update_sampler << ".";
1157 *error = error_str.str();
1158 return false;
1159 }
1160 } else {
1161 // TODO : Warn here
1162 }
1163 // Validate image
1164 auto image_view = img_samp_desc->GetImageView();
1165 auto image_layout = img_samp_desc->GetImageLayout();
Tobin Ehlis4e380592016-06-02 12:41:47 -06001166 if (!ValidateImageUpdate(image_view, image_layout, type, device_data_, error)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001167 std::stringstream error_str;
Tobin Ehliscbcf2342016-05-24 13:07:12 -06001168 error_str << "Attempted copy update to combined image sampler descriptor failed due to: " << error->c_str();
Tobin Ehlis300888c2016-05-18 13:43:26 -06001169 *error = error_str.str();
1170 return false;
1171 }
1172 }
1173 }
1174 case Image: {
1175 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1176 auto img_desc = static_cast<const ImageDescriptor *>(src_set->descriptors_[index + di].get());
1177 auto image_view = img_desc->GetImageView();
1178 auto image_layout = img_desc->GetImageLayout();
Tobin Ehlis4e380592016-06-02 12:41:47 -06001179 if (!ValidateImageUpdate(image_view, image_layout, type, device_data_, error)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001180 std::stringstream error_str;
Tobin Ehliscbcf2342016-05-24 13:07:12 -06001181 error_str << "Attempted copy update to image descriptor failed due to: " << error->c_str();
Tobin Ehlis300888c2016-05-18 13:43:26 -06001182 *error = error_str.str();
1183 return false;
1184 }
1185 }
1186 break;
1187 }
1188 case TexelBuffer: {
1189 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1190 auto buffer_view = static_cast<TexelDescriptor *>(src_set->descriptors_[index + di].get())->GetBufferView();
Tobin Ehlis424859c2016-06-02 09:43:11 -06001191 auto bv_info = getBufferViewInfo(device_data_, buffer_view);
1192 if (!bv_info) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001193 std::stringstream error_str;
Tobin Ehliscbcf2342016-05-24 13:07:12 -06001194 error_str << "Attempted copy update to texel buffer descriptor with invalid buffer view: " << buffer_view;
1195 *error = error_str.str();
1196 return false;
1197 }
Tobin Ehlis424859c2016-06-02 09:43:11 -06001198 auto buffer = bv_info->buffer;
Tobin Ehliscbcf2342016-05-24 13:07:12 -06001199 if (!ValidateBufferUpdate(buffer, type, error)) {
1200 std::stringstream error_str;
1201 error_str << "Attempted copy update to texel buffer descriptor failed due to: " << error->c_str();
Tobin Ehlis300888c2016-05-18 13:43:26 -06001202 *error = error_str.str();
1203 return false;
1204 }
1205 }
1206 break;
1207 }
1208 case GeneralBuffer: {
1209 for (uint32_t di = 0; di < update->descriptorCount; ++di) {
1210 auto buffer = static_cast<BufferDescriptor *>(src_set->descriptors_[index + di].get())->GetBuffer();
Tobin Ehliscbcf2342016-05-24 13:07:12 -06001211 if (!ValidateBufferUpdate(buffer, type, error)) {
Tobin Ehlis300888c2016-05-18 13:43:26 -06001212 std::stringstream error_str;
Tobin Ehliscbcf2342016-05-24 13:07:12 -06001213 error_str << "Attempted copy update to buffer descriptor failed due to: " << error->c_str();
Tobin Ehlis300888c2016-05-18 13:43:26 -06001214 *error = error_str.str();
1215 return false;
1216 }
1217 }
1218 break;
1219 }
1220 default:
1221 assert(0); // We've already verified update type so should never get here
1222 break;
1223 }
1224 // All checks passed so update contents are good
1225 return true;
Chris Forbesb4e0bdb2016-05-31 16:34:40 +12001226}
Tobin Ehlisee471462016-05-26 11:21:59 -06001227// Verify that the state at allocate time is correct, but don't actually allocate the sets yet
Tobin Ehlis815e8132016-06-02 13:02:17 -06001228bool cvdescriptorset::ValidateAllocateDescriptorSets(const debug_report_data *report_data,
1229 const VkDescriptorSetAllocateInfo *p_alloc_info,
1230 const core_validation::layer_data *dev_data,
1231 AllocateDescriptorSetsData *ds_data) {
Tobin Ehlisee471462016-05-26 11:21:59 -06001232 bool skip_call = false;
Tobin Ehlisee471462016-05-26 11:21:59 -06001233
1234 for (uint32_t i = 0; i < p_alloc_info->descriptorSetCount; i++) {
Tobin Ehlis815e8132016-06-02 13:02:17 -06001235 auto layout = getDescriptorSetLayout(dev_data, p_alloc_info->pSetLayouts[i]);
1236 if (!layout) {
Tobin Ehlisee471462016-05-26 11:21:59 -06001237 skip_call |=
1238 log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_LAYOUT_EXT,
1239 reinterpret_cast<const uint64_t &>(p_alloc_info->pSetLayouts[i]), __LINE__, DRAWSTATE_INVALID_LAYOUT, "DS",
1240 "Unable to find set layout node for layout 0x%" PRIxLEAST64 " specified in vkAllocateDescriptorSets() call",
1241 reinterpret_cast<const uint64_t &>(p_alloc_info->pSetLayouts[i]));
Tobin Ehlis68d0adf2016-06-01 11:33:50 -06001242 } else {
Tobin Ehlis815e8132016-06-02 13:02:17 -06001243 ds_data->layout_nodes[i] = layout;
Tobin Ehlis68d0adf2016-06-01 11:33:50 -06001244 // Count total descriptors required per type
Tobin Ehlis815e8132016-06-02 13:02:17 -06001245 for (uint32_t j = 0; j < layout->GetBindingCount(); ++j) {
1246 const auto &binding_layout = layout->GetDescriptorSetLayoutBindingPtrFromIndex(j);
Tobin Ehlis68d0adf2016-06-01 11:33:50 -06001247 uint32_t typeIndex = static_cast<uint32_t>(binding_layout->descriptorType);
1248 ds_data->required_descriptors_by_type[typeIndex] += binding_layout->descriptorCount;
1249 }
Tobin Ehlisee471462016-05-26 11:21:59 -06001250 }
1251 }
Tobin Ehlis815e8132016-06-02 13:02:17 -06001252 auto pool_node = getPoolNode(dev_data, p_alloc_info->descriptorPool);
1253 if (!pool_node) {
Tobin Ehlisee471462016-05-26 11:21:59 -06001254 skip_call |=
1255 log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_POOL_EXT,
1256 reinterpret_cast<const uint64_t &>(p_alloc_info->descriptorPool), __LINE__, DRAWSTATE_INVALID_POOL, "DS",
1257 "Unable to find pool node for pool 0x%" PRIxLEAST64 " specified in vkAllocateDescriptorSets() call",
1258 reinterpret_cast<const uint64_t &>(p_alloc_info->descriptorPool));
1259 } else { // Make sure pool has all the available descriptors before calling down chain
1260 // Track number of descriptorSets allowable in this pool
Tobin Ehlis815e8132016-06-02 13:02:17 -06001261 if (pool_node->availableSets < p_alloc_info->descriptorSetCount) {
1262 skip_call |=
1263 log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_POOL_EXT,
1264 reinterpret_cast<uint64_t &>(pool_node->pool), __LINE__, DRAWSTATE_DESCRIPTOR_POOL_EMPTY, "DS",
1265 "Unable to allocate %u descriptorSets from pool 0x%" PRIxLEAST64
1266 ". This pool only has %d descriptorSets remaining.",
1267 p_alloc_info->descriptorSetCount, reinterpret_cast<uint64_t &>(pool_node->pool), pool_node->availableSets);
Tobin Ehlisee471462016-05-26 11:21:59 -06001268 }
1269 // Determine whether descriptor counts are satisfiable
1270 for (uint32_t i = 0; i < VK_DESCRIPTOR_TYPE_RANGE_SIZE; i++) {
Tobin Ehlis815e8132016-06-02 13:02:17 -06001271 if (ds_data->required_descriptors_by_type[i] > pool_node->availableDescriptorTypeCount[i]) {
1272 skip_call |= log_msg(report_data, VK_DEBUG_REPORT_ERROR_BIT_EXT, VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_POOL_EXT,
1273 reinterpret_cast<const uint64_t &>(pool_node->pool), __LINE__, DRAWSTATE_DESCRIPTOR_POOL_EMPTY,
1274 "DS", "Unable to allocate %u descriptors of type %s from pool 0x%" PRIxLEAST64
1275 ". This pool only has %d descriptors of this type remaining.",
1276 ds_data->required_descriptors_by_type[i], string_VkDescriptorType(VkDescriptorType(i)),
1277 reinterpret_cast<uint64_t &>(pool_node->pool), pool_node->availableDescriptorTypeCount[i]);
Tobin Ehlisee471462016-05-26 11:21:59 -06001278 }
1279 }
1280 }
1281 return skip_call;
1282}
1283// Decrement allocated sets from the pool and insert new sets into set_map
Tobin Ehlis4e380592016-06-02 12:41:47 -06001284void cvdescriptorset::PerformAllocateDescriptorSets(const VkDescriptorSetAllocateInfo *p_alloc_info,
1285 const VkDescriptorSet *descriptor_sets,
1286 const AllocateDescriptorSetsData *ds_data,
1287 std::unordered_map<VkDescriptorPool, DESCRIPTOR_POOL_NODE *> *pool_map,
1288 std::unordered_map<VkDescriptorSet, cvdescriptorset::DescriptorSet *> *set_map,
1289 const core_validation::layer_data *dev_data) {
Tobin Ehlisee471462016-05-26 11:21:59 -06001290 auto pool_state = (*pool_map)[p_alloc_info->descriptorPool];
Tobin Ehlis68d0adf2016-06-01 11:33:50 -06001291 /* Account for sets and individual descriptors allocated from pool */
Tobin Ehlisee471462016-05-26 11:21:59 -06001292 pool_state->availableSets -= p_alloc_info->descriptorSetCount;
Tobin Ehlis68d0adf2016-06-01 11:33:50 -06001293 for (uint32_t i = 0; i < VK_DESCRIPTOR_TYPE_RANGE_SIZE; i++) {
1294 pool_state->availableDescriptorTypeCount[i] -= ds_data->required_descriptors_by_type[i];
1295 }
Tobin Ehlisee471462016-05-26 11:21:59 -06001296 /* Create tracking object for each descriptor set; insert into
1297 * global map and the pool's set.
1298 */
1299 for (uint32_t i = 0; i < p_alloc_info->descriptorSetCount; i++) {
Tobin Ehlis4e380592016-06-02 12:41:47 -06001300 auto new_ds = new cvdescriptorset::DescriptorSet(descriptor_sets[i], ds_data->layout_nodes[i], dev_data);
Tobin Ehlisee471462016-05-26 11:21:59 -06001301
1302 pool_state->sets.insert(new_ds);
1303 new_ds->in_use.store(0);
1304 (*set_map)[descriptor_sets[i]] = new_ds;
1305 }
1306}