{"id":543,"date":"2014-06-12T14:59:00","date_gmt":"2014-06-12T14:59:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/vcblog\/2014\/06\/12\/project-support-for-natvis\/"},"modified":"2021-10-11T14:30:32","modified_gmt":"2021-10-11T14:30:32","slug":"project-support-for-natvis","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/project-support-for-natvis\/","title":{"rendered":"Project Support for Natvis"},"content":{"rendered":"

The past two releases of Visual Studio have evolved the Natvis format to allow developers to easily visualize their debug data inside the VC++ expression evaluator.  The first Visual Studio “14” CTP provides a new way for native developers to consume and manage their Natvis debug visualizers.  In response to <\/span>requests<\/a> from Visual Studio developers, these files can now be added to a VC++ project which enables easier tracking and integration with source control.  Special thanks to C++ MVP Marius Bancila for sharing the Natvis project integration <\/span>on his blog<\/a>! <\/span><\/p>\n

 <\/p>\n

Adding a Visualizer to a Project<\/strong><\/span><\/p>\n

Existing .natvis files can be easily added to a project using the “Add Existing Item…” option and navigating to their location.<\/p>\n

\"Image<\/a><\/p>\n

\"Image<\/a><\/p>\n

In the image below, Volcanoes.natvis<\/em> has been added to the project and is shown in the Solution Explorer. <\/span>\n\"Image<\/a>\n<\/p>\n

Natvis files from the project will be evaluated by the debugger after all other directories<\/a>, allowing an existing visualizer to be overridden by a custom .natvis file inside the project.<\/p>\n

Note: The CTP does not have a new item template for a blank .natvis file, however this will be available in the next release of Visual Studio along with a file icon for Natvis.<\/p>\n

 <\/p>\n

Live Editing While Debugging<\/strong><\/span><\/p>\n

Another improvement that we made for the first CTP is that the debugger no longer needs to be stopped to pick up the changes.  The animation below demonstrates the live editing of Volcanoes.natvis<\/em> while debugging the program. Visualization code is pasted into the .natvis file and then saved during the debugging session. Notice how the value for volcanoesOfWashington<\/em> turns red<\/span> to indicate that the saved changes in the visualizer have been picked up by the debugger:<\/p>\n

\"Image<\/a><\/p>\n

For more details on writing .natvis debug visualizers, consult these blog posts:<\/p>\n