Vulkan-Docs/doc/specs/vulkan/man/vkCmdSetBlendConstants.txt

44 lines
1.4 KiB
Plaintext

vkCmdSetBlendConstants.txt(3)
=============================
Name
----
vkCmdSetBlendConstants - Set the values of blend constants.
C Specification
---------------
include::../protos/vkCmdSetBlendConstants.txt[]
Parameters
----------
pname:commandBuffer::
The command buffer into which to insert the command.
pname:blendConstants::
An array of values specifying the new blend constants.
Description
-----------
fname:vkCmdSetBlendConstants sets the blend constants for the command buffer specified
by pname:commandBuffer to the values specified in the four element array pname:blendConstants.
Blend constants may be modified only if the current pipeline state object was created
with the ename:VK_DYNAMIC_STATE_BLEND_CONSTANTS dynamic state enabled. When a pipeline
that does not have ename:VK_DYNAMIC_STATE_BLEND_CONSTANTS dynamic state enabled is
first bound, the values of the blend constants are taken from the pipeline and
attempts to change them using fname:vkCmdSetBlendConstants results in undefined
behavior. When a pipeline does have ename:VK_DYNAMIC_STATE_BLEND_CONSTANTS dynamic
state enabled is first bound, the current values of the blend constants become undefined
and must be set using a call to fname:vkCmdSetBlendConstants.
include::../validity/protos/vkCmdSetBlendConstants.txt[]
See Also
--------
flink:vkCreateGraphicsPipelines, slink:VkPipelineDynamicStateCreateInfo
include::footer.txt[]