Starting your application using the GPU PerfClient

The GPU PerfClient can be used to start a local debug session very simply using a just a few mouse clicks.

Please note that technique only works for local debug sessions. For remote debugging sessions your application must be started with the GPU PerfServer using manual methods. (see: Starting your application manually with the GPU PerfServer)

1) Start the GPU PerfClient.exe program

ClientStart1.png

2) Click the blue connect button.

Connect.png

3) This will open the GPU PerfStudio Session Settings dialog. To run a local debug session the "Local" radio button must be selected. The Local Session Settings can be used to configure the target application, its arguments, working directory, the bitness of the application, and the GPU PerfServer options.

The Port number of the local server can also be specified using the Port text entry box. The port number defaults to 80 in the client and server settings. NOTE: if you change the server port option then the same port number should be used in this client dialog so that they match. For more details on port usage see: Port Usage .

Some applications are started via loaders or launchers. GPU PerfStudio has the ability to process-hop over the launcher and into the application. It is important that the server used has the same bitness as the target application to be analyzed. For example, if a 64-bit application is to be analyzed and it is started via a 32-bit launcher, the 32-bit launcher should be started with the 64-bit server.

Click Next at the bottom of the dialog when done.

ClientStart2.png

4) This will open the General settings dialog that allows you more control over how a frame is captured. The default settings work with most applications.

Click Connect at the bottom of the dialog when done.

ClientStart2-part2.png

5) The GPU PerfClient will start your application with the GPU PerfStudio server and the GPU PerfServer console window will appear.

ClientStart3.png

Your application will startup.

ClientStart5.png

The API Selection window will also appear (it may be behind your applications window).

ClientStart4.png

The API Selection window should disappear and the GPU PerfClient window should appear as follows with an active Pause button. GPU PerfStudio is now connected to your application and you are ready to start debugging. Your application is still running and you can now navigate to the part you wish to debug. See the following section on how to use GPU PerfStudio to capture and debug a frame (Using Frame Capture).

ClientStart6.png