mirror of
https://github.com/baldurk/renderdoc.git
synced 2026-05-05 09:30:44 +00:00
baldurk
c38affcded
* All renderdoc code up to this point was written by me, history is available by request
108 lines
5.0 KiB
XML
108 lines
5.0 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<topic id="6f4dad92-3db3-448f-9f1a-79af65f74492" revisionNumber="1">
|
|
<developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<introduction>
|
|
<autoOutline />
|
|
<para>The Live capture window opens up when you launch a capture of a program, as well as when
|
|
you attach to an existing program.</para>
|
|
</introduction>
|
|
<section address="attaching">
|
|
<title>Attaching to an existing instance</title>
|
|
<content>
|
|
<para>
|
|
After you've launched a program through RenderDoc and its hooks are added you can freely disconnect
|
|
(by closing the live capture window) or close the main UI. You can then connect to this again later,
|
|
either from the same computer or another computer connecting over the network.
|
|
</para>
|
|
<para>
|
|
To connect to an existing hooked program, select Attach to Running Instance from the File menu. This opens up
|
|
the attach window that allows you to select a remote host to connect to. By default localhost is already
|
|
in the list, but you can add and remove other hosts.
|
|
</para>
|
|
|
|
<alert class="caution">
|
|
<para>Please note that none of the connections RenderDoc makes or uses are encrypted or protected, so if this is a
|
|
concern you should look into securing the connections by hand.</para>
|
|
</alert>
|
|
|
|
<mediaLink>
|
|
<caption placement="after" lead="Remote Hosts">Attaching to a running instance either locally or remotely.</caption>
|
|
<image xlink:href="AttachInstance"/>
|
|
</mediaLink>
|
|
|
|
<para>
|
|
When the window opens, when you add a new host or when you click refresh then the hosts will be queried
|
|
across the network to see if a connection exists. While this is in progress the host will be listed in
|
|
italics and with a busy icon.
|
|
</para>
|
|
<para>
|
|
Once a host has been scanned, if any instances are found then that host can be expanded to see the list, and
|
|
details are listed about each instance. The name is OS-dependent but is usually the executable name. The API
|
|
name is listed, as well as the username of any user that is already connected.
|
|
</para>
|
|
<para>
|
|
When you click connect, a live capture window will be opened up - just the same as the window that is automatically
|
|
opened when you start a program. Any captures that have already been made before you connect will then populate.
|
|
</para>
|
|
|
|
<alert class="note">
|
|
<para>If you connect to a running instance, any existing user will be kicked off. Just seeing the instances running on
|
|
a host will not.</para>
|
|
</alert>
|
|
|
|
</content>
|
|
</section>
|
|
<section address="multicap">
|
|
<title>Capture Connection window</title>
|
|
<content>
|
|
|
|
<para>
|
|
When a capture is launched (or attached to) the connection window is opened in the main UI. If you
|
|
end up only taking one capture and closing the program afterwards the connection window will automatically
|
|
close - likewise if you take no captures at all. These cases don't need the management options the connection
|
|
window provides.
|
|
</para>
|
|
|
|
<para>
|
|
In addition to managing captures that have been taken, you can also trigger a capture (optionally with a
|
|
countdown timer).
|
|
</para>
|
|
|
|
<mediaLink>
|
|
<caption placement="after" lead="Connection Window">Viewing multiple captures taken in a program.</caption>
|
|
<image xlink:href="MultipleCaptures"/>
|
|
</mediaLink>
|
|
|
|
<para>
|
|
In this example we have a connection window open to the CascadedShadowMaps11 sample from the DirectX SDK.
|
|
Two captures have been made and we can see their thumbnails to help distinguish between them. This is visible
|
|
at any point, regardless of whether you have close the program or not - you can simply switch back to RenderDoc
|
|
while it's running.
|
|
</para>
|
|
|
|
<alert class="note">
|
|
<para>Note, if you have remotely connected you will need to wait while the captures copy across the network
|
|
to your PC, after which point everything behaves the same as a local capture.</para>
|
|
</alert>
|
|
|
|
<para>
|
|
From here you can save these captures out - as currently they are only temporary copies that will be
|
|
cleaned up on close. You can also manually delete any capture you wish to discard.
|
|
</para>
|
|
|
|
<para>
|
|
Double clicking on any capture will close any current open capture in the RenderDoc UI, and open up that
|
|
capture for inspection. You may also right click or use the drop-down menu on the open button to
|
|
launch a new instance of RenderDoc for viewing the log. This is mostly useful if you want to compare two
|
|
captures side-by-side easily.
|
|
</para>
|
|
|
|
<mediaLink>
|
|
<caption placement="after" lead="New instance">Launch new RenderDoc instance to open this capture.</caption>
|
|
<image xlink:href="OpenCapNewInstance"/>
|
|
</mediaLink>
|
|
|
|
</content>
|
|
</section>
|
|
</developerConceptualDocument>
|
|
</topic> |