Skip to content
This repository has been archived by the owner on Mar 11, 2022. It is now read-only.

Latest commit

 

History

History
51 lines (27 loc) · 3.95 KB

DEBUGGING.md

File metadata and controls

51 lines (27 loc) · 3.95 KB
Raw

Attaching a debugger to the glTF-Blender-IO addon

These instructions are considered experimental. They describe how to attach a Python debugger from VSCode to Blender, using a 3rd-party addon called blender-debugger-for-vscode.

Installation

  1. If not already installed, download and install Visual Studio Code ("VSCode").

  2. If not already installed, download and install Python 3.x. It includes a package manager named "pip" that should also be installed.

  3. Open a new command shell and type pip install ptvsd. Ptvsd is "Python Tools for Visual Studio debug server". (source code on GitHub)

  4. Launch VSCode, go to the "Extensions" tab, and install the ms-python.python extension from the "recommended" list. (For more info see the market page).

  5. If you're using Blender 2.80 that bundles a copy of the glTF addon, remove that folder from the install, as this will use the git source tree instead.

  6. In Blender -> Edit -> Preferences -> Files, there is a blank entry for "Scripts" about 4th from the top. Paste in the full path to the glTF-Blender-IO local git repository on your drive. Save the preferences.

  7. Download the blender-debugger-for-vscode addon. Place it in the addons/ folder of the glTF-Blender-IO git repository. By installing the debugging addon there, instead of in the default Blender addons directory, you'll be able to keep it installed when upgrading Blender later.

  8. In Blender -> Edit -> Preferences -> Add-ons, search for the word "Debug", and enable the addon "Development: Debugger for VS Code". It should automatically pick up the location of where ptvsd was installed on this panel. Save the preferences.

  9. (For Blender 2.90 and higher) In Blender -> Edit -> Preferences -> Interface, in the top "Display" section, put a checkmark to enable "Developer Extras."

  10. Quit and re-start Blender. Make sure the glTF import/export options are available, indicating the addon is running from the new location.

Usage

  1. In Blender, press F3 to bring up the tools search window. Search for the word "Debug", and then click "Debug: Start Debug Server for VS Code."

  2. In VSCode, with the glTF-Blender-IO folder opened, press F5 or choose "Start Debugging" from the Debug menu.

If both actions happen within 20 seconds or so, you may see a console message in VSCode saying "Debugger is attached." If not, it may have just silently worked, but you can check: Go back to Blender and find the tool "Debug: Check if VS Code is Attached" and run that. It should also produce the "Debugger is Attached" message.

Sample Breakpoint

Look for a line in __init__.py at the end of def invoke that looks like this:

        return ExportHelper.invoke(self, context, event)

Try placing a breakpoint on this line by clicking to the left of the line number, to place a red dot there. Then, in Blender, go to File -> Export -> glTF. Blender's entire UI should immediately lock up, and VSCode should show the execution halted on the breakpoint.

Once a breakpoint is hit, you can inspect the call stack in the left window, and interrogate local variables with the DEBUG CONSOLE window at the bottom.

See the documentation and video included with blender-debugger-for-vscode for additional capabilities not covered here.

Stop Debugging

In VSCode, the far-right icon on the debug toolbar is a red square with a disconnected plug, with a "Disconnect" tool-tip. Clicking this will detach the debugger and let Blender continue. The ptvsd server is likely still running for the remainder of the Blender session, so you can re-attach by asking VSCode to launch the debugger again.