From 58496f9f8ab7274b1f9623c8a2f902b7d244c03e Mon Sep 17 00:00:00 2001
From: Davis King <davis@dlib.net>
Date: Fri, 20 May 2016 08:29:39 -0400
Subject: [PATCH] Added Johannes Huber's natvis file for visual studio.

---
 tools/visual_studio_natvis/README.txt  | 12 ++++++
 tools/visual_studio_natvis/dlib.natvis | 51 ++++++++++++++++++++++++++
 2 files changed, 63 insertions(+)
 create mode 100644 tools/visual_studio_natvis/README.txt
 create mode 100644 tools/visual_studio_natvis/dlib.natvis

diff --git a/tools/visual_studio_natvis/README.txt b/tools/visual_studio_natvis/README.txt
new file mode 100644
index 000000000..f766ac0c1
--- /dev/null
+++ b/tools/visual_studio_natvis/README.txt
@@ -0,0 +1,12 @@
+Hi Davis,
+thanks for your work on dlib!
+ 
+I have created a natvis file to have nicer debugger visualization of dlib matrices in Visual Studio (2012 - …) and I just wanted to share it with you.
+ 
+To test it, copy the file into you folder  %USERPROFILE%\My Documents\Visual Studio 2015\Visualizers or %VSINSTALLDIR%\Common7\Packages\Debugger\Visualizers as described here https://msdn.microsoft.com/en-us/library/jj620914.aspx
+ 
+It’s certainly extendable, especially to include it into image watch, but currently it may help users to debug much faster.
+ 
+Feel free to share it.
+Best,
+    Johannes Huber
diff --git a/tools/visual_studio_natvis/dlib.natvis b/tools/visual_studio_natvis/dlib.natvis
new file mode 100644
index 000000000..0c1c52060
--- /dev/null
+++ b/tools/visual_studio_natvis/dlib.natvis
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<AutoVisualizer xmlns="http://schemas.microsoft.com/vstudio/debugger/natvis/2010">
+  <!-- dlib matrix debugger visualization in Visual Studio-->
+  <!-- Johannes Huber, SAFEmine Part of Hexagon -->
+  <!-- no warranty -->
+
+  <!-- general dlib::matrix fixed size-->
+   <Type Name="dlib::matrix&lt;*,*,*,*&gt;">
+   <DisplayString>{{ size= &lt;{$T2}&gt; x &lt;{$T3}&gt; }}</DisplayString>
+   <Expand>
+      <ArrayItems>
+         <Size>$T2 * $T3</Size>
+         <ValuePointer>($T1*)data.data</ValuePointer>
+      </ArrayItems>
+   </Expand>
+  </Type>
+
+  <!-- general dlib::matrix fixed rows-->
+  <Type Name="dlib::matrix&lt;*,0,*,*&gt;">
+   <DisplayString>{{ size={data.nr_} x &lt;{$T2}&gt; }}</DisplayString>
+   <Expand>
+      <ArrayItems Condition="data.data != 0">
+         <Size>data.nr_ * $T2</Size>
+         <ValuePointer>($T1*)data.data</ValuePointer>
+      </ArrayItems>
+   </Expand>
+  </Type>
+
+  <!-- general dlib::matrix fixed cols-->
+  <Type Name="dlib::matrix&lt;*,*,0,*&gt;">
+   <DisplayString>{{ size= &lt;{$T2}&gt; x {data.nc_} }}</DisplayString>
+   <Expand>
+      <ArrayItems Condition="data.data != 0">
+         <Size>$T2 * data.nc_</Size>
+         <ValuePointer>($T1*)data.data</ValuePointer>
+      </ArrayItems>
+   </Expand>
+  </Type>
+
+  <!-- general dlib::matrix dynamic size-->
+  <Type Name="dlib::matrix&lt;*,0,0,*&gt;">
+   <DisplayString>{{ size= {data.nc_} x {data.nc_} }}</DisplayString>
+   <Expand>
+      <ArrayItems Condition="data.data != 0">
+         <Size>data.nr_*data.nc_</Size>
+         <ValuePointer>($T1*)data.data</ValuePointer>
+      </ArrayItems>
+   </Expand>
+  </Type>
+
+</AutoVisualizer>
\ No newline at end of file