文本文件  |  88行  |  3.83 KB

# This is an example vk_layer_settings.txt file.
#  This file allows for per-layer settings which can dynamically affect layer
#  behavior. Comments in this file are denoted with the "#" char.
#  Settings lines are of the form "<LayerIdentifier>.<SettingName> = <SettingValue>"
#
#  <LayerIdentifier> is typically the official layer name, minus the VK_LAYER prefix
#  and all lower-camel-case -- i.e., for VK_LAYER_LUNARG_core_validation, the layer
#  identifier is 'lunarg_core_validation', and for VK_LAYER_GOOGLE_threading the layer
#  identifier is 'google_threading'.
#
#  There are some common settings that are used by each layer.
#  Below is a general description of three common settings, followed by
#  actual template settings for each layer in the SDK.
#
# Common settings descriptions:
# =============================
#
#   DEBUG_ACTION:
#   =============
#   <LayerIdentifier>.debug_action : This is an enum value indicating what action is to
#    be taken when a layer wants to report information. Possible settings values
#    are defined in the vk_layer.h header file. These settings are:
#    VK_DBG_LAYER_ACTION_IGNORE - Take no action
#    VK_DBG_LAYER_ACTION_LOG_MSG - Log a txt message to stdout or to a log file
#       specified via the <LayerIdentifier>.log_filename setting (see below)
#    VK_DBG_LAYER_ACTION_CALLBACK - Call user defined callback function(s) that
#       have been registered via the VK_EXT_LUNARG_debug_report extension. Since
#       app must register callback, this is a NOOP for the settings file.
#    VK_DBG_LAYER_ACTION_BREAK - Trigger a breakpoint.
#
#   REPORT_FLAGS:
#   =============
#   <LayerIdentifier>.report_flags : This is a comma-delineated list of options telling
#    the layer what types of messages it should report back. Options are:
#    info - Report informational messages
#    warn - Report warnings of using the API in an unrecommended manner which may
#       also lead to undefined behavior
#    perf - Report using the API in a way that may cause suboptimal performance
#    error - Report errors in API usage
#    debug - For layer development. Report messages for debugging layer behavior
#
#   LOG_FILENAME:
#   =============
#   <LayerIdentifier>.log_filename : output filename. Can be relative to location of
#      vk_layer_settings.txt file, or an absolute path. If no filename is
#      specified or if filename has invalid path, then stdout is used by default.
#
#
#
# Example of actual settings for each layer:
# ==========================================
#
# VK_LAYER_LUNARG_device_limits Settings
lunarg_device_limits.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
lunarg_device_limits.report_flags = error,warn,perf
lunarg_device_limits.log_filename = stdout

# VK_LAYER_LUNARG_core_validation Settings
lunarg_core_validation.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
lunarg_core_validation.report_flags = error,warn,perf
lunarg_core_validation.log_filename = stdout

# VK_LAYER_LUNARG_image Settings
lunarg_image.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
lunarg_image.report_flags = error,warn,perf
lunarg_image.log_filename = stdout

# VK_LAYER_LUNARG_object_tracker Settings
lunarg_object_tracker.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
lunarg_object_tracker.report_flags = error,warn,perf
lunarg_object_tracker.log_filename = stdout

# VK_LAYER_LUNARG_parameter_validation Settings
lunarg_parameter_validation.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
lunarg_parameter_validation.report_flags = error,warn,perf
lunarg_parameter_validation.log_filename = stdout

# VK_LAYER_LUNARG_swapchain Settings
lunarg_swapchain.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
lunarg_swapchain.report_flags = error,warn,perf
lunarg_swapchain.log_filename = stdout

# VK_LAYER_GOOGLE_threading Settings
google_threading.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
google_threading.report_flags = error,warn,perf
google_threading.log_filename = stdout