Skip to content

Commit 5c5cfd4

Browse files
Allow VK_INSTANCE_LAYERS to order implicit layers
Implicit layers previously were always loaded closest to the application regardless of whether they appeared in any environment variables. This commit allows users to order implicit layers using VK_INSTANCE_LAYERS, so that if a user has put an implicit layer in that environment variable, that layer will be loaded respecting its order relative to other layers in the env-var. If VK_INSTANCE_LAYERS contains just a single implicit layer, this will cause that implicit layer to be loaded after all other implicit layers, and before any app-enabled layers. This commit also updates the documentation to reflect the un-deprecated nature of VK_INSTANCE_LAYERS as well as other fixes related to this change.
1 parent e753770 commit 5c5cfd4

10 files changed

+308
-381
lines changed

docs/LoaderInterfaceArchitecture.md

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -888,9 +888,7 @@ discovery.
888888
Known layers are those which are found by the loader taking into account
889889
default search paths and other environment variables
890890
(like <i>VK_LAYER_PATH</i>).
891-
<br/>
892-
This has replaced the older deprecated environment variable
893-
<i>VK_INSTANCE_LAYERS</i>
891+
</i>
894892
</small></td>
895893
<td><small>
896894
This functionality is only available with Loaders built with version
@@ -1045,8 +1043,7 @@ may be removed in a future loader release.
10451043
<i>ppEnabledLayerNames</i>.
10461044
</small></td>
10471045
<td><small>
1048-
This has been deprecated by <i>VK_LOADER_LAYERS_ENABLE</i>.
1049-
It also overrides any layers disabled with
1046+
It overrides any layers disabled with
10501047
<i>VK_LOADER_LAYERS_DISABLE</i>.
10511048
</small></td>
10521049
<td><small>

docs/LoaderLayerInterface.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -563,7 +563,7 @@ i.e. they do not require any external context to be enabled, will be enabled.
563563

564564
##### `VK_INSTANCE_LAYERS`
565565

566-
The original `VK_INSTANCE_LAYERS` can be viewed as a special case of the new
566+
The original `VK_INSTANCE_LAYERS` can be viewed as a special case of
567567
`VK_LOADER_LAYERS_ENABLE`.
568568
Because of this, any layers enabled via `VK_INSTANCE_LAYERS` will be treated the
569569
same as layers enabled with `VK_LOADER_LAYERS_ENABLE` and will therefore

docs/images/loader_layer_order.png

-4.01 KB
Loading
-13.1 KB
Loading

docs/images/svgs/loader_layer_order.svg

Lines changed: 106 additions & 94 deletions
Loading

0 commit comments

Comments
 (0)