Skip to content
Permalink
Browse files

Change log for April 29, 2016 Vulkan 1.0.12 spec update:

  * Bump API patch number and header version number to 12 for this
    update.

Github Issues:

  * Change valid usage statements intended to be "sub-points" to
    be actual sub-points (public issue 66).
  * Replace double negation in description of
    slink:VkRenderPassBeginInfo::pname:pClearValues (based on public
    merge 142).
  * Cleanup minor typos in spec, ref pages and XML, including those
    proposed in public pull requests 144, 150, 151, 167, 168, 181, and
    186.
  * Use *strict subset* in describing the partial order of memory
    property types for slink:VkMemoryType, and update the style guide
    accordingly (public issue 190).
  * Fix various "a image" -> "an image" typos (public issue 191).
  * Note in the <<fundamentals-validusage,Valid Usage>> and
    <<extensions-interactions,Extension Interactions>> sections that
    structures defined by extensions which may be passed in structure
    chains using the ptext:pNext member must: include initial
    ptext:sType and ptext:pNext members (public issue 192).

Internal Issues:

  * Remove duplicate language from the description of the pname:fence
    parameter to flink:vkQueueSubmit and improve validity language
    (internal issue 91).
  * Added documentation for "optional" attribute to XML readme.tex/pdf
    (internal issue 149).
  * Clarify the host-side data validity rules and behavior of
    flink:vkFlushMappedMemoryRanges and
    flink:vkInvalidateMappedMemoryRanges (internal issue 266).

Other Commits:

  * Added clarification to flink:vkCmdFillBuffer regarding the use of
    ename:VK_WHOLE_SIZE.
  * Fixed and documented implementation of "validextensionstructs"
    attribute. in XML processing scripts and readme.tex/pdf.
  * Add missing validity statements to flink:vkResetEvent and
    flink:vkCmdResetEvent.
  * Fix validity for the
    ename:VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT flag.
    Correct all the draw/dispatch commands to mention optimally tiled
    images as well as linear tiled images, and say image VIEWS instead
    of images. Add validity statement to flink:vkCmdBlitImage
  * Replace the {apiname} macro with hardcoded "Vulkan", now that we've
    committed to that name.
  * Add the VK_AMD_rasterization_order extension to vk.xml.
  • Loading branch information...
