Preparation

1. Open VS Code in a parent directory of the shader.
2. Open the shader in VS Code.
3. If you define the root signature in HLSL, make sure that the [RootSignature()] attribute appears just above your shader. For more information about how root signatures can be defined, see here.
4. If you are compiling a graphics pipeline, make sure to have the gpso file available. This defines a subset of the D3D12 graphics pipeline, read more here. Note: it may be easier to copy the filename (including the path) to the clipboard.
5. Select the vertex shader entry point of the pipeline. Only the function name is necessary.
6. Press Alt (or use some other form of multi-select) while selecting the pixel shader entry point of your pipeline.

Build Configuration

1. Open the command palette of VS Code with Ctrl+Shift+P.
2. Enter the command Call RGA: DX12 .
3. Choose the preferred target architecture. For Radeon RX 5700 XT this would be gfx1010. Call rga.exe directly to show the full list of supported ASICs.
4. Select the shader type of the first entry point. In this case this would be vs for VSMain .
5. Do the same for the second entry point, and so on.
6. Choose the preferred shader profile from the drop down. For instance – 6_0 for Shader Model 6.0.
7. Type in the path to the gpso file, or paste it from the clipboard, or choose from the list of recent paths.
8. Type in any custom arguments. If the [RootSignature()] is defined in binary form, add the --rs-bin argument followed by the absolute path here. This is also the stage for adding any arbitrary command that RGA supports.
9. If the shader compiles successfully, the resulting AMD IL and AMD GCN/RDNA ISA disassembly will open in separate views.

All output is redirected to the terminal. That means error messages can be checked there, as well as the constructed command used to call RGA.

The shader can be changed as required. Pressing F7 (default) will run the last command again.

Hints and Tips

RGA Options

Searching for ‘RGA’ under VS Code settings provides more options for customizing the behavior. Some of these options include:

• Configuring the command string. For some users, it might be preferable to continuously override a single root signature binary file that resides under c:\vs_code\rs\rga.fx.rs instead of copying different paths to the clipboard.
• ‘Rga > View Column: Isa’ for controlling the editor column the ISA shows up in.

• Syntax Highlighting

  To add syntax highlighting for “AMD GCN ISA” (also works for RDNA):

  1. Install the GCN VS Code extension from the marketplace.

2. Add a editor.tokenColorCustomizations field to your theme settings. Access this file ( settings.json ) by:

• • Go to the VS Code settings (‘File->Preferences->Settings’)
  • At the top right of the settings window, there are three icons. Select the left one highlighted in a circle here:

3. To separate the additional new entry from the previous entry (which may be the path setting) use a comma.

4. The code to add is as follows:

"editor.tokenColorCustomizations": {
    "textMateRules": [
            {
                "scope": "storage.type.amd-gcn-isa",
                "settings": {
                    "foreground": "#CC3333"
                }
            },
            {
                "scope": "keyword.vector.amd-gcn-isa",
                "settings": {
                    "foreground": "#33CCCC"
                }
            },
            {
                "scope": "keyword.scalar.amd-gcn-isa",
                "settings": {
                    "foreground": "#CC33CC"
                }
            },
            {
                "scope": "support.variable.vector.amd-gcn-isa",
                "settings": {
                    "foreground": "#CCCC33"
                }
            },
            {
                "scope": "support.variable.scalar.amd-gcn-isa",
                "settings": {
                    "foreground": "#6495ED"
                }
            },
            {
                "scope": "keyword.control.label.amd-gcn-isa",
                "settings": {
                    "foreground": "#33CC33"
                }
            }
        ]
    }