mirror of
https://github.com/baldurk/renderdoc.git
synced 2026-05-04 17:10:47 +00:00
baldurk
8890233fe0
* Without this, the chm viewer attempts to open the external link in its own windows. With some ancient IE6 monstrosity. Ouch.
91 lines
4.6 KiB
ReStructuredText
91 lines
4.6 KiB
ReStructuredText
Introduction
|
|
============
|
|
|
|
.. |builds_link| raw:: html
|
|
|
|
<a href="https://renderdoc.org/builds" target="_blank">Builds page</a>
|
|
|
|
.. |github_link| raw:: html
|
|
|
|
<a href="https://github.com/baldurk/renderdoc" target="_blank">GitHub repository</a>
|
|
|
|
.. |github_wiki_link| raw:: html
|
|
|
|
<a href="https://github.com/baldurk/renderdoc/wiki" target="_blank">GitHub wiki</a>
|
|
|
|
.. |github_issues_link| raw:: html
|
|
|
|
<a href="https://github.com/baldurk/renderdoc/issues" target="_blank">GitHub issues list</a>
|
|
|
|
.. |renderdoc_logo| image:: imgs/logo.png
|
|
|
|
|renderdoc_logo|
|
|
|
|
Welcome to RenderDoc - a graphics debugger currently available for D3D11, Vulkan and OpenGL development on windows.
|
|
|
|
This document serves primarily as reference guide, introductory document and explanation of which features are available in RenderDoc and how to best use them.
|
|
|
|
The latest information and discussion is always available on the |github_wiki_link|.
|
|
|
|
License
|
|
-------
|
|
|
|
RenderDoc is released under the MIT license, so there are no restrictions on your use of it either commercial or non-commercial. This includes the source release available on the |github_link|.
|
|
|
|
Details of the licenses of third party software used in RenderDoc are included in the LICENSE file in the RenderDoc directory as well as in the :doc:`credits_acknowledgements`.
|
|
|
|
How to browse this documentation
|
|
--------------------------------
|
|
|
|
If you just want to dive straight in and learn how to get started using RenderDoc consider looking at the :doc:`getting_started/quick_start` section which gives a simple introduction on how to get started. Afterwards there are reference pages on each of the windows available in RenderDoc which can be referred to as you use the program, or skimmed to get a feel for the functionality available.
|
|
|
|
|
|
Those of you familiar with other graphics debuggers will likely find much of RenderDoc recognisable, you might want to check out the :doc:`getting_started/faq`, :doc:`getting_started/features`, :doc:`getting_started/tips_tricks` or browse the :doc:`how/index` sections which detail how some common tasks are accomplished.
|
|
|
|
Regardless of your experience or patience for documentation it's recommended that you read the :doc:`getting_started/gotchas_known_issues` as this details known bugs and current limitations of the program.
|
|
|
|
Important notes
|
|
---------------
|
|
|
|
* RenderDoc is not yet bug free! It is pretty stable but you will still likely encounter bugs depending on your use case. I am *always* happy to spend time to fix them and I can work with you even if you cannot share any details about your project. Get in touch (see below) and I will actively fix your bug!
|
|
* On the other side of the coin, please do give feedback when RenderDoc works for you and request features that would make your life easier or improve your workflow.
|
|
* There are a few common issues you might run into, so if you have any problems check the :doc:`getting_started/faq`, or the |github_issues_link| to see if it's been reported.
|
|
|
|
Documentation and Tutorials
|
|
---------------------------
|
|
|
|
.. |youtube_tuts_link| raw:: html
|
|
|
|
<a href="http://www.youtube.com/user/baldurkarlsson/" target="_blank">youtube video tutorials</a>
|
|
|
|
I have recorded some |youtube_tuts_link| showing the use of some basic features and an introduction/overview.
|
|
|
|
.. |icetigris_twitter_link| raw:: html
|
|
|
|
<a href="https://twitter.com/Icetigris" target="_blank">@Icetigris</a>
|
|
|
|
.. |icetigris_presentation_link| raw:: html
|
|
|
|
<a href="https://docs.google.com/presentation/d/1LQUMIld4SGoQVthnhT1scoA3k4Sg0as14G4NeSiSgFU/" target="_blank">slides are up here</a>
|
|
|
|
There is also a great presentation by |icetigris_twitter_link| which goes into some details of how RenderDoc can be used in real world situations: |icetigris_presentation_link|.
|
|
|
|
Contact info, Feedback, Bug reports
|
|
-----------------------------------
|
|
|
|
If you want to get in touch with any feature requests, suggestions, comments etc then feel free to contact me: `Contact me <mailto:baldurk@baldurk.org?subject=RenderDoc%20feedback>`_.
|
|
|
|
Bug reports can be submitted directly via email, or also on the |github_issues_link| where you can also find the full source code.
|
|
|
|
The |builds_link| always has the latest stable and beta build downloads, as well as builds made from the source code each night for the bleeding edge. Stable releases update relatively infrequently and are tested the most to ensure they're as reliable as possible. Beta releases update more often to expose the latest fixes and features from the source, but risk more bugs sneaking in.
|
|
|
|
See Also
|
|
--------
|
|
|
|
.. |homepage_link| raw:: html
|
|
|
|
<a href="https://renderdoc.org/" target="_blank">RenderDoc Homepage</a>
|
|
|
|
* |homepage_link|
|
|
* |builds_link|
|