oddhack committed Apr 29, 2016
1 parent 6db51e9 commit 75bbb5f4d52321eed41337cc463aa036748a1352
Showing with 557 additions and 432 deletions.
  1. +54 −0 ChangeLog.txt
  2. +3 −4 doc/specs/vulkan/Makefile
  3. +1 −1 doc/specs/vulkan/appendices/VK_KHR_sampler_mirror_clamp_to_edge.txt
  4. +3 −3 doc/specs/vulkan/appendices/compressedtex.txt
  5. +47 −39 doc/specs/vulkan/appendices/extensions.txt
  6. +7 −7 doc/specs/vulkan/appendices/glossary.txt
  7. +18 −18 doc/specs/vulkan/appendices/invariance.txt
  8. +10 −10 doc/specs/vulkan/appendices/spirvenv.txt
  9. +3 −1 doc/specs/vulkan/chapters/clears.txt
  10. +8 −27 doc/specs/vulkan/chapters/cmdbuffers.txt
  11. +1 −1 doc/specs/vulkan/chapters/copies.txt
  12. +2 −2 doc/specs/vulkan/chapters/descriptorsets.txt
  13. +11 −11 doc/specs/vulkan/chapters/devsandqueues.txt
  14. +9 −9 doc/specs/vulkan/chapters/extensions.txt
  15. +14 −9 doc/specs/vulkan/chapters/features.txt
  16. +1 −1 doc/specs/vulkan/chapters/fragops.txt
  17. +1 −1 doc/specs/vulkan/chapters/framebuffer.txt
  18. +68 −65 doc/specs/vulkan/chapters/fundamentals.txt
  19. +1 −1 doc/specs/vulkan/chapters/fxvertex.txt
  20. +13 −13 doc/specs/vulkan/chapters/initialization.txt
  21. +2 −2 doc/specs/vulkan/chapters/interfaces.txt
  22. +17 −17 doc/specs/vulkan/chapters/introduction.txt
  23. +60 −53 doc/specs/vulkan/chapters/memory.txt
  24. +5 −5 doc/specs/vulkan/chapters/pipelines.txt
  25. +2 −2 doc/specs/vulkan/chapters/primsrast.txt
  26. +4 −4 doc/specs/vulkan/chapters/queries.txt
  27. +2 −2 doc/specs/vulkan/chapters/renderpass.txt
  28. +3 −3 doc/specs/vulkan/chapters/resources.txt
  29. +2 −2 doc/specs/vulkan/chapters/samplers.txt
  30. +1 −1 doc/specs/vulkan/chapters/shaders.txt
  31. +3 −3 doc/specs/vulkan/chapters/sparsemem.txt
  32. +9 −9 doc/specs/vulkan/chapters/synchronization.txt
  33. +1 −1 doc/specs/vulkan/copyright.txt
  34. +1 −1 doc/specs/vulkan/man/vkAllocateCommandBuffers.txt
  35. +1 −1 doc/specs/vulkan/man/vkCmdCopyBuffer.txt
  36. +1 −1 doc/specs/vulkan/man/vkCmdResolveImage.txt
  37. +1 −1 doc/specs/vulkan/man/vkCreateBuffer.txt
  38. +1 −1 doc/specs/vulkan/man/vkCreateComputePipelines.txt
  39. +1 −1 doc/specs/vulkan/man/vkCreateImageView.txt
  40. +1 −1 doc/specs/vulkan/man/vkCreatePipelineLayout.txt
  41. +1 −1 doc/specs/vulkan/man/vkEnumeratePhysicalDevices.txt
  42. +1 −1 doc/specs/vulkan/man/vkGetImageSubresourceLayout.txt
  43. +1 −1 doc/specs/vulkan/man/vkGetInstanceProcAddr.txt
  44. +2 −2 doc/specs/vulkan/man/vkGetPhysicalDeviceQueueFamilyProperties.txt
  45. +8 −1 doc/specs/vulkan/style/styleguide.txt
  46. +1 −0 doc/specs/vulkan/validity/protos/vkCmdBlitImage.txt
  47. +1 −1 doc/specs/vulkan/validity/protos/vkCmdClearColorImage.txt
  48. +1 −1 doc/specs/vulkan/validity/protos/vkCmdClearDepthStencilImage.txt
  49. +1 −1 doc/specs/vulkan/validity/protos/vkCmdDispatch.txt
  50. +1 −1 doc/specs/vulkan/validity/protos/vkCmdDispatchIndirect.txt
  51. +1 −1 doc/specs/vulkan/validity/protos/vkCmdDraw.txt
  52. +1 −1 doc/specs/vulkan/validity/protos/vkCmdDrawIndexed.txt
  53. +1 −1 doc/specs/vulkan/validity/protos/vkCmdDrawIndexedIndirect.txt
  54. +1 −1 doc/specs/vulkan/validity/protos/vkCmdDrawIndirect.txt
  55. +1 −0 doc/specs/vulkan/validity/protos/vkCmdResetEvent.txt
  56. +2 −2 doc/specs/vulkan/validity/protos/vkQueueSubmit.txt
  57. +1 −0 doc/specs/vulkan/validity/protos/vkResetEvent.txt
  58. +7 −7 doc/specs/vulkan/validity/structs/VkBufferImageCopy.txt
  59. +4 −4 doc/specs/vulkan/validity/structs/VkBufferViewCreateInfo.txt
  60. +8 −8 doc/specs/vulkan/validity/structs/VkImageCopy.txt
  61. +3 −2 doc/specs/vulkan/vkapi.py
  62. +1 −1 doc/specs/vulkan/vkspec.txt
  63. +8 −5 src/spec/generator.py
  64. BIN src/spec/readme.pdf
  65. +20 −9 src/spec/readme.tex
  66. +1 −1 src/spec/registry.rnc
  67. +1 −1 src/spec/test.c
  68. +61 −43 src/spec/vk.xml
  69. +24 −1 src/vulkan/vulkan.h
@@ -526,3 +526,57 @@ Other Commits:
on relevant script/XML/header files. This does not affect the
specification source copyright.

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

Change log for April 29, 2016 Vulkan 1.0.12 spec update:

* Bump API patch number and header version number to 12 for this
update.

Github Issues:

* Change valid usage statements intended to be "sub-points" to
be actual sub-points (public issue 66).
* Replace double negation in description of
slink:VkRenderPassBeginInfo::pname:pClearValues (based on public
merge 142).
* Cleanup minor typos in spec, ref pages and XML, including those
proposed in public pull requests 144, 150, 151, 167, 168, 181, and
186.
* Use *strict subset* in describing the partial order of memory
property types for slink:VkMemoryType, and update the style guide
accordingly (public issue 190).
* Fix various "a image" -> "an image" typos (public issue 191).
* Note in the <<fundamentals-validusage,Valid Usage>> and
<<extensions-interactions,Extension Interactions>> sections that
structures defined by extensions which may be passed in structure
chains using the ptext:pNext member must: include initial
ptext:sType and ptext:pNext members (public issue 192).

