AssetFetch for Blender

This addon is a client for the AssetFetch protocol, an open system for 3D asset discovery and automated imports.

Installation

Visit the AssetFetch website for an expedited installation option using the extension repository system in Blender.

Otherwise, follow these steps to manually install the addon:

1. Visit the Releases page
2. Choose the latest version and click on "Assets" below the informative text
3. Download the .zip archive for the addon (not "Source code")
4. Go into Blender and select Edit -> Preferences -> Get Extensions.
5. Open the small drop-down menu in the top-right corner and click on Install from disk... and navigate to the ZIP file (no need to unpack it).
6. The AssetFetch panel will be added in the right-side menu in the 3D-window.

Development Setup

I recommend developing in VS Code with the Blender Development Extension by Jacques Lucke

Code overview

The addon is split into multiple modules:

• operator contains all the bpy operators, meaning all the distinct actions this addon can perform.
• property contains all the bpy properties that are used to store and handle the incoming data from the provider. AF stores all its data in bpy.context.window_manager.af.
• ui contains the code for the individual panels, all of which are in the VIEW_3D section (meaning the window that you get by opening the right-side panel in the 3D view).
• util is for miscellaneous functionality.

Every module's __init__.py imports all relevant classes and stores them in a registration_targets array from where the register() and unregister() functions read them when the addon is (un)loaded inside Blender.

The global __init__.py for the entire addon does the same pattern again by loading the registration functions from all the other modules.

Required dependencies are loaded from the /src/lib directory.

YAPF style

The following YAPF style configuration is recommended:

{based_on_style: pep8, indent_width:4, continuation_indent_width:4, continuation_align_style = fixed, column_limit: 180, use_tabs: true}

When using VSCode you can install the YAPF extension (eeyore.yapf) and add the following to your settings.json:

"yapf.args": ["--style", "{based_on_style: pep8, indent_width:4, continuation_indent_width:4, continuation_align_style = fixed, column_limit: 180, use_tabs: true}"]