ENH: Add Visual Studio specific debug helpers to ITKCommon project

Starting in Visual Studio 2022 version 17.6, copying these files
to VS installation directory will no longer be required.
Natvis has been supported for longer, including all
currently supported Visual Studio versions.

Author: dzenanz

Modules/Core/Common/src/CMakeLists.txt

@@ -278,3 +278,43 @@ if(ITK_USE_TBB)
   #      Define TBB_USE_CAPTURED_EXCEPTION=0 to request rethrow of the exact exception.
   target_compile_definitions(ITKCommon PUBLIC TBB_USE_CAPTURED_EXCEPTION=0)
 endif()
+
+if(MSVC)
+  set(ITK_NATVIS_FILE "${ITK_SOURCE_DIR}/Utilities/Debugger/ITK.natvis")
+  if(CMAKE_GENERATOR MATCHES "Ninja")
+    # Ninja/Makefiles Generator support (embeds directly inside the executable's PDB)
+    target_link_options(
+      ITKCommon
+      INTERFACE
+        "$<BUILD_INTERFACE:/NATVIS:${ITK_NATVIS_FILE}>"
+        "$<INSTALL_INTERFACE:/NATVIS:${ITK_INSTALL_DATA_DIR}/Debugger/ITK.natvis>"
+    )
+    # Force Ninja to re-link if the .natvis file changes
+    set_property(
+      TARGET
+        ITKCommon
+      APPEND
+      PROPERTY
+        LINK_DEPENDS
+          "${ITK_NATVIS_FILE}"
+    )
+  else()
+    # Visual Studio Generator support (shows up in the Solution Explorer)
+    target_sources(
+      ITKCommon
+      INTERFACE
+        "$<BUILD_INTERFACE:${ITK_NATVIS_FILE}>"
+        "$<BUILD_INTERFACE:${ITK_SOURCE_DIR}/Utilities/Debugger/ITK.natstepfilter>"
+        "$<INSTALL_INTERFACE:${ITK_INSTALL_DATA_DIR}/Debugger/ITK.natvis>"
+        "$<INSTALL_INTERFACE:${ITK_INSTALL_DATA_DIR}/Debugger/ITK.natstepfilter>"
+    )
+  endif()
+
+  install(
+    FILES
+      "${ITK_NATVIS_FILE}"
+      "${ITK_SOURCE_DIR}/Utilities/Debugger/ITK.natstepfilter"
+    DESTINATION ${ITK_INSTALL_DATA_DIR}/Debugger
+    COMPONENT Development
+  )
+endif()

Utilities/Debugger/ITK.natstepfilter

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Documentation: https://learn.microsoft.com/en-us/visualstudio/debugger/just-my-code?view=visualstudio -->
+<StepFilter xmlns="http://schemas.microsoft.com/vstudio/debugger/natstepfilter/2010">
+  <Function><Name>itk::SmartPointer.*</Name><Action>NoStepInto</Action></Function>
+  <Function><Name>itk::Object::Register</Name><Action>NoStepInto</Action></Function>
+  <Function><Name>vtkSmartPointer.*</Name><Action>NoStepInto</Action></Function>
+  <!-- We can also disable stepping into STL functions by uncommeting the next line: -->
+  <!-- <Function><Name>std::.+</Name><Action>NoStepInto</Action></Function> -->
+</StepFilter>

Utilities/Debugger/ITK.natvis

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8" ?>
-<!-- Documentation: https://msdn.microsoft.com/en-us/library/jj620914.aspx?f=255&MSPPError=-2147217396 -->
-<!-- e.g. copy into C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\Packages\Debugger\Visualizers\ITK.natvis -->
+<!-- Documentation: https://learn.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2015/debugger/create-custom-views-of-native-objects?view=vs-2015 -->
 <AutoVisualizer xmlns="http://schemas.microsoft.com/vstudio/debugger/natvis/2010">
 
   <Type Name="itk::Size&lt;1&gt;">