Internal Issues:

* Remove duplicate language from the description of the pname:fence
parameter to flink:vkQueueSubmit and improve validity language
(internal issue 91).
* Added documentation for "optional" attribute to XML readme.tex/pdf
(internal issue 149).
* Clarify the host-side data validity rules and behavior of
flink:vkFlushMappedMemoryRanges and
flink:vkInvalidateMappedMemoryRanges (internal issue 266).

Other Commits:

* Added clarification to flink:vkCmdFillBuffer regarding the use of
ename:VK_WHOLE_SIZE.
* Fixed and documented implementation of "validextensionstructs"
attribute. in XML processing scripts and readme.tex/pdf.
* Add missing validity statements to flink:vkResetEvent and
flink:vkCmdResetEvent.
* Fix validity for the
ename:VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT flag.
Correct all the draw/dispatch commands to mention optimally tiled
images as well as linear tiled images, and say image VIEWS instead
of images. Add validity statement to flink:vkCmdBlitImage
* Replace the {apiname} macro with hardcoded "Vulkan", now that we've
committed to that name.
* Add the VK_AMD_rasterization_order extension to vk.xml.
@@ -26,7 +26,6 @@ allchecks: checkinc checklinks
# Note that the := assignments below are immediate, not deferred, and
# are therefore order-dependent in the Makefile

APINAME=Vulkan
QUIET?=@
ASCIIDOC ?= asciidoc.py
A2X ?= a2x.py
@@ -64,14 +63,14 @@ KEEP =
# asciidoc / a2x attributes to set.
# XMLLINT normally unset - to detect problems with intermediate files
# NOTEOPTS sets options controlling which NOTEs are generated
# ATTRIBOPTS sets {apiname} to "Vulkan" and enables MathJax generation
# ATTRIBOPTS sets the api revision and enables MathJax generation
# VKCONF contains Vulkan-specific Asciidoc macros
# ADOCOPTS options for asciidoc->HTML output
# ADOCPDFOPTS options for asciidoc->PDF output via dblatex (not using a2x)
# A2XOPTS options for a2x->{HTML,PDF} output
XMLLINT = --no-xmllint
NOTEOPTS = -a editing-notes -a implementation-guide
ATTRIBOPTS = -a apiname=$(APINAME)@ -a apirevision="$(SPECREVISION)" -a mathjax
ATTRIBOPTS = -a apirevision="$(SPECREVISION)" -a mathjax
VKCONF = config/vkspec.conf
ADOCOPTS = $(ATTRIBOPTS) $(NOTEOPTS) -f config/mathjax-asciidoc.conf \
-f $(VKCONF) $(VERBOSE)
@@ -126,7 +125,7 @@ INCLUDES := $(wildcard protos/*.txt structs/*.txt flags/*.txt enums/*.txt funcpo
COMMONDOCS := $(CHAPTERS) $(INCLUDES)
# A generated included file with the spec version, date, and git commit
SPECVERSION = specversion.txt
SPECREVISION = 1.0.11
SPECREVISION = 1.0.12
SPECREMARK =

# Spec targets
@@ -7,7 +7,7 @@
*Last Modified Date*:: 16/02/2016
*Revision*:: 1
*Dependencies*::
- This extension is written against version 1.0. of the {apiname} API.
- This extension is written against version 1.0. of the Vulkan API.
*Contributors*::
- Tobias Hector, Imagination Technologies
*Contacts*::
@@ -26,7 +26,7 @@ Format Specification.
[[appendix-compressedtex-bc]]
== Block-Compressed Image Formats

.Mapping of {apiname} BC formats to descriptions
.Mapping of Vulkan BC formats to descriptions
[width="90%",options="header",cols="5,4"]
|==============================
| VkFormat | Data Format Specification description
@@ -59,7 +59,7 @@ Format Specification.
The following formats are described in the ``ETC2 Compressed Texture Image
Formats'' chapter of the Khronos Data Format Specification.

.Mapping of {apiname} ETC formats to descriptions
.Mapping of Vulkan ETC formats to descriptions
[options="header",cols="1,1"]
|==============================
| VkFormat | Data Format Specification description
@@ -83,7 +83,7 @@ Formats'' chapter of the Khronos Data Format Specification.
ASTC formats are described in the ``ASTC Compressed Texture Image Formats''
chapter of the Khronos Data Format Specification.

.Mapping of {apiname} ASTC formats to descriptions
.Mapping of Vulkan ASTC formats to descriptions
[width="75%",options="header",cols="63%,15%,22%"]
|==============================
| VkFormat ^| Compressed texel block dimensions ^| sRGB-encoded

0 comments on commit 75bbb5f

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