VKCMDSETBLENDCONSTAN(3)

NAME
vkCmdSetBlendConstants - Set the values of blend constants.

C SPECIFICATION

    void vkCmdSetBlendConstants(
        VkCommandBuffer                             commandBuffer,
        const float                                 blendConstants[4]);

PARAMETERS

commandBuffer
    The command buffer into which to insert the command.

blendConstants
    An array of values specifying the new blend constants.

DESCRIPTION

vkCmdSetBlendConstants sets the blend constants for the command buffer specified by commandBuffer to the values specified in the four element array blendConstants. Blend constants may be modified only if the current pipeline state object was created with the VK_DYNAMIC_STATE_BLEND_CONSTANTS dynamic state enabled. When a pipeline that does not have 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 vkCmdSetBlendConstants results in undefined behavior. When a pipeline does have 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 vkCmdSetBlendConstants.

VALID USAGE

    • commandBuffer must be a valid VkCommandBuffer handle

    • commandBuffer must be in the recording state

    • The VkCommandPool that commandBuffer was allocated from must support graphics operations

HOST SYNCHRONIZATION

    • Host access to commandBuffer must be externally synchronized

COMMAND PROPERTIES
Command Buffer Levels | Render Pass Scope | Supported Queue Types
Primary Secondary | Both | GRAPHICS

SEE ALSO

vkCreateGraphicsPipelines, VkPipelineDynamicStateCreateInfo

COPYRIGHT

Copyright © 2014-2016 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.

AUTHOR

Khronos Group
    Author.