Skip to content
Permalink
Browse files

Change log for August 11, 2019 Vulkan 1.1.118 spec update:

  * Update release number to 118.

Github Issues:

  * Update `BUILD.adoc` to specifically require asciidoctor 1.5.8, and make
    that change to the gitlab CI script (public issue 968).
  * Remove redundant slink:VkSubpassDependency and
    slink:VkSubpassDependency2KHR valid usage statements
    (public pull request 995).
  * Clarify the <<vkGetInstanceProcAddr behavior>> and <<vkGetDeviceProcAddr
    behavior>> tables (public pull request 1004).
  * Fix use of nonexistent
    slink:VkSamplerYcbcrConversionImageFormatProperties::pname:maxCombinedImageSamplerDescriptorCount
    (public pull request 1010).
  * Use compatible pathlib for python2 (public pull request 1012).

Internal Issues:

  * Mark the <<VK_KHR_vulkan_memory_model>> extension as no longer
    provisional in `vk.xml` (internal issue 1369).
  * Clarify that use-defined code:Input and code:Output variables cannot be
    code:Boolean in the <<interfaces-iointerfaces-user, User-defined
    Variable Interface>> section (internal issue 1663).
  * Fix naming inconsistencies in
    slink:VkPhysicalDevicePerformanceQueryFeaturesKHR,
    slink:VkPhysicalDevicePerformanceQueryPropertiesKHR,
    slink:VkQueryPoolPerformanceCreateInfoKHR, and associated enumerants
    (internal issue 1746).
  * Use ACM reference style for normative references (internal merge request
    3256).
  * Explicitly list the features changed in Vulkan 1.1 in the
    <<features-requirements, Feature Requirements>> section and the
    <<versions, Core Revisions (Informative)>> appendix (internal merge
    request 3274).
  * Add the slink:VkPhysicalDeviceSubgroupSizeControlFeaturesEXT structure
    to the <<VK_EXT_subgroup_size_control>> extension, which was
    accidentally omitted in the initial release of the extension (internal
    merge request 3287).
  * Add missing slink:VkImageUsageFlag description for
    ename:VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT (internal merge
    request 3292).
  * Add valid usage statements to slink:VkAccelerationStructureInfoNV and
    flink:vkGetAccelerationStructureHandleNV to clarify usage of
    acceleration structure handle and geometries (internal merge request
    3292).

New Extensions:

  * `<<VK_AMD_shader_core_properties2>>`
  * `<<VK_AMD_pipeline_compiler_control>>`
  • Loading branch information...
oddhack committed Aug 11, 2019
1 parent b3968ec commit 94f03f1ccaecf6403d44fbe3de78d033e396bc58
@@ -11,7 +11,9 @@ spec-generate:
# won't work with ruby 2.1, doesn't abort the CI job when installing
# other gems which need it.
- gem install i18n -v 1.5.1
- gem install asciidoctor asciidoctor-mathematical coderay json-schema
- gem install asciidoctor -v 1.5.8
- gem -v
- gem install asciidoctor-mathematical coderay json-schema
script:
# Internal self-test of the check_spec_links script
- ( cd scripts && py.test-3 test*.py )
@@ -400,8 +400,9 @@ This section describes the software components used by the Vulkan spec
toolchain.

Before building the Vulkan spec, you must install the following tools.
Minimum versions known to be working are shown. Later versions will probably
work at least as well.
Minimum versions known to be working are shown. Later versions may work as
well; however, specific versions are sometimes required and when this is
known, it is noted below.

