1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
// Copyright (c) 2017-2020 NVIDIA Corporation
//
// SPDX-License-Identifier: CC-BY-4.0
include::{generated}/meta/{refprefix}VK_NV_viewport_array2.adoc[]
=== Other Extension Metadata
*Last Modified Date*::
2017-02-15
*Interactions and External Dependencies*::
- This extension provides API support for
{GLregistry}/NV/NV_viewport_array2.txt[`GL_NV_viewport_array2`]
- This extension requires the pname:geometryShader and pname:multiViewport
features.
- This extension interacts with the pname:tessellationShader feature.
*Contributors*::
- Piers Daniell, NVIDIA
- Jeff Bolz, NVIDIA
=== Description
This extension adds support for the following SPIR-V extension in Vulkan:
* `SPV_NV_viewport_array2`
which allows a single primitive to be broadcast to multiple viewports and/or
multiple layers.
A new shader built-in output code:ViewportMaskNV is provided, which allows a
single primitive to be output to multiple viewports simultaneously.
Also, a new SPIR-V decoration is added to control whether the effective
viewport index is added into the variable decorated with the code:Layer
built-in decoration.
These capabilities allow a single primitive to be output to multiple layers
simultaneously.
This extension allows variables decorated with the code:Layer and
code:ViewportIndex built-ins to be exported from vertex or tessellation
shaders, using the code:ShaderViewportIndexLayerNV capability.
This extension adds a new code:ViewportMaskNV built-in decoration that is
available for output variables in vertex, tessellation evaluation, and
geometry shaders, and a new code:ViewportRelativeNV decoration that can be
added on variables decorated with code:Layer when using the
code:ShaderViewportMaskNV capability.
When using GLSL source-based shading languages, the code:gl_ViewportMask[]
built-in output variable and code:viewport_relative layout qualifier from
`GL_NV_viewport_array2` map to the code:ViewportMaskNV and
code:ViewportRelativeNV decorations, respectively.
Behaviour is described in the `GL_NV_viewport_array2` extension
specification.
ifdef::VK_EXT_shader_viewport_index_layer[]
[NOTE]
.Note
====
The code:ShaderViewportIndexLayerNV capability is equivalent to the
code:ShaderViewportIndexLayerEXT capability added by
`apiext:VK_EXT_shader_viewport_index_layer`.
====
endif::VK_EXT_shader_viewport_index_layer[]
include::{generated}/interfaces/VK_NV_viewport_array2.adoc[]
=== New or Modified Built-In Variables
* (modified) <<interfaces-builtin-variables-layer,code:Layer>>
* (modified)
<<interfaces-builtin-variables-viewportindex,code:ViewportIndex>>
* <<interfaces-builtin-variables-viewportmask,code:ViewportMaskNV>>
=== New Variable Decoration
* <<interfaces-builtin-variables-layer,code:ViewportRelativeNV in
code:Layer>>
=== New SPIR-V Capabilities
* <<spirvenv-capabilities-table-ShaderViewportIndexLayerNV,
code:ShaderViewportIndexLayerNV>>
* <<spirvenv-capabilities-table-ShaderViewportMaskNV,
code:ShaderViewportMaskNV>>
=== Version History
* Revision 1, 2017-02-15 (Daniel Koch)
** Internal revisions
|
