mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-10 05:55:38 +00:00
35e7bee5f0
* Update release number to 102.
Public Issues:
* Simplify flink:vkGetImageMemoryRequirements constraint for
ename:VK_MEMORY_PROPERTY_LAZILY_ALLOCATED_BIT (public pull request 817).
* Fix typo in markup of the <<textures-texel-coordinate-systems-diagrams,
Texel Coordinate Systems, Corner Sampling>> image that was generating
complaints from chunked HTML output generation (public pull request
928).
Internal Issues:
* Split the old <<features, Features>> chapter into four chapters:
<<features, Features>>, <<limits, Limits>>, <<formats, Formats>>, and
<<capabilities, Capabilities>>, with minor edits to the introductory
paragraph of each chapter. Anchor names in these chapters were changed,
with corresponding effects to xrefs to these anchors elsewhere in spec
markup . The purpose is to make the chunked HTML spec output load faster
on what was previously a single, gigantic chapter (internal issue 1554).
* Add ename:VK_PIPELINE_STAGE_RAY_TRACING_SHADER_BIT_NV, to the supported
pipeline stages for ename:VK_ACCESS_UNIFORM_READ,
ename:VK_ACCESS_SHADER_READ, and ename:VK_ACCESS_SHADER_WRITE in the
<<synchronization-access-types-supported>> table.
* Correct legal name of Google, LLC in vk.xml \<tags> section and a
copyright statement.
* Clarify that Vulkan treats the Android
code:AHARDWAREBUFFER_FORMAT_R8G8B8X8_UNORM format as RGBA, and the
application is responsible for forcing the X/A component to be read as
1.0, in the <<memory-external-android-hardware-buffer-formats>> table.
* Clarify the vertex order of various primitive topologies, and define the
order of transform feedback vertex capture based on that. This involves
a lot of refactoring and cleanup in the <<drawing-primitive-topologies,
Primitive Topologies>>, <<geometry-input, Geometry Shader Input
Primitives>> sections, and <<vertexpostproc-transform-feedback Transform
Feedback>> sections, and numerous places in the <<tessellation>>
chapter,
New Extensions:
* `VK_EXT_metal_surface`
* `VK_EXT_ycbcr_image_arrays` (internal issue 1361).
* `VK_NVX_image_view_handle`
112 lines
3.4 KiB
Makefile
112 lines
3.4 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
|
|
PYFILES = genheaders.py reg.py
|
|
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
|
|
VULKAN = $(INCLUDE)/vulkan
|
|
SRC = ../src
|
|
|
|
# Vulkan platform-specific headers
|
|
PLATFORM_HEADERS = \
|
|
$(VULKAN)/vulkan_android.h \
|
|
$(VULKAN)/vulkan_fuchsia.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
|
|
VKH_DEPENDS = vk.xml genvk.py reg.py generator.py
|
|
|
|
$(HEADERS): $(VKH_DEPENDS)
|
|
$(PYTHON) genvk.py -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 -pedantic -std=c99 -c -I$(INCLUDE) test.c
|
|
g++ -Wall -c -std=c++98 -I$(INCLUDE) test.c
|
|
g++ -Wall -c -std=c++11 -I$(INCLUDE) test.c
|
|
gcc $(TESTDEFS) -Wall -pedantic -std=c99 -c -I$(INCLUDE) test.c
|
|
rm test.o
|
|
|
|
################################################
|
|
|
|
# Autogenerate extension loader from XML API description
|
|
# Also generates $(EXTLOADER)/vulkan_ext.h
|
|
# No longer supported.
|
|
|
|
EXTLOADER = $(SRC)/ext_loader
|
|
EXTSRCS = $(EXTLOADER)/vulkan_ext.c
|
|
extloader $(EXTSRCS): $(VKH_DEPENDS)
|
|
$(PYTHON) genvk.py -registry vk.xml -o $(EXTLOADER) vulkan_ext.c
|
|
|
|
################################################
|
|
|
|
# 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)
|