* GNU make (`make` version: 4.0.8-1; older versions probably OK)
* Python 3 (`python`, version: 3.4.2)
@@ -444,7 +445,8 @@ environment managers below.
Please read the remainder of this document (other than platform-specific
parts you don't use) completely before trying to install.

* Asciidoctor (`asciidoctor`, version: 1.5.8)
* Asciidoctor (`asciidoctor`, version: 1.5.8). Version 2.0.0 and later
will *not* work at this time due to breaking changes in asciidoctor.
* Coderay (`coderay`, version 1.1.2)
* JSON Schema (`json-schema`, version 2.8.1)
* Asciidoctor Diagram (`asciidoctor-diagram`, version: 1.5.11)
@@ -730,7 +732,8 @@ The following ruby gems can be installed directly via the `gem install`
command, once the platform is set up:

----
gem install --no-rdoc --no-ri asciidoctor coderay json-schema asciidoctor-mathematical asciidoctor-diagram
gem install --no-rdoc --no-ri asciidoctor -v 1.5.8
gem install --no-rdoc --no-ri coderay json-schema asciidoctor-mathematical asciidoctor-diagram
gem install --no-rdoc --no-ri --pre asciidoctor-pdf
----

@@ -1009,7 +1012,8 @@ echo "2.5.3" > ~/.rbenv/version
# asciidoctor-mathematical also takes in excess of 20 min. to build!
# The same RUBY_CONFIGURE_OPTS advice above may apply here as well.
gem install --no-rdoc --no-ri asciidoctor coderay json-schema asciidoctor-mathematical asciidoctor-diagram
gem install --no-rdoc --no-ri asciidoctor -v 1.5.8
gem install --no-rdoc --no-ri coderay json-schema asciidoctor-mathematical asciidoctor-diagram
gem install --no-rdoc --no-ri --pre asciidoctor-pdf
----

@@ -8,6 +8,61 @@ public pull requests that have been accepted.

-----------------------------------------------------

Change log for August 11, 2019 Vulkan 1.1.118 spec update:

* Update release number to 118.

Github Issues:

* Update `BUILD.adoc` to specifically require asciidoctor 1.5.8, and make
that change to the gitlab CI script (public issue 968).
* Remove redundant slink:VkSubpassDependency and
slink:VkSubpassDependency2KHR valid usage statements
(public pull request 995).
* Clarify the <<vkGetInstanceProcAddr behavior>> and <<vkGetDeviceProcAddr
behavior>> tables (public pull request 1004).
* Fix use of nonexistent
slink:VkSamplerYcbcrConversionImageFormatProperties::pname:maxCombinedImageSamplerDescriptorCount
(public pull request 1010).
* Use compatible pathlib for python2 (public pull request 1012).

Internal Issues:

* Mark the <<VK_KHR_vulkan_memory_model>> extension as no longer
provisional in `vk.xml` (internal issue 1369).
* Clarify that use-defined code:Input and code:Output variables cannot be
code:Boolean in the <<interfaces-iointerfaces-user, User-defined
Variable Interface>> section (internal issue 1663).
* Fix naming inconsistencies in
slink:VkPhysicalDevicePerformanceQueryFeaturesKHR,
slink:VkPhysicalDevicePerformanceQueryPropertiesKHR,
slink:VkQueryPoolPerformanceCreateInfoKHR, and associated enumerants
(internal issue 1746).
* Use ACM reference style for normative references (internal merge request
3256).
* Explicitly list the features changed in Vulkan 1.1 in the
<<features-requirements, Feature Requirements>> section and the
<<versions, Core Revisions (Informative)>> appendix (internal merge
request 3274).
* Add the slink:VkPhysicalDeviceSubgroupSizeControlFeaturesEXT structure
to the <<VK_EXT_subgroup_size_control>> extension, which was
accidentally omitted in the initial release of the extension (internal
merge request 3287).
* Add missing slink:VkImageUsageFlag description for
ename:VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT (internal merge
request 3292).
* Add valid usage statements to slink:VkAccelerationStructureInfoNV and
flink:vkGetAccelerationStructureHandleNV to clarify usage of
acceleration structure handle and geometries (internal merge request
3292).

New Extensions:

* `<<VK_AMD_shader_core_properties2>>`
* `<<VK_AMD_pipeline_compiler_control>>`

-----------------------------------------------------

Change log for July 28, 2019 Vulkan 1.1.117 spec update:

* Update release number to 117.
@@ -121,7 +121,7 @@ VERBOSE =
# ADOCOPTS options for asciidoc->HTML5 output

NOTEOPTS = -a editing-notes -a implementation-guide
PATCHVERSION = 117
PATCHVERSION = 118
ifneq (,$(findstring VK_VERSION_1_1,$(VERSIONS)))
SPECREVISION = 1.1.$(PATCHVERSION)
else
@@ -19,7 +19,7 @@ Vulkan:
colorspace.
For example, this color space would be set by the swapchain to use the
native color space in Freesync2 displays.

* Local dimming control

=== New Object Types
@@ -0,0 +1,49 @@
include::meta/VK_AMD_pipeline_compiler_control.txt[]

*Last Modified Date*::
2019-07-26
*IP Status*::
No known IP claims.
*Contributors*::
- Matthaeus G. Chajdas, AMD
- Daniel Rakos, AMD
- Maciej Jesionowski, AMD
- Tobias Hector, AMD

This extension introduces slink:VkPipelineCompilerControlCreateInfoAMD
structure that can be chained to a pipeline's create info to specify
additional flags that affect pipeline compilation.

=== New Object Types

None.

=== New Enum Constants

* Extending elink:VkStructureType:
** ename:VK_STRUCTURE_TYPE_PIPELINE_COMPILER_CONTROL_CREATE_INFO_AMD

=== New Enums

* elink:VkPipelineCompilerControlFlagBitsAMD

=== New Structures

* slink:VkPipelineCompilerControlCreateInfoAMD

=== New Functions

None.

=== Issues

None.

=== Examples

None.

=== Version History

* Revision 1, 2019-07-26 (Tobias Hector)
- Initial revision.
@@ -0,0 +1,44 @@
include::meta/VK_AMD_shader_core_properties2.txt[]

*Last Modified Date*::
2019-07-26
*IP Status*::
No known IP claims.
*Contributors*::
- Matthaeus G. Chajdas, AMD
- Tobias Hector, AMD

This extension exposes additional shader core properties for a target
physical device through the `<<VK_KHR_get_physical_device_properties2>>`
extension.

=== New Object Types

None.

=== New Enum Constants

* Extending elink:VkStructureType:
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_CORE_PROPERTIES_2_AMD

=== New Enums

* elink:VkShaderCorePropertiesFlagBitsAMD

=== New Structures

* slink:VkPhysicalDeviceShaderCoreProperties2AMD


=== New Functions

None.

=== Examples

None.

=== Version History

* Revision 1, 2019-07-26 (Matthaeus G. Chajdas)
- Initial draft.
@@ -71,6 +71,8 @@ subgroup size.
=== New Enum Constants

* Extending elink:VkStructureType:
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SUBGROUP_SIZE_CONTROL_FEATURES_EXT
(added in version 2)
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SUBGROUP_SIZE_CONTROL_PROPERTIES_EXT
** ename:VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_REQUIRED_SUBGROUP_SIZE_CREATE_INFO_EXT
* Extending elink:VkPipelineShaderStageCreateFlagBits:
@@ -79,6 +81,8 @@ subgroup size.

=== New Structures

* slink:VkPhysicalDeviceSubgroupSizeControlFeaturesEXT (added in version
2)
* slink:VkPhysicalDeviceSubgroupSizeControlPropertiesEXT
* slink:VkPipelineShaderStageRequiredSubgroupSizeCreateInfoEXT

@@ -90,3 +94,7 @@ None.

* Revision 1, 2019-03-05 (Neil Henning)
- Initial draft

* Revision 2, 2019-07-26 (Jason Ekstrand)
- Add the missing slink:VkPhysicalDeviceSubgroupSizeControlFeaturesEXT
for querying subgroup size control features.
@@ -12,7 +12,7 @@ Contributors::
This extension allows images of a format that requires
<<formats-requiring-sampler-ycbcr-conversion, Y'C~B~C~R~ conversion>> to be
created with multiple array layers, which is otherwise restricted.

=== New Enum Constants

* Extending elink:VkStructureType:
@@ -93,9 +93,9 @@ None.
** ename:VK_SHADING_RATE_PALETTE_ENTRY_1_INVOCATION_PER_4X2_PIXELS_NV
** ename:VK_SHADING_RATE_PALETTE_ENTRY_1_INVOCATION_PER_2X4_PIXELS_NV
** ename:VK_SHADING_RATE_PALETTE_ENTRY_1_INVOCATION_PER_4X4_PIXELS_NV

* elink:VkCoarseSampleOrderTypeNV, containing the following constants:

** ename:VK_COARSE_SAMPLE_ORDER_TYPE_DEFAULT_NV
** ename:VK_COARSE_SAMPLE_ORDER_TYPE_CUSTOM_NV
** ename:VK_COARSE_SAMPLE_ORDER_TYPE_PIXEL_MAJOR_NV
@@ -28,9 +28,10 @@ number of key extensions into the core API:
include::meta/promoted_extensions_VK_VERSION_1_1.txt[]

The only changes to the functionality added by these extensions were to
`VK_KHR_shader_draw_parameters`, which had a
<<features-shaderDrawParameters, feature bit>> added to determine support in
the core API, and <<features-variablePointersStorageBuffer,
`VK_KHR_shader_draw_parameters`, which had the
<<features-shaderDrawParameters, pname:shaderDrawParameters>> feature bit
added to determine support in the core API, and
<<features-variablePointersStorageBuffer,
pname:variablePointersStorageBuffer>> from `VK_KHR_variable_pointers` was
made optional.

@@ -0,0 +1,33 @@
// This section is included inside the Pipelines chapter (pipelines.txt)

[[pipelines-compiler-control]]
== Pipeline Compiler Control

[open,refpage='VkPipelineCompilerControlCreateInfoAMD',desc='Structure used to pass compilation control flags to a pipeline',type='structs']
--

The compilation of a pipeline can: be tuned by including a
sname:VkPipelineCompilerControlCreateInfoAMD structure in the pname:pNext
chain of slink:VkGraphicsPipelineCreateInfo or
slink:VkComputePipelineCreateInfo.

include::{generated}/api/structs/VkPipelineCompilerControlCreateInfoAMD.txt[]

* pname:sType is the type of this structure.
* pname:pNext is `NULL` or a pointer to an extension-specific structure.
* pname:compilerControlFlags is a bitmask of
elink:VkPipelineCompilerControlFlagBitsAMD affecting how the pipeline
will be compiled.

include::{generated}/validity/structs/VkPipelineCompilerControlCreateInfoAMD.txt[]
--

[open,refpage='VkPipelineCompilerControlFlagBitsAMD',desc='Enum specifying available compilation control flags',type='enums']
--

There are currently no available flags for this extension; flags will be
added by future versions of this extension.

include::{generated}/api/enums/VkPipelineCompilerControlFlagBitsAMD.txt[]

--
@@ -126,6 +126,10 @@ flink:vkCmdBuildAccelerationStructureNV.
* [[VUID-VkAccelerationStructureInfoNV-type-02426]]
If pname:type is ename:VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_NV
then pname:instanceCount must: be `0`
* [[VUID-VkAccelerationStructureInfoNV-type-02786]]
If pname:type is ename:VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_NV
then the pname:geometryType member of each geometry in pname:pGeometries
must: be the same
* [[VUID-VkAccelerationStructureInfoNV-flags-02592]]
If pname:flags has the
ename:VK_BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_TRACE_BIT_NV bit set,
@@ -567,6 +571,10 @@ include::{generated}/api/protos/vkGetAccelerationStructureHandleNV.txt[]
* [[VUID-vkGetAccelerationStructureHandleNV-dataSize-02240]]
pname:dataSize must: be large enough to contain the result of the query,
as described above
* [[VUID-vkGetAccelerationStructureHandleNV-accelerationStructure-02787]]
pname:accelerationStructure must: be bound completely and contiguously
to a single sname:VkDeviceMemory object via
flink:vkBindAccelerationStructureMemoryNV
****

include::{generated}/validity/protos/vkGetAccelerationStructureHandleNV.txt[]
@@ -2074,9 +2074,9 @@ ifdef::VULKAN_1_1,VK_KHR_sampler_ycbcr_conversion[]
.Note
====
When creating a descriptor pool that will contain descriptors for combined
image samplers of multi-planar formats, an application needs to account
for non-trivial descriptor consumption when choosing the
pname:descriptorCount value, as indicated by
image samplers of multi-planar formats, an application needs to account for
non-trivial descriptor consumption when choosing the pname:descriptorCount
value, as indicated by
slink:VkSamplerYcbcrConversionImageFormatProperties::pname:combinedImageSamplerDescriptorCount.
====
endif::VULKAN_1_1,VK_KHR_sampler_ycbcr_conversion[]

0 comments on commit 94f03f1

Please sign in to comment.
You can’t perform that action at this time.