File: how_rgp_profile.rst

package info (click to toggle)
renderdoc 1.24%2Bdfsg-1%2Bdeb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 105,156 kB
  • sloc: cpp: 759,405; ansic: 309,460; python: 26,606; xml: 22,599; java: 11,365; cs: 7,181; makefile: 6,707; yacc: 5,682; ruby: 4,648; perl: 3,461; sh: 2,354; php: 2,119; lisp: 1,835; javascript: 1,524; tcl: 1,068; ml: 747
file content (48 lines) | stat: -rw-r--r-- 2,505 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
How do I generate an RGP profile?
=================================

RenderDoc has integration with AMD's Radeon GPU Profiler. This allows you to generate an RGP profile from a RenderDoc capture, embed the profile in the capture file, and synchronise the view of the frames between RenderDoc and RGP.

Enabling RGP integration
------------------------

By default the RGP integration is disabled. To enable it go to the :guilabel:`Settings` window and in the :guilabel:`Core` section enable :guilabel:`Enable Radeon GPU Profiler integration`.

Generating a profile
--------------------

To begin you will need to go to the :guilabel:`Tools` menu and select :guilabel:`Create new RGP Profile`. If this menu option isn't available, you need to have the latest AMD drivers installed on your machine.

Selecting this menu item will open a small popup and spend a few second creating the profile itself. After the profile is created, the RGP profiling tool will automatically open up.

.. note::

    If you haven't configured the path to the RGP tool, you will be prompted to here. Once the path has been configured successfully the tool will open.

Opening a previously created profile
------------------------------------

After generating a profile above, the RGP data is embedded in the ``.rdc`` file.

Since RGP can open a profile on any machine without needing AMD drivers or hardware, this embedded RGP profile can be opened at any time by going to the :guilabel:`Tools` menu and select :guilabel:`Open RGP Profile`.

The RGP tool will open just the same as if the profile was newly created.

Correlating information between RenderDoc and RGP
-------------------------------------------------

If using RGP version 1.2 or higher, once both tools are open they have a synchronised view of the underlying data.

This means that within RGP you can select an event, right click and choose :guilabel:`Select RenderDoc Event`. This will bring RenderDoc to the foreground with the event selected. Similarly in RenderDoc you can right-click on an event in the event browser and choose :guilabel:`Select RGP Event` which will perform the same operation in reverse.

.. figure:: ../imgs/Screenshots/SelectRGPEvent.png

	Select an RGP event from RenderDoc

.. figure:: ../imgs/Screenshots/SelectRenderDocEvent.png

	Select a RenderDoc event from RGP

.. note::

    Since RGP and RenderDoc have different scopes, purposes, and views of the frame the numbering of events will not be the same between the two tools.