# ~~~ # Copyright (c) 2014-2023 Valve Corporation # Copyright (c) 2014-2023 LunarG, 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. # ~~~ add_library(VkLayer_utils STATIC) target_sources(VkLayer_utils PRIVATE generated/vk_format_utils.h generated/vk_format_utils.cpp generated/vk_validation_error_messages.h generated/vk_layer_dispatch_table.h generated/vk_dispatch_table_helper.h generated/vk_safe_struct.h generated/vk_safe_struct.cpp # NOTE: This header file is installed by the LunarG SDK and treated as part of VulkanHeaders # IE: This header file is also a deliverable of VVL. generated/vk_enum_string_helper.h generated/vk_object_types.h generated/vk_extension_helper.h generated/vk_typemap_helper.h cast_utils.h hash_util.h hash_vk_types.h vk_layer_config.h vk_layer_config.cpp vk_layer_data.h vk_layer_extension_utils.h vk_layer_extension_utils.cpp vk_layer_logging.h vk_layer_logging.cpp vk_layer_utils.h vk_layer_utils.cpp xxhash.h xxhash.cpp ) # XXH_NO_LONG_LONG: removes compilation of algorithms relying on 64-bit types (XXH3 and XXH64). Only XXH32 will be compiled. # We only need XXH32 due to restrictions requiring a 32 bit hash. This also reduces binary size. # # v0.8.1 also has compilation issues that are removed by setting this define. # https://github.com/KhronosGroup/Vulkan-ValidationLayers/pull/4639 # https://github.com/KhronosGroup/Vulkan-ValidationLayers/issues/4640 target_compile_definitions(VkLayer_utils PUBLIC XXH_NO_LONG_LONG) target_link_libraries(VkLayer_utils PUBLIC Vulkan::Headers) target_include_directories(VkLayer_utils PUBLIC . generated # Needed otherwise VkLayer_utils won't install properly. ) find_package(robin_hood CONFIG) option(USE_ROBIN_HOOD_HASHING "robin_hood provides faster versions of std::unordered_map and std::unordered_set" ${robin_hood_FOUND}) if (USE_ROBIN_HOOD_HASHING) target_link_libraries(VkLayer_utils PRIVATE robin_hood::robin_hood) target_compile_definitions(robin_hood::robin_hood INTERFACE USE_ROBIN_HOOD_HASHING) endif() # Currently repos like LunarG/VulkanTools require source code from VVL # This results in VkLayer_utils needing to be installed. Ideally this is # cleaned up in the future since this is a result of history involving the mono-repo. if(BUILD_LAYER_SUPPORT_FILES) # NOTE: We need to install header/source files for Android get_target_property(LAYER_UTIL_FILES VkLayer_utils SOURCES) install(FILES ${LAYER_UTIL_FILES} DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/vulkan) install(TARGETS VkLayer_utils) endif() if(${CMAKE_CXX_COMPILER_ID} MATCHES "Clang") target_compile_options(VkLayer_utils PRIVATE -Wno-sign-conversion -Wno-implicit-int-conversion -Wno-enum-enum-conversion ) endif() # NOTE: LunarG/VulkanTools disables BUILD_LAYERS and BUILD_TESTS to minimize dependencies. if (NOT BUILD_LAYERS) return() endif() # Represents all SPIRV libraries we need add_library(VVL-SPIRV-LIBS INTERFACE) find_package(SPIRV-Headers REQUIRED CONFIG QUIET) target_link_libraries(VVL-SPIRV-LIBS INTERFACE SPIRV-Headers::SPIRV-Headers) find_package(SPIRV-Tools-opt REQUIRED CONFIG QUIET) target_link_libraries(VVL-SPIRV-LIBS INTERFACE SPIRV-Tools-opt) find_package(SPIRV-Tools REQUIRED CONFIG QUIET) # See https://github.com/KhronosGroup/SPIRV-Tools/issues/3909 for background on this. # The targets available from SPIRV-Tools change depending on how SPIRV_TOOLS_BUILD_STATIC is set. # Try to handle all possible combinations so that we work with externally built packages. if (TARGET SPIRV-Tools) target_link_libraries(VVL-SPIRV-LIBS INTERFACE SPIRV-Tools) elseif(TARGET SPIRV-Tools-static) target_link_libraries(VVL-SPIRV-LIBS INTERFACE SPIRV-Tools-static) elseif(TARGET SPIRV-Tools-shared) target_link_libraries(VVL-SPIRV-LIBS INTERFACE SPIRV-Tools-shared) else() message(FATAL_ERROR "Cannot determine SPIRV-Tools target name") endif() find_package(PythonInterp 3 QUIET) if (PYTHONINTERP_FOUND) # Get the include directory of the SPIRV-Headers get_target_property(SPIRV_HEADERS_INCLUDE_DIR SPIRV-Headers::SPIRV-Headers INTERFACE_INCLUDE_DIRECTORIES) set(spirv_unified_include_dir "${SPIRV_HEADERS_INCLUDE_DIR}/spirv/unified1/") if (NOT IS_DIRECTORY ${spirv_unified_include_dir}) message(FATAL_ERROR "Unable to find spirv/unified1") endif() set(generate_source_py "${VVL_SOURCE_DIR}/scripts/generate_source.py") if (NOT EXISTS ${generate_source_py}) message(FATAL_ERROR "Unable to find generate_source.py!") endif() add_custom_target(VulkanVL_generated_source COMMAND ${CMAKE_COMMAND} -E env PYTHONPATH=${VULKAN_HEADERS_REGISTRY_DIRECTORY} ${PYTHON_EXECUTABLE} ${generate_source_py} ${VULKAN_HEADERS_REGISTRY_DIRECTORY} ${spirv_unified_include_dir} --incremental --generated-version ${VulkanHeaders_VERSION} WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/generated ) else() message(NOTICE "VulkanVL_generated_source target requires python 3") endif() add_library(VkLayer_khronos_validation MODULE) target_sources(VkLayer_khronos_validation PRIVATE best_practices/best_practices_error_enums.h best_practices/best_practices_utils.cpp best_practices/best_practices_validation.h core_checks/android_validation.cpp core_checks/buffer_validation.cpp core_checks/cmd_buffer_dynamic_validation.cpp core_checks/cmd_buffer_validation.cpp core_checks/copy_blit_resolve_validation.cpp core_checks/core_validation.h core_checks/descriptor_validation.cpp core_checks/device_validation.cpp core_checks/device_memory_validation.cpp core_checks/drawdispatch_validation.cpp core_checks/external_object_validation.cpp core_checks/image_validation.cpp core_checks/image_layout_validation.cpp core_checks/pipeline_validation.cpp core_checks/query_validation.cpp core_checks/queue_validation.cpp core_checks/ray_tracing_validation.cpp core_checks/render_pass_validation.cpp core_checks/shader_validation.cpp core_checks/shader_validation.h core_checks/synchronization_validation.cpp core_checks/video_validation.cpp core_checks/wsi_validation.cpp generated/best_practices.cpp generated/best_practices.h generated/chassis.cpp generated/valid_param_values.cpp generated/command_validation.cpp generated/enum_flag_bits.h generated/layer_chassis_dispatch.cpp generated/object_tracker.cpp generated/object_tracker.h generated/parameter_validation.cpp generated/parameter_validation.h generated/spirv_grammar_helper.cpp generated/spirv_validation_helper.cpp generated/sync_validation_types.cpp generated/thread_safety.cpp generated/thread_safety.h generated/vk_safe_struct.cpp generated/vk_safe_struct.h gpu_validation/debug_printf.cpp gpu_validation/debug_printf.h gpu_validation/gpu_utils.cpp gpu_validation/gpu_utils.h gpu_validation/gpu_validation.cpp gpu_validation/gpu_validation.cpp gpu_validation/gpu_validation.h state_tracker/base_node.cpp state_tracker/base_node.h state_tracker/buffer_state.cpp state_tracker/buffer_state.h state_tracker/cmd_buffer_state.cpp state_tracker/cmd_buffer_state.h state_tracker/descriptor_sets.cpp state_tracker/descriptor_sets.h state_tracker/device_memory_state.cpp state_tracker/device_memory_state.h state_tracker/device_state.h state_tracker/image_layout_map.cpp state_tracker/image_layout_map.h state_tracker/image_state.cpp state_tracker/image_state.h state_tracker/pipeline_layout_state.cpp state_tracker/pipeline_layout_state.h state_tracker/pipeline_state.cpp state_tracker/pipeline_state.h state_tracker/pipeline_sub_state.cpp state_tracker/pipeline_sub_state.h state_tracker/query_state.h state_tracker/queue_state.cpp state_tracker/queue_state.h state_tracker/ray_tracing_state.h state_tracker/render_pass_state.cpp state_tracker/render_pass_state.h state_tracker/sampler_state.h state_tracker/shader_instruction.cpp state_tracker/shader_instruction.h state_tracker/shader_module.cpp state_tracker/shader_module.h state_tracker/state_tracker.cpp state_tracker/state_tracker.h state_tracker/video_session_state.cpp state_tracker/video_session_state.h stateless/parameter_validation_utils.cpp stateless/stateless_validation.h sync/sync_validation.cpp sync/sync_validation.h sync/sync_utils.cpp sync/sync_utils.h sync/sync_vuid_maps.cpp sync/sync_vuid_maps.h convert_to_renderpass2.cpp core_error_location.cpp core_error_location.h core_validation_error_enums.h layer_options.cpp object_lifetime_validation.h object_tracker_utils.cpp range_vector.h sparse_containers.h subresource_adapter.cpp subresource_adapter.h vk_layer_settings_ext.h ) if(MSVC) target_link_options(VkLayer_khronos_validation PRIVATE /DEF:${CMAKE_CURRENT_SOURCE_DIR}/VkLayer_khronos_validation.def) target_compile_options(VkLayer_khronos_validation PRIVATE /bigobj) elseif(MINGW) target_sources(VkLayer_khronos_validation PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/VkLayer_khronos_validation.def) target_compile_options(VkLayer_khronos_validation PRIVATE -Wa,-mbig-obj) elseif(APPLE) message(DEBUG "Functions are exported via VVL_EXPORT") set_target_properties(VkLayer_khronos_validation PROPERTIES SUFFIX ".dylib") elseif(ANDROID) message(DEBUG "Functions are exported via VVL_EXPORT") else() target_link_options(VkLayer_khronos_validation PRIVATE LINKER:--version-script=${CMAKE_CURRENT_SOURCE_DIR}/libVkLayer_khronos_validation.map,-Bsymbolic,--exclude-libs,ALL) endif() if(${CMAKE_CXX_COMPILER_ID} MATCHES "(GNU|Clang)") target_compile_options(VkLayer_khronos_validation PRIVATE -Wno-unused-parameter -Wno-missing-field-initializers ) if(CMAKE_CXX_COMPILER_ID MATCHES "Clang") target_compile_options(VkLayer_khronos_validation PRIVATE -Wno-sign-conversion -Wno-implicit-int-conversion -Wno-enum-enum-conversion ) endif() endif() # Khronos validation additional dependencies if (USE_ROBIN_HOOD_HASHING) target_link_libraries(VkLayer_khronos_validation PRIVATE robin_hood::robin_hood) endif() # Order matters here. VkLayer_utils should be the last link library to ensure mimalloc overrides are picked up correctly. # Otherwise, libraries after VkLayer_utils will not benefit from this performance improvement. target_link_libraries(VkLayer_khronos_validation PRIVATE VVL-SPIRV-LIBS VkLayer_utils) # Using mimalloc on non-Windows OSes currently results in unit test instability with some # OS version / driver combinations. On 32-bit systems, using mimalloc cause an increase in # the amount of virtual address space needed, which can also cause stability problems. if (MSVC AND CMAKE_SIZEOF_VOID_P EQUAL 8) find_package(mimalloc CONFIG) option(USE_MIMALLOC "Use mimalloc, a fast malloc/free replacement library" ${mimalloc_FOUND}) if (USE_MIMALLOC) target_compile_definitions(mimalloc-static INTERFACE USE_MIMALLOC) target_link_libraries(VkLayer_khronos_validation PRIVATE mimalloc-static) endif() endif() # There are 2 primary deliverables for the validation layers. # - The actual library VkLayer_khronos_validation.(dll|so|dylib) # - The respective json file, VkLayer_khronos_validation.json # This code generates the appropriate json for both local testing and the installation. # NOTE: For WIN32 the JSON and dll MUST be placed in the same location, due to Win32 using a relative path for installation. set(INPUT_FILE "${CMAKE_CURRENT_SOURCE_DIR}/VkLayer_khronos_validation.json.in") set(INTERMEDIATE_FILE "${CMAKE_CURRENT_BINARY_DIR}/json/validation.json") set(OUTPUT_FILE_FINAL_NAME "VkLayer_khronos_validation.json") set(LAYER_INSTALL_DIR ${CMAKE_INSTALL_LIBDIR}) if (WIN32) set(LAYER_INSTALL_DIR ${CMAKE_INSTALL_BINDIR}) # WIN32/MINGW expect the dll in the `bin` dir, this matches our WIN32 SDK process endif() if (WIN32) set(JSON_LIBRARY_PATH ".\\\\VkLayer_khronos_validation.dll") elseif(APPLE) set(JSON_LIBRARY_PATH "./libVkLayer_khronos_validation.dylib") else() set(JSON_LIBRARY_PATH "./libVkLayer_khronos_validation.so") endif() configure_file(${INPUT_FILE} ${INTERMEDIATE_FILE} @ONLY) # To support both multi/single configuration generators just copy the json to the correct directory add_custom_command(TARGET VkLayer_khronos_validation POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different ${INTERMEDIATE_FILE} $/${OUTPUT_FILE_FINAL_NAME} ) # For UNIX-based systems, `library_path` should not contain a relative path (indicated by "./") before installing to system directories # This json isn't used for regular local development, it's used for installation if (UNIX) set(UNIX_INTERMEDIATE_FILE "${CMAKE_CURRENT_BINARY_DIR}/json/unix_install_validation.json") if(APPLE) set(JSON_LIBRARY_PATH "libVkLayer_khronos_validation.dylib") else() set(JSON_LIBRARY_PATH "libVkLayer_khronos_validation.so") endif() configure_file(${INPUT_FILE} ${UNIX_INTERMEDIATE_FILE} @ONLY) install(FILES ${UNIX_INTERMEDIATE_FILE} DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/vulkan/explicit_layer.d RENAME ${OUTPUT_FILE_FINAL_NAME}) endif() if (WIN32) install(FILES ${INTERMEDIATE_FILE} DESTINATION ${LAYER_INSTALL_DIR} RENAME ${OUTPUT_FILE_FINAL_NAME}) endif() if (MSVC) install(FILES $ DESTINATION ${LAYER_INSTALL_DIR}) endif() install(TARGETS VkLayer_khronos_validation DESTINATION ${LAYER_INSTALL_DIR})