Skip to content
This repository was archived by the owner on Feb 25, 2025. It is now read-only.
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 4 additions & 5 deletions impeller/docs/renderdoc_frame_capture.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,15 @@
# Frame Capture with RenderDoc

[RenderDoc](https://renderdoc.org/) is a graphics debugger that can be used to capture frames. With Impeller starting to support gles and Vulkan backends, RenderDoc can provide insights into the application's frames.
[RenderDoc](https://renderdoc.org/) is a graphics debugger that can be used to capture frames. With Impeller starting to support OpenGL ES and Vulkan backends, RenderDoc can provide insights into the application's frames.

1. First step is to set up RenderDoc. Follow the instructions [here](https://renderdoc.org/docs/getting_started/quick_start.html). For the purposes of this guide it is assumed that you are able to get RenderDoc running.
2. The next step would be to run the application you wish the capture the frames of. Typically these would be one of the playground tests. To build these, do:

```bash
# In your $ENGINE_SRC folder, do:

./flutter/tools/gn --unopt --no-lto --enable-impeller-playground\
--target-dir host_debug_impeller_vulkan
autoninja -C out/host_debug_impeller_vulkan/
./flutter/tools/gn --unopt --enable-impeller-vulkan
ninja -C out/host_debug_unopt/
```

3. Start RenderDoc, and click the "Launch Application" button.
Expand All @@ -19,7 +18,7 @@ autoninja -C out/host_debug_impeller_vulkan/

4. Fill out the following parameters, and click launch:
- executable: `$ENGINE_SRC/out/host_debug_impeller_vulkan/impeller_unittests` (expand `ENGINE_SRC`).
- args: `--gtest_filter="*CanDrawRect/Vulkan*"`
- args: `--gtest_filter="*CanDrawRect/Vulkan*" --enable_playground`
- working dir: `$ENGINE_SRC` (expand `ENGINE_SRC`)

5. For the frame you wish to capture, press `F12`, you will now be able to see the frame capture and inspect the state.
Expand Down