59 lines
1.8 KiB
Plaintext
59 lines
1.8 KiB
Plaintext
vkCmdSetStencilWriteMask(3)
|
|
===========================
|
|
|
|
Name
|
|
----
|
|
vkCmdSetStencilWriteMask - Set the stencil write mask dynamic state.
|
|
|
|
C Specification
|
|
---------------
|
|
|
|
include::../protos/vkCmdSetStencilWriteMask.txt[]
|
|
|
|
Parameters
|
|
----------
|
|
|
|
pname:commandBuffer::
|
|
The command buffer into which to insert the command.
|
|
|
|
pname:faceMask::
|
|
The face or faces to which the new mask is to apply.
|
|
|
|
|
|
pname:writeMask::
|
|
The new value to use for the stencil compare mask.
|
|
|
|
Description
|
|
-----------
|
|
|
|
fname:vkCmdSetStencilWriteMask sets the mask value used for stencil writes
|
|
on the command buffer specified by pname:commandBuffer to pname:writeMask. pname:faceMask specifies the
|
|
face or faces to which the new values are applied. It a bitmask comprised of members
|
|
of the elink:VkStencilFaceFlagBits enumeration, the definition of which is:
|
|
|
|
include::../enums/VkStencilFaceFlagBits.txt[]
|
|
|
|
The graphics pipeline bound to pname:commandBuffer must have the
|
|
ename:VK_DYNAMIC_STATE_STENCIL_WRITE_MASK dynamic state enabled. When a pipeline
|
|
that does not have ename:VK_DYNAMIC_STATE_STENCIL_WRITE_MASK dynamic state enabled is
|
|
first bound, the value of the stencil write mask is taken from the pipeline and
|
|
attempts to change it using fname:vkCmdSetStencilWriteMask results in undefined
|
|
behavior. When a pipeline does have ename:VK_DYNAMIC_STATE_STENCIL_WRITE_MASK dynamic
|
|
state enabled is bound, the current value of the stencil write mask becomes undefined
|
|
and must be set using a call to fname:vkCmdSetStencilWriteMask.
|
|
|
|
If the stencil test is disabled in the current graphics pipeline, then the value of
|
|
the stencil write mask is ignored.
|
|
|
|
include::../validity/protos/vkCmdSetStencilWriteMask.txt[]
|
|
|
|
See Also
|
|
--------
|
|
|
|
flink:vkCreateGraphicsPipelines,
|
|
flink:vkCmdSetStencilCompareMask,
|
|
flink:vkCmdSetStencilReference,
|
|
slink:VkPipelineDynamicStateCreateInfo
|
|
|
|
include::footer.txt[]
|