53 lines
1.7 KiB
Plaintext
53 lines
1.7 KiB
Plaintext
|
vkCmdNextSubpass(3)
|
||
|
|
===================
|
||
|
|
|
||
|
|
Name
|
||
|
|
----
|
||
|
|
vkCmdNextSubpass - Transition to the next subpass of a render pass.
|
||
|
|
|
||
|
|
C Specification
|
||
|
|
---------------
|
||
|
|
|
||
|
|
include::../protos/vkCmdNextSubpass.txt[]
|
||
|
|
|
||
|
|
Parameters
|
||
|
|
----------
|
||
|
|
|
||
|
|
pname:commandBuffer::
|
||
|
|
The command buffer in which to switch to the next subpass.
|
||
|
|
|
||
|
|
pname:contents::
|
||
|
|
A description of how the commands for the next subpass will be issued.
|
||
|
|
|
||
|
|
Description
|
||
|
|
-----------
|
||
|
|
|
||
|
|
fname:vkCmdNextSubpass finalizes the previous subpass of the current render pass
|
||
|
|
and prepares for the next subpass. It may only be called in a primary command
|
||
|
|
buffer when a render pass is active. For a render pass with N subpasses,
|
||
|
|
fname:vkCmdNextSubpass must be used exactly N-1 times between
|
||
|
|
fname:vkCmdBeginRenderPass and fname:vkCmdEndRenderPass to transition through all
|
||
|
|
of the subpasses.
|
||
|
|
|
||
|
|
The pname:contents parameter describes how the commands in the next subpass will be
|
||
|
|
provided. If it is ename:VK_SUBPASS_CONTENTS_INLINE, the contents of the
|
||
|
|
subpass will be recorded inline in the primary command buffer, and calling a
|
||
|
|
secondary command buffer within the subpass is an error. If pname:contents
|
||
|
|
is ename:VK_SUBPASS_CONTENTS_SECONDARY_COMMAND_BUFFERS, the contents are
|
||
|
|
recorded in secondary command buffers that will be called from the primary
|
||
|
|
command buffer, and fname:vkCmdExecuteCommands is the only valid command on
|
||
|
|
the command buffer until fname:vkCmdNextSubpass or fname:vkCmdEndRenderPass.
|
||
|
|
|
||
|
|
Transitioning between subpasses performs any multisample resolve operations in
|
||
|
|
the pass being ended, and transitions attachment images from their current
|
||
|
|
layout to the layout required by the next subpass.
|
||
|
|
|
||
|
|
include::../validity/protos/vkCmdNextSubpass.txt[]
|
||
|
|
|
||
|
|
See Also
|
||
|
|
--------
|
||
|
|
|
||
|
|
flink:vkCmdEndRenderPass, flink:vkCreateRenderPass
|
||
|
|
|
||
|
|
include::footer.txt[]
|