This project is read-only.

Visual Debugging Tool for Goblin XNA

Coordinator
Mar 5, 2009 at 11:27 PM
Edited Mar 5, 2009 at 11:47 PM
We proudly announce that we're releasing a visual debugging tool (SceneGraphDisplay) for Goblin XNA today. It helps you visualize the scene graph structure as well as the property values of a selected node in the scene graph. 


GoblinXNA scene graph tool


The followings are the features of this tool:


 

  1. The tool is a Windows Form which contains two tabs and one data grid table. The first tab contains a tree view of the scene graph and the second tab contains a graphical view of the scene graph.<o:p></o:p>
  2. Both the tree view and the graphical view are synchronized. All the various nodes of the scene graph are added as nodes in both the tree view and the graphical view. If there is any change in the scene graph of the application, then corresponding changes in the tree view and graphical view are immediately shown (with a maximum delay of 100 milliseconds)<o:p></o:p>
  3. Tree View:<o:p></o:p>
    1. Clicking on a node in the tree view – All properties of the corresponding scene graph node get enumerated in the ‘Properties’ data grid table. The selected node is highlighted. <o:p></o:p>
    2. If the selected node is a geometry node – then the corresponding object in the application gets highlighted (a bounding box is drawn around all the objects contained within the selected geometry node). The currently selected geometry node is highlighted with a blue background color. <o:p></o:p>
    3. If a particular geometry node is outside the current camera bounding frustum (out of view), then it is highlighted with a red background color. <o:p></o:p>
  4. Graphical View:<o:p></o:p>
    1. It contains both an enlarged view and a small graphical view of the SceneGraph. <o:p></o:p>
    2. Clicking on any nodes either in the enlarged view or the small graphical view, highlights the corresponding node (a black filled rectangle is drawn behind the node circle) and all the properties of the corresponding scene graph node get enumerated in the ‘Properties’ data grid table.<o:p></o:p>
    3. If the selected node is a geometry node – then the corresponding object in the application gets highlighted<o:p></o:p>
    4. If a particular geometry node is outside the current camera bounding frustum (out of view), then the corresponding node circle is colored red.<o:p></o:p>
    5. In the smaller panel (if the graphical hierarchy does not fit into the panel), scroll bars are provided for navigation. In the enlarged view, mouse drag can be used to move the display area in any directions. <o:p></o:p>
    6. Zoom Track slider is provided next to the small panel. There are five levels of zoom. The zoom control is for both the small panel and the enlarged panel. <o:p></o:p>
    7. A small legend is drawn in the right hand corner of the Graphical Display tab, showing the mapping of node colors to the scene graph node types. <o:p></o:p>
  5. Picking an object from the application screen: Clicking on a particular object in the main application screen will highlight the corresponding node in the tree view as well as the graphical view with blue color. Also a bounding box is drawn around the picked object in the application screen.
  6. Properties DataGrid Table: The properties table enumerates all the property values for the selected node. Some complex objects such as Model, Network are just listed with the class names as the values. Right clicking on such complex object rows, will show a popup menu “Click here for detailed information”. On clicking this button, the complex object property values are filled up in the DataGrid table. To return to the property values of the currently selected node, a back button is provided on the upper right corner above the table.



Please see the user manual regarding the instructions on how to use this tool with your Goblin XNA application.

Thanks for Nikhil Ramesh (nikutopian@hotmail.com) for developing this great tool!!