mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-02-12 14:26:23 +00:00
b1042a3204
* Update release number to 106.
Public Issues:
* Add searchbox and generate search index for the chunked HTML target.
Note that doing this requires several new toolchain components to build
the `chunked` target (public issue 578 / internal issue 1352).
* Remove descriptions of flink:vkCreateSampler sampler constraints which
were repeated in the valid usage statements (public pull request 648).
* Fix sense of conditional around a valid usage statement in the
<<copies>> chapter (public issue 942).
Internal Issues:
* Add missing pname:extent.width and pname:extent.height valid usage
statements for flink:vkCmdClearAttachments (internal issue 1583).
* Fix some inconsistencies in structures and corresponding pname:sType
enumerant names by renaming
sname:VkPhysicalDeviceShaderDrawParameterFeatures ->
slink:slink:VkPhysicalDeviceShaderDrawParametersFeatures;
sname:VkPhysicalDeviceVariablePointerFeatures ->
slink:VkPhysicalDeviceVariablePointerFeatures;
sname:VkPhysicalDeviceVariablePointerFeaturesKHR ->
slink:VkPhysicalDeviceVariablePointerFeaturesKHR;
sname:VkPhysicalDeviceBufferAddressFeaturesEXT ->
slink:VkPhysicalDeviceBufferDeviceAddressFeaturesEXT;
etext:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_DRAW_PARAMETER_FEATURES
->
ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_DRAW_PARAMETERS_FEATURES;
etext:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VARIABLE_POINTER_FEATURES ->
ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VARIABLE_POINTERS_FEATURES;
etext:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VARIABLE_POINTER_FEATURES_KHR ->
ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VARIABLE_POINTERS_FEATURES_KHR;
and etext:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BUFFER_ADDRESS_FEATURES_EXT
->
ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BUFFER_DEVICE_ADDRESS_FEATURES_EXT.
The old names are still available as aliases for backwards
compatibility. This change required introducing valid XML markup which
externally written XML processing scripts may need to be modified to
accomodate, to support multiple aliases of a single command or token
name (internal issue 1592).
* Add slink:VkDevice as the first parameter to flink:vkSetLocalDimmingAMD
(internal issue 1618).
* Improve CI header compilation tests to test all Vulkan platform
includes, using fake platform headers where needed, and change the
`allchecks` Makefile target to use the more comprehensive
`check_spec_links.py` script instead of the retired `checkinc` and
`checklinks` targets.
* Move descriptions of the ASTC compressed texture decode mode from the
<<appendix-compressedtex-astc,appendix>> to the recently updated
external Khronos Data Format Specification.
* Fix minor markup and spelling issues in the `VK_NV_ray_tracing`
extension.
104 lines
3.2 KiB
Makefile
104 lines
3.2 KiB
Makefile
# Copyright (c) 2013-2019 The Khronos Group Inc.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
# If a recipe fails, delete its target file. Without this cleanup, the leftover
|
|
# file from the failed recipe can falsely satisfy dependencies on subsequent
|
|
# runs of `make`.
|
|
.DELETE_ON_ERROR:
|
|
|
|
# Generator scripts and options
|
|
# GENOPTS can be e.g. '-noprotect'
|
|
|
|
PYTHON ?= python3
|
|
SCRIPTS = ../scripts
|
|
GENOPTS =
|
|
|
|
# Generate Vulkan header from XML. Many other files can be generated
|
|
# from vk.xml using the scripts, but they are all generated in ../ as
|
|
# part of the process of building the Specification.
|
|
#
|
|
# Targets:
|
|
#
|
|
# default / install - regenerate headers in ../include/vulkan/.
|
|
# validate - run XML validator on vk.xml against the schema.
|
|
# test - check if vulkan_core.h compiles.
|
|
# clean_dirt - remove intermediate files.
|
|
# clean - remove installed and intermediate files.
|
|
|
|
INCLUDE = ../include
|
|
TESTS = ../tests
|
|
VULKAN = $(INCLUDE)/vulkan
|
|
SRC = ../src
|
|
|
|
# Vulkan platform-specific headers
|
|
PLATFORM_HEADERS = \
|
|
$(VULKAN)/vulkan_android.h \
|
|
$(VULKAN)/vulkan_fuchsia.h \
|
|
$(VULKAN)/vulkan_ggp.h \
|
|
$(VULKAN)/vulkan_ios.h \
|
|
$(VULKAN)/vulkan_macos.h \
|
|
$(VULKAN)/vulkan_vi.h \
|
|
$(VULKAN)/vulkan_wayland.h \
|
|
$(VULKAN)/vulkan_win32.h \
|
|
$(VULKAN)/vulkan_xcb.h \
|
|
$(VULKAN)/vulkan_xlib.h \
|
|
$(VULKAN)/vulkan_xlib_xrandr.h \
|
|
$(VULKAN)/vulkan_metal.h
|
|
HEADERS = $(VULKAN)/vulkan_core.h $(PLATFORM_HEADERS)
|
|
|
|
default install: $(HEADERS)
|
|
|
|
################################################
|
|
|
|
# Autogenerate vulkan header from XML API description
|
|
|
|
# Python and XML files on which vulkan_core.h depends
|
|
GENSCRIPT = $(SCRIPTS)/genvk.py
|
|
VKH_DEPENDS = vk.xml $(GENSCRIPT) $(SCRIPTS)/reg.py $(SCRIPTS)/generator.py
|
|
|
|
$(HEADERS): $(VKH_DEPENDS)
|
|
$(PYTHON) $(GENSCRIPT) -registry vk.xml -o $(VULKAN) $(notdir $@)
|
|
|
|
platform: $(PLATFORM_HEADERS)
|
|
|
|
# Verify registry XML file against the schema
|
|
validate:
|
|
jing -c registry.rnc vk.xml
|
|
|
|
# Test that vulkan_core.h compiles
|
|
|
|
# Platforms to test
|
|
TESTDEFS = -DVK_USE_PLATFORM_XCB_KHR -DVK_USE_PLATFORM_XLIB_KHR
|
|
|
|
test: $(HEADERS) $(VULKAN)/vulkan.h $(VULKAN)/vk_platform.h
|
|
gcc -Wall -std=c99 -c -I$(INCLUDE) -I$(TESTS) $(TESTS)/htest.c
|
|
gcc -Wall -std=c11 -c -I$(INCLUDE) -I$(TESTS) $(TESTS)/htest.c
|
|
g++ -Wall -c -std=c++98 -I$(INCLUDE) -I$(TESTS) $(TESTS)/htest.c
|
|
g++ -Wall -c -std=c++11 -I$(INCLUDE) -I$(TESTS) $(TESTS)/htest.c
|
|
rm -f $(TESTS)/test.o
|
|
|
|
################################################
|
|
|
|
# Files to clean up
|
|
PYDIRT = diag.txt dumpReg.txt errwarn.txt *.pyc regdump.txt
|
|
DIRT = $(PYDIRT) ERRS \#*
|
|
|
|
# Clean intermediate files
|
|
clean_dirt:
|
|
-rm -f $(DIRT)
|
|
|
|
# Clean generated targets as well as intermediates.
|
|
clean clobber: clean_dirt
|
|
-rm -f $(HEADERS) $(PLATFORM_HEADERS)
|