Layout Management

The pipeline stage view allows you quickly load a layout that is customized to show data specific to a given stage of the graphics pipeline.

The pipeline stage view also allows you do to the following:

Using the Pipeline Stage View

The pipeline stage view supports a set of layouts for each graphics API supported by GPU PerfStudio. There is one layout for each stage of the graphics pipeline, as well as four user-defined layouts.

When you first open the Frame Debugger, the default layout for the current API is automatically loaded. You can load the layout for any pipeline stage by clicking on that stage. When you select a stage, the existing layout is closed and the layout associated with the selected stage is loaded. The pipeline stage view indicates which stage is loaded by highlighting the background of the stage. When a layout is loaded, the windows contained in the layout are fixed -- you can not close or move a window, nor can you open additional windows. You must choose to edit a layout before you can modify it.

The following image shows the pipeline stage view with the DX11 PS stage selected, and the frame debugger with the DX11 PS layout loaded:

StageView_DX11_PS.png

You can manage the layouts using the context menu that appears when right clicking on a particular stage. The context menu is slightly different depending on whether you right click on a pipeline stage or a user-defined layout. The following image shows the context menu that appears when right clicking on a pipeline stage:

StageView_DX11_PS_Menu.png

The following image shows the context menu that appears when right clicking on a user layout:

StageView_DX11_User_Menu.png

Editing a Layout

When you choose to edit a layout, the selected layout is placed in Edit mode. This following image shows a layout in Edit mode:

StageView_DX11_Edit_Mode.png

In Edit mode, you can open additional windows using the command tree on the left hand side. You can also close, resize, or reposition any open windows within the layout. To save changes made to a layout, click the "Save Layout" button located above the command tree. To discard any changes made and exit Edit mode, click the "Cancel" button located above the command tree.

Using the Resources Viewer

The Resources Viewer allows the user to select a set of image resources that they want to display in a thumbnail viewer. The user can select which images to include in the viewer by clicking on the "Select Resources" button. A dialog window is presented allowing the user to select image data from the various pipeline stages. The resources viewer contains a larger image viewer in which the individual thumbnails can be displayed at higher resolution. A single click on a thumbnail image will open it in the larger window. A double click on the thumbnail image or the larger image will open the image in an even larger modal dialog. NOTE: the user can undock the larger image window and dock it separately from the thumbnail view.

The "Show Descriptions" checkbox controls if basic information about the resource is shown alongside each thumbnail image.

ResourcesEdit2.png

Using the properties Viewer

GPU PerfStudio ships with default layouts that include a properties window to display text based data. The properties window in each layout has been customized to show data from the stage that the layout is associated with. For example, clicking on the DX11 PS stage will show a properties window that contains sampler information, shader linkage, and the output merger render states.

PropertiesWindow1.png

Each of the data items can be displayed by using the pull down menu at the top of the property window.

PropertiesWindow2.png

The contents of the properties window can be edited to show data items from any stage of the pipeline if the user requires this. To customize the properties data selection right click on the stage you wish to edit to go into edit mode. A new button called "Select Properties" will appear at the top of the properties window. Click this button to bring up the "Select Properties" dialog and select the data items you want to appear. Click the Save Layout button in the stage tree to save your edits and go back to user mode.

PropertiesWindowEdit.png