KhronosGroup / KhronosGroup/Vulkan-Docs
Incomplete VUIDs for VkPipelineColorBlendAttachmentState blend properties if blending is disabled
- Dominant language
- JavaScript
- Stars
- 3.3k
- Forks
- 549
- Avg merge
- 5d 5h
- Merged PRs (30d)
- 2
Description
I assume that if VkPipelineColorBlendAttachmentState::blendEnable is false, then the blend-related fields of the struct are ignored. If so, then the VUIDs for those fields (both on this struct and parent structs) should probably include "If `blendEnable` is `VK_TRUE`, ..."?
It's also a bit unclear how VUID-VkPipelineColorBlendAttachmentState-advancedBlendIndependentBlend-01407 and VUID-VkPipelineColorBlendAttachmentState-advancedBlendIndependentBlend-01408 apply with respect to `blendEnable`. In the case that the VUIDs apply to, should blending be enabled on all attachments, or does `colorBlendOp`/`alphaBlendOp` only need to be equal for those attachments that have blending enabled?
Contributor guide
Research direction
No file or test is named. Start by reviewing the cited VkPipelineColorBlendAttachmentState VUIDs, including 01407 and 01408, and the related parent-struct requirements. Done means the specification clearly states how blendEnable affects these requirements and how the advanced-blend conditions apply to attachments.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100