KhronosGroup / KhronosGroup/Vulkan-Docs

Incomplete VUIDs for VkPipelineColorBlendAttachmentState blend properties if blending is disabled

Open
#2,190 1 comment 0 reactions 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.