Home | History | Annotate | Download | only in layers
      1 ################################################################################
      2 #
      3 #  This file contains per-layer settings that configure layer behavior at
      4 #  execution time. Comments in this file are denoted with the "#" char.
      5 #  Settings lines are of the form:
      6 #      "<LayerIdentifier>.<SettingName> = <SettingValue>"
      7 #
      8 #  <LayerIdentifier> is typically the official layer name, minus the VK_LAYER
      9 #  prefix and all lower-camel-case -- i.e., for VK_LAYER_LUNARG_core_validation,
     10 #  the layer identifier is 'lunarg_core_validation', and for
     11 #  VK_LAYER_GOOGLE_threading the layeridentifier is 'google_threading'.
     12 #
     13 ################################################################################
     14 ################################################################################
     15 # Validation Layer Common Settings:
     16 # =================================
     17 #
     18 #   DEBUG_ACTION:
     19 #   =============
     20 #   <LayerIdentifier>.debug_action : This is an enum value indicating what
     21 #    action is to be taken when a layer wants to report information.
     22 #    Possible settings values are defined in the vk_layer.h header file.
     23 #    These settings are:
     24 #    VK_DBG_LAYER_ACTION_IGNORE - Take no action.
     25 #    VK_DBG_LAYER_ACTION_LOG_MSG - Log a txt message to stdout or to a log filename
     26 #       specified via the <LayerIdentifier>.log_filename setting (see below).
     27 #    VK_DBG_LAYER_ACTION_CALLBACK - Call user defined callback function(s) that
     28 #       have been registered via the VK_EXT_debug_report extension. Since
     29 #       app must register callback, this is a NOOP for the settings file.
     30 #    VK_DBG_LAYER_DEBUG_OUTPUT [Windows only] - Log a txt message using the
     31 #       Windows OutputDebugString function -- messages will show up in the
     32 #       Visual Studio output window, for instance.
     33 #    VK_DBG_LAYER_ACTION_BREAK - Trigger a breakpoint.
     34 #
     35 #   REPORT_FLAGS:
     36 #   =============
     37 #   <LayerIdentifier>.report_flags : This is a comma-delineated list of options
     38 #    telling the layer what types of messages it should report back.
     39 #    Options are:
     40 #    info - Report informational messages.
     41 #    warn - Report warnings from using the API in a manner which may lead to
     42 #           undefined behavior or to warn the user of common trouble spots.
     43 #           A warning does NOT necessarily signify illegal application behavior.
     44 #    perf - Report using the API in a way that may cause suboptimal performance.
     45 #    error - Report errors in API usage.
     46 #    debug - For layer development. Report messages for debugging layer
     47 #            behavior.
     48 #
     49 #   LOG_FILENAME:
     50 #   =============
     51 #   <LayerIdentifier>.log_filename : output filename. Can be relative to
     52 #      location of vk_layer_settings.txt file, or an absolute path. If no
     53 #      filename is specified or if filename has invalid path, then stdout
     54 #      is used by default.
     55 #
     56 
     57 # VK_LAYER_LUNARG_core_validation Settings
     58 lunarg_core_validation.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
     59 lunarg_core_validation.report_flags = error,warn,perf
     60 lunarg_core_validation.log_filename = stdout
     61 
     62 # VK_LAYER_LUNARG_image Settings
     63 lunarg_image.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
     64 lunarg_image.report_flags = error,warn,perf
     65 lunarg_image.log_filename = stdout
     66 
     67 # VK_LAYER_LUNARG_object_tracker Settings
     68 lunarg_object_tracker.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
     69 lunarg_object_tracker.report_flags = error,warn,perf
     70 lunarg_object_tracker.log_filename = stdout
     71 
     72 # VK_LAYER_LUNARG_parameter_validation Settings
     73 lunarg_parameter_validation.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
     74 lunarg_parameter_validation.report_flags = error,warn,perf
     75 lunarg_parameter_validation.log_filename = stdout
     76 
     77 # VK_LAYER_LUNARG_swapchain Settings
     78 lunarg_swapchain.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
     79 lunarg_swapchain.report_flags = error,warn,perf
     80 lunarg_swapchain.log_filename = stdout
     81 
     82 # VK_LAYER_GOOGLE_threading Settings
     83 google_threading.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
     84 google_threading.report_flags = error,warn,perf
     85 google_threading.log_filename = stdout
     86 
     87 # VK_LAYER_GOOGLE_unique_objects Settings
     88 google_unique_objects.debug_action = VK_DBG_LAYER_ACTION_LOG_MSG
     89 google_unique_objects.report_flags = error,warn,perf
     90 google_unique_objects.log_filename = stdout
     91 ################################################################################
     92