Emulator-Archive/ppsspp
1
0
Fork 0
mirror of https://github.com/hrydgard/ppsspp.git synced 2024-11-22 21:09:52 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
Page: How to create a frame dump
Pages
Build instructions Help: Graphics don't look right Help: My saves won't load Help: PPSSPP is crashing Home How to bisect to find what broke a game How to create a display list dump How to create a frame dump How to debug crashes on Android using addr2line How to debug the JIT How to find JIT bugs, the easy way How to find a graphic issue with the GE debugger How to get an adb logcat from a PC How to hook memcpy to fix black screen problems How to keep a pull request up to date How to play multiplayer games with PPSSPP How to report an issue properly How to use the Vulkan validation layers on Android Texture replacement ini syntax i18n translation pointer names 如何使用PPSSPP多人联机游戏
12 How to create a frame dump
Henrik Rydgård edited this page 2024-11-22 00:12:10 +01:00
Table of Contents

Frame dumps are very useful for graphics debugging. They consist of a complete log of all the graphics used in a frame, which can be loaded back into PPSSPP by another user and debugged.

Tip: if you're not seeing anything at all with certain settings or a backend, create the frame dump while you can see those things. This way you will create a correct frame dump that can be used to troubleshoot the settings.

Method #1: In-app developer menu

NOTE: This only works in recent versions of PPSSPP. It will store the file in your memstick directory (PSP/SYSTEM/DUMP). If you don't know how to get it out of there, use method #2.

If you haven't already done this, enable the in-game developer menu:

  • Settings->Tools->Developer Tools: Check "Show developer menu"

To grab a frame dump:

  • Dev-menu -> "Create frame dump"

On desktop platforms, it will highlight the new file in the file manager. On mobile platform, it will display the path to the new file.

Method 2: The web debugger

  1. In PPSSPP's settings, select Tools -> Developer Tools and enable "Allow remote debugger".
  2. Start your game, play to the place where you have a graphical problem.
  3. Visit this page: http://ppsspp-debugger.unknownbrackets.org/gpu (in PPSSPP 1.8.0 and lower, you may need to use Firebox\Edge.). Also, make sure you didn't get redirected to the https:// protocol, it really needs to be http://
  4. Press Record.
  5. If you're using Android or iOS, you may need to switch back to PPSSPP for it to finish recording.
  6. The frame dump should automatically download.
  7. Take this file and upload it or email it or whatever. To attach it to a github issue, just zip it up and drag it into the post.

You can visit the debugger URL from a different device, as long as it's connected to the same network.

Method 3 (Windows-only): The GE debugger

Here's the alternate method that works only on Windows, but also works on PPSSPP 1.5.x and 1.6.x:

  • Start your game, play to the place where you have a graphical problem.

  • Open the log console (optional)

  • Choose Debug->GE Debugger in the window menu

  • Press Record

  • You'll see something like the following written in the log console:

      N[G3D]: Debugger\Record.cpp:386 Recording filename: C:\dev\ppsspp\Windows\..\memstick/PSP/SYSTEM/DUMP//ULESxxxxx_yyyy.ppdmp
  N[SYSTEM]: Debugger\Record.cpp:623 Recording finished

  • Take this file and upload it or email it or whatever.