About:
------

RenderDoc is a debugger for graphics APIs, currently supporting OpenGL
and Vulkan.

The directory structure in the package matches how it should be
installed, most commonly under /usr but this is up to you.

After installation if you'd like to register the desktop files like
thumbnailer, shortcut, icons, etc, you'll need something along the lines
of these commands as root:

# update-desktop-database
# update-menus
# update-mime-database /usr/share/mime/
# gtk-update-icon-cache /usr/share/icons/hicolor/

Documentation is available online at https://renderdoc.org/docs and more
information in general is available on the github repository and wiki -
https://github.com/baldurk/renderdoc


Requirements:
-------------

* libxcb
* libX11
* libX11-xcb
* libGL

These should be available on any system with X installed. You can always
build RenderDoc yourself from source. For more information, github.

To run qrenderdoc, Qt is statically linked but additional system
libraries are needed:

* libstdc++ >= 6.0.21 (from GCC 5.x)
* libfontconfig1 >= 2.11.0
* libfreetype6 >= 2.4.8
* libproxy >= 0.4.7

If you get errors on run about missing GLIBCXX symbols then you likely
haven't met the libstdc++ requirement and will need to either find a
package in your distribution to install gcc 5.x, or else compile
RenderDoc from source (though you will still need gcc-5 to compile).

Vulkan Layer registration:
--------------------------

RenderDoc cannot capture Vulkan when run from binary without any
installation. Any installed package from a distribution or otherwise is
expected to have registered the Vulkan layer as appropriate, but if you
are running binaries loose then the renderdoccmd utility will prompt you
to register the layer. This involves placing an appropriate .json file
under $HOME/.local/vulkan, or optionally in /etc if desired (and if the
tool is run with appropriate permissions).


Reporting bugs:
---------------

Bugs should be reported directly via email to Arm Ltd <developer@arm.com